Stack AI - індекс

Навігаційна точка входу для Obsidian vault. Головна карта - Canvas.

Карта проєкту

• project-overview - архітектурна карта stack-ai: Legend, Tips, Memory, Supabase, Upstream, LLM providers, runtime і головні ризики.

Глосарій

• glossary - базовий словник термінів: RU, TU, Family, Stack Lady, Lady Legend, ролі, сервіси, runtime, client_id, woman_id, Supabase/vector memory.

Сервіси

• legend-service - Legend API, async jobs, staged pipeline, QA після кожного stage, переклад #fix
• legend-external-week-plan - additional QA план для daily/external Legend validation
• tips-service - актуальний /stack-ai/tips/status і /stack-ai/tips/generate: daily sync, upstream, memory retrieval, assistant workflow, token usage
• tips-memory-controller - HTTP API tips-memory #fix
• assistant-service - генерація через Gemini/xAI із self-improvement loop #fix
• ai-providers - providers Gemini/xAI для structured JSON LLM-викликів #fix
• memory-service - ingest/search chunks у Supabase pgvector
• upstream-service - upstream API layer: profiles, messages, notes, auth forwarding, family routes
• dialog-info-service - завантаження повного діалогу з upstream getFullDialogInfo
• supabase-service - health check Supabase Auth + client_memory_chunks
• token-usage-service - облік токенів LLM-викликів у Supabase #fix

Flow

• daily-sync - раз на добу: профілі RU/TU, фото, нові notes, snapshots і vector memory #fix
• generation-pipeline - клік “Згенерувати” в Electron → sync → retrieval → assistant workflow → token usage
• dialog-status-check - read-only статус даних діалогу в vector DB
• photo-analysis-ingest - TODO: аналіз фото профілю і запис текстового опису в memory

Дані

• memory-chunk - структура chunk у client_memory_chunks #fix
• photo-analysis - TODO: майбутній текстовий опис фото профілю як source='photo'

Система

• runtime - Nest runtime: global prefix, response wrapper, error convention, validation, Swagger, CORS
• auth - AuthGuard + RolesGuard + @ApiRoles; без @ApiRoles endpoint публічний по ролі
• supabase - детальна документація бази: підключення, таблиці, ingest, search, RPC, daily snapshots, token usage #fix
• config - env getters для tips-memory, providers і Supabase

API

Swagger UI локально: http://localhost:3001/stack-ai/api-docs.

Markdown-доки описують бізнес-логіку, базу і flows. Контракт DTO залишається у Swagger.