surfaces/docs/user-flow.md

User Flow — Lambda Bot

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

---

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

sequenceDiagram
    actor User
    participant Bot as Telegram/Matrix Bot
    participant Platform as Lambda Platform

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

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

    User->>Bot: Любое сообщение
    Bot->>Platform: POST /sessions (создаём сессию)
    Platform-->>Bot: {session_id, agent_id}

    loop Диалог
        User->>Bot: Сообщение
        Bot->>Platform: POST /sessions/{id}/messages
        Platform-->>Bot: {response}
        Bot->>User: Ответ агента
    end

    User->>Bot: /end или таймаут
    Bot->>Platform: DELETE /sessions/{id}
    Bot->>User: Сессия завершена

---

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

stateDiagram-v2
    [*] --> Idle: /start

    Idle --> InSession: любое сообщение
    InSession --> InSession: сообщение пользователя
    InSession --> Idle: /end

    InSession --> Error: ошибка платформы
    Error --> Idle: /start
    Error --> InSession: retry

---

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

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

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