daarion-admin/microdao-daarion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
742c238b3bc771308f16e7333c105f65180f94b6
microdao-daarion/docs/INDEX.md
Apple 3de3c8cb36 feat: Add presence heartbeat for Matrix online status 
- matrix-gateway: POST /internal/matrix/presence/online endpoint
- usePresenceHeartbeat hook with activity tracking
- Auto away after 5 min inactivity
- Offline on page close/visibility change
- Integrated in MatrixChatRoom component
2025-11-27 00:19:40 -08:00

225 lines
6.8 KiB
Markdown
Raw Blame History

# DAARION Documentation Index
**Quick navigation for all documentation**
---
## 🚀 Quick Start
### For New Developers
1. [PROJECT_CONTEXT.md](../PROJECT_CONTEXT.md) — Project overview
2. [INFRASTRUCTURE.md](../INFRASTRUCTURE.md) — Servers, ports, services
3. [docs/cursor/README.md](./cursor/README.md) — Cursor AI documentation (72 docs)
### For Implementation
1. [docs/tasks/README.md](./tasks/README.md) — **Cursor-ready tasks** ⭐
2. [MESSAGING_ARCHITECTURE.md](./MESSAGING_ARCHITECTURE.md) — Complete tech spec
3. [MESSENGER_TESTING_GUIDE.md](./MESSENGER_TESTING_GUIDE.md) — Testing guide
---
## 📋 Cursor Tasks (New!)
**Ready-to-use tasks for Cursor AI:**
### Priority 1: Agent Integration
- [TASK_PHASE2_AGENT_INTEGRATION.md](./tasks/TASK_PHASE2_AGENT_INTEGRATION.md)
- 4 weeks, High priority
- agent_filter + DAGI Router + agent-runtime
- Makes Messenger agent-aware
### Priority 2: Agent Hub
- [TASK_AGENT_HUB_MVP.md](./tasks/TASK_AGENT_HUB_MVP.md)
- 2 weeks, High priority
- Main interface for working with agents
- Reuses Messenger components
---
## 🏗️ Architecture
### Core Specs
- [MESSAGING_ARCHITECTURE.md](./MESSAGING_ARCHITECTURE.md) — Messenger + Matrix + Agents (110+ KB)
- [MESSENGER_COMPLETE_SPECIFICATION.md](./MESSENGER_COMPLETE_SPECIFICATION.md) — Master doc
- [messaging-erd.dbml](./messaging-erd.dbml) — Database ERD (dbdiagram.io format)
### Technical Docs
- [INFRASTRUCTURE.md](../INFRASTRUCTURE.md) — Servers, nodes, ports, services
- [infrastructure_quick_ref.ipynb](./infrastructure_quick_ref.ipynb) — Quick reference notebook
---
## 📚 Cursor AI Documentation (72 docs)
**See:** [docs/cursor/README.md](./cursor/README.md)
### Key Documents
1. **MVP & Architecture (00-07)**
- `00_overview_microdao.md` — System overview
- `01_product_brief_mvp.md` — Product requirements
- `02_architecture_basics.md` — Technical architecture
- `03_api_core_snapshot.md` — API contracts
- `MVP_VERTICAL_SLICE.md` — Implementation plan
2. **Agent System (08-24)**
- `12_agent_runtime_core.md` — Agent Runtime Core
- `13_agent_memory_system.md` — Memory system
- `21_agent_only_interface.md` — Agent-Only Interface
- `22_operator_modes_and_system_agents.md` — System agents
3. **Infrastructure (25-50)**
- `25_deployment_infrastructure.md` — Deployment
- `27_database_schema_migrations.md` — Database schema
- `34_internal_services_architecture.md` — 17 services
- `42_nats_event_streams_and_event_catalog.md` — NATS events
---
## 🔧 Implementation Guides
### Completed Modules
- [MESSENGER_MODULE_COMPLETE.md](./MESSENGER_MODULE_COMPLETE.md) — Phase 1 summary
- Database schema
- messaging-service
- Frontend UI
- WebSocket real-time
### In Progress
- [tasks/TASK_PHASE2_AGENT_INTEGRATION.md](./tasks/TASK_PHASE2_AGENT_INTEGRATION.md) — Agent integration
- [tasks/TASK_AGENT_HUB_MVP.md](./tasks/TASK_AGENT_HUB_MVP.md) — Agent Hub UI
---
## 🧪 Testing
### Messenger Testing
- [MESSENGER_TESTING_GUIDE.md](./MESSENGER_TESTING_GUIDE.md) — 13 test scenarios
- Basic messaging
- Element compatibility
- Agent posting
- WebSocket
- E2EE channels
### General Testing
- [cursor/07_testing_checklist_mvp.md](./cursor/07_testing_checklist_mvp.md) — MVP checklist
---
## 📊 Data Models
### Database
- [messaging-erd.dbml](./messaging-erd.dbml) — **Messenger ERD** (paste to dbdiagram.io)
- [cursor/27_database_schema_migrations.md](./cursor/27_database_schema_migrations.md) — Full schema
### API
- [cursor/03_api_core_snapshot.md](./cursor/03_api_core_snapshot.md) — Core API
- [services/matrix-gateway/API_SPEC.md](../services/matrix-gateway/API_SPEC.md) — Matrix Gateway
---
## 🎯 Roadmap & Plans
### Current Phase
- ✅ Phase 1: Messenger Core (Complete)
- 📋 Phase 2: Agent Integration (Next)
- 📋 Phase 2.5: Agent Hub (Parallel)
### Planning Docs
- [MVP_VERTICAL_SLICE.md](./cursor/MVP_VERTICAL_SLICE.md) — MVP plan
- [PLAN_MODULES.md](./cursor/PLAN_MODULES.md) — Module plans
- [ACTION_PLAN.md](./ACTION_PLAN.md) — Action plan
---
## 🔐 Security & Infrastructure
### Security
- [cursor/26_security_audit.md](./cursor/26_security_audit.md) — Security checklist
- [cursor/33_api_gateway_security_and_pep.md](./cursor/33_api_gateway_security_and_pep.md) — API security
### Infrastructure
- [cursor/25_deployment_infrastructure.md](./cursor/25_deployment_infrastructure.md) — Deployment
- [cursor/29_scaling_and_high_availability.md](./cursor/29_scaling_and_high_availability.md) — Scaling
---
## 🌐 Integration Guides
### DAARION.city
- [DAARION_city_integration.md](./cursor/DAARION_city_integration.md) — City integration
- [DAARION_city_platforms_catalog.md](./cursor/DAARION_city_platforms_catalog.md) — Platforms
### External Systems
- [cursor/20_integrations_bridges_agent.md](./cursor/20_integrations_bridges_agent.md) — Bridges
- [cursor/40_rwa_energy_food_water_flow_specs.md](./cursor/40_rwa_energy_food_water_flow_specs.md) — RWA
---
## 💰 Tokenomics
### Core Docs
- [tokenomics/city-tokenomics.md](./tokenomics/city-tokenomics.md) — ⭐ CANONICAL
- [cursor/30_cost_optimization_and_token_economics_infrastructure.md](./cursor/30_cost_optimization_and_token_economics_infrastructure.md)
---
## 📝 Quick Reference
### Files by Type
#### Configuration
- `../package.json` — Frontend dependencies
- `../vite.config.ts` — Vite config
- `../docker-compose.messenger.yml` — Messenger stack
- `../docker-compose.agents.yml` — Agent services (to be created)
#### Migrations
- `../migrations/001_create_messenger_schema.sql` — Messenger DB
#### Services
- `../services/messaging-service/` — Messaging API
- `../services/matrix-gateway/` — Matrix adapter
- `../services/city-service/` — City API
- `../services/space-service/` — Space API
#### Frontend
- `../src/features/messenger/` — Messenger UI
- `../src/features/city/` — City Dashboard
- `../src/features/space-dashboard/` — Space Dashboard
- `../src/features/onboarding/` — Onboarding
---
## 🔍 Search Tips
### Find by Topic
- **Messenger:** Search for "messaging", "Matrix", "channels"
- **Agents:** Search for "agent", "runtime", "LLM"
- **Infrastructure:** Search for "deployment", "docker", "NATS"
- **Security:** Search for "security", "PDP", "capabilities"
### Find by File Type
- `.md` — Documentation
- `.dbml` — Database models
- `.sql` — Migrations
- `.ipynb` — Jupyter notebooks
- `.yml` — Docker configs
---
## 📞 Support
### Documentation Issues
- Check [cursor/README.md](./cursor/README.md) for navigation
- Use [PROJECT_CONTEXT.md](../PROJECT_CONTEXT.md) for quick context
### Implementation Help
- Start with [tasks/README.md](./tasks/README.md)
- Review [MESSAGING_ARCHITECTURE.md](./MESSAGING_ARCHITECTURE.md) for technical details
---
**Last Updated:** 2025-11-24
**Version:** 1.1.0
**Maintainer:** DAARION Platform Team
Reference in New Issue View Git Blame Copy Permalink