# Marketing Operations Cabinet

Многоклиентский операционный кабинет для отдела маркетинга: планирование проектов и задач,
сбор доказательств выполнения, приёмка результатов, прозрачный расчёт KPI и премий, бизнес-ценность,
AI-отчёты с подтверждением человеком, отчётные лендинги и уведомления.

Это **не** трекер задач и **не** клон таблицы, а role-based продукт операционного управления.
Первый продакшн-кейс — отдел маркетинга **ГК ОСКАР**, но архитектура многоклиентская с самого начала.

## Продуктовый цикл

> Project / Brand / Direction → Period → Plan → Tasks → Evidence → Review → KPI → Bonus →
> Business Value → Report Landing Page → Executive Approval

## Стек

- **Next.js 15** (App Router) + **TypeScript** + **React 19**
- **Prisma** + **PostgreSQL** (собственная БД проекта из `DATABASE_URL`)
- **Tailwind CSS** — минималистичная дизайн-система
- **Auth.js (NextAuth v5)** — роли ADMIN / HEAD / EMPLOYEE / EXECUTIVE / VIEWER
- **Anthropic API** — AI-ассистент задач/отчётов (всегда с подтверждением человека, §3.2)

## Роли (§4)

| Роль | Назначение |
|------|------------|
| ADMIN | Полный контроль: пользователи, сущности, формулы KPI, интеграции, аудит |
| HEAD | Главный оператор: проекты, периоды, задачи, приёмка, отчёты |
| EMPLOYEE | Исполнение и загрузка доказательств |
| EXECUTIVE | Директор/владелец/клиент: дашборд, отчёты, утверждение |
| VIEWER | Настраиваемые роли наблюдателя |

## Ключевые принципы

- **Evidence-based приёмка** — задача принимается только после доказательства (§3.1).
- **Human-controlled AI** — AI предлагает, человек подтверждает критические действия (§3.2).
- **Прозрачная премия** — каждая сумма раскладывается по задачам/весам/коэффициентам (§3.3).
- **Desktop-first**, затем мобильная адаптация (§3.5).

## Структура

```
prisma/schema.prisma   — модель данных (Client/Brand/Direction/Project/Period/Task/Evidence/KPI…)
src/app/                — App Router (оболочка; дашборды по ролям — Stage 4)
src/lib/db.ts           — Prisma client
src/lib/kpi.ts          — расчёт KPI/премии (формула из xlsx — Stage 3)
```

## Запуск (после Stage 1)

```bash
cp .env.example .env      # DATABASE_URL уже выдан фабрикой
npm install
npm run db:migrate
npm run db:seed           # демо-структура ГК ОСКАР
npm run dev
```

## Дорожная карта

1. **Каркас и фундамент** — стек, схема БД, оболочка (текущий этап).
2. **Данные и доступ** — миграции, сид ГК ОСКАР, Auth.js, RBAC, аудит.
3. **Ядро операций** — проекты/периоды/задачи, доказательства, Review Center, KPI/премия из xlsx.
4. **UX и дашборды** — role-based дашборды, бизнес-ценность, адаптив + проверка Playwright.
5. **AI, отчёты, уведомления** — AI-отчёты с подтверждением, отчётные лендинги, e-mail/in-app, mock-интеграции.

## Допущения и ограничения (на сейчас)

- Файл `KPI ОТДЕЛ МАРКЕТИНГА 2.0.xlsx` пока не приложен — `src/lib/kpi.ts` содержит каркас формулы,
  точная логика портируется на Stage 3 (нужен xlsx от владельца).
- Интеграции (Bitrix24, телефония, BI) реализуются как mock-ready архитектура (§spec).
- Финансовый учёт остаётся вне кабинета — считаем и объясняем премию, но не проводим выплаты.