diff --git a/README.md b/README.md
new file mode 100644
index 0000000..483ffee
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# \# Система анализа заказов интернет-магазина
+
+# 
+
+# \## Описание
+
+# Модуль для обработки заказов: валидация, группировка по пользователям, расчёт сумм, скидки, фильтрация, отчёты.
+
+# 
+
+# \## Функции
+
+# \- load\_orders – загрузка из файла
+
+# \- validate\_orders – отбрасывание некорректных записей
+
+# \- group\_by\_user – группировка по пользователям
+
+# \- calculate\_user\_total – сумма трат пользователя
+
+# \- find\_most\_expensive\_item – самый дорогой товар (за единицу)
+
+# \- apply\_discount – применение скидки
+
+# \- filter\_by\_price\_threshold – фильтрация по цене
+
+# \- get\_unique\_items – уникальные названия товаров
+
+# \- generate\_report – формирование отчёта
+
+# \- save\_report – сохранение отчёта
+
+# 
+
+# \## Запуск
+
+# python order\_processor.py
+