5. Рамазанова Дарина Наимовна 614

README.md

@@ -13,6 +13,7 @@
 - [Часть 2. CRUD и корзина для интернет-магазина](src/part2/TASK.md) — нужно реализовать хранилище товаров в памяти (список кортежей), операции создания, чтения, изменения и удаления записей, аккуратную работу с ценами через `Decimal` и корзину покупателя, в которую товары переносятся со склада и обратно без потери количества.
 - [Часть 3. Нормализация имён и консоль администратора](src/part3/TASK.md) — нужно привести названия товаров к единому написанию и следить за их уникальностью, научить хранилище печатать себя выровненной текстовой таблицей и написать интерактивную консоль администратора, через которую можно создавать, просматривать, изменять и удалять товары.
 - [Часть 4. Хранилище-словарь и UUID-идентификаторы](src/part4/TASK.md) — нужно перевести хранилище со списка кортежей на словарь, выдавать товарам идентификаторы в виде UUID, завести индекс имён для быстрой проверки уникальности, научить `update_product` менять только часть полей и оформить продуктовую корзину в виде словаря.
+- [Часть 5. Snowflake-идентификаторы для интернет-магазина](src/part5/TASK.md) — нужно вернуться к Snowflake из части 1 и оформить его как генератор со своим счётчиком, перевести товары с UUID на целочисленные идентификаторы и написать параметрический декоратор, который считает успешные и неуспешные вызовы операций хранилища, а консоль администратора научить печатать эту статистику командой `stats`.
 
 ## Дедлайны
 
@@ -21,7 +22,8 @@
 | [Часть 1. Генератор идентификаторов Twitter Snowflake](src/part1/TASK.md) | 25.09.2026 | дедлайн истек |
 | [Часть 2. CRUD и корзина для интернет-магазина](src/part2/TASK.md) | 02.10.2026 | дедлайн истек |
 | [Часть 3. Нормализация имён и консоль администратора](src/part3/TASK.md) | 12.10.2026 | дедлайн истек |
-| [Часть 4. Хранилище-словарь и UUID-идентификаторы](src/part4/TASK.md) | 01.11.2026 | активно |
+| [Часть 4. Хранилище-словарь и UUID-идентификаторы](src/part4/TASK.md) | 01.11.2026 | дедлайн истек |
+| [Часть 5. Snowflake-идентификаторы для интернет-магазина](src/part5/TASK.md) | 15.11.2026 | активно |
 
 ## Критерии оценивания
 

docs/grading_criteria.md

@@ -61,12 +61,13 @@
 | `T1` | `else` или `elif` после `return`, `raise`, `continue` или `break` |
 | `T2` | Явное приведение к `bool` в условиях (`if bool(x):`) и сравнение с `True` / `False` (`if x == True:`) |
 | `T3` | Сравнение с синглтонами и членами enum'ов через `==` / `!=` вместо `is` / `is not` |
-| `T4` | Проверка пустоты коллекции через `len(x) == 0` вместо `if not x` |
+| `T4` | Неправильная проверка коллекции на пустоту: через `len(x) == 0` или через сравнение с литералом пустой коллекции (`string == ""`, `dict_ == {}`, `items == []`) вместо `if not x` |
 | `T5` | Обход через `for i in range(len(items))`, когда индекс не нужен (вместо `for item in items` или `enumerate`) |
 | `T6` | `if cond: return True else: return False` вместо `return cond` |
 | `T7` | Изменяемое значение по умолчанию у аргумента (`def f(x=[])`) |
 | `T8` | Ручная конкатенация строк вместо f-строк |
 | `T9` | Избыточные комментарии, пересказывающие очевидный код |
+| `T10` | Транслитерация в именах переменных (`spisok`, `summa`, `chislo` вместо `items`, `total`, `number`) |
 
 ## Штраф за списывание
 

src/part1/constants.py

@@ -19,20 +19,20 @@
 # Все константы, зависящие от ёмкостей *_BITS, должны вычисляться из них.
 
 # Twitter's original Snowflake epoch: 2010-11-04 01:42:54.657 UTC.
-EPOCH_MS_DEFAULT: Final[int] = 0
+EPOCH_MS_DEFAULT: Final[int] = 1288834974657
 
 # Node identifier used when the caller does not supply one.
