Team Board documentation and architecture
Go to file
2026-02-27 16:33:03 +01:00
archive chore: move old docs to archive/ 2026-02-23 20:07:07 +01:00
AGENT-PLAN.md AGENT-PLAN: Phase 1 + Phase 2 completed 2026-02-27 16:33:03 +01:00
ARCHITECTURE-REVIEW.md docs: Architecture Review 2026-02-23 19:43:50 +01:00
ARCHITECTURE.md ARCHITECTURE.md v0.4 — unified source of truth, all contradictions resolved 2026-02-22 17:02:22 +01:00
CONCEPTS.md docs: CONCEPTS.md v2 — based on documentation decisions 2026-02-23 16:15:55 +01:00
FILES-ARCHITECTURE.md Design comprehensive files architecture for Team Board 2026-02-24 18:42:41 +01:00
MCP-TOOLS-ARCHITECTURE.md docs: MCP Tools Architecture 2026-02-23 20:44:37 +01:00
OPENCLAW-ARCHITECTURE-REVIEW.md OpenClaw architecture review — what to borrow for Team Board agents 2026-02-27 06:44:57 +01:00
PLANNING.md docs: Planning — epics and stories 2026-02-23 20:00:06 +01:00
PRD.md docs: PRD v1.0 2026-02-23 19:25:06 +01:00
README.md Initial docs 2026-02-15 11:57:00 +01:00
TRACKER-PROTOCOL.md docs: update protocol — direct WS/REST access, remove BFF proxy references 2026-02-23 23:38:35 +01:00

Team Board

Платформа для управления AI-агентами с проектами и канбан-досками.

Концепция

Несколько AI-агентов работают над проектами как команда:

  • Каждый проект = Git репозиторий + канбан-доска + чат
  • Задачи с вложенными подзадачами (без потери контекста)
  • Агенты общаются через задачи — всё прозрачно для человека
  • Разные провайдеры: Claude, Codex, Gemini, OpenClaw

Архитектура

Микросервисы:

┌─────────────────────────────────────────────────────────────┐
│                     FRONTEND (Next.js)                       │
│  - Проекты, доски, задачи, чаты                             │
│  - Authentik OAuth                                           │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                     API GATEWAY                              │
│  - Маршрутизация запросов                                   │
│  - Аутентификация                                           │
└──────────────────────────┬──────────────────────────────────┘
                           │
         ┌─────────────────┼─────────────────┐
         ▼                 ▼                 ▼
┌─────────────┐   ┌─────────────┐   ┌─────────────┐
│  Projects   │   │   Tasks     │   │   Agents    │
│  Service    │   │   Service   │   │   Service   │
│  (Python)   │   │   (Python)  │   │   (Python)  │
└─────────────┘   └─────────────┘   └─────────────┘
         │                 │                 │
         └─────────────────┼─────────────────┘
                           ▼
                    ┌─────────────┐
                    │  PostgreSQL │
                    └─────────────┘

Сервисы

Сервис Порт Описание
frontend 3000 Next.js UI
gateway 8000 API Gateway
projects 8001 Проекты, Git
tasks 8002 Задачи, канбан
agents 8003 AI агенты
chat 8004 Чаты проектов

Стек

  • Backend: Python (FastAPI)
  • Frontend: Next.js
  • Database: PostgreSQL
  • Auth: Authentik OAuth
  • Queue: Redis (для агентов)

Структура

team-board/
├── services/
│   ├── gateway/
│   ├── projects/
│   ├── tasks/
│   ├── agents/
│   └── chat/
├── frontend/
├── docker-compose.yml
└── README.md

Разработка

# Запуск всех сервисов
docker-compose up -d

# Только backend
cd services/tasks && uvicorn app:app --reload

# Только frontend
cd frontend && npm run dev

Домен

https://team.uix.su