301 lines
13 KiB
Markdown
301 lines
13 KiB
Markdown
# TASKS.md — Полный список задач Team Board
|
||
|
||
Обновлено: 2026-02-28
|
||
|
||
## Легенда
|
||
- ✅ Готово
|
||
- 🔧 В работе
|
||
- 📋 Запланировано
|
||
- 💡 Идея (требует brainstorm)
|
||
|
||
---
|
||
|
||
## Инфраструктура
|
||
|
||
- ✅ Tracker MVP: FastAPI + SQLAlchemy 2 + PostgreSQL 16
|
||
- ✅ Docker для Tracker (bind mounts: postgres, uploads, projects)
|
||
- ✅ Nginx + SSL (dev.team.uix.su)
|
||
- ✅ CI/CD: Gitea Actions auto-deploy
|
||
- ✅ Redis удалён (был не нужен)
|
||
- ✅ BFF удалён — фронт напрямую к Tracker
|
||
|
||
## Аутентификация
|
||
|
||
- ✅ JWT auth для людей (login/password)
|
||
- ✅ Token auth для агентов (Bearer tb-xxx)
|
||
- ✅ Auth middleware на всех /api/ endpoints
|
||
- ✅ OPTIONS preflight пропускается
|
||
- ✅ Bcrypt пароли (миграция с SHA-256)
|
||
- 📋 Authentik OAuth (SSO через auth.uix.su)
|
||
|
||
## Модели данных
|
||
|
||
- ✅ Unified Member model (human + agent)
|
||
- ✅ UUID как primary identifier везде (slug только для display)
|
||
- ✅ Soft-delete для agents (is_active flag)
|
||
- ✅ AgentConfig: capabilities, labels, chat/task_listen, prompt, model, provider
|
||
- ✅ Project: name, slug, description, repo_urls, status, task_counter, auto_assign
|
||
- ✅ ProjectMember (many-to-many)
|
||
- ✅ Task: title, desc, type, status, priority, labels, assignee, reviewer, watchers, parent_id, depends_on
|
||
- ✅ TaskAction (structured audit log)
|
||
- ✅ TaskLink (blocks, depends_on, relates_to)
|
||
- ✅ Label (глобальные, app-wide)
|
||
- ✅ TaskLabel (many-to-many)
|
||
- ✅ Step (checklist внутри задачи)
|
||
- ✅ Chat + Message (unified: чат + комментарии к задачам)
|
||
- ✅ Message: thinking, tool_log, actor_id, mentions
|
||
- ✅ Attachment (файлы в чате)
|
||
- ✅ ProjectFile (файлы проекта)
|
||
- ✅ Centralized enums (tracker/enums.py)
|
||
|
||
## WebSocket
|
||
|
||
- ✅ WS Foundation: подключение, auth, heartbeat
|
||
- ✅ Auto-subscribe на проекты при auth
|
||
- ✅ broadcast_message (с фильтрацией агентов)
|
||
- ✅ broadcast_task_event (с project_id)
|
||
- ✅ System messages: @mention filtering для агентов
|
||
- ✅ Agent streaming: start/delta/tool/end events
|
||
- ✅ config.updated event (hot reload)
|
||
- ✅ Frontend WS heartbeat (30 сек)
|
||
|
||
## REST API
|
||
|
||
- ✅ CRUD: projects, tasks, steps, messages, members
|
||
- ✅ Task links API (POST/GET/DELETE)
|
||
- ✅ Labels API (global CRUD + task associations)
|
||
- ✅ Project files API (upload, download, search, thumbnails)
|
||
- ✅ Chat attachments API
|
||
- ✅ Task search (q= по номеру + title)
|
||
- ✅ Subscription modes: all, mentions, assigned, none
|
||
- ✅ Auto-assign (task labels ↔ agent labels, project option)
|
||
- ✅ Init handshake: assigned_tasks в auth.ok
|
||
|
||
## Web Client (Vite + React SPA)
|
||
|
||
### Kanban Board
|
||
- ✅ 5 колонок (backlog → done) с цветами
|
||
- ✅ Карточки: приоритет, assignee, labels
|
||
- ✅ Parent/child key на карточках (TE-1 / TE-3)
|
||
- ✅ Move buttons (← →)
|
||
- ✅ Task dedup fix
|
||
|
||
### Task Modal
|
||
- ✅ Inline edit title + description
|
||
- ✅ Task key сверху (breadcrumb с родителем)
|
||
- ✅ Status, priority, assignee, reviewer selectors
|
||
- ✅ Steps (checklist с прогресс-баром)
|
||
- ✅ Comments (newest first, input on top)
|
||
- ✅ File attachments в чате
|
||
- ✅ Dependencies section (colored labels + search autocomplete)
|
||
- ✅ Subtasks section (status dots, clickable navigation)
|
||
- ✅ "+" Подзадача button
|
||
- ✅ Thinking blocks (collapsible 💭)
|
||
- ✅ Tool log (collapsible 🔧)
|
||
|
||
### Create Task Modal
|
||
- ✅ Title, Description
|
||
- ✅ Type (task/bug/feature)
|
||
- ✅ Status selector (colored circles, default backlog)
|
||
- ✅ Priority selector (colored circles)
|
||
- ✅ Assignee + Reviewer dropdowns
|
||
- ✅ Labels toggle buttons
|
||
- ✅ Parent ID (for subtasks)
|
||
|
||
### Chat Panel
|
||
- ✅ Fullscreen, dedup by ID
|
||
- ✅ Message styling (yellow=system, green=agent)
|
||
- ✅ @mention autocomplete (MentionInput)
|
||
- ✅ File attachments
|
||
|
||
### Project
|
||
- ✅ Tabs: Board / Chat / Files / Settings
|
||
- ✅ Project Files (drag & drop, search, thumbnails)
|
||
- ✅ Project Settings: name, desc, repos, status, auto-assign toggle
|
||
- ✅ Member management (humans + agent toggles)
|
||
|
||
### Settings (app-wide)
|
||
- ✅ Settings Layout с sidebar
|
||
- ✅ 🏷️ Лейблы — глобальные лейблы (CRUD, color picker)
|
||
- ✅ 🤖 Агенты — список, создание, редактирование
|
||
- ✅ Agent Modal: capabilities, labels, listen modes, prompt, model, token management
|
||
|
||
### Auth & Navigation
|
||
- ✅ Login page
|
||
- ✅ Sidebar с проектами
|
||
- ✅ Mobile viewport fix (100dvh)
|
||
- ✅ No-cache для index.html
|
||
|
||
## Picogent (Pi Agent Core — TypeScript)
|
||
|
||
- ✅ WS transport с auth
|
||
- ✅ Router: pure relay, zero side effects
|
||
- ✅ Agent streaming (start/delta/tool/end)
|
||
- ✅ Config split: agent.json + config.json
|
||
- ✅ Hot config update (config.updated handler)
|
||
- ✅ Anti-loop: ignore agent messages unless @mentioned
|
||
- ✅ Bootstrap context: AGENT.md + memory files
|
||
- ✅ Session compaction via Haiku
|
||
- ✅ Per-project memory (UUID-based dirs)
|
||
- ✅ Auto-reply (if no send_message tool called)
|
||
- ✅ 23 MCP tools: tasks(5), steps(2), messages(2), projects(2), members(1), files(6), task links(3)
|
||
- ✅ systemd template: picogent@.service
|
||
|
||
## Агенты
|
||
|
||
- ✅ Coder: slug=coder, capabilities=[code,review], AGENT.md (BMAD Dev style)
|
||
- ✅ Architect: slug=architect, capabilities=[architecture,review,planning], AGENT.md (BMAD Winston)
|
||
- ✅ Anti-loop rules в обоих AGENT.md
|
||
- ✅ Multi-agent: max 1 exchange per topic
|
||
|
||
## Безопасность
|
||
|
||
- ✅ Path traversal protection (basename + realpath)
|
||
- ✅ Agent sandbox (allowedPaths = [agentHome])
|
||
- ✅ CASCADE delete (tasks → messages, steps)
|
||
- ✅ Auth на всех mutations (get_current_member Depends)
|
||
|
||
---
|
||
|
||
## Запланировано
|
||
|
||
### Фича: RBAC — система прав
|
||
- 💡 Brainstorm: архитектура permissions (roles, per-endpoint checks)
|
||
- 📋 Реализация: таблица roles, role_permissions, middleware
|
||
- 📋 Права для агентов (ограничение действий)
|
||
- 📋 Viewer role (read-only, уже решено концептуально)
|
||
|
||
### Фича: Subtasks (расширение)
|
||
- ✅ parent_id в модели Task
|
||
- ✅ Subtasks section в TaskModal
|
||
- ✅ Create subtask button
|
||
- 📋 Subtasks на kanban доске (индентация или группировка)
|
||
- 📋 Drag & drop subtask в другого родителя
|
||
|
||
### Фича: Task Priorities (расширение)
|
||
- ✅ Priority field в модели + UI
|
||
- 📋 Сортировка по приоритету на доске
|
||
- 📋 Фильтр по приоритету
|
||
|
||
### Фича: PR-flow + Gitea интеграция
|
||
- 💡 Brainstorm: архитектура интеграции с Gitea API
|
||
- 📋 requires_pr flag на задаче
|
||
- 📋 Webhook от Gitea → Tracker (PR created/merged)
|
||
- 📋 Auto-move задачи в review при PR creation
|
||
- 📋 Auto-move в done при PR merge
|
||
|
||
### Фича: Review Iterations
|
||
- 📋 author ≠ reviewer validation
|
||
- 📋 Max 3 review iterations
|
||
- 📋 Review comments → task comments
|
||
|
||
### Фича: Voice Messages
|
||
- 📋 Web: MediaRecorder → upload audio
|
||
- 📋 Audio player в чате
|
||
- 📋 STT транскрипция для агентов (через Thoth)
|
||
- 📋 Android: voice recording
|
||
|
||
### Фича: Telegram Bridge (Picobridge)
|
||
- 📋 Bridge agent (member_type=bridge)
|
||
- 📋 WS → Telegram notifications
|
||
- 📋 Важные события: assigned, mentions
|
||
- 📋 Bidirectional: Telegram → Tracker
|
||
|
||
### Фича: Android Client
|
||
- ✅ Brainstorm завершён (Kotlin + Jetpack Compose)
|
||
- 📋 Создать репо team-board/android
|
||
- 📋 MVP: Kanban + Chat + Voice + Task creation
|
||
|
||
### Фича: Authentik OAuth
|
||
- 📋 OAuth2 flow с auth.uix.su
|
||
- 📋 Auto-create member при первом login
|
||
- 📋 SSO для всех сервисов
|
||
|
||
### Фича: Billing / API Usage
|
||
- 💡 Brainstorm: что считать, как хранить
|
||
- 📋 Tracking token usage per agent
|
||
- 📋 Cost dashboard
|
||
|
||
### Фича: Расширенные зависимости
|
||
- ✅ TaskLink model (blocks, depends_on, relates_to)
|
||
- ✅ UI: colored labels + search autocomplete
|
||
- 📋 Валидация циклических зависимостей
|
||
- 📋 Блокировка взятия задач с незавершёнными зависимостями
|
||
- 📋 Граф зависимостей (визуализация)
|
||
|
||
### Фича: Файлы в задачах
|
||
- 📋 Attachments прямо на задаче (не только в чате)
|
||
- 📋 Drag & drop в TaskModal
|
||
|
||
### Фича: Picogent npm package
|
||
- 📋 bin entry, shebang
|
||
- 📋 Publish в Gitea registry
|
||
|
||
### Фича: Фильтры и поиск
|
||
- 📋 Фильтр задач по assignee, priority, labels на доске
|
||
- 📋 Глобальный поиск задач
|
||
- 📋 Saved filters
|
||
|
||
### Фича: Vector Search (Phase 3)
|
||
- 💡 Когда >20 проектов — RAG для agent memory
|
||
|
||
---
|
||
|
||
## Исследования и заимствования
|
||
|
||
### Google A2A Protocol — что можно взять
|
||
Источник: https://github.com/a2aproject/A2A (RC v1.0)
|
||
|
||
- 💡 **context_id** — кросс-задачный контекст для группировки связанных задач. Агент помнит что TE-5, TE-6, TE-7 — одна история. Наследуется от родителя.
|
||
- 💡 **Extensions framework** — механизм плагинов для агентов:
|
||
- Data-only: метаинформация (стоимость, SLA)
|
||
- Profile: ограничения на формат данных
|
||
- Method Extensions: кастомные API endpoints (git-diff, run-tests)
|
||
- State Machine: кастомные статусы задач
|
||
- 💡 **Agent Card** (`/.well-known/agent.json`) — стандартный формат описания агента для совместимости с внешними A2A-агентами
|
||
- 💡 **Artifact vs Message** — разделение: Message = общение, Artifact = результат работы
|
||
- 💡 **A2A Gateway** — адаптер для интеграции с внешними A2A-совместимыми агентами
|
||
|
||
### Фича: Agent Skills (Inter-agent Method Invocation)
|
||
Вдохновлено: A2A Method Extensions
|
||
|
||
- 💡 `skills` поле в AgentConfig — массив объектов {id, name, description, input_schema, output_schema}
|
||
- 💡 API: `GET /agents/{id}/skills` — список skills агента
|
||
- 💡 API: `POST /agents/{id}/skills/{skill_id}/invoke` — вызов skill
|
||
- 💡 WS event `skill.invoke` → агент получает структурированный запрос
|
||
- 💡 WS event `skill.result` → результат возвращается вызывающему
|
||
- 💡 MCP tool `list_agent_skills(agent)` — агент узнаёт skills других агентов
|
||
- 💡 MCP tool `invoke_skill(agent, skill_id, params)` — формальный вызов
|
||
- 💡 Discovery: skills включаются в auth.ok (bootstrap) для всех участников проекта
|
||
- 💡 Tracker = прокси (маршрутизирует invoke → целевому агенту через WS)
|
||
- 💡 Input/output schema validation на Tracker (до отправки агенту)
|
||
|
||
### Фича: Agent Secrets & Granular Permissions
|
||
Связано с: RBAC, Agent Skills
|
||
|
||
- 💡 **Agent Secrets** — зашифрованное хранилище секретов per-agent (API keys, prod credentials, SSH keys)
|
||
- Секреты доступны ТОЛЬКО агенту-владельцу (не через UI, не другим агентам)
|
||
- Tracker хранит encrypted, агент расшифровывает при получении
|
||
- Управление: admin создаёт/обновляет через UI, агент читает через MCP tool `get_secret(key)`
|
||
- 💡 **Resource Permissions** — какой агент к чему имеет доступ:
|
||
- `prod_deploy` — только deploy-agent
|
||
- `db_write` — только coder (read-only для остальных)
|
||
- `external_api` — только у агента с соответствующим секретом
|
||
- 💡 **Sandbox levels** — расширение текущего allowedPaths:
|
||
- Level 0: только свой agentHome (текущее)
|
||
- Level 1: + project files (read)
|
||
- Level 2: + project files (write) + git
|
||
- Level 3: + system commands (deploy, restart)
|
||
- 💡 Предпосылка для Agent Skills — без permissions skills бесполезны
|
||
|
||
### Фича: Token Budget & Error Recovery
|
||
- 📋 Picogent: graceful error handling при 429/402 от LLM API
|
||
- Системное сообщение в чат: "⚠️ Агент X: rate limit / billing error"
|
||
- Статус агента → `error` (новый MemberStatus)
|
||
- Retry с backoff для 429, полная остановка для 402
|
||
- 📋 Token usage tracking: Picogent считает usage → отправляет в Tracker
|
||
- 📋 UI: расход токенов per agent (dashboard)
|
||
- 📋 Alerts: уведомление при приближении к лимиту (80%, 95%)
|
||
- 💡 Budget limits: max tokens per agent per day/month
|
||
- 💡 Auto-pause: агент автоматически останавливается при достижении лимита
|