-NODE_ID_DEFAULT: Final[int] = 0
+NODE_ID_DEFAULT: Final[int] = 1
 
 # Width of each field, in bits.
-TIMESTAMP_BITS: Final[int] = 0
-NODE_ID_BITS: Final[int] = 0
-SEQUENCE_ID_BITS: Final[int] = 0
+TIMESTAMP_BITS: Final[int] = 41
+NODE_ID_BITS: Final[int] = 10
+SEQUENCE_ID_BITS: Final[int] = 12
 
 # Largest value each field can hold.
-TIMESTAMP_MS_MAX: Final[int] = 0
-NODE_ID_MAX: Final[int] = 0
-SEQUENCE_ID_MAX: Final[int] = 0
+TIMESTAMP_MS_MAX: Final[int] = (2**TIMESTAMP_BITS) - 1
+NODE_ID_MAX: Final[int] = (2**NODE_ID_BITS) - 1
+SEQUENCE_ID_MAX: Final[int] = (2**SEQUENCE_ID_BITS) - 1
 
 # Здесь можно добавить собственные вспомогательные константы
 # (например, сдвиги полей при сборке идентификатора).

src/part1/snowflake.py

@@ -13,13 +13,16 @@
 :func:`decode_node_id` and :func:`decode_sequence_id`.
 """
 
-import time  # noqa: F401
+import time
 
 from .constants import (  # noqa: F401
     EPOCH_MS_DEFAULT,
+    NODE_ID_BITS,
     NODE_ID_DEFAULT,
     NODE_ID_MAX,
+    SEQUENCE_ID_BITS,
     SEQUENCE_ID_MAX,
+    TIMESTAMP_BITS,
     TIMESTAMP_MS_MAX,
 )
 
@@ -35,7 +38,7 @@ def read_current_millis(epoch_ms: int) -> int:
         negative if ``epoch_ms`` lies in the future.
     """
     # TODO: реализуйте функцию
-    return 0
+    return int(time.time() * 1000) - epoch_ms
 
 
 def decode_timestamp_ms(snowflake_id: int, epoch_ms: int = EPOCH_MS_DEFAULT) -> int:
@@ -51,7 +54,7 @@ def decode_timestamp_ms(snowflake_id: int, epoch_ms: int = EPOCH_MS_DEFAULT) ->
         generated.
     """
     # TODO: реализуйте функцию
-    return 0
+    return epoch_ms + (snowflake_id >> (NODE_ID_BITS + SEQUENCE_ID_BITS))
 
 
 def decode_node_id(snowflake_id: int) -> int:
@@ -65,7 +68,7 @@ def decode_node_id(snowflake_id: int) -> int:
         ``[0, NODE_ID_MAX]``.
     """
     # TODO: реализуйте функцию
-    return 0
+    return (snowflake_id >> SEQUENCE_ID_BITS) & NODE_ID_MAX
 
 
 def decode_sequence_id(snowflake_id: int) -> int:
@@ -79,7 +82,7 @@ def decode_sequence_id(snowflake_id: int) -> int:
         the range ``[0, SEQUENCE_ID_MAX]``.
     """
     # TODO: реализуйте функцию
-    return 0
+    return snowflake_id & SEQUENCE_ID_MAX
 
 
 def generate_snowflake_id(
@@ -111,4 +114,19 @@ def generate_snowflake_id(
         cases an explanatory message is printed to stdout first.
     """
     # TODO: реализуйте функцию
-    return 0
+    if not (0 <= node_id <= NODE_ID_MAX):
+        print(f"node_id must be in [0, {NODE_ID_MAX}], have {node_id}")
+        return None
+
+    if not (0 <= sequence_id <= SEQUENCE_ID_MAX):
+        print(f"sequence_id must be in [0; {SEQUENCE_ID_MAX}], have {sequence_id}")
+        return None
+
+    vremya = read_current_millis(epoch_ms)
+    if vremya > TIMESTAMP_MS_MAX:
+        print("Timestamps overflows")
+        return None
+
+    return (vremya << (NODE_ID_BITS + SEQUENCE_ID_BITS)) | (
+        node_id << (SEQUENCE_ID_BITS | sequence_id)
+    )

src/part2/TASK.md

@@ -8,6 +8,7 @@
 построим на нём серверную часть простого интернет-магазина: каталог товаров и
 корзину покупателя.
 
+
 Если писать такой код «в лоб», быстро возникают проблемы:
 
 - записи о товарах разбросаны по программе, и каждый кусок кода сам решает, как

src/part2/cart.py

@@ -11,8 +11,8 @@
 
 from typing import Final
 
-from .crud import read_product, update_product  # noqa: F401
-from .storage import (  # noqa: F401
+from .crud import read_product, update_product
+from .storage import (
     NAME_INDEX,
     PRICE_INDEX,
     QUANTITY_INDEX,
@@ -24,7 +24,33 @@
 
 # TODO: задайте позиции полей внутри кортежа CartLine
 LINE_PRODUCT_ID_INDEX: Final = 0
-LINE_QUANTITY_INDEX: Final = 0
+LINE_QUANTITY_INDEX: Final = 1
+
+
+def find_cart_line(cart: list[CartLine], product_id: int) -> CartLine | None:
+
+    for line in cart:
+        if line[LINE_PRODUCT_ID_INDEX] == product_id:
+            return line
+    return None
+
+
+def change_cart_quantity(
+    cart: list[CartLine], product_id: int, delta: int
+) -> CartLine | None:
+
+    for i, line in enumerate(cart):
+        if line[LINE_PRODUCT_ID_INDEX] == product_id:
+            new_quantity = line[LINE_QUANTITY_INDEX] + delta
+
+            if new_quantity == 0:
+                del cart[i]
+                return None
+            else:
+                new_line = (product_id, new_quantity)
+                cart[i] = new_line
+                return new_line
+    return None
 
 
 def add_to_cart(
@@ -54,7 +80,29 @@ def add_to_cart(
         when the product is unknown or the store cannot cover the request.
     """
     # TODO: реализуйте функцию
-    return (0, 0)
+    product = read_product(storage, product_id)
+    if product is None:
+        return None
+
+    stock_quantity = product[QUANTITY_INDEX]
+    if stock_quantity < quantity:
+        print(
+            f"not enough stock for product {product_id}: "
+            f"{stock_quantity} available, {quantity} requested"
+        )
+        return None
+
+    new_stock_quantity = stock_quantity - quantity
+    fields = (product[NAME_INDEX], product[PRICE_INDEX], new_stock_quantity)
+    update_product(storage, product_id, fields)
+
+    existing_line = find_cart_line(cart, product_id)
+    if existing_line:
+        return change_cart_quantity(cart, product_id, quantity)
+    else:
+        new_line = (product_id, quantity)
+        cart.append(new_line)
+        return new_line
 
 
 def remove_from_cart(
@@ -86,4 +134,29 @@ def remove_from_cart(
         line for the product or holds too few units.
     """
     # TODO: реализуйте функцию
-    return (0, 0)
+    cart_line = find_cart_line(cart, product_id)
+    if cart_line is None:
+        print(f"product {product_id} is not in the cart")
+        return None
+
+    cart_quantity = cart_line[LINE_QUANTITY_INDEX]
+    if cart_quantity < quantity:
+        print(
+            f"cart holds only {cart_quantity} unit(s) of product "
+            f"{product_id}, cannot remove {quantity}"
+        )
+        return None
+
+    product = read_product(storage, product_id)
+    if product is None:
+        return None
+
+    new_stock_quantity = product[QUANTITY_INDEX] + quantity
+    fields = (product[NAME_INDEX], product[PRICE_INDEX], new_stock_quantity)
+    update_product(storage, product_id, fields)
+
+    result = change_cart_quantity(cart, product_id, -quantity)
+
+    if result is None:
+        return (product_id, 0)
+    return result

src/part2/crud.py

@@ -14,13 +14,13 @@
 
 from decimal import Decimal
 
-from .storage import (  # noqa: F401
+from .storage import (
     NAME_INDEX,
     PRODUCT_ID_INDEX,
     PRODUCT_ID_MIN,
     Product,
 )
-from .utils import normalize_price  # noqa: F401
+from .utils import normalize_price
 
 
 def generate_product_id(storage: list[Product]) -> int:
@@ -35,7 +35,9 @@ def generate_product_id(storage: list[Product]) -> int:
         empty.
     """
     # TODO: реализуйте функцию
-    return 0
+    if not storage:
+        return PRODUCT_ID_MIN
+    return max(product[PRODUCT_ID_INDEX] for product in storage) + 1
 
 
 def create_product(
@@ -57,7 +59,19 @@ def create_product(
         name is printed.
     """
     # TODO: реализуйте функцию
-    return 0
+    name, price, quantity = fields
+
+    for product in storage:
+        if product[NAME_INDEX] == name:
+            print(f"product name '{name}' is already taken")
+            return None
+
+    product_id = generate_product_id(storage)
+    normalized_price = normalize_price(price)
+
+    new_product = (product_id, name, normalized_price, quantity)
+    storage.append(new_product)
+    return product_id
 
 
 def read_product(storage: list[Product], product_id: int) -> Product | None:
@@ -73,7 +87,12 @@ def read_product(storage: list[Product], product_id: int) -> Product | None:
         printed in that case).
     """
     # TODO: реализуйте функцию
-    return (0, "", Decimal(0), 0)
+    for product in storage:
+        if product[PRODUCT_ID_INDEX] == product_id:
+            return product
+
+    print(f"no product with id {product_id}")
+    return None
 
 
 def update_product(
@@ -100,7 +119,17 @@ def update_product(
         left unchanged and a message is printed).
     """
     # TODO: реализуйте функцию
-    return (0, "", Decimal(0), 0)
+    name, price, quantity = fields
+    normalized_price = normalize_price(price)
+
+    for i, product in enumerate(storage):
+        if product[PRODUCT_ID_INDEX] == product_id:
+            updated_product = (product_id, name, normalized_price, quantity)
+            storage[i] = updated_product
+            return updated_product
+
+    print(f"no product with id {product_id}")
+    return None
 
 
 def delete_product(storage: list[Product], product_id: int) -> int | None:
@@ -117,4 +146,10 @@ def delete_product(storage: list[Product], product_id: int) -> int | None:
         a message is printed).
     """
     # TODO: реализуйте функцию
-    return 0
+    for i, product in enumerate(storage):
+        if product[PRODUCT_ID_INDEX] == product_id:
+            del storage[i]
+            return product_id
+
+    print(f"no product with id {product_id}")
+    return None

src/part2/storage.py

@@ -26,9 +26,9 @@
 
 # TODO: задайте позиции полей внутри кортежа Product
 PRODUCT_ID_INDEX: Final = 0
-NAME_INDEX: Final = 0
-PRICE_INDEX: Final = 0
-QUANTITY_INDEX: Final = 0
+NAME_INDEX: Final = 1
+PRICE_INDEX: Final = 2
+QUANTITY_INDEX: Final = 3
 
 # TODO: задайте идентификатор первого товара в пустом хранилище
-PRODUCT_ID_MIN: Final[int] = 0
+PRODUCT_ID_MIN: Final[int] = 1

src/part2/utils.py

@@ -6,13 +6,13 @@
 currency values free of binary floating-point error.
 """
 
-from decimal import ROUND_HALF_UP, Decimal  # noqa: F401
+from decimal import ROUND_HALF_UP, Decimal
 from typing import Final
 
 
 # TODO: задайте число знаков после запятой и шаг квантования
-PRICE_PRECISION: Final[int] = 0
-PRICE_STEP: Final = Decimal(0)
+PRICE_PRECISION: Final[int] = 2
+PRICE_STEP: Final = Decimal(1).scaleb(-PRICE_PRECISION)
 
 
 def normalize_price(price: Decimal) -> Decimal:
@@ -26,4 +26,4 @@ def normalize_price(price: Decimal) -> Decimal:
         with halves rounded up.
     """
     # TODO: реализуйте функцию
-    return Decimal(0)
+    return price.quantize(PRICE_STEP, rounding=ROUND_HALF_UP)

src/part3/TASK.md

@@ -81,6 +81,7 @@ CRUD-операции над ним. Корзина (`cart.py`) в этой ча
 `"abc    def\tghi\tjkl" → "abc def ghi jkl"`, `" \t\n " → ""`,
 `"claw hammer" → "claw hammer"` (уже канонично — не меняется).
 
+
 ### `get_storage_str_representation(storage: list[Product]) -> str`
 
 Отрисовывает всё хранилище одной мультистрокой — выровненной таблицей,