Files

Apple c552199eed chore: organize documentation structure for monorepo

- Create /docs structure (microdao, daarion, agents)
- Organize 61 cursor technical docs
- Add README files for each category
- Copy key documents to public categories
- Add GitHub setup instructions and scripts

2025-11-15 04:08:35 -08:00

8.8 KiB

Raw Blame History

🚀 microDAO2 — Швидкий контекст проєкту

Для швидкого посилання в чатах та Cursor

📍 Де знаходиться проєкт

Повний шлях:

/Users/apple/Desktop/MicroDAO/MicroDAO 3

Швидкий доступ:

Символічне посилання: ~/Desktop/MicroDAO-QuickAccess
Spotlight: ⌘ + Space → "MicroDAO 3"

📚 Документація для Cursor

Основна папка:

docs/cursor/

Ключові документи:

Фундамент (01-13)

00_overview_microdao.md — Загальний огляд
01_product_brief_mvp.md — Product requirements
02_architecture_basics.md — Технічна архітектура
03_api_core_snapshot.md — API контракти
04_ui_ux_onboarding_chat.md — UI/UX специфікація
05_coding_standards.md — Стандарти кодування
06_tasks_onboarding_mvp.md — Технічні задачі
07_testing_checklist_mvp.md — Тестовий чеклист

Агентська система (08-13)

08_agent_first_onboarding.md — Агентський онбординг
09_evolutionary_agent.md — Еволюційний агент
10_agent_ui_system.md — Агентський UI
11_llm_integration.md — Інтеграція LLM
12_agent_runtime_core.md — Agent Runtime Core
13_agent_memory_system.md — Система пам'яті агентів

Модулі та інтерфейс (14-24)

14_messenger_agent_module.md — Агент-месенджер
15_projects_agent_module.md — Агент-проєктний менеджер
16_followups_reminders_agent.md — Агент нагадувань та фоллоуапів
17_comemory_knowledge_space.md — Co-Memory та Knowledge Space
18_governance_access_agent.md — Governance & Access Agent
19_notifications_attention_agent.md — Notifications & Attention Agent
20_integrations_bridges_agent.md — Integrations & Bridges Agent
21_agent_only_interface.md — Agent-Only Interface
22_operator_modes_and_system_agents.md — Operator Modes & System Agents
22_agent_only_interface_tasks.md — Задачі для Agent-Only Interface
23_domains_wallet_dao_deepdive.md — Domains, Wallet & DAO Deep Dive
23_agent_cards_and_console.md — Живі картки агентів та Console
24_agent_cards_tasks.md — Задачі для Agent Cards
24_access_keys_capabilities_system.md — Access Keys & Capabilities System

DAARION.city та платформи

DAARION_city_integration.md — Інтеграція DAARION.city
DAARION_city_platforms_catalog.md — Каталог платформ DAARION.city

Deployment, Infrastructure та Database

25_deployment_infrastructure.md — Deployment процес, середовища, CI/CD, моніторинг
26_security_audit.md — Безпековий чеклист для аудитування
27_database_schema_migrations.md — Повна схема БД та міграції
28_flows_wallet_embassy_energy_union.md — Sequence-діаграми критичних потоків
29_scaling_and_high_availability.md — Масштабування та висока доступність
30_cost_optimization_and_token_economics_infrastructure.md — Оптимізація витрат та токеноміка
31_governance_policies_for_capabilities_and_quotas.md — Політики DAO для управління доступами та квотами
32_policy_service_PDP_design.md — Архітектура Policy Decision Point
33_api_gateway_security_and_pep.md — API Gateway Architecture та Policy Enforcement Point
34_internal_services_architecture.md — Архітектура внутрішніх сервісів (17 сервісів)
35_microdao_service_mesh_design.md — MicroDAO Service Mesh (zero-trust, mTLS, observability)
36_agent_runtime_isolation_and_sandboxing.md — Безпечна ізоляція агентів та sandbox-модель
37_agent_tools_and_plugins_specification.md — Специфікація інструментів та плагінів агентів
38_private_agents_lifecycle_and_management.md — Життєвий цикл приватних агентів
39_private_agent_templates_and_behavior_profiles.md — Шаблони агентів та поведінкові профілі
40_rwa_energy_food_water_flow_specs.md — Потоки RWA (енергія, їжа, вода)
41_ai_governance_agent_design.md — AI Governance Agent (політики, голосування, застосування правил)
42_nats_event_streams_and_event_catalog.md — NATS Event Streams та Event Catalog
43_database_events_outbox_design.md — Outbox Pattern (транзакційна доставка подій)
44_usage_accounting_and_quota_engine.md — Usage Accounting & Quota Engine
45_llm_proxy_and_multimodel_routing.md — LLM Proxy & Multi-Model Routing
46_router_orchestrator_design.md — Router Orchestrator Design
47_messaging_channels_and_privacy_layers.md — Messaging Channels & Privacy Layers
48_teams_access_control_and_confidential_mode.md — Teams Access Control & Confidential Mode
49_wallet_rwa_payouts_claims.md — Wallet, RWA, Payouts & Claims
50_daarion_city_website_integration.md — DAARION.city Website Integration
docs/tokenomics/README.md — Unified Tokenomics for DAARION.city & MicroDAO
docs/tokenomics/city-tokenomics.md — City Tokenomics — DAARION.city
docs/integration-daarion.md — Integration Guide: MicroDAO → DAARION.city
docs/agents.md — Agents Map — DAARION.city (A1-A4 hierarchy)
docs/api.md — API Reference — DAARION.city & MicroDAO (MVP endpoints)

Повний список: docs/cursor/README.md

🗂️ Структура проєкту

MicroDAO 3/
├── docs/
│   ├── cursor/              # Документація для Cursor (17+ документів)
│   └── microdao_project_notes.ipynb  # Jupyter ноутбук
├── src/
│   ├── api/                 # API клієнти
│   ├── components/          # React компоненти
│   │   └── onboarding/      # Компоненти онбордингу
│   ├── hooks/               # React hooks
│   ├── pages/               # Сторінки
│   └── types/                # TypeScript типи
├── package.json
├── vite.config.ts
└── PROJECT_CONTEXT.md       # Цей файл

🎯 Поточний статус

✅ Завершено

Документація для Cursor (17 документів)
Онбординг компоненти (6 кроків)
API клієнти (teams, channels, agents, auth)
Git репозиторій ініціалізовано
Dev server налаштовано

⏳ В процесі

Реалізація Agent-Only Interface (4 задачі)
Інтеграція LLM
Система пам'яті агентів

📋 Заплановано

Projects Agent Module (15)
Follow-ups Agent (16)
Co-Memory Agent (17)
Governance Agent (18)
Notifications Agent (19)
Integrations Agent (20)

🔗 Швидкі посилання

Для Cursor

Додай в контекст: /Users/apple/Desktop/MicroDAO/MicroDAO 3/docs/cursor/

Для розробки

cd "/Users/apple/Desktop/MicroDAO/MicroDAO 3"
npm install
npm run dev

Відкрити в браузері

Головна: http://localhost:3000
Онбординг: http://localhost:3000/onboarding

📝 Як посилатись на проєкт

В чатах з Cursor / AI

Просто скопіюй:

Проєкт: microDAO2
Шлях: /Users/apple/Desktop/MicroDAO/MicroDAO 3
Документація: docs/cursor/ (31 документ)

Або коротко:

microDAO2: /Users/apple/Desktop/MicroDAO/MicroDAO 3

Для швидкого старту

Використовуй: PROJECT_CONTEXT.md в корені проєкту

🛠️ Технології

Frontend: React 18, TypeScript, Vite, Tailwind CSS
Backend: API Gateway https://api.microdao.xyz/v1
State: React Query, Zustand/Context
LLM: OpenAI (інтеграція через backend)

📖 Корисні файли

QUICK_START.md — Швидкий старт
PROJECT_INFO.md — Інформація про проєкт
GIT_SETUP.md — Налаштування Git
STATUS.md — Статус проєкту
docs/cursor/README.md — Навігація по документації

Останнє оновлення: 2024-11-13

8.8 KiB Raw Blame History Unescape Escape