Optimized Prompts: - Create utils/rag_prompt_builder.py with citation-optimized prompts - Specialized for DAO tokenomics and technical documentation - Proper citation format [1], [2] with doc_id, page, section - Memory context integration (facts, events, summaries) - Token count estimation RAG Service Metrics: - Add comprehensive logging in query_pipeline.py - Log: question, doc_ids, scores, retrieval method, timing - Track: retrieval_time, total_query_time, documents_found, citations_count - Add metrics in ingest_pipeline.py: pages_processed, blocks_processed, pipeline_time Router Improvements: - Use optimized prompt builder in _handle_rag_query() - Add graceful fallback: if RAG unavailable, use Memory only - Log prompt token count, RAG usage, Memory usage - Return detailed metadata (rag_used, memory_used, citations_count, metrics) Evaluation Tools: - Create tests/rag_eval.py for systematic quality testing - Test fixed questions with expected doc_ids - Save results to JSON and CSV - Compare RAG Service vs Router results - Track: citations, expected docs found, query times Documentation: - Create docs/RAG_METRICS_PLAN.md - Plan for Prometheus metrics collection - Grafana dashboard panels and alerts - Implementation guide for metrics
Документація MicroDAO & DAARION.city
Ця папка містить всю документацію проєкту, організовану за категоріями.
📁 Структура документації
/microdao/ — Документація MicroDAO
Архітектура, RBAC, токеноміка, технічні специфікації MicroDAO.
Ключові документи:
architecture.md— загальна архітектура системиrbac.md— система ролей та доступів (RBAC, Confidential Mode)access-keys-capabilities.md— система ключів доступу та capabilities
Детальна технічна документація: /cursor/ (61 документ для розробників)
/daarion/ — Документація DAARION.city
Roadmap, governance, токеноміка міста, інтеграція з MicroDAO.
Ключові документи:
integration-microdao.md— інтеграція DAARION.city з MicroDAOplatforms-catalog.md— каталог платформ (GREENFOOD, EnergyUnion, WaterUnion)tokenomics-city.md— токеноміка міста (DAAR, DAARION)
/agents/ — Документація агентської системи
DAGI Router, DevTools Agent, CrewAI Orchestrator.
Структура:
dagi-router.md— архітектура DAGI Routerdevtools-agent.md— DevTools Agentcrewai-orchestrator.md— CrewAI інтеграція
/cursor/ — Технічна документація для розробки
61 документ з детальними специфікаціями для Cursor AI та розробників.
Категорії:
- 00-07: Фундамент (overview, product brief, architecture, API, UI/UX, coding standards, tasks, testing)
- 08-13: Агентська система (onboarding, evolutionary agent, UI, LLM, runtime core, memory)
- 14-24: Модулі та інтерфейс (messenger, projects, follow-ups, co-memory, governance, notifications, integrations, agent-only interface, operator modes, domains/wallet/DAO, agent cards)
- 24-50: Інфраструктура та сервіси (access keys, deployment, security, database, flows, scaling, cost optimization, governance policies, PDP, API Gateway, service mesh, agent isolation, tools, lifecycle, templates, RWA, AI governance, NATS, outbox, usage, LLM proxy, router, messaging, teams, wallet, website integration)
Детальний опис: /cursor/README.md
🚀 Швидкий старт
Для розробників
- Почни з
/cursor/00_overview_microdao.md— загальний огляд - Вивчи
/cursor/01_product_brief_mvp.md— product requirements - Переглянь
/cursor/03_api_core_snapshot.md— API контракти - Дотримуйся
/cursor/05_coding_standards.md— стандарти кодування
Для архітекторів
/microdao/architecture.md— архітектура MicroDAO/microdao/rbac.md— система доступів/daarion/integration-microdao.md— інтеграція з DAARION.city/cursor/34_internal_services_architecture.md— архітектура сервісів
Для product/growth
/daarion/tokenomics-city.md— токеноміка міста/daarion/platforms-catalog.md— каталог платформ/cursor/MVP_VERTICAL_SLICE.md— план MVP
📚 Посилання на повну документацію
- MicroDAO документація
- DAARION.city документація
- Агентська система
- Технічна документація для розробки
🔄 Версіонування
Вся документація зберігається в Git репозиторії. Для оновлення:
git pull origin main
📝 Внесок у документацію
Див. CONTRIBUTING_DOCS.md для інструкцій з оновлення документації.
Останнє оновлення: 2024-11-14
Версія: 1.0.0