Admin Franchise

Admin Franchise — BR 1.4.1

Контракты

• User Service API — 24 public эндпоинта для проксирования
• Расписание смен (фронт-спека)
• Дашборд (фронт-спека)
• Ведомости (фронт-спека)

---

BFF (bff/)

Proxy Routes

• EMPE-01: Все proxy routes к User Service (24 public эндпоинта)
  • /employees/:id/legal-details → GET, PUT
  • /shift-templates → GET, POST, PATCH, DELETE
  • /schedules → GET, POST, PATCH, DELETE
  • /shift-records → GET, POST, PATCH
  • /shift-records/:id/corrections → POST, DELETE
  • /dashboard/activity → GET
  • /salary-formulas → GET, POST, PATCH, DELETE
  • /payroll → GET, POST calculate, POST confirm, POST mark-paid, GET export

---

Shared (shared/)

• EMPE-02: TypeScript типы
  • EmployeeLegalDetails
  • ShiftTemplate, ShiftTemplateCreateRequest, ShiftTemplateUpdateRequest
  • ShiftSchedule, ShiftScheduleCreateRequest
  • ShiftRecord, ShiftRecordCreateRequest, ShiftCorrection, ShiftCorrectionCreateRequest
  • ShiftStatus = "on_schedule" | "off_schedule" | "missed" | "unplanned"
  • SalaryFormula, SalaryFormulaCreateRequest, FormulaType = "hourly" | "fixed" | "mixed"
  • PayrollRecord, PayrollStatus = "calculated" | "confirmed" | "paid"
  • DashboardActivity, DashboardSummary, EmployeeActivity

---

Web (web/)

Карточка сотрудника (рефакторинг)

• EMPE-03: Рефакторинг на 5 вкладок (Tabs component)
  • Tab 1: Общая информация (существующая форма)
  • Tab 2: Роли и магазины
  • Tab 3: Юридические детали
  • Tab 4: Рабочее время
  • Tab 5: История заказов (заглушка)
• EMPE-04: Вкладка “Юридические детали” — форма GET/PUT
• EMPE-05: Вкладка “Рабочее время” — календарь часов за период

Расписание

• EMPE-06: Календарь-грид (layout, переключение неделя/месяц, фильтры)
• EMPE-07: Плановые смены (create/edit/delete, шаблон-селектор, batch)
• EMPE-08: Фактические смены (отображение с цветовой кодировкой статусов)
• EMPE-09: Корректировки (модалка: тип, минуты, комментарий, сброс)
• EMPE-10: Шаблоны смен (CRUD, макс 4 валидация)

Дашборд

• EMPE-11: Страница дашборда (summary cards + таблица активности)

Зарплата

• EMPE-12: Формулы зарплаты (CRUD, по роли + индивидуальные)
• EMPE-13: Платёжные ведомости (расчёт, подтверждение, выплата, CSV)

Навигация

• EMPE-14: Sidebar — добавить пункты: Расписание, Дашборд активности, Платёжные ведомости

---

Порядок реализации

1. EMPE-01 (BFF) + EMPE-02 (типы) — инфраструктура
2. EMPE-14 (навигация) + EMPE-03 (вкладки карточки) — каркас
3. EMPE-04 (юр. детали) + EMPE-05 (рабочее время) — вкладки
4. EMPE-06 → EMPE-07 → EMPE-08 → EMPE-09 → EMPE-10 — расписание (последовательно)
5. EMPE-11 (дашборд) — зависит от данных смен
6. EMPE-12 → EMPE-13 — зарплата (последовательно)