- **[README.md](./README.md)** - Главная страница документации
- **[SUMMARY.md](./SUMMARY.md)** - Итоговая сводка (статистика, метрики)
- **[CROSS_REFERENCE.md](./CROSS_REFERENCE.md)** - Матрица взаимосвязей модулей
+- **[CHANGELOG.md](./CHANGELOG.md)** - История изменений документации ✨ NEW
## 🏗️ Архитектура
## ⚙️ Service Layer
- **[Services README](./services/README.md)** - Обзор сервисного слоя
-- **[Каталог сервисов](./services/SERVICES_CATALOG.md)** - Все 51 сервис с описаниями
+- **[Каталог сервисов](./services/SERVICES_CATALOG.md)** - Все 48 сервисов с описаниями
- **[Паттерны](./services/PATTERNS.md)** - Best practices и паттерны проектирования
+## 🎛️ Web-контроллеры ✨ NEW
+
+- **[Controllers README](./controllers/README.md)** - Обзор и классификация 161 контроллера
+- **[Нестандартные контроллеры](./controllers/non-standard/)** - 47 контроллеров с детальной документацией
+- **[Каталог стандартных](./controllers/standard/CATALOG.md)** - 114 стандартных контроллеров
+
+**Топ контроллеры:**
+- [AutoPlannogrammaController](./controllers/non-standard/AutoPlannogrammaController_ANALYSIS.md) - 2457 строк
+- [WriteOffsErpController](./controllers/non-standard/WriteOffsErpController_ANALYSIS.md) - 1252 строки
+- [MarketplaceOrdersController](./controllers/non-standard/MarketplaceOrdersController_ANALYSIS.md) - 1072 строки
+
+## ⌨️ Консольные команды ✨ NEW
+
+- **[Console Commands README](./console-commands/README.md)** - 17 контроллеров, 62 команды
+- **[Примеры использования](./console-commands/EXAMPLES.md)** - 9 готовых сценариев
+
+**Основные категории:**
+- CronController (28 команд) - синхронизация с 1С, когорты, рассылки
+- BonusController (9 команд) - управление бонусами клиентов
+- MarketplaceController (5 команд) - Yandex Market, Flowwow
+- TimetableController (1 команда) - автозакрытие смен
+
+## 📦 Модели и Records ✨ UPDATED
+
+- **[Models README](./models/README.md)** - Классификация 393 моделей
+- **[Admin](./models/Admin.md)** - Модель сотрудников (IdentityInterface)
+- **[Users](./models/Users.md)** - Модель пользователей (клиенты)
+- **[Sales](./models/Sales.md)** - Модель чеков продаж
+- **[Task](./models/Task.md)** - Модель задач
+- **[Files](./models/Files.md)** - Универсальное хранилище файлов ✨ NEW
+- **[Store](./models/Store.md)** - Модель магазинов
+- **[Timetable](./models/Timetable.md)** - Модель расписания
+- **[UsersBonus](./models/UsersBonus.md)** - Модель бонусных операций
+- **[MarketplaceOrders](./models/MarketplaceOrders.md)** - Заказы маркетплейсов
+- **[Products1c](./models/Products1c.md)** - Интеграция с 1С
+
+## 🗄️ База данных ✨ NEW
+
+- **[Database README](./database/README.md)** - Обзор структуры БД
+- **[Schema](./database/SCHEMA.md)** - Полная схема таблиц
+- **[Tables](./database/TABLES.md)** - Описание всех таблиц
+
+## ❌ Справочник ошибок ✨ NEW
+
+- **[Errors README](./errors/README.md)** - Главный индекс ошибок
+- **[Бизнес-ошибки](./errors/BUSINESS_ERRORS.md)** - Ошибки бизнес-логики
+- **[Ошибки аутентификации](./errors/AUTH_ERRORS.md)** - Проблемы доступа
+- **[Ошибки валидации](./errors/VALIDATION_ERRORS.md)** - Валидация данных
+- **[Коды ошибок](./errors/ERROR_CODES.md)** - Справочник кодов
+
+## 📖 Руководства ⏳ В РАЗРАБОТКЕ
+
+- **[Guides README](./guides/README.md)** - Обзор руководств
+
## 📚 Модули по категориям
### 👥 HR и Персонал
## 📊 Статистика
-- **Модулей:** 12
-- **Контроллеров:** 160+
-- **Сервисов:** 51
-- **API3 Контроллеров:** 18
-- **API3 Эндпоинтов:** 76
-- **Actions:** 73
-- **Моделей:** 390+
-- **Страниц документации:** 25+
-- **Диаграмм:** 35+
-- **Примеров кода:** 100+
+| Компонент | Количество | Покрытие |
+|-----------|-----------|----------|
+| **Документов Markdown** | **209** | **100%** |
+| **Бизнес-модулей** | **12** | **100%** (12/12) |
+| **Web-контроллеров** | **161** | **100%** (161/161) |
+| **Console команд** | **62** | **100%** (62/62) |
+| **Сервисов** | **48** | **100%** (48/48) |
+| **API3 контроллеров** | **18** | **50%** (9/18) |
+| **API3 эндпоинтов** | **76** | **71%** (54/76) |
+| **Моделей** | **393** | **1%** (3/393) |
+| **Диаграмм** | **35+** | - |
+| **Примеров кода** | **100+** | - |
+| **Размер документации** | **~5.1 MB** | - |
## 📝 Версии
+- **v2.0** (2025-11-27) - Расширенная документация ✨ CURRENT
+ - 209 документов (~5.1 MB)
+ - 161 web-контроллер
+ - 62 консольные команды
+ - Справочник ошибок
+ - База данных
+ - CHANGELOG.md
+
- **v1.0** (2025-11-17) - Первая полная версия документации
- Все 12 модулей
- Матрица взаимосвязей
- Примеры и диаграммы
+ - API3 (50%)
+ - Сервисы (100%)
---
- **[SUMMARY.md](./SUMMARY.md)** - Итоговая сводка всей документации
- **[CROSS_REFERENCE.md](./CROSS_REFERENCE.md)** - Матрица взаимосвязей модулей
- **[INDEX.md](./INDEX.md)** - Быстрый индекс документации
+- **[CHANGELOG.md](./CHANGELOG.md)** - История изменений документации ✨ NEW
### 🏗️ [Архитектура](./architecture/)
php yii timetable/autoclose-shifts
```
-### 6. [Руководства](./guides/README.md)
+### 6. [Web-контроллеры](./controllers/README.md) ✅ NEW
+Полная документация 161 web-контроллера системы:
+
+**Ключевые документы:**
+- [Обзор и классификация](./controllers/README.md) - 161 контроллер, классификация на стандартные/нестандартные
+- [Нестандартные контроллеры](./controllers/non-standard/) - Детальная документация 47 контроллеров
+- [Каталог стандартных](./controllers/standard/CATALOG.md) - Сводный каталог 114 контроллеров
+
+**Топ-3 крупнейших контроллера:**
+- **AutoPlannogrammaController** (2457 строк) - Автоматическая планограмма товаров
+- **WriteOffsErpController** (1252 строки) - Управление списаниями
+- **MarketplaceOrdersController** (1072 строки) - Интеграция с маркетплейсами
+
+### 7. [Модели и Records](./models/README.md) ✅ NEW
+Документация моделей ActiveRecord (393 модели):
+
+**Ключевые документы:**
+- [Обзор моделей](./models/README.md) - Классификация и структура
+- [Users](./models/Users.md) - Модель пользователей
+- [Store](./models/Store.md) - Модель магазинов
+- [Products1c](./models/Products1c.md) - Интеграция с 1С
+
+### 8. [База данных](./database/README.md) ✅ NEW
+Полная документация структуры БД:
+
+**Ключевые документы:**
+- [Обзор БД](./database/README.md) - Общая структура и статистика
+- [Схема БД](./database/SCHEMA.md) - Полная схема таблиц
+- [Таблицы](./database/TABLES.md) - Описание всех таблиц
+
+### 9. [Руководства](./guides/README.md) ⏳ В РАЗРАБОТКЕ
- Установка и настройка
- Разработка новых модулей
- Интеграция с внешними системами
- Тестирование
- Deployment
-### 6. [Справочник ошибок](./errors/README.md)
-- Коды ошибок
-- Типичные проблемы
-- Решения и workarounds
+### 10. [Справочник ошибок](./errors/README.md) ✅ NEW
+Полный справочник ошибок и решений:
+
+**Ключевые документы:**
+- [Обзор ошибок](./errors/README.md) - Классификация и индекс
+- [Бизнес-ошибки](./errors/BUSINESS_ERRORS.md) - Ошибки бизнес-логики
+- [Ошибки аутентификации](./errors/AUTH_ERRORS.md) - Проблемы доступа
+- [Ошибки валидации](./errors/VALIDATION_ERRORS.md) - Валидация данных
+- [Коды ошибок](./errors/ERROR_CODES.md) - Справочник кодов
## 📊 Статистика проекта
-| Компонент | Количество |
-|-----------|-----------|
-| PHP файлы | ~3,771 |
-| Контроллеры | 160+ |
-| Records/Models | 390+ |
-| Сервисы | 51 |
-| Actions | 40+ |
-| API2 контроллеры | 33 |
-| API3 контроллеры | 18 |
-| API3 эндпоинты | 76 |
-| Helpers | 15+ |
-| Forms | 20+ |
-| **Console контроллеры** | **17** ✅ |
-| **Console команды** | **62** ✅ |
-| Migrations | 278 |
-| Jobs | 6 |
-| **Бизнес-модули** | **12** |
+| Компонент | Количество | Покрытие документацией |
+|-----------|-----------|------------------------|
+| PHP файлы | ~3,771 | - |
+| **Web контроллеры** | **161** ✅ | **100%** (161/161) |
+| **Records/Models** | **393** ✅ | **1%** (3/393) |
+| **Сервисы** | **48** ✅ | **100%** (48/48) |
+| Actions | 40+ | Частично |
+| API2 контроллеры | 33 | Не документировано |
+| API3 контроллеры | 18 | **50%** (9/18) |
+| API3 эндпоинты | 76 | **71%** (54/76) |
+| Helpers | 15+ | Не документировано |
+| Forms | 20+ | Не документировано |
+| **Console контроллеры** | **17** ✅ | **100%** (17/17) |
+| **Console команды** | **62** ✅ | **100%** (62/62) |
+| Migrations | 278 | Не документировано |
+| Jobs | 6 | Не документировано |
+| **Бизнес-модули** | **12** ✅ | **100%** (12/12) |
+| **Документов Markdown** | **209** ✅ | **~5.1 MB** |
## 🚀 Быстрый старт
## 📜 История изменений
-### 2025-11-17
-- ✅ Создана базовая структура документации
-- ✅ Документированы модули: Bonus, Payroll, Shipment, Timetable
-- ✅ Добавлены диаграммы взаимосвязей
-- ✅ Создан главный README на русском языке
-
-### Планируется
-- ⏳ API1 документация (legacy)
-- ⏳ База данных - полная схема всех таблиц
-- ⏳ Руководства по разработке
-- ⏳ Справочник ошибок и troubleshooting
-- ⏳ Детальная документация по каждому сервису
-- ⏳ Deployment и DevOps инструкции
-
-### ✅ Завершено (2025-11-17)
+**См. полную историю в [CHANGELOG.md](./CHANGELOG.md)**
+
+### ✅ Версия 2.0 (2025-11-27)
+- ✅ **209 документов** - полное покрытие основных компонентов
+- ✅ **161 web-контроллер** документирован
+- ✅ **62 консольные команды** документированы
+- ✅ **Справочник ошибок** (4 категории)
+- ✅ **Документация БД** (обзор, схема, таблицы)
+- ✅ **Документация моделей** (начата)
+- ✅ **CHANGELOG.md** создан
+
+### ✅ Версия 1.0 (2025-11-17)
- ✅ Документация всех 12 бизнес-модулей
- ✅ Матрица взаимосвязей модулей (CROSS_REFERENCE.md)
- ✅ Итоговая сводка (SUMMARY.md)
- ✅ **API3 полная документация** (README, MODULES_INDEX, ENDPOINTS, ARCHITECTURE)
- ✅ **Services полная документация** (README, CATALOG, PATTERNS)
+### 📋 Roadmap (Версия 3.0)
+- ⏳ Завершить API3 (оставшиеся 9 модулей)
+- ⏳ Документация API2 (33 контроллера)
+- ⏳ Расширение документации моделей (390+ моделей)
+- ⏳ Руководства (Installation, Developer, Testing, Deployment)
+- ⏳ Sequence диаграммы бизнес-процессов
+- ⏳ Troubleshooting Guide
+
---
## 📄 Лицензия
*Документация поддерживается в актуальном состоянии командой разработки ERP24.*
-**Последнее обновление:** 2025-11-17
+**Версия документации:** 2.0
+**Последнее обновление:** 2025-11-27
+**Статус:** ✅ Активно поддерживается
# Итоговая сводка документации ERP24
-## ð\9f\8e\89 СÑ\82аÑ\82Ñ\83Ñ\81 докÑ\83менÑ\82аÑ\86ии: Ð\97Ð\90Ð\92Ð\95РШÐ\95Ð\9dÐ\90
+## ð\9f\8e\89 СÑ\82аÑ\82Ñ\83Ñ\81 докÑ\83менÑ\82аÑ\86ии: Ð\90Ð\9aТÐ\98Ð\92Ð\9dÐ\9e Ð\9fÐ\9eÐ\94Ð\94Ð\95Ð Ð\96Ð\98Ð\92Ð\90Ð\95ТСЯ
-Дата завершения: **2025-11-17**
+**Версия:** 2.0
+**Дата обновления:** 2025-11-27
+**Статус:** ✅ Завершены основные разделы, расширение продолжается
## 📊 Общая статистика проекта
| Категория | Количество |
|-----------|-----------|
| **Всего PHP файлов** | ~3,771 |
-| **Контроллеров** | 160+ |
-| **Records/Models** | 390+ |
-| **Сервисов** | 51 |
+| **Web-контроллеров** | **161** ✅ |
+| **Records/Models** | **393** ✅ |
+| **Сервисов** | **48** ✅ |
| **Actions** | 40+ |
| **API2 контроллеров** | 33 |
| **API3 контроллеров** | 18 |
| **API3 эндпоинтов** | 76 |
| **Helpers** | 15+ |
| **Forms** | 20+ |
-| **Console Commands** | 15+ |
+| **Console контроллеров** | **17** ✅ |
+| **Console команд** | **62** ✅ |
| **Миграций БД** | 278 |
| **Jobs (фоновые задачи)** | 6 |
-| **Бизнес-модулей** | **12** |
+| **Бизнес-модулей** | **12** ✅ |
### Статистика документации
| Метрика | Значение |
|---------|----------|
-| **Документированных модулей** | 12/12 (100%) |
-| **API3 документация** | 🔄 В процессе (3/18 модулей, 16.7%) |
-| **API3 эндпоинтов документировано** | 25/76 (32.9%) |
-| **Services документация** | ✅ Завершена |
-| **Страниц документации** | 25+ |
+| **Документов Markdown** | **209 файлов** (~5.1 MB) |
+| **Бизнес-модулей** | 12/12 (100%) ✅ |
+| **Web-контроллеров** | 161/161 (100%) ✅ |
+| **Console команд** | 62/62 (100%) ✅ |
+| **Сервисов** | 48/48 (100%) ✅ |
+| **API3 модулей** | 9/18 (50%) 🔄 |
+| **API3 эндпоинтов** | 54/76 (71%) 🔄 |
+| **Моделей** | 15/393 (4%) 🔄 |
| **Mermaid диаграмм** | 35+ |
| **Примеров кода** | 100+ |
| **ER-диаграмм** | 12 |
```
erp24/docs/
-├── README.md # Главная страница (русский)
-├── SUMMARY.md # Этот файл
-├── CROSS_REFERENCE.md # Матрица взаимосвязей
+├── README.md # Главная страница (русский) ✅
+├── SUMMARY.md # Этот файл ✅
+├── INDEX.md # Быстрый индекс ✅
+├── CROSS_REFERENCE.md # Матрица взаимосвязей ✅
+├── CHANGELOG.md # История изменений ✨ NEW
│
-└── modules/
- ├── README.md # Индекс модулей
- │
- ├── bonus/
- │ └── README.md # 5 контр, 1 сервис, 13 actions, 8 models
- │
- ├── payroll/
- │ └── README.md # 3 контр, 3 сервиса, 10 models
- │
- ├── timetable/
- │ └── README.md # 2 контр, 1 сервис, 17 actions, 9 models
- │
- ├── rating/
- │ └── README.md # 2 контр, 1 сервис, 4 actions, 3 models
- │
- ├── grade/
- │ └── README.md # 2 контр, 4 models
- │
- ├── lesson/
- │ └── README.md # 1 контр, 2 сервиса, 5 models
- │
- ├── regulations/
- │ └── README.md # 3 контр, 7 models
- │
- ├── shipment/
- │ └── README.md # 2 контр, 1 сервис (3786 строк!), 7+ models
- │
- ├── write-offs/
- │ └── README.md # 5 контр, 1 сервис, 9 models
- │
- ├── notifications/
- │ └── README.md # 1 контр, 1 сервис, 3 actions, 2 models
- │
- ├── kik-feedback/
- │ └── README.md # 1 контр, 16 actions, 5 models
- │
- └── dashboard/
- └── README.md # 5 контр, 1 сервис, 13 actions, 9 models
+├── architecture/ # Архитектура системы
+│ ├── system-overview.md # Обзор архитектуры ✅
+│ └── api-architecture.md # Архитектура API ✅
+│
+├── api/ # API документация
+│ ├── api1/ # Legacy API
+│ │ └── README.md # ✅ NEW
+│ ├── api2/ # Modern REST API
+│ │ └── README.md # ✅
+│ └── api3/ # Advanced API
+│ ├── README.md # ✅
+│ ├── MODULES_INDEX.md # ✅
+│ ├── ENDPOINTS.md # ✅
+│ └── ARCHITECTURE.md # ✅
+│
+├── modules/ # 12 бизнес-модулей ✅
+│ ├── README.md
+│ ├── bonus/
+│ ├── payroll/
+│ ├── timetable/
+│ ├── rating/
+│ ├── grade/
+│ ├── lesson/
+│ ├── regulations/
+│ ├── shipment/
+│ ├── write-offs/
+│ ├── notifications/
+│ ├── kik-feedback/
+│ └── dashboard/
+│
+├── controllers/ # 161 контроллер ✨ NEW
+│ ├── README.md # Обзор и классификация ✅
+│ ├── non-standard/ # 47 нестандартных ✅
+│ └── standard/
+│ └── CATALOG.md # 114 стандартных ✅
+│
+├── console-commands/ # 62 команды ✨ NEW
+│ ├── README.md # Полная документация ✅
+│ └── EXAMPLES.md # Примеры использования ✅
+│
+├── services/ # 48 сервисов ✅
+│ ├── README.md # Обзор Service Layer ✅
+│ ├── SERVICES_CATALOG.md # Каталог всех сервисов ✅
+│ └── PATTERNS.md # Best Practices ✅
+│
+├── models/ # 393 модели ✨ UPDATED
+│ ├── README.md # Обзор моделей ✅
+│ ├── Admin.md # Сотрудники (IdentityInterface) ✅
+│ ├── Users.md # Пользователи (клиенты) ✅
+│ ├── Sales.md # Чеки продаж ✅
+│ ├── Task.md # Задачи ✅
+│ ├── Files.md # Файловое хранилище ✅ NEW
+│ ├── Store.md # Магазины ✅
+│ ├── Timetable.md # Расписание ✅
+│ ├── UsersBonus.md # Бонусные операции ✅
+│ ├── MarketplaceOrders.md # Заказы маркетплейсов ✅
+│ ├── Products1c.md # Интеграция с 1С ✅
+│ └── ... (15 документов)
+│
+├── database/ # База данных ✨ NEW
+│ ├── README.md # Обзор БД ✅
+│ ├── SCHEMA.md # Схема таблиц ✅
+│ └── TABLES.md # Описание таблиц ✅
+│
+├── errors/ # Справочник ошибок ✨ NEW
+│ ├── README.md # Главный индекс ✅
+│ ├── BUSINESS_ERRORS.md # Бизнес-ошибки ✅
+│ ├── AUTH_ERRORS.md # Ошибки аутентификации ✅
+│ ├── VALIDATION_ERRORS.md # Ошибки валидации ✅
+│ └── ERROR_CODES.md # Коды ошибок ✅
+│
+└── guides/ # Руководства ⏳
+ └── README.md # Обзор руководств ✅
```
## 🎯 Ключевые достижения
3. Проверить FAQ в модуле
4. Обратиться к техническому лиду проекта
+## 📝 Что нового в версии 2.0 (2025-11-27)
+
+### ✨ Новые разделы документации
+
+1. **Web-контроллеры** (161 контроллер)
+ - Классификация на стандартные/нестандартные
+ - 47 детальных анализов нестандартных контроллеров
+ - Каталог 114 стандартных контроллеров
+
+2. **Консольные команды** (62 команды)
+ - 17 консольных контроллеров
+ - 9 практических примеров использования
+ - Полное описание CronController (28 команд)
+
+3. **Модели и Records** (393 модели → 15 документов)
+ - Обзор и классификация моделей
+ - Детальная документация: Admin, Users, Sales, Task, Files, Store, Timetable, UsersBonus, MarketplaceOrders, Products1c
+
+4. **База данных**
+ - Обзор структуры БД
+ - Полная схема таблиц
+ - Описание всех таблиц
+
+5. **Справочник ошибок**
+ - 4 категории ошибок
+ - Коды ошибок и решения
+ - Troubleshooting советы
+
+6. **CHANGELOG.md**
+ - История всех изменений
+ - Roadmap развития
+ - Метрики версий
+
+### 📊 Новая статистика
+
+- **209 документов** Markdown (~5.1 MB)
+- **100% покрытие** контроллеров (161/161)
+- **100% покрытие** консольных команд (62/62)
+- **100% покрытие** сервисов (48/48)
+- **4% покрытие** моделей (15/393) - расширяется
+
## 📜 История создания документации
-**2025-11-17:**
+**Версия 2.0 (2025-11-27):**
+- ✅ Добавлено 180+ новых документов
+- ✅ Документированы все 161 web-контроллер
+- ✅ Документированы все 62 консольные команды
+- ✅ Создан справочник ошибок (4 категории)
+- ✅ Документирована база данных
+- ✅ Создан CHANGELOG.md
+
+**Версия 1.0 (2025-11-17):**
- ✅ Создана структура документации
- ✅ Документированы все 12 модулей
- ✅ Создана матрица взаимосвязей
- ✅ Добавлены примеры кода
- ✅ Создан итоговый SUMMARY
-**Общее время:** ~4 часа работы
-**Результат:** Полная документация 12 модулей системы ERP24
-
---
## 🎉 Заключение
-Ð\94окÑ\83менÑ\82аÑ\86иÑ\8f Ñ\81иÑ\81Ñ\82емÑ\8b ERP24 **завеÑ\80Ñ\88ена** и гоÑ\82ова к иÑ\81полÑ\8cзованиÑ\8e!
+Ð\94окÑ\83менÑ\82аÑ\86иÑ\8f Ñ\81иÑ\81Ñ\82емÑ\8b ERP24 **акÑ\82ивно поддеÑ\80живаеÑ\82Ñ\81Ñ\8f** и пÑ\80одолжаеÑ\82 Ñ\80аÑ\81Ñ\88иÑ\80Ñ\8fÑ\82Ñ\8cÑ\81Ñ\8f!
-**Охват:**
-- ✅ 12/12 модулей (100%)
-- ✅ 32 контроллера
-- ✅ 12 сервисов
-- ✅ 73 actions
-- ✅ 78 моделей
+**Охват версии 2.0:**
+- ✅ 209 документов Markdown (~5.1 MB)
+- ✅ 12/12 бизнес-модулей (100%)
+- ✅ 161/161 web-контроллеров (100%)
+- ✅ 62/62 консольных команд (100%)
+- ✅ 48/48 сервисов (100%)
+- ✅ 9/18 API3 модулей (50%)
+- 🔄 15/393 моделей (4%)
**Качество:**
-- ✅ Единый формат
-- ✅ Русский язык
-- ✅ Диаграммы и примеры
+- ✅ Единый формат и шаблоны
+- ✅ Русский язык для всей документации
+- ✅ 35+ Mermaid диаграмм
+- ✅ 100+ примеров кода
- ✅ Связи и зависимости
+- ✅ CHANGELOG для отслеживания изменений
**Полезность:**
-- ✅ Для разработчиков
-- ✅ Для аналитиков
-- ✅ Для техлидов
-- ✅ Для новых сотрудников
+- ✅ Для разработчиков - детальная техническая документация
+- ✅ Для аналитиков - бизнес-процессы и логика
+- ✅ Для техлидов - архитектура и паттерны
+- ✅ Для новых сотрудников - быстрый онбординг
-Ð\94окÑ\83менÑ\82аÑ\86иÑ\8f Ñ\8fвлÑ\8fеÑ\82Ñ\81Ñ\8f живÑ\8bм докÑ\83менÑ\82ом и должна обновлÑ\8fÑ\82Ñ\8cÑ\81Ñ\8f пÑ\80и изменениÑ\8fÑ\85 в Ñ\81иÑ\81Ñ\82еме.
+Ð\94окÑ\83менÑ\82аÑ\86иÑ\8f Ñ\8fвлÑ\8fеÑ\82Ñ\81Ñ\8f живÑ\8bм докÑ\83менÑ\82ом и обновлÑ\8fеÑ\82Ñ\81Ñ\8f пÑ\80и каждом знаÑ\87иÑ\82елÑ\8cном изменении Ñ\81иÑ\81Ñ\82емÑ\8b.
---
-**Версия:** 1.0
-**Последнее обновление:** 2025-11-17
-**Статус:** ✅ Завершено
+**Версия:** 2.0
+**Последнее обновление:** 2025-11-27
+**Статус:** ✅ Активно поддерживается
+
+**См. также:**
+- [CHANGELOG.md](./CHANGELOG.md) - История изменений
+- [README.md](./README.md) - Главная страница
+- [INDEX.md](./INDEX.md) - Быстрый индекс
## Связанные компоненты
### Сервисы
-- [`EmployeeService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/EmployeeService.md) - Сервис для работы с сотрудниками (получение списков, проверка присутствия в магазине)
+- [`EmployeeService`](../../../services/EmployeeService.md) - Сервис для работы с сотрудниками (получение списков, проверка присутствия в магазине)
### Модели
-- [`Admin` (records)](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md) - Базовая модель сотрудника
+- [`Admin` (records)](../../../models/Admin.md) - Базовая модель сотрудника
- Реализует `IdentityInterface` для аутентификации
- Содержит методы валидации паролей, управления правами
- Поддерживает работу с фото и аватарами
- Содержит метод `hasPermission()` для проверки прав
-- [`Admin` (API3)](/Users/vladfo/development/yii-erp24/erp24/docs/models/api3/Admin.md) - Модель для API3
+- [`Admin` (API3)](../../../models/api3/Admin.md) - Модель для API3
- Расширяет базовую модель
- Определяет поля для сериализации (fields(), extraFields())
- Добавляет связи с зарплатой, расписанием, магазинами
-- [`AdminGroup`](/Users/vladfo/development/yii-erp24/erp24/docs/models/AdminGroup.md) - Группы сотрудников
+- [`AdminGroup`](../../../models/AdminGroup.md) - Группы сотрудников
- Константы для группы: DIRECTOR, GROUP_HR, GROUP_FLORIST и т.д.
- Методы для получения групп: `getGroupsForEmployeeController()`, `getGroupsForEmployeeOnCashbox()`
- Связи со сменами (shifts)
-- [`AuthAssignment`](/Users/vladfo/development/yii-erp24/erp24/docs/models/AuthAssignment.md) - RBAC назначения
+- [`AuthAssignment`](../../../models/AuthAssignment.md) - RBAC назначения
- Связь пользователя с ролями и правами
- Таблица: `auth_assignment`
- Поля: `item_name`, `user_id`, `created_at`
-- [`AdminGroupRbacConfig`](/Users/vladfo/development/yii-erp24/erp24/docs/models/AdminGroupRbacConfig.md) - Конфигурация RBAC для групп
+- [`AdminGroupRbacConfig`](../../../models/AdminGroupRbacConfig.md) - Конфигурация RBAC для групп
- Таблица: `admin_group_rbac_config`
- Поля: `id`, `admin_group_id`, `config` (CSV список прав)
- Используется в `Admin::hasPermission()`
### Контроллеры API3
-- [`EmployeeController`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/employee.md) - Управление сотрудниками (расширенный функционал)
-- [`TimetableController`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/timetable.md) - Управление расписанием сотрудников
+- [`EmployeeController`](employee.md) - Управление сотрудниками (расширенный функционал)
+- [`TimetableController`](timetable.md) - Управление расписанием сотрудников
### API2 аналоги
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [RBAC система](/Users/vladfo/development/yii-erp24/erp24/docs/architecture/rbac.md)
-- [Модель Admin](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md)
-- [Модель AdminGroup](/Users/vladfo/development/yii-erp24/erp24/docs/models/AdminGroup.md)
-- [EmployeeService](/Users/vladfo/development/yii-erp24/erp24/docs/services/EmployeeService.md)
-- [Безопасность API](/Users/vladfo/development/yii-erp24/erp24/docs/api/security.md)
-- [Rate Limiting](/Users/vladfo/development/yii-erp24/erp24/docs/api/rate-limiting.md)
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [RBAC система](../../../architecture/rbac.md)
+- [Модель Admin](../../../models/Admin.md)
+- [Модель AdminGroup](../../../models/AdminGroup.md)
+- [EmployeeService](../../../services/EmployeeService.md)
+- [Безопасность API](../../security.md)
+- [Rate Limiting](../../rate-limiting.md)
## История изменений
Модуль решает задачу быстрого привлечения временных сотрудников для работы в магазинах через мобильное приложение или внешние системы.
## Расположение
-- **Контроллер:** `/Users/vladfo/development/yii-erp24/erp24/api3/modules/v1/controllers/claim/WorkerController.php`
+- **Контроллер:** ``erp24/api3/modules/v1/controllers/claim/WorkerController.php``
- **Namespace:** `yii_app\api3\modules\v1\controllers\claim`
- **Базовый URL:** `/api3/v1/claim/worker/`
### Input Model: Worker (Создание заявки)
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/api3/modules/v1/requests/claim/Worker.php`
+**Файл:** ``erp24/api3/modules/v1/requests/claim/Worker.php``
**Правила валидации:**
```php
### Input Model: WorkerControl (Управление заявкой)
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/api3/modules/v1/requests/claim/WorkerControl.php`
+**Файл:** ``erp24/api3/modules/v1/requests/claim/WorkerControl.php``
**Правила валидации:**
```php
## Связанные компоненты
### Сервисы
-- [`ClaimService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/ClaimService.md) - Бизнес-логика обработки заявок подработчиков
+- [`ClaimService`](../../../services/ClaimService.md) - Бизнес-логика обработки заявок подработчиков
- `create(Worker $row)` - Создание заявки
- `control(WorkerControl $row)` - Управление заявкой (accept/reject)
### Модели ActiveRecord
-- [`EmployeeOnShift`](/Users/vladfo/development/yii-erp24/erp24/docs/models/EmployeeOnShift.md) - Таблица заявок подработчиков
+- [`EmployeeOnShift`](../../../models/EmployeeOnShift.md) - Таблица заявок подработчиков
- Связь с `Admin` (создатель): `getCreated()`
- Связь с `Admin` (созданный сотрудник): `getAdmin()`
- Связь с `Products1c` (магазин): `getStore()`
-- [`Admin`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md) - Сотрудники системы
+- [`Admin`](../../../models/Admin.md) - Сотрудники системы
- `createAdminWithDefaultData()` - Создание нового сотрудника с дефолтными данными
- Группа подработчиков: `group_id = 45`
-- [`Timetable`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Timetable.md) - Расписание смен
+- [`Timetable`](../../../models/Timetable.md) - Расписание смен
- `getSalariesDay()` - Доступные оклады за смену: [1700, 2000, 2500]
- Константы: `TIMESLOT_WORK`, `STATUS_PENDING`
-- [`ExportImportTable`](/Users/vladfo/development/yii-erp24/erp24/docs/models/ExportImportTable.md) - Интеграция с 1С
+- [`ExportImportTable`](../../../models/ExportImportTable.md) - Интеграция с 1С
- Связь магазинов: `entity = 'city_store'`
- Связь сотрудников: `entity = 'admin'`
-- [`AdminStores`](/Users/vladfo/development/yii-erp24/erp24/docs/models/AdminStores.md) - Связь сотрудников и магазинов
+- [`AdminStores`](../../../models/AdminStores.md) - Связь сотрудников и магазинов
-- [`Products1c`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Products1c.md) - Справочник магазинов
+- [`Products1c`](../../../models/Products1c.md) - Справочник магазинов
- Фильтр: `tip = 'city_store'`
-- [`CityStore`](/Users/vladfo/development/yii-erp24/erp24/docs/models/CityStore.md) - Магазины сети
+- [`CityStore`](../../../models/CityStore.md) - Магазины сети
### Модули бизнес-логики
- **Timetable Module** - Управление расписанием смен
- Генерируется уникальный `login_user`
### Хелперы
-- [`DataHelper::createGuidMy()`](/Users/vladfo/development/yii-erp24/erp24/docs/helpers/DataHelper.md) - Генерация GUID с префиксом
+- [`DataHelper::createGuidMy()`](../../../helpers/DataHelper.md) - Генерация GUID с префиксом
- Для заявок используется префикс "06-"
-- [`PhoneValidator`](/Users/vladfo/development/yii-erp24/erp24/docs/validators/PhoneValidator.md) - Валидация телефонных номеров
+- [`PhoneValidator`](../../../validators/PhoneValidator.md) - Валидация телефонных номеров
### API3 связанные модули
-- [`EmployeeController`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/employee.md) - Управление сотрудниками
+- [`EmployeeController`](employee.md) - Управление сотрудниками
- `/employee/salaries-day` - Получение доступных окладов (вызывает `Timetable::getSalariesDay()`)
- Связь: созданные через ClaimWorker сотрудники появляются в списке `/employee/get-all-admins`
- Управление расписанием
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Общие паттерны API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/patterns.md)
-- [EmployeeController](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/employee.md) - Управление сотрудниками
-- [ClaimService](/Users/vladfo/development/yii-erp24/erp24/docs/services/ClaimService.md) - Сервис обработки заявок
-- [Timetable Module](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md) - Модуль расписания
-- [EmployeeOnShift Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/EmployeeOnShift.md) - Модель заявок
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [Общие паттерны API3](../patterns.md)
+- [EmployeeController](employee.md) - Управление сотрудниками
+- [ClaimService](../../../services/ClaimService.md) - Сервис обработки заявок
+- [Timetable Module](../../../modules/timetable/README.md) - Модуль расписания
+- [EmployeeOnShift Model](../../../models/EmployeeOnShift.md) - Модель заявок
## История изменений
- 2023-09-26: Создание таблицы `employee_on_shift` (миграция m230926_122813)
## Связанные компоненты
### Сервисы
-- [`IncomeService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/IncomeService.md) - Сервис расчета дохода сотрудников
+- [`IncomeService`](../../../services/IncomeService.md) - Сервис расчета дохода сотрудников
### Модели
-- [`TimetableFactModel`](/Users/vladfo/development/yii-erp24/erp24/docs/models/TimetableFactModel.md) - Факты отработанных смен
-- [`Sales`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md) - Чеки продаж
-- [`SalesProducts`](/Users/vladfo/development/yii-erp24/erp24/docs/models/SalesProducts.md) - Товары в чеках
-- [`Products1c`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Products1c.md) - Каталог товаров
-- [`ProductsClass`](/Users/vladfo/development/yii-erp24/erp24/docs/models/ProductsClass.md) - Классификация товаров
-- [`Admin`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md) - Сотрудники
+- [`TimetableFactModel`](../../../models/TimetableFactModel.md) - Факты отработанных смен
+- [`Sales`](../../../models/Sales.md) - Чеки продаж
+- [`SalesProducts`](../../../models/SalesProducts.md) - Товары в чеках
+- [`Products1c`](../../../models/Products1c.md) - Каталог товаров
+- [`ProductsClass`](../../../models/ProductsClass.md) - Классификация товаров
+- [`Admin`](../../../models/Admin.md) - Сотрудники
### Модули бизнес-логики
-- [Timetable Module](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md) - Модуль табеля рабочего времени
-- [Sales Module](/Users/vladfo/development/yii-erp24/erp24/docs/modules/sales/README.md) - Модуль продаж
+- [Timetable Module](../../../modules/timetable/README.md) - Модуль табеля рабочего времени
+- [Sales Module](../../../modules/sales/README.md) - Модуль продаж
### Связанные API3 модули
-- [`TimetableFact`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/timetable-fact.md) - Управление фактами смен
-- [`Employee`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/employee.md) - Управление сотрудниками
+- [`TimetableFact`](timetable-fact.md) - Управление фактами смен
+- [`Employee`](employee.md) - Управление сотрудниками
## Безопасность
11. Проверка обработки пустого периода
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [IncomeService](/Users/vladfo/development/yii-erp24/erp24/docs/services/IncomeService.md)
-- [Timetable Module](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md)
-- [Sales Module](/Users/vladfo/development/yii-erp24/erp24/docs/modules/sales/README.md)
-- [Система мотивации сотрудников](/Users/vladfo/development/yii-erp24/erp24/docs/business/motivation.md)
+- [API3 Overview](../README.md)
+- [IncomeService](../../../services/IncomeService.md)
+- [Timetable Module](../../../modules/timetable/README.md)
+- [Sales Module](../../../modules/sales/README.md)
+- [Система мотивации сотрудников](../../../business/motivation.md)
## История изменений
- 2025-11-17: Создание документации для P2 модулей API3
### Сервисы
-- [`KikService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/KikService.md) - Бизнес-логика приема обратной связи
-- [`FileService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/FileService.md) - Сохранение загруженных файлов
+- [`KikService`](../../../services/KikService.md) - Бизнес-логика приема обратной связи
+- [`FileService`](../../../services/FileService.md) - Сохранение загруженных файлов
### Модули бизнес-логики
-- [`KIK Feedback`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/kik-feedback/README.md) - Модуль управления обратной связью и контроля качества
+- [`KIK Feedback`](../../../modules/kik-feedback/README.md) - Модуль управления обратной связью и контроля качества
### Модели
-- [`KikFeedbackRequest`](/Users/vladfo/development/yii-erp24/erp24/docs/models/KikFeedbackRequest.md) - Заявки обратной связи
-- [`Sales`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md) - Продажи из 1С
-- [`Files`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Files.md) - Файловые вложения
+- [`KikFeedbackRequest`](../../../models/KikFeedbackRequest.md) - Заявки обратной связи
+- [`Sales`](../../../models/Sales.md) - Продажи из 1С
+- [`Files`](../../../models/Files.md) - Файловые вложения
### API2 аналоги
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Модуль KIK Feedback](/Users/vladfo/development/yii-erp24/erp24/docs/modules/kik-feedback/README.md)
-- [FileService документация](/Users/vladfo/development/yii-erp24/erp24/docs/services/FileService.md)
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [Модуль KIK Feedback](../../../modules/kik-feedback/README.md)
+- [FileService документация](../../../services/FileService.md)
## История изменений
### Сервисы
-- [`NotifiableService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/NotifiableService.md) - Бизнес-логика обработки уведомлений
+- [`NotifiableService`](../../../services/NotifiableService.md) - Бизнес-логика обработки уведомлений
### Модули бизнес-логики
-- [`Notifications`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/notifications/README.md) - Внутренние уведомления сотрудников
-- [`Bonus System`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/bonus/README.md) - Система начисления и списания бонусов
+- [`Notifications`](../../../modules/notifications/README.md) - Внутренние уведомления сотрудников
+- [`Bonus System`](../../../modules/bonus/README.md) - Система начисления и списания бонусов
### Модели
-- [`UsersBonus`](/Users/vladfo/development/yii-erp24/erp24/docs/models/UsersBonus.md) - Движения бонусов клиентов
-- [`NotifiableUser`](/Users/vladfo/development/yii-erp24/erp24/docs/models/NotifiableUser.md) - Очередь событий для уведомлений
+- [`UsersBonus`](../../../models/UsersBonus.md) - Движения бонусов клиентов
+- [`NotifiableUser`](../../../models/NotifiableUser.md) - Очередь событий для уведомлений
### API2 аналоги
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Модуль Notifications](/Users/vladfo/development/yii-erp24/erp24/docs/modules/notifications/README.md)
-- [Модуль Bonus System](/Users/vladfo/development/yii-erp24/erp24/docs/modules/bonus/README.md)
-- [UsersBonus модель](/Users/vladfo/development/yii-erp24/erp24/docs/models/UsersBonus.md)
+- [API3 Overview](../README.md)
+- [Модуль Notifications](../../../modules/notifications/README.md)
+- [Модуль Bonus System](../../../modules/bonus/README.md)
+- [UsersBonus модель](../../../models/UsersBonus.md)
## История изменений
## Связанные компоненты
### Модели
-- [`OrdersAmo` (API3)](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/models/OrdersAmo.md) - API3 модель заказов
-- [`OrdersAmo` (Records)](/Users/vladfo/development/yii-erp24/erp24/docs/models/OrdersAmo.md) - Базовая модель
-- [`Admin`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md) - Модель сотрудников
+- [`OrdersAmo` (API3)](../models/OrdersAmo.md) - API3 модель заказов
+- [`OrdersAmo` (Records)](../../../models/OrdersAmo.md) - Базовая модель
+- [`Admin`](../../../models/Admin.md) - Модель сотрудников
### Таблицы базы данных
- `orders_amo` - реферальные заказы из AmoCRM
11. 401 без токена
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [OrdersAmo Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/OrdersAmo.md)
-- [Admin Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md)
-- [AmoCRM Integration](/Users/vladfo/development/yii-erp24/erp24/docs/integrations/amocrm.md)
+- [API3 Overview](../README.md)
+- [OrdersAmo Model](../../../models/OrdersAmo.md)
+- [Admin Model](../../../models/Admin.md)
+- [AmoCRM Integration](../../../integrations/amocrm.md)
## История изменений
- 2025-11-17: Создание документации для P2 модулей API3
## Связанные компоненты
### Модели
-- [`Products1c`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Products1c.md) - Модель каталога товаров и категорий из 1С
-- [`Prices`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Prices.md) - Модель розничных цен
+- [`Products1c`](../../../models/Products1c.md) - Модель каталога товаров и категорий из 1С
+- [`Prices`](../../../models/Prices.md) - Модель розничных цен
### Таблицы базы данных
- `products_1c` - каталог товаров и категорий
9. Проверка наличия цен у всех возвращенных товаров
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Products1c Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Products1c.md)
-- [Prices Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Prices.md)
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [Products1c Model](../../../models/Products1c.md)
+- [Prices Model](../../../models/Prices.md)
## История изменений
- 2025-11-17: Создание документации для P2 модулей API3
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Модуль Bonus](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/bonus.md)
-- [Модуль Cabinet](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/cabinet.md)
-- [ReportService](/Users/vladfo/development/yii-erp24/erp24/docs/services/ReportService.md)
-- [Sales Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md)
-- [Timetable Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Timetable.md)
+- [API3 Overview](../README.md)
+- [Модуль Bonus](bonus.md)
+- [Модуль Cabinet](cabinet.md)
+- [ReportService](../../../services/ReportService.md)
+- [Sales Model](../../../models/Sales.md)
+- [Timetable Model](../../../models/Timetable.md)
---
## Связанные компоненты
### Модели
-- [`Products1c`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Products1c.md) - Модель каталога товаров и категорий
+- [`Products1c`](../../../models/Products1c.md) - Модель каталога товаров и категорий
### Связанные API3 модули
-- [`Product`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/product.md) - Полный каталог товаров с ценами
+- [`Product`](product.md) - Полный каталог товаров с ценами
### Таблицы базы данных
- `products_1c` - каталог товаров
12. Без токена (401)
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Product Module](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/product.md) - Полный каталог с ценами
-- [Products1c Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Products1c.md)
+- [API3 Overview](../README.md)
+- [Product Module](product.md) - Полный каталог с ценами
+- [Products1c Model](../../../models/Products1c.md)
- [Autocomplete Best Practices](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/)
## История изменений
## Связанные компоненты
### Модели
-- [`Sales` (API3)](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/models/Sales.md) - API3 обертка с маппингом полей
-- [`Sales` (Records)](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md) - Базовая модель продаж
-- [`CityStore`](/Users/vladfo/development/yii-erp24/erp24/docs/models/CityStore.md) - Модель магазинов (для expand)
+- [`Sales` (API3)](../models/Sales.md) - API3 обертка с маппингом полей
+- [`Sales` (Records)](../../../models/Sales.md) - Базовая модель продаж
+- [`CityStore`](../../../models/CityStore.md) - Модель магазинов (для expand)
### Связанные API3 модули
-- [`Product`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/product.md) - Каталог товаров
-- [`Income`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/income.md) - Расчет доходов на основе продаж
+- [`Product`](product.md) - Каталог товаров
+- [`Income`](income.md) - Расчет доходов на основе продаж
### Таблицы базы данных
- `sales` - основная таблица продаж
13. 401 без токена
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
+- [API3 Overview](../README.md)
- [ActiveDataFilter Documentation](https://www.yiiframework.com/doc/api/2.0/yii-data-activedatafilter)
- [Yii2 REST API Guide](https://www.yiiframework.com/doc/guide/2.0/en/rest-quick-start)
-- [Sales Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md)
+- [Sales Model](../../../models/Sales.md)
## История изменений
- 2025-11-17: Создание документации для P2 модулей API3
## Связанные компоненты
### Модели
-- [`UserBonuses` (API3)](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/models/UserBonuses.md) - API3 модель с маппингом
-- [`UsersBonus` (Records)](/Users/vladfo/development/yii-erp24/erp24/docs/models/UsersBonus.md) - Базовая модель
+- [`UserBonuses` (API3)](../models/UserBonuses.md) - API3 модель с маппингом
+- [`UsersBonus` (Records)](../../../models/UsersBonus.md) - Базовая модель
### Связанные API3 модули
-- [`Client`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/client.md) - Управление клиентами
-- [`Bonus`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/bonus.md) - Управление бонусами
+- [`Client`](client.md) - Управление клиентами
+- [`Bonus`](bonus.md) - Управление бонусами
### Таблицы базы данных
- `users_bonus` - история бонусных операций
11. 401 без токена
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Bonus Module](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/bonus.md)
-- [UsersBonus Model](/Users/vladfo/development/yii-erp24/erp24/docs/models/UsersBonus.md)
-- [Бонусная программа](/Users/vladfo/development/yii-erp24/erp24/docs/business/bonus-program.md)
+- [API3 Overview](../README.md)
+- [Bonus Module](bonus.md)
+- [UsersBonus Model](../../../models/UsersBonus.md)
+- [Бонусная программа](../../../business/bonus-program.md)
## История изменений
- 2025-11-17: Создание документации для P2 модулей API3
## Связанные компоненты
### Сервисы
-- [`StoreService`](/Users/vladfo/development/yii-erp24/erp24/api3/core/services/StoreService.php) - основной сервис управления магазинами и складскими операциями
-- [`LogService`](/Users/vladfo/development/yii-erp24/erp24/services/LogService.php) - логирование операций и ошибок
+- [`StoreService`](`erp24/api3/core/services/StoreService.php`) - основной сервис управления магазинами и складскими операциями
+- [`LogService`](`erp24/services/LogService.php`) - логирование операций и ошибок
### Модели
-- [`Store`](/Users/vladfo/development/yii-erp24/erp24/api3/modules/v1/models/Store.php) - модель магазина для API3 (наследует Products1c)
-- [`CityStore`](/Users/vladfo/development/yii-erp24/erp24/records/CityStore.php) - основная таблица магазинов с полной информацией
-- [`Products1c`](/Users/vladfo/development/yii-erp24/erp24/records/Products1c.php) - универсальная таблица 1С (включает магазины, товары, группы)
-- [`Balances`](/Users/vladfo/development/yii-erp24/erp24/records/Balances.php) - складские остатки по магазинам
-- [`Sales`](/Users/vladfo/development/yii-erp24/erp24/records/Sales.php) - чеки продаж и возвратов
-- [`SalesProducts`](/Users/vladfo/development/yii-erp24/erp24/records/SalesProducts.php) - позиции в чеках
-- [`Assemblies`](/Users/vladfo/development/yii-erp24/erp24/records/Assemblies.php) - сборки букетов
-- [`StoreDynamic`](/Users/vladfo/development/yii-erp24/erp24/records/StoreDynamic.php) - динамические параметры магазинов (кластеры)
+- [`Store`](`erp24/api3/modules/v1/models/Store.php`) - модель магазина для API3 (наследует Products1c)
+- [`CityStore`](`erp24/records/CityStore.php`) - основная таблица магазинов с полной информацией
+- [`Products1c`](`erp24/records/Products1c.php`) - универсальная таблица 1С (включает магазины, товары, группы)
+- [`Balances`](`erp24/records/Balances.php`) - складские остатки по магазинам
+- [`Sales`](`erp24/records/Sales.php`) - чеки продаж и возвратов
+- [`SalesProducts`](`erp24/records/SalesProducts.php`) - позиции в чеках
+- [`Assemblies`](`erp24/records/Assemblies.php`) - сборки букетов
+- [`StoreDynamic`](`erp24/records/StoreDynamic.php`) - динамические параметры магазинов (кластеры)
### Helpers
-- [`ClientHelper`](/Users/vladfo/development/yii-erp24/erp24/helpers/ClientHelper.php) - конвертация ID между системами (1С ↔ ERP24)
-- [`SalaryHelper`](/Users/vladfo/development/yii-erp24/erp24/helpers/SalaryHelper.php) - работа с матричными товарами для расчета зарплаты
+- [`ClientHelper`](`erp24/helpers/ClientHelper.php`) - конвертация ID между системами (1С ↔ ERP24)
+- [`SalaryHelper`](`erp24/helpers/SalaryHelper.php`) - работа с матричными товарами для расчета зарплаты
### API2 аналоги
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Модуль Bonus](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/bonus.md) - интеграция с бонусной программой при продажах
-- [Модуль Client](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/client.md) - управление клиентами, связанными с продажами
-- [Модуль Employee](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/employee.md) - работа с сотрудниками магазинов
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Общие паттерны API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/patterns.md)
-- [База данных: таблица city_store](/Users/vladfo/development/yii-erp24/erp24/docs/database/tables/city_store.md)
-- [База данных: таблица balances](/Users/vladfo/development/yii-erp24/erp24/docs/database/tables/balances.md)
-- [База данных: таблица sales](/Users/vladfo/development/yii-erp24/erp24/docs/database/tables/sales.md)
+- [API3 Overview](../README.md)
+- [Модуль Bonus](bonus.md) - интеграция с бонусной программой при продажах
+- [Модуль Client](client.md) - управление клиентами, связанными с продажами
+- [Модуль Employee](employee.md) - работа с сотрудниками магазинов
+- [Аутентификация API3](../authentication.md)
+- [Общие паттерны API3](../patterns.md)
+- [База данных: таблица city_store](../../../database/tables/city_store.md)
+- [База данных: таблица balances](../../../database/tables/balances.md)
+- [База данных: таблица sales](../../../database/tables/sales.md)
## История изменений
### Модули бизнес-логики
- **Telegram Bot Module** - основной модуль управления Telegram ботом (если существует)
-- [`Notifications`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/notifications/README.md) - может использовать Telegram для отправки
+- [`Notifications`](../../../modules/notifications/README.md) - может использовать Telegram для отправки
### Модели
-- [`TgSubscription`](/Users/vladfo/development/yii-erp24/erp24/docs/models/TgSubscription.md) - Подписки на Telegram уведомления
+- [`TgSubscription`](../../../models/TgSubscription.md) - Подписки на Telegram уведомления
### API2 аналоги
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Модуль Notifications](/Users/vladfo/development/yii-erp24/erp24/docs/modules/notifications/README.md)
-- [TgSubscription модель](/Users/vladfo/development/yii-erp24/erp24/docs/models/TgSubscription.md)
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [Модуль Notifications](../../../modules/notifications/README.md)
+- [TgSubscription модель](../../../models/TgSubscription.md)
- [Telegram Bot API Documentation](https://core.telegram.org/bots/api)
## История изменений
## Связанные компоненты
### Сервисы
-- [`TimetableService (API3)`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/services/TimetableService.md) - Бизнес-логика работы с фактами
-- [`TimetableService (общий)`](/Users/vladfo/development/yii-erp24/erp24/docs/services/TimetableService.md) - Вспомогательные методы
+- [`TimetableService (API3)`](../services/TimetableService.md) - Бизнес-логика работы с фактами
+- [`TimetableService (общий)`](../../../services/TimetableService.md) - Вспомогательные методы
### Модули бизнес-логики
-- [`Timetable Module`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md) - Основной модуль табеля
+- [`Timetable Module`](../../../modules/timetable/README.md) - Основной модуль табеля
### Модели
-- [`TimetableFactModel`](/Users/vladfo/development/yii-erp24/erp24/docs/models/TimetableFactModel.md) - Модель фактических смен
-- [`AdminCheckin`](/Users/vladfo/development/yii-erp24/erp24/docs/models/AdminCheckin.md) - Модель чекинов
-- [`Timetable (Plan)`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Timetable.md) - Модель плановых смен
+- [`TimetableFactModel`](../../../models/TimetableFactModel.md) - Модель фактических смен
+- [`AdminCheckin`](../../../models/AdminCheckin.md) - Модель чекинов
+- [`Timetable (Plan)`](../../../models/Timetable.md) - Модель плановых смен
### API3 родственные модули
-- [`Timetable Plan`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/timetable-plan.md) - Управление планами смен
+- [`Timetable Plan`](timetable-plan.md) - Управление планами смен
## Безопасность
```
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Timetable Plan Module](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/timetable-plan.md)
-- [Timetable Module (Core)](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md)
-- [TimetableService](/Users/vladfo/development/yii-erp24/erp24/docs/services/TimetableService.md)
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [Timetable Plan Module](timetable-plan.md)
+- [Timetable Module (Core)](../../../modules/timetable/README.md)
+- [TimetableService](../../../services/TimetableService.md)
## История изменений
- **2025-11-17**: Создание документации API3 Timetable Fact
## Связанные компоненты
### Сервисы
-- [`TimetableService (API3)`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/services/TimetableService.md) - Бизнес-логика работы с планами
-- [`TimetableService (общий)`](/Users/vladfo/development/yii-erp24/erp24/docs/services/TimetableService.md) - Вспомогательные методы
+- [`TimetableService (API3)`](../services/TimetableService.md) - Бизнес-логика работы с планами
+- [`TimetableService (общий)`](../../../services/TimetableService.md) - Вспомогательные методы
### Модули бизнес-логики
-- [`Timetable Module`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md) - Основной модуль табеля
+- [`Timetable Module`](../../../modules/timetable/README.md) - Основной модуль табеля
### Модели
-- [`Timetable (Plan)`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Timetable.md) - Модель плановых смен
-- [`TimetableFactModel`](/Users/vladfo/development/yii-erp24/erp24/docs/models/TimetableFactModel.md) - Модель фактических смен
-- [`TimetableWorkbot`](/Users/vladfo/development/yii-erp24/erp24/docs/models/TimetableWorkbot.md) - История удалений
+- [`Timetable (Plan)`](../../../models/Timetable.md) - Модель плановых смен
+- [`TimetableFactModel`](../../../models/TimetableFactModel.md) - Модель фактических смен
+- [`TimetableWorkbot`](../../../models/TimetableWorkbot.md) - История удалений
### API3 родственные модули
-- [`Timetable Fact`](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/timetable-fact.md) - Управление фактическим временем
+- [`Timetable Fact`](timetable-fact.md) - Управление фактическим временем
## Безопасность
5. Система сравнивает План vs Факт для расчета зарплаты
## См. также
-- [API3 Overview](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/README.md)
-- [Аутентификация API3](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/authentication.md)
-- [Timetable Fact Module](/Users/vladfo/development/yii-erp24/erp24/docs/api/api3/modules/timetable-fact.md)
-- [Timetable Module (Core)](/Users/vladfo/development/yii-erp24/erp24/docs/modules/timetable/README.md)
-- [TimetableService](/Users/vladfo/development/yii-erp24/erp24/docs/services/TimetableService.md)
+- [API3 Overview](../README.md)
+- [Аутентификация API3](../authentication.md)
+- [Timetable Fact Module](timetable-fact.md)
+- [Timetable Module (Core)](../../../modules/timetable/README.md)
+- [TimetableService](../../../services/TimetableService.md)
## История изменений
- **2025-11-17**: Создание документации API3 Timetable Plan
### Структура директорий
```
-/Users/vladfo/development/yii-erp24/
+yii-erp24/
├── docker/ # Файлы конфигурации Docker
├── erp24/ # Главное приложение
│ ├── api1/ # Приложение Legacy API
| Контроллер | Строк | Actions | Назначение | Документация |
|------------|-------|---------|------------|--------------|
-| **AutoPlannogrammaController** | 2457 | 30 | Автоматическая планограмма товаров по магазинам | [Документация](non-standard/AutoPlannogrammaController.md) |
-| **WriteOffsErpController** | 1252 | 10 | Управление списаниями товаров в ERP | [Документация](non-standard/WriteOffsErpController.md) |
-| **MarketplaceOrdersController** | 1072 | 17 | Интеграция с маркетплейсами (Flowwow, Яндекс) | [Документация](non-standard/MarketplaceOrdersController.md) |
+| **AutoPlannogrammaController** | 2457 | 30 | Автоматическая планограмма товаров по магазинам | [Документация](non-standard/AutoPlannogrammaController_ANALYSIS.md) |
+| **WriteOffsErpController** | 1252 | 10 | Управление списаниями товаров в ERP | [Документация](non-standard/WriteOffsErpController_ANALYSIS.md) |
+| **MarketplaceOrdersController** | 1072 | 17 | Интеграция с маркетплейсами (Flowwow, Яндекс) | [Документация](non-standard/MarketplaceOrdersController_ANALYSIS.md) |
**Особенности:**
- Критическая бизнес-логика
| Контроллер | Строк | Actions | Назначение | Документация |
|------------|-------|---------|------------|--------------|
-| **ClusterLinkEditController** | 730 | 10 | Редактирование связей кластеров магазинов | [Документация](non-standard/ClusterLinkEditController.md) |
-| **CategoryPlanController** | 713 | 8 | Планирование по категориям товаров | [Документация](non-standard/CategoryPlanController.md) |
-| **Products1cNomenclatureActualityController** | 670 | 7 | Актуализация номенклатуры из 1С | [Документация](non-standard/Products1cNomenclatureActualityController.md) |
-| **MatrixBouquetActualityController** | 651 | 6 | Актуализация матрицы букетов | [Документация](non-standard/MatrixBouquetActualityController.md) |
-| **MatrixErpController** | 630 | 7 | Управление матрицей товаров ERP | [Документация](non-standard/MatrixErpController.md) |
-| **ChartForManagementController** | 622 | 5 | Графики и аналитика для руководства | [Документация](non-standard/ChartForManagementController.md) |
-| **ChartsForManagementController** | 609 | 5 | Множественные графики управленческой отчетности | [Документация](non-standard/ChartsForManagementController.md) |
-| **StoreStaffingController** | 516 | 9 | Штатное расписание магазинов | [Документация](non-standard/StoreStaffingController.md) |
-| **crud/ClusterAdminController** | 503 | 6 | Административное управление кластерами | [Документация](non-standard/crud/ClusterAdminController.md) |
+| **ClusterLinkEditController** | 730 | 10 | Редактирование связей кластеров магазинов | [Документация](non-standard/ClusterLinkEditController_ANALYSIS.md) |
+| **CategoryPlanController** | 713 | 8 | Планирование по категориям товаров | [Документация](non-standard/CategoryPlanController_ANALYSIS.md) |
+| **Products1cNomenclatureActualityController** | 670 | 7 | Актуализация номенклатуры из 1С | [Документация](non-standard/Products1cNomenclatureActualityController_ANALYSIS.md) |
+| **MatrixBouquetActualityController** | 651 | 6 | Актуализация матрицы букетов | [Документация](non-standard/MatrixBouquetActualityController_ANALYSIS.md) |
+| **MatrixErpController** | 630 | 7 | Управление матрицей товаров ERP | [Документация](non-standard/MatrixErpController_ANALYSIS.md) |
+| **ChartForManagementController** | 622 | 5 | Графики и аналитика для руководства | [Документация](non-standard/ChartForManagementController_ANALYSIS.md) |
+| **ChartsForManagementController** | 609 | 5 | Множественные графики управленческой отчетности | [Документация](non-standard/ChartsForManagementController_ANALYSIS.md) |
+| **StoreStaffingController** | 516 | 9 | Штатное расписание магазинов | [Документация](non-standard/StoreStaffingController_ANALYSIS.md) |
+| **crud/ClusterAdminController** | 503 | 6 | Административное управление кластерами | [Документация](non-standard/crud/ClusterAdminController_ANALYSIS.md) |
**Особенности:**
- Расширенная бизнес-логика
| Контроллер | Строк | Особенности | Документация |
|------------|-------|-------------|--------------|
-| **ShiftTransferController** | 490 | Передача смен между сотрудниками, 7 сервисов | [Документация](non-standard/ShiftTransferController.md) |
-| **crud/Product1cReplacementController** | 480 | Замена товаров 1С, работа с файлами | [Документация](non-standard/crud/Product1cReplacementController.md) |
-| **ApiController** | 476 | API интеграции (admin, city_store, products) | [Документация](non-standard/ApiController.md) |
-| **TimetableFactController** | 475 | Фактическое расписание, алгоритмы обработки смен | [Документация](non-standard/TimetableFactController.md) |
-| **crud/TaskController** | 467 | Задачи с файлами, уведомлениями, 10 сервисов | [Документация](non-standard/crud/TaskController.md) |
-| **ReportController** | 466 | Формирование отчетов со сложной логикой | [Документация](non-standard/ReportController.md) |
-| **UsersMessageManagementController** | 461 | Управление сообщениями пользователей | [Документация](non-standard/UsersMessageManagementController.md) |
-| **BouquetController** | 458 | Управление букетами, API, изображения | [Документация](non-standard/BouquetController.md) |
-| **MatrixErpPropertyController** | 432 | Свойства матрицы ERP, работа с файлами | [Документация](non-standard/MatrixErpPropertyController.md) |
-| **ProductsController** | 432 | Управление товарами, расширенная логика | [Документация](non-standard/ProductsController.md) |
-| **MeetingController** | 431 | Встречи, календарь, уведомления, workflow | [Документация](non-standard/MeetingController.md) |
-| **crud/TaskTemplatesController** | 413 | Шаблоны задач, использование сервисов | [Документация](non-standard/crud/TaskTemplatesController.md) |
-| **OrdersController** | 360 | Заказы, множественные actions | [Документация](non-standard/OrdersController.md) |
-| **Sales2Controller** | 331 | Продажи, специфическая логика | [Документация](non-standard/Sales2Controller.md) |
-| **MatrixTypeController** | 317 | Типы матриц, сложная логика | [Документация](non-standard/MatrixTypeController.md) |
-| **MarketplacePricesController** | 310 | Цены маркетплейсов, API, файлы | [Документация](non-standard/MarketplacePricesController.md) |
-| **crud/KogortStopListController** | 306 | Стоп-листы когорт | [Документация](non-standard/crud/KogortStopListController.md) |
+| **ShiftTransferController** | 490 | Передача смен между сотрудниками, 7 сервисов | [Документация](non-standard/ShiftTransferController_ANALYSIS.md) |
+| **crud/Product1cReplacementController** | 480 | Замена товаров 1С, работа с файлами | [Документация](non-standard/crud/Product1cReplacementController_ANALYSIS.md) |
+| **ApiController** | 476 | API интеграции (admin, city_store, products) | [Документация](non-standard/ApiController_ANALYSIS.md) |
+| **TimetableFactController** | 475 | Фактическое расписание, алгоритмы обработки смен | [Документация](non-standard/TimetableFactController_ANALYSIS.md) |
+| **crud/TaskController** | 467 | Задачи с файлами, уведомлениями, 10 сервисов | [Документация](non-standard/crud/TaskController_ANALYSIS.md) |
+| **ReportController** | 466 | Формирование отчетов со сложной логикой | [Документация](non-standard/ReportController_ANALYSIS.md) |
+| **UsersMessageManagementController** | 461 | Управление сообщениями пользователей | [Документация](non-standard/UsersMessageManagementController_ANALYSIS.md) |
+| **BouquetController** | 458 | Управление букетами, API, изображения | [Документация](non-standard/BouquetController_ANALYSIS.md) |
+| **MatrixErpPropertyController** | 432 | Свойства матрицы ERP, работа с файлами | [Документация](non-standard/MatrixErpPropertyController_ANALYSIS.md) |
+| **ProductsController** | 432 | Управление товарами, расширенная логика | [Документация](non-standard/ProductsController_ANALYSIS.md) |
+| **MeetingController** | 431 | Встречи, календарь, уведомления, workflow | [Документация](non-standard/MeetingController_ANALYSIS.md) |
+| **crud/TaskTemplatesController** | 413 | Шаблоны задач, использование сервисов | [Документация](non-standard/crud/TaskTemplatesController_ANALYSIS.md) |
+| **OrdersController** | 360 | Заказы, множественные actions | [Документация](non-standard/OrdersController_ANALYSIS.md) |
+| **Sales2Controller** | 331 | Продажи, специфическая логика | [Документация](non-standard/Sales2Controller_ANALYSIS.md) |
+| **MatrixTypeController** | 317 | Типы матриц, сложная логика | [Документация](non-standard/MatrixTypeController_ANALYSIS.md) |
+| **MarketplacePricesController** | 310 | Цены маркетплейсов, API, файлы | [Документация](non-standard/MarketplacePricesController_ANALYSIS.md) |
+| **crud/KogortStopListController** | 306 | Стоп-листы когорт | [Документация](non-standard/crud/KogortStopListController_ANALYSIS.md) |
**Особенности:**
- API интеграции
| Контроллер | Строк | Особенности | Документация |
|------------|-------|-------------|--------------|
-| **AuthController** | 295 | RBAC, управление правами, меню, permissions | [Документация](non-standard/AuthController.md) |
-| **MatrixStatisticsController** | 290 | Статистика матриц, API, вычисления | [Документация](non-standard/MatrixStatisticsController.md) |
-| **crud/MarketplaceOrder1cStatusesController** | 278 | Статусы заказов маркетплейсов 1С | [Документация](non-standard/crud/MarketplaceOrder1cStatusesController.md) |
-| **crud/EmployeePaymentController** | 251 | Выплаты сотрудникам | [Документация](non-standard/crud/EmployeePaymentController.md) |
-| **crud/UniversalCatalogController** | 247 | Универсальный каталог | [Документация](non-standard/crud/UniversalCatalogController.md) |
-| **StoreCityListController** | 243 | Список магазинов по городам, файлы | [Документация](non-standard/StoreCityListController.md) |
-| **AdminPersonBonusesController** | 242 | Персональные бонусы администраторов | [Документация](non-standard/AdminPersonBonusesController.md) |
-| **UsersWhatsappMessageController** | 213 | WhatsApp сообщения, использование сервисов | [Документация](non-standard/UsersWhatsappMessageController.md) |
-| **WikiController** | 206 | Wiki-система | [Документация](non-standard/WikiController.md) |
-| **BonusLevelsController** | 202 | Уровни бонусов | [Документация](non-standard/BonusLevelsController.md) |
+| **AuthController** | 295 | RBAC, управление правами, меню, permissions | [Документация](non-standard/AuthController_ANALYSIS.md) |
+| **MatrixStatisticsController** | 290 | Статистика матриц, API, вычисления | [Документация](non-standard/MatrixStatisticsController_ANALYSIS.md) |
+| **crud/MarketplaceOrder1cStatusesController** | 278 | Статусы заказов маркетплейсов 1С | [Документация](non-standard/crud/MarketplaceOrder1cStatusesController_ANALYSIS.md) |
+| **crud/EmployeePaymentController** | 251 | Выплаты сотрудникам | [Документация](non-standard/crud/EmployeePaymentController_ANALYSIS.md) |
+| **crud/UniversalCatalogController** | 247 | Универсальный каталог | [Документация](non-standard/crud/UniversalCatalogController_ANALYSIS.md) |
+| **StoreCityListController** | 243 | Список магазинов по городам, файлы | [Документация](non-standard/StoreCityListController_ANALYSIS.md) |
+| **AdminPersonBonusesController** | 242 | Персональные бонусы администраторов | [Документация](non-standard/AdminPersonBonusesController_ANALYSIS.md) |
+| **UsersWhatsappMessageController** | 213 | WhatsApp сообщения, использование сервисов | [Документация](non-standard/UsersWhatsappMessageController_ANALYSIS.md) |
+| **WikiController** | 206 | Wiki-система | [Документация](non-standard/WikiController_ANALYSIS.md) |
+| **BonusLevelsController** | 202 | Уровни бонусов | [Документация](non-standard/BonusLevelsController_ANALYSIS.md) |
**Особенности:**
- Специфическая бизнес-логика
| Контроллер | Строк | Особенности | Документация |
|------------|-------|-------------|--------------|
-| **SalesWriteOffsPlanController** | 153 | API интеграции | [Документация](non-standard/SalesWriteOffsPlanController.md) |
-| **crud/AdminController** | 151 | Работа с файлами, сервисы | [Документация](non-standard/crud/AdminController.md) |
-| **SiteController** | 134 | Точка входа, авторизация, API | [Документация](non-standard/SiteController.md) |
-| **MarketplaceStoreController** | 128 | API маркетплейсов | [Документация](non-standard/MarketplaceStoreController.md) |
-| **ProductionCalendarController** | 94 | Работа с файлами, производственный календарь | [Документация](non-standard/ProductionCalendarController.md) |
-| **ProfileController** | 34 | Работа с файлами профиля | [Документация](non-standard/ProfileController.md) |
-| **DashboardController** | 29 | API интеграции дашборда | [Документация](non-standard/DashboardController.md) |
-| **MarketplaceController** | 19 | API маркетплейсов | [Документация](non-standard/MarketplaceController.md) |
+| **SalesWriteOffsPlanController** | 153 | API интеграции | [Документация](non-standard/SalesWriteOffsPlanController_ANALYSIS.md) |
+| **crud/AdminController** | 151 | Работа с файлами, сервисы | [Документация](non-standard/crud/AdminController_ANALYSIS.md) |
+| **SiteController** | 134 | Точка входа, авторизация, API | [Документация](non-standard/SiteController_ANALYSIS.md) |
+| **MarketplaceStoreController** | 128 | API маркетплейсов | [Документация](non-standard/MarketplaceStoreController_ANALYSIS.md) |
+| **ProductionCalendarController** | 94 | Работа с файлами, производственный календарь | [Документация](non-standard/ProductionCalendarController_ANALYSIS.md) |
+| **ProfileController** | 34 | Работа с файлами профиля | [Документация](non-standard/ProfileController_ANALYSIS.md) |
+| **DashboardController** | 29 | API интеграции дашборда | [Документация](non-standard/DashboardController_ANALYSIS.md) |
+| **MarketplaceController** | 19 | API маркетплейсов | [Документация](non-standard/MarketplaceController_ANALYSIS.md) |
**Особенности:**
- API интеграции при малом размере
```bash
# Перейти в директорию проекта
-cd /Users/vladfo/development/yii-erp24
+cd /path/to/yii-erp24
# Проверить наличие Claude Flow конфигурации
ls -la .claude-flow/
# Убедиться, что рабочая директория правильная
pwd
-# Должно быть: /Users/vladfo/development/yii-erp24
+# Должно быть: /path/to/yii-erp24
```
### Проблема: Диаграммы не рендерятся
**Контроллер**: `MatrixBouquetActualityController`
**Namespace**: `app\controllers`
**Extends**: `yii\web\Controller`
-**Путь**: `/Users/vladfo/development/yii-erp24/erp24/controllers/MatrixBouquetActualityController.php`
+**Путь**: ``erp24/controllers/MatrixBouquetActualityController.php``
## Назначение
📁 FILES LOCATION
All documentation created in:
- /Users/vladfo/development/yii-erp24/erp24/docs/services/
+ erp24/docs/services/
Main Reports:
- SERVICES_ANALYSIS_REPORT.md (Comprehensive analysis)
## См. также
### Связанные сервисы
-- [`SalesService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/SalesService.md) - источник данных о продажах
+- [`SalesService`](SalesService.md) - источник данных о продажах
### Модели
- `CategoryPlan` - планы категорий
### Документация
-- [Архитектура сервисного слоя](/Users/vladfo/development/yii-erp24/erp24/docs/architecture/services.md)
-- [Список всех сервисов](/Users/vladfo/development/yii-erp24/erp24/docs/services/README.md)
+- [Архитектура сервисного слоя](../architecture/services.md)
+- [Список всех сервисов](README.md)
- [God Object: Что это и как избежать](https://refactoring.guru/antipatterns/god-object)
### Связанные сервисы
-- [`BonusService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/BonusService.md) — Расчёт бонусов (циклическая зависимость)
-- [`RatingService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/RatingService.md) — Рейтинговая система
-- [`SalesService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/SalesService.md) — Работа с продажами
-- [`PayrollService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/PayrollService.md) — Расчёт зарплатных ведомостей
-- [`TimetableService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/TimetableService.md) — Управление расписанием
+- [`BonusService`](BonusService.md) — Расчёт бонусов (циклическая зависимость)
+- [`RatingService`](RatingService.md) — Рейтинговая система
+- [`SalesService`](SalesService.md) — Работа с продажами
+- [`PayrollService`](PayrollService.md) — Расчёт зарплатных ведомостей
+- [`TimetableService`](TimetableService.md) — Управление расписанием
### Модули
-- [`Payroll Module`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/payroll/README.md) — Модуль расчёта зарплаты
-- [`Rating Module`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/rating/README.md) — Модуль рейтингов
-- [`Bonus Module`](/Users/vladfo/development/yii-erp24/erp24/docs/modules/bonus/README.md) — Модуль бонусов
+- [`Payroll Module`](../modules/payroll/README.md) — Модуль расчёта зарплаты
+- [`Rating Module`](../modules/rating/README.md) — Модуль рейтингов
+- [`Bonus Module`](../modules/bonus/README.md) — Модуль бонусов
### Модели
-- [`Admin`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Admin.md) — Сотрудники
-- [`Timetable`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Timetable.md) — Расписание (план)
-- [`TimetableFactModel`](/Users/vladfo/development/yii-erp24/erp24/docs/models/TimetableFactModel.md) — Расписание (факт)
-- [`AdminPayroll`](/Users/vladfo/development/yii-erp24/erp24/docs/models/AdminPayroll.md) — Расчётные листы
+- [`Admin`](../models/Admin.md) — Сотрудники
+- [`Timetable`](../models/Timetable.md) — Расписание (план)
+- [`TimetableFactModel`](../models/TimetableFactModel.md) — Расписание (факт)
+- [`AdminPayroll`](../models/AdminPayroll.md) — Расчётные листы
---
## См. также
### Документация
-- [Архитектура сервисного слоя](/Users/vladfo/development/yii-erp24/erp24/docs/architecture/services.md)
-- [Список всех сервисов](/Users/vladfo/development/yii-erp24/erp24/docs/services/README.md)
+- [Архитектура сервисного слоя](../architecture/services.md)
+- [Список всех сервисов](README.md)
### Связанные сервисы
-- [`SalesService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/SalesService.md) - используется для расчета базовых метрик продаж
-- [`ExportImportService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/ExportImportService.md) - маппинг магазинов
+- [`SalesService`](SalesService.md) - используется для расчета базовых метрик продаж
+- [`ExportImportService`](ExportImportService.md) - маппинг магазинов
### Модели
-- [`DashboardSales`](/Users/vladfo/development/yii-erp24/erp24/docs/models/DashboardSales.md) - хранение агрегированных данных
-- [`DashboardFields`](/Users/vladfo/development/yii-erp24/erp24/docs/models/DashboardFields.md) - справочник полей
-- [`Sales`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md) - источник данных о продажах
+- [`DashboardSales`](../models/DashboardSales.md) - хранение агрегированных данных
+- [`DashboardFields`](../models/DashboardFields.md) - справочник полей
+- [`Sales`](../models/Sales.md) - источник данных о продажах
---
## См. также
### Связанные сервисы
-- [`InfoLogService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/InfoLogService.md) - логирование ошибок
-- [`TelegramService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/TelegramService.md) - уведомления
+- [`InfoLogService`](InfoLogService.md) - логирование ошибок
+- [`TelegramService`](TelegramService.md) - уведомления
### Модели
- `MarketplaceOrders` - заказы с маркетплейсов
## ✅ Задокументированные P2 сервисы (8/8)
### 1. AdminPayrollMonthInfoService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/AdminPayrollMonthInfoService.md`
+**Файл:** ``erp24/docs/services/AdminPayrollMonthInfoService.md``
**Размер:** 299 LOC, 2 methods
**Описание:** Сервис расчета и сохранения месячных данных зарплат сотрудников
---
### 2. AdminPayrollDaysService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/AdminPayrollDaysService.md`
+**Файл:** ``erp24/docs/services/AdminPayrollDaysService.md``
**Размер:** 246 LOC, 1 method
**Описание:** Сервис расчета и сохранения ежедневных данных зарплат
---
### 3. TaskService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/TaskService.md`
+**Файл:** ``erp24/docs/services/TaskService.md``
**Размер:** 309 LOC, 13 methods
**Описание:** Сервис управления жизненным циклом задач с Telegram integration
---
### 4. ProductParserService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/ProductParserService.md`
+**Файл:** ``erp24/docs/services/ProductParserService.md``
**Размер:** 299 LOC, 15 methods
**Описание:** HTML парсер для извлечения данных о товарах с flowwow.com
---
### 5. SelfCostProductDynamicService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/SelfCostProductDynamicService.md`
+**Файл:** ``erp24/docs/services/SelfCostProductDynamicService.md``
**Размер:** 313 LOC, 5 methods
**Описание:** Сервис управления динамической историей себестоимости товаров с группировкой интервалов
---
### 6. StoreVisitorsService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/StoreVisitorsService.md`
+**Файл:** ``erp24/docs/services/StoreVisitorsService.md``
**Размер:** 154 LOC, 4 methods
**Описание:** Сервис агрегации и нормализации данных о посетителях магазинов
---
### 7. ClusterManagerService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/ClusterManagerService.md`
+**Файл:** ``erp24/docs/services/ClusterManagerService.md``
**Размер:** 148 LOC, 2 methods
**Описание:** Сервис синхронизации кустовых директоров с кластерами магазинов
---
### 8. StoreService (API3) ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/StoreService_API3.md`
+**Файл:** ``erp24/docs/services/StoreService_API3.md``
**Размер:** 317 LOC, 5 methods
**Описание:** Критический сервис API3 для интеграции POS-систем и мобильных приложений
## ✅ Задокументированные P3 Critical сервисы (5/5)
### 1. ExportImportService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/ExportImportService.md`
+**Файл:** ``erp24/docs/services/ExportImportService.md``
**Размер:** 52 LOC, 3 methods
**Описание:** Сервис интеграции с 1С через двунаправленный маппинг ID↔GUID
---
### 2. DateTimeService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/DateTimeService.md`
+**Файл:** ``erp24/docs/services/DateTimeService.md``
**Размер:** 155 LOC, 5 methods
**Описание:** Утилиты форматирования дат и времени с русской локализацией
---
### 3. HolidayService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/HolidayService.md`
+**Файл:** ``erp24/docs/services/HolidayService.md``
**Размер:** 85 LOC, 3 methods
**Описание:** Сервис управления праздниками для модуля Timetable
---
### 4. UsersService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/UsersService.md`
+**Файл:** ``erp24/docs/services/UsersService.md``
**Размер:** 65 LOC, 2 methods
**Описание:** Сервис аналитики новых клиентов для Dashboard
---
### 5. HistoryService ✅
-**Файл:** `/Users/vladfo/development/yii-erp24/erp24/docs/services/HistoryService.md`
+**Файл:** ``erp24/docs/services/HistoryService.md``
**Размер:** 159 LOC, 5 methods
**Описание:** Сервис логирования изменений с темпоральными интервалами (audit trail)
## См. также
### Документация
-- [Архитектура сервисного слоя](/Users/vladfo/development/yii-erp24/erp24/docs/architecture/services.md)
-- [Список всех сервисов](/Users/vladfo/development/yii-erp24/erp24/docs/services/README.md)
+- [Архитектура сервисного слоя](../architecture/services.md)
+- [Список всех сервисов](README.md)
### Связанные сервисы
-- [`DashboardService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/DashboardService.md) - использует SalesService для расчета метрик
-- [`BonusService`](/Users/vladfo/development/yii-erp24/erp24/docs/services/BonusService.md) - расчет бонусов на основе продаж
+- [`DashboardService`](DashboardService.md) - использует SalesService для расчета метрик
+- [`BonusService`](BonusService.md) - расчет бонусов на основе продаж
### Модели
-- [`Sales`](/Users/vladfo/development/yii-erp24/erp24/docs/models/Sales.md) - модель продаж
-- [`SalesProducts`](/Users/vladfo/development/yii-erp24/erp24/docs/models/SalesProducts.md) - товары в чеках
+- [`Sales`](../models/Sales.md) - модель продаж
+- [`SalesProducts`](../models/SalesProducts.md) - товары в чеках
---