Files
microdao-daarion/docs
Apple 1ed1181105 feat: add RAG quality metrics, optimized prompts, and evaluation tools
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
2025-11-16 05:12:19 -08:00
..

Документація 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 з MicroDAO
  • platforms-catalog.md — каталог платформ (GREENFOOD, EnergyUnion, WaterUnion)
  • tokenomics-city.md — токеноміка міста (DAAR, DAARION)

/agents/ — Документація агентської системи

DAGI Router, DevTools Agent, CrewAI Orchestrator.

Структура:

  • dagi-router.md — архітектура DAGI Router
  • devtools-agent.md — DevTools Agent
  • crewai-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

🚀 Швидкий старт

Для розробників

  1. Почни з /cursor/00_overview_microdao.md — загальний огляд
  2. Вивчи /cursor/01_product_brief_mvp.md — product requirements
  3. Переглянь /cursor/03_api_core_snapshot.md — API контракти
  4. Дотримуйся /cursor/05_coding_standards.md — стандарти кодування

Для архітекторів

  1. /microdao/architecture.md — архітектура MicroDAO
  2. /microdao/rbac.md — система доступів
  3. /daarion/integration-microdao.md — інтеграція з DAARION.city
  4. /cursor/34_internal_services_architecture.md — архітектура сервісів

Для product/growth

  1. /daarion/tokenomics-city.md — токеноміка міста
  2. /daarion/platforms-catalog.md — каталог платформ
  3. /cursor/MVP_VERTICAL_SLICE.md — план MVP

📚 Посилання на повну документацію

🔄 Версіонування

Вся документація зберігається в Git репозиторії. Для оновлення:

git pull origin main

📝 Внесок у документацію

Див. CONTRIBUTING_DOCS.md для інструкцій з оновлення документації.


Останнє оновлення: 2024-11-14
Версія: 1.0.0