§01
Обзор
- Что это: внутренняя система управления закупками/складом/операциями для ресторанной сети. Заказы поставщикам с workflow по статусам, учёт склада и списаний, модуль расхода масла (кг↔л, согласование), дашборды рыночных/базарных цен, сводки по заказам блюд, экспорт в Excel/PDF, генерация накладных, RBAC по магазинам/филиалам.
- Тип / статус / роль: web-app (ERP/back-office) · active (последний коммит 2026-05-23) · solo — 225 из 227 коммитов сделаны пользователем (Davron 221 + Dave93 4; root@choparpizza.uz 2).
- Период активности: 2023-03-07 → 2026-05-23 — 3+ года непрерывной поддержки, проект живее всех живых. Сильный сигнал ownership и долгосрочной ответственности.
§02
Стек
- Языки: PHP (Yii2), JavaScript, SQL (MySQL).
- Фреймворки/библиотеки: Yii2 (~2.0.14, PHP 5.4+), MVC + ActiveRecord ORM; yii2-bootstrap; phpoffice/phpspreadsheet (экспорт в Excel); kartik-v/yii2-mpdf (PDF-накладные); kartik datepicker/select2; pkpass/pkpass (Apple Wallet passes?); Codeception (unit/functional/acceptance тесты).
- Инфра/деплой: Docker (docker-compose), Vagrant (Vagrantfile + vagrant/), Gii + Debug Toolbar (dev). Сессии в БД, file-cache, schema-cache в проде.
- Данные: MySQL
les_exord_db(orders, order_items, oil_inventory, products, stores, users, stock/stock_balance). - Заметный тулинг: AI-инструменты прямо в репозитории —
.claude/,AGENTS.md,.conductor/,.kombai/(Kombai — AI-генератор фронтенда); REST API для Telegram (/api/tguser/*).
§03
Что реализовано
225 авторских коммитов за 3 года; свежие (2026) показывают активную работу над фичами и поддержкой (по диффам):
- Дашборд рыночных/базарных цен (
b0083cf+423,a41c7f0экспорт XLSX,d47897bдоступ роли buyer по филиалам,59d7ee6ускорение списка — батчинг подсчётов + более узкий диапазон,7501764фикс DISTINCT в подзапросе по order-ids). - Сводка по заказам блюд (
2fc006c+176,afe6d75разбивка по магазинам,282198eтранспонированная таблица + XLSX). - Интеграция с iiko (
31b7fc4исключение soft-deleted позиций из экспорта документов iiko; накладные). - Накладные (
c0e1008лог отправки/удаления заказа + автооткрытие накладной,fc4dba6фикс таймзоны в Yii-форматтере + переработка шапки,0fb086bдата документа = дата создания заказа). - Учёт масла (конвертация кг↔л 1кг=1.1л, workflow статусов new→filled→accepted/rejected, аналитика — отдельные файлы CHANGES_*.md).
- Telegram-уведомления (
0c4bd5aперенос токенов в конфиг,e17703adebug-логирование для списаний/перемещений). - Масштаб: 227 коммитов; стабильный поток фич и фиксов 2023→2026.
§04
Технические челленджи
По диффам свежих коммитов (авторства пользователя):
- Корректность складского учёта в экспортах (
31b7fc4): исключение soft-deleted позиций заказа из экспортов в iiko — типичная, но важная задача целостности данных в интеграции ERP↔POS. - Производительность списка цен (
59d7ee6,7501764): сужение дефолтного диапазона дат + батчинг подсчётов вместо N запросов; фикс некорректногоDISTINCTв подзапросе по order-id. → Оптимизация SQL/ActiveRecord на реалистичном объёме данных. - Единицы и таймзоны (
fc4dba6, масло кг↔л): конвертация единиц с округлением, фикс таймзоны Yii-форматтера в накладных — внимание к доменным edge-кейсам. - RBAC по филиалам (
d47897b): доступ роли buyer к ценам, ограниченный своими филиалами — реальная изоляция данных между магазинами. - Движок экспорта: XLSX (phpspreadsheet) + PDF-накладные (mpdf); фикс «битого XLSX» (
5d8c9b7). → Отчётность production-уровня. - Оговорка: стек легаси (Yii2, PHP 5.4+), но код грамотно поддерживается и расширяется.
§05
AI-разработка
- Найдено сессий: 6
.jsonl-файлов в директории сессий Claude Code для этого проекта (проверено через нормализацию полного пути). - Что делалось с AI: свежие фичи 2025–2026 (дашборды, экспорты, iiko/Telegram) — учитывая наличие сессий и AI-тулинга, значительная часть сделана с AI-ассистом.
- Паттерны AI-воркфлоу: богатый AI-тулкит — Claude Code +
AGENTS.md+.conductor/(оркестрация агентов) +.kombai/(AI-генерация UI). Детальные CHANGES_*.md как спеки изменений. Пользователь применяет AI даже к легаси-кодовой базе на PHP.
§06
Достижения и метрики
- 3+ года непрерывной эксплуатации в проде; ~36 контроллеров, ~68 моделей, ~22 директории миграций (по структуре) — крупная бизнес-система.
- Реальные операции сети: закупки, склад, масло, цены, отчётность; интеграции iiko + Telegram.
- Сольный ownership от начала до конца (225/227 коммитов).