index

Stack Docs

Документація проєкту. Корінь — глобальні речі (конвенції, глосарій, ролі, мапа сервісів). Сервіси — кожен у своєму репо, агрегуються сюди автоматично.

Мапа сервісів

flowchart TB
    subgraph Frontend
        client[stack-client]
        electron[stack-electron]
    end

    stack[stack<br/>orchestrator + auth]

    subgraph "Domain backends"
        golden[stack-golden]
        prime[stack-prime]
        udate[stack-udate]
        chathouse[stack-chathouse]
    end

    subgraph "Окремі сервіси"
        academy[stack-academy]
        ai[stack-ai]
    end

    client --> stack
    electron --> stack
    electron -->|/electron-api| golden
    stack --> golden
    stack --> prime
    stack --> udate
    stack --> chathouse
    stack --> academy
    stack --> ai

    classDef done fill:#e3f2fd,stroke:#1976d2;
    classDef wip fill:#fff3e0,stroke:#f57c00;
    classDef todo fill:#fafafa,stroke:#9e9e9e;

    class electron,golden done;
    class client,stack wip;
    class prime,udate,chathouse,academy,ai todo;

    click electron "/services/electron/" "Stack Electron docs"
    click golden "/services/golden/" "Stack Golden docs"

Кольори: блакитний — доки готові, помаранчевий — в роботі, сірий — заплановано. Клік на ноду електрону / golden → переходить на доку сервісу.

Початок

• Як це працює → README
• Правила формату → CONVENTIONS
• Як створювати/оновлювати сторінки → AUTHORING
• Глосарій термінів → glossary
• Каталог ролей → roles
• Приклади Mermaid-діаграм → diagram-examples (стенд із усіма типами що рендеряться)

Архітектура

• Огляд сервісів → Overview
• Візуальна мапа (Canvas) → Canvas
• Як працює пайплайн доки → Docs Pipeline

Сервіси

Кожен сервіс має свою документацію в services/<name>/:

• stack-electron · Canvas — електрон-клієнт оператора
• stack-golden · Canvas — бек проєкту goldenbride
• (інші сервіси з’являться коли в них буде docs/)

Крос-сервісне

• Сутності → Entities (порожньо)
• Історія змін → changelog