architect

name	architect
description	Архитектурный анализ и планирование реализации фич. Используй при планировании, архитектуре, дизайне системы, новой фиче, как реализовать, продумать решение.

/architect — Architecture & Planning

Instructions

1. Пойми задачу

Уточни у пользователя:

• Что именно нужно реализовать?
• Какие ограничения/требования?
• Есть ли примеры/референсы?

2. Изучи текущую архитектуру

Прочитай ключевые файлы проекта: handlers, services, models.

3. Предложи архитектуру

## Архитектура: {название фичи}

### Обзор
{краткое описание решения}

### Компоненты

1. **Handler/Page** — `src/{path}`
   - Принимает запросы
   - Валидирует входные данные
   - Вызывает сервис

2. **Service** — `src/{path}`
   - Бизнес-логика
   - Оркестрирует репозитории
   - Обрабатывает ошибки

3. **Repository/Model** (если нужно) — `src/{path}`
   - Доступ к данным
   - CRUD операции

### Модели данных

{Pydantic / TypeScript / SQL models}

### Интеграции
- Какие существующие сервисы затронуты
- Новые зависимости

### План реализации

1. [ ] Создать модели данных
2. [ ] Реализовать repository (если нужен)
3. [ ] Реализовать сервис
4. [ ] Добавить handler/page
5. [ ] Зарегистрировать роутер
6. [ ] Протестировать

4. Принципы

ВСЕГДА следуй:

• KISS — простота важнее
• YAGNI — не на будущее
• SRP — одна ответственность
• Async — все I/O через async/await (если применимо)

5. После согласования

• Обнови documentation/ARCHITECTURE.md если нужно
• Создай task breakdown для реализации