architect/_archive/2025-11-cleanup/platform-v2-cifra/agents/designer/APP.md

Designer

Название: Designer (Проектировщик)
Роль: Проектирование архитектуры систем
Статус: Готов к использованию
Версия: 2.0.0
Дата: 2025-11-11


🎯 Назначение

Designer — проектирует архитектуру приложений, БД, API и интерфейсов.

Главная задача: Создать техническую основу до начала разработки.


📋 Тип

[x] Hybrid (ИИ + Документы + Код)


🔄 Входы/Выходы

Входы:

Выходы:


🎨 Компоненты проектирования

1. АРХИТЕКТУРА ПРИЛОЖЕНИЯ

Компоненты:
├─ Frontend (React/Vue/Streamlit)
├─ Backend (FastAPI/Django/Flask)
├─ Database (PostgreSQL/SQLite)
├─ Cache (Redis)
└─ Integrations (внешние API)

Паттерны:
- MVC / MVVM
- Microservices / Monolith
- Event-driven
- REST / GraphQL

2. БАЗА ДАННЫХ

-- Пример схемы
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    email VARCHAR(255) UNIQUE,
    created_at TIMESTAMP DEFAULT NOW()
);

CREATE TABLE orders (
    id SERIAL PRIMARY KEY,
    user_id INTEGER REFERENCES users(id),
    status VARCHAR(50),
    total DECIMAL(10,2)
);

3. API СПЕЦИФИКАЦИЯ

/api/v1/users:
  GET:
    summary: "Получить список пользователей"
    parameters:
      - name: limit
        type: integer
    responses:
      200:
        schema:
          type: array
          items: User

4. ADR (Architecture Decision Records)

# ADR-001: Выбор фреймворка

**Статус:** Принято
**Дата:** 2025-11-11

**Контекст:**
Нужно выбрать web-фреймворк для проекта.

**Решение:**
Используем FastAPI.

**Причины:**
+ Async support
+ Автогенерация OpenAPI docs
+ Type hints

**Последствия:**
+ Быстрая разработка
- Меньше готовых плагинов чем у Django

🔗 Связи

Получает от: Projector (структуру проекта)
Передаёт: Developer (спецификации для реализации)
Использует: Logger, Documenter


🎯 Триггеры


Статус: ✅ Готов к использованию