diff --git a/README.m b/README.m
new file mode 100644
index 0000000..0db5981
Binary files /dev/null and b/README.m differ
diff --git a/src/README.md b/src/README.md
index e69de29..c0aa6ae 100644
--- a/src/README.md
+++ b/src/README.md
@@ -0,0 +1,21 @@
+# Управление складскими запасами интернет-магазина
+
+## Реализованные 10 функций
+
+| Функция | Описание | Возвращает |
+|---------|----------|------------|
+| load_products(filepath) | Загружает товары из CSV | list[dict] |
+| validate_product(product) | Проверяет корректность данных | bool |
+| filter_by_category(products, category) | Фильтрует по категории | list[dict] |
+| filter_by_quantity(products, min_quantity) | Фильтрует по остатку (≥) | list[dict] |
+| calculate_total_value(products) | Общая стоимость склада | float |
+| find_low_stock(products, threshold) | Товары с остатком ≤ порога | list[dict] |
+| group_by_supplier(products) | Группировка по поставщикам | dict |
+| get_most_expensive_product(products) | Самый дорогой товар | dict или None |
+| search_by_name(products, keyword) | Поиск по ключевому слову | list[dict] |
+| save_inventory_report(products, filepath) | Сохраняет отчёт | bool |
+
+## Запуск
+
+```bash
+python src/main.py
\ No newline at end of file