# 06 — Tasks: Onboarding & MVP Core (for Cursor)

Цей документ містить чіткі технічні задачі для Cursor.
Кожна задача сформульована у форматі, який Cursor розуміє найкраще:
- контекст
- специфікації
- API
- acceptance criteria
- очікуваний вивід (list of files + diff)

Всі задачі беруть дані з:
- 01_product_brief_mvp.md
- 02_architecture_basics.md
- 03_api_core_snapshot.md
- 04_ui_ux_onboarding_chat.md
- 05_coding_standards.md

## BLOCK A — ONBOARDING (5 кроків)

### Task A1 — Create route `/onboarding` + base layout

**Context:**
Onboarding складається з 5 кроків. Потрібен базовий контейнер зі state machine.

**Specs:**
- Створити сторінку `/onboarding`.
- Додати компонент `OnboardingLayout`.
- Зберігати поточний крок у локальному стані.
- Кроки: `welcome`, `team`, `privacy`, `channel`, `agent`, `invite`.
- У верхній частині: step indicator.

**Acceptance Criteria:**
- `/onboarding` відкривається без помилок.
- Є stepper з актуальною позначкою (1–5).
- Немає реальних API-викликів (тільки каркас).

**Cursor Output:**
- Список файлів для змін.
- Код.

### Task A2 — Onboarding Step 1: Welcome Screen

**Specs:**
- Заголовок: "Створимо твою MicroDAO".
- Підзаголовок: "5 кроків — і твоя спільнота буде готова до роботи."
- Кнопка: "Почати".
- При натисканні — перехід на Step 2.

**Acceptance Criteria:**
- Стиль згідно з 04_ui_ux_onboarding_chat.md.
- Робоча кнопка.

### Task A3 — Step 2: Create Team (API: POST /teams)

**Specs:**
- Форма:
  - `Назва спільноти` (required)
  - `Опис` (optional)
- Виклик: `POST /teams`
- Результат: зберегти `teamId` у state onboarding.

**Acceptance Criteria:**
- Форма валідна: без назви кнопка disabled.
- Після успішного виклику → Step 3.
- Обробка помилок через toast.

### Task A4 — Step 3: Privacy mode (PATCH /teams/{id})

**Specs:**
UI: дві великі карточки:

- PUBLIC:
  - Текст: "Є публічний канал. Гості можуть читати та приєднатися."

- CONFIDENTIAL:
  - Текст: "Тільки запрошені учасники. Чати зашифровані."

При натисканні — PATCH `/teams/{teamId}`.

**Acceptance Criteria:**
- Виділяється вибраний режим.
- Успішний PATCH → Step 4.

### Task A5 — Step 4: Create first channel (POST /channels)

**Specs:**
- Поля:
  - Назва каналу
  - Тип: public | group
- Виклик:
  ```json
  {
    "team_id": "...",
    "type": "...",
    "title": "...",
    "mode": "public" | "confidential"
  }
  ```

**Acceptance Criteria:**
- Після успіху → Step 5.
- Канал створений і додається до списку каналів у state.

### Task A6 — Step 5: Agent & memory settings (POST /agents)

**Specs:**
UI:

- toggle: "Увімкнути приватного агента"
- select: мова агента
- select: профіль агента
- select: memory depth

API:

1. Якщо toggle ON →
   `POST /agents` body:

```json
{
  "owner_kind": "team",
  "owner_id": "t_123",
  "name": "Team Assistant",
  "role": "general",
  "scopes": ["chat"]
}
```text

2. Якщо OFF → skip

**Acceptance Criteria:**

- Вибір зберігається в onboarding state.
- API викликається тільки якщо агент включений.
- Після успіху → Step 6.

### Task A7 — Step 6: Invite (UI only)

**Specs:**
UI:

- Заголовок: "Спільнота створена!"
- Показати посилання-запрошення (stub: `/invite?t=ID`).
- Кнопка: "Перейти в чат".

**Acceptance Criteria:**

- Немає API.
- При натисканні — redirect до `/t/:teamId/c/:channelId`.

## BLOCK B — CHAT CORE

### Task B1 — Channel List in Sidebar

**Specs:**

- Зробити компонент `SidebarChannels`.
- Отримати список каналів командою:

  - Використати локальний state (оновлює онбординг).
  - У реальному додатку — GET `/teams/{id}/channels` (можна додати).
- Показати активний канал.

**Acceptance Criteria:**

- Sidebar показує всі канали.
- Active канал підсвічений.

### Task B2 — Messages Stream (GET /channels/{id}/messages)

**Specs:**

- Компонент: `MessagesStream`.
- Пагінація: cursor-based scroll.
- Рендер: avatar + name + time + text.
- Confidential → body_enc (можна stub дешифрування).

**Acceptance Criteria:**

- Стрічка відображає повідомлення.
- При скролі догори → підвантаження старих.

### Task B3 — Composer (POST /messages)

**Specs:**

- Компонент: `MessageComposer`.
- Input + кнопка "Надіслати".
- Enter → відправка.
- Shift+Enter → новий рядок.

**Acceptance Criteria:**

- Повідомлення додається в стрічку без перезавантаження.
- Порожній інпут → заборонити надсилання.

### Task B4 — Follow-up creation (POST /followups)

**Specs:**

- Контекстне меню у повідомленні: "Створити follow-up".
- Модалка: назва (автоматично), assignee (список членів), due.
- API: POST `/followups`.

**Acceptance Criteria:**

- Follow-up створюється успішно.
- Помилки показуються через toast.

## BLOCK C — PROJECTS & TASKS

### Task C1 — Project List (GET /projects)

**Specs:**

- Вкладка "Проєкти".
- Список проєктів (назва).
- Кнопка "Створити проєкт".

**Acceptance Criteria:**

- Працює рендер списку.
- Порожній стан: "Проєкти ще не створені".

### Task C2 — Create Project (POST /projects)

**Specs:**

- Модалка → створення нового проєкту.
- Поля: назва, visibility (public/confidential).
- API: POST `/projects`.

**Acceptance Criteria:**

- Новий проєкт зʼявляється в списку.

### Task C3 — Tasks Board (GET/POST /projects/{id}/tasks)

**Specs:**

- 3 колонки: backlog, in_progress, done.
- Карточка задачі: title + status.
- При кліку → змінити статус.

**Acceptance Criteria:**

- Задачі змінюють статус (PATCH можна stub: просто оновлювати client state).
- Мінімальний Kanban працює.

## BLOCK D — AGENTS

### Task D1 — Agents List (GET /agents)

**Specs:**

- Вкладка "Агенти".
- Показати всіх агентів команди.

**Acceptance Criteria:**

- Один агент "Team Assistant" відображається.

### Task D2 — Agent Chat (stub)

**Specs:**

- Створити окремий чат з агентом:

  - `MessageComposer`
  - потік повідомлень (локальний state)
- В API-запиті викликати зовнішній LLM (можна mock)
- Зберігати історію до reload.

**Acceptance Criteria:**

- Агент відповідає у вигляді тексту.
- Історія видно в UI.

## BLOCK E — FINALIZATION

### Task E1 — Route redirect after onboarding

**Specs:**

- Після Step 6 redirect:
  `/t/:teamId/c/:channelId`

**Acceptance Criteria:**

- Після онбордингу користувач потрапляє у свій перший канал.

### Task E2 — Mobile adaptation

**Specs:**

- Sidebar → Drawer
- Composer sticky bottom
- Onboarding → одна колонка

**Acceptance Criteria:**

- Мобільна версія не ламається.

### Task E3 — Error Handling Audit

**Specs:**
Перевірити всі виклики API:

- login
- teams
- channels
- messages
- followups
- projects
- tasks
- agents

**Acceptance Criteria:**

- Усі помилки показуються через toast.
- Немає uncaught exceptions у консолі.

## Кінець документа

Цей файл є головним TODO для Cursor.

Кожна задача може бути надіслана як окремий prompt,
Cursor повинен завжди відповідати:

- списком файлів,
- diff,
- коротким summary.