# User Flow — Lambda Bot

> **Статус:** ШАБЛОН — заполняет @architect после исследований
> **Зависит от:** docs/research/telegram-flows.md, docs/research/competitor-ux.md

---

## Основной сценарий (happy path)

```mermaid
sequenceDiagram
    actor User
    participant Bot as Telegram/Matrix Bot
    participant Platform as Lambda Platform (Master)

    User->>Bot: /start
    Bot->>Platform: GET /users/{tg_id}?platform=telegram
    Platform-->>Bot: {user_id, is_new}

    alt Новый пользователь
        Bot->>User: Приветствие + инструкция
    else Существующий пользователь
        Bot->>User: Добро пожаловать обратно
    end

    loop Диалог (бот не управляет сессиями — Master делает это автоматически)
        User->>Bot: Сообщение в чат C1/C2/...
        Bot->>Platform: POST /users/{user_id}/chats/{chat_id}/messages
        Note over Platform: Master поднимает контейнер,<br/>монтирует нужный чат, запускает агента
        Platform-->>Bot: {message_id, response, tokens_used}
        Bot->>User: Ответ агента
    end
```

---

## Состояния FSM (Telegram)

```mermaid
stateDiagram-v2
    [*] --> Unauthenticated: первый контакт

    Unauthenticated --> Idle: /start (auth confirmed)

    Idle --> WaitingResponse: сообщение пользователя
    WaitingResponse --> Idle: ответ получен
    WaitingResponse --> Error: ошибка платформы

    Idle --> Idle: /new (создан новый чат)
    Idle --> ConfirmAction: агент запрашивает подтверждение
    ConfirmAction --> Idle: подтверждено / отменено

    Error --> Idle: /start
```

---

## Открытые вопросы

> Заполняет @researcher и @architect после исследований

- [ ] Как выглядит онбординг новых пользователей у конкурентов?
- [ ] Нужна ли кнопка "Новая сессия" или сессия стартует автоматически?
- [ ] Что показываем пока агент думает (typing indicator)?
- [ ] Как обрабатываем timeout ответа от платформы?