ATOM SaaS Documentation Index
**Last Updated:** 2026-04-05
**Version:** v11.2
📚 Quick Navigation
Getting Started
- **Marketplace Quick Start** - Get started with marketplace in 5 minutes ⭐ NEW
- **Marketplace User Guide** - Comprehensive marketplace guide ⭐ NEW
- **Quick Start Guide** - Platform quick start
- **Architecture Overview** - System architecture overview
- **Single-App Architecture** - Unified container model ⭐ NEW
- **Brain Systems** - AI brain systems documentation
- **BYOK Stabilization Report** - Tenant-scoped security & system health ⭐ NEW
Marketplace & Federation ⭐ NEW
- **Marketplace Architecture** - Marketplace system design and data flow
- **Federation Protocol** - Cross-instance federation protocol
- **Developer Guide** - API reference and authentication
- **Integration Guide** - Implementation patterns and code examples
- **Marketplace API** - Complete REST API documentation
Platform Documentation
- **Deployment** - Production deployment guides
- **Integrations** - Integration system documentation (569+ integrations)
- **API Reference** - API documentation
- **Testing** - Testing guides and coverage
---
🛒 Marketplace & Federation ⭐ NEW
User Documentation
- **Marketplace Quick Start** - Get started in 5 minutes (497 lines)
- **Marketplace User Guide** - Comprehensive guide (2,150 lines)
- All 4 marketplace types: Agent, Skill, Canvas, Domain
- Step-by-step workflows for browsing, publishing, installing
- Code examples in Python, JavaScript, Go, cURL
- CLI automation examples
- Troubleshooting guide
Architecture & Protocol
- **Marketplace Architecture** - System design (23,985 lines)
- 4 marketplace types architecture
- Data flow diagrams (publish, approve, install, rate)
- Federation protocol architecture
- Security model and threat analysis
- **Federation Protocol** - Cross-instance communication (23,203 lines)
- REST API specification
- Authentication (X-Federation-Key)
- Bundle format and schema
- Security best practices
Developer Documentation
- **Developer Guide** - API reference (21,720 lines)
- Authentication methods
- All API endpoints with examples
- Error codes and troubleshooting
- Rate limiting and quotas
- **Integration Guide** - Implementation patterns (28,533 lines)
- Integration patterns (Direct API, SDK, Webhook, Federation)
- Complete workflow examples
- Testing strategies
- Deployment configurations
- Performance optimization
- **Marketplace API** - REST API reference (66,685 lines)
- All endpoints documented
- Request/response examples
- Error codes and troubleshooting
---
🎯 Core Documentation
Platform Architecture
- **Architecture Overview** - Complete system architecture
- **Single-App Architecture** - Unified container model (Next.js + FastAPI) ⭐ NEW
- **Architectural Economics** - Cost and performance considerations
- **Data Flow Architecture** - Data flow patterns
- **Billing Architecture** - Multi-tenant billing system
- **AI World Model** - AI memory and learning systems
Brain Systems (Cognitive Architecture)
- **Brain Systems Overview** - All 6 brain systems documented
- Cognitive Architecture
- Learning & Adaptation Engine
- World Model (Long-term Memory)
- Reasoning Engine
- Cross-System Reasoning
- Episodic Memory & Graduation
Standards & Best Practices
- **API Response Standard** - API response formatting
- **Auth Error Standard** - Authentication error handling
- **Database Query Standard** - Database query patterns
- **Email Service Standard** - Email service patterns
- **Frontend State Standard** - State management patterns
---
🔧 Development Documentation
Development Standards
- **Development Standards** - Coding standards and conventions
- **SDLC Agents** - AI-powered development lifecycle
- **Local Setup** - Development environment setup
- **Tenant Isolation** - Multi-tenant patterns
Testing
- **Testing Coverage** - Coverage reports and goals
- **Test Coverage Roadmap** - Coverage improvement plans
- **E2E Testing Guide** - End-to-end testing
- **Coverage Monitoring** - Coverage tracking
- **CI/CD Coverage Enforcement** - Automated coverage checks
---
🚀 Deployment Documentation
Production Deployment
- **Production Runbook** - Production operations guide
- **Deployment Guide** - Step-by-step deployment
- **Deployment Verification** - Post-deployment checks
- **Infrastructure Troubleshooting** - Common deployment issues
Infrastructure Setup
- **Production Setup Guide** - Production environment setup
- **Desktop Hosting Setup** - Desktop app deployment
- **AWS Deployment** - AWS infrastructure setup
- **AWS SES Setup** - Email service configuration
- **Stripe Setup** - Payment processing setup
- **EventBridge Setup** - Event-driven architecture
- **Scaling System** - Auto-scaling configuration
---
🔌 Integrations Documentation
Integration System
- **Integrations Overview** - Integration system architecture
- **Integration Credentials** - Credential management
- **Integrations List** - All 569+ integrations
- **Package Management** - Python/NPM package security
Key Integrations
- **WhatsApp Business** - WhatsApp integration guide
- **Agent Integration** - Agent integration patterns
- **Canvas & Visual Builder** - Canvas API reference
- **Workflow Builder** - Workflow automation
- **Marketplace** - Skill marketplace
- **Telegram** - Telegram integration
Media & Creative Tools
- **Media Integration** - Media platform integrations
- **Creative Tools** - Creative software integrations
---
📖 API Documentation
External APIs
- **External API** - External API overview
- **External API Examples** - Usage examples
- **API Development Guidelines** - API design standards
Public APIs
- **Public Marketplace API** - Marketplace REST API
- **Marketplace Authentication** - OAuth setup
---
🎓 User Guides
Platform Usage
- **Personal Edition** - Personal edition setup
- **Personal Edition Examples** - Usage examples
- **Personal Edition Parity** - Feature comparison
Smart Home
- **Smart Home Integration** - Smart home setup
- **Smart Home Automation** - Automation examples
- **Voice Control** - Voice commands
- **Troubleshooting** - Common issues
---
🔒 Security Documentation
- **Security Overview** - Security architecture
- **Terminal Security** ----
📐 Architecture Documentation
Core Architecture
- **Architecture Overview** - Complete system architecture
- **Single-App Architecture** - Unified container model (Next.js + FastAPI) ⭐ NEW
- **Multi-Tenant Patterns** - Tenant isolation and data sovereignty
- **Governance Architecture** - Maturity gating and agent governance
Graph & Data Storage
- **PostgreSQL Graph Architecture** - Graph database setup
- **V2 Graph Architecture** - V2 improvements
- **Graph Storage Comparison** - Storage options
Feature Architecture
- **Auto-Dev Architecture** - Autonomous development system
- **Marketplace Architecture** - Distributed marketplace design
---
🔧 Development Documentation
Development Standards
- **Development Standards** - Coding standards and conventions
- **SDLC Agents** - AI-powered development lifecycle
- **TDD Patterns** - Test-driven development for AI stability
- **Regression Prevention** - Defensive coding and monitoring
- **Local Setup** - Development environment setup
Technical Guides
- **Auto-Dev Developer Guide** - Building with autonomous agents
- **Historical Sync Debugging** - Troubleshooting sync jobs
- **Graph Diagnosis** - Knowledge graph health checks
- **Frontend-Backend Unification** - Shared types and protocol
---
📖 API Documentation
System Protocols
- **Auto-Dev Event Protocol** - Event-driven agent communication
- **Federation Protocol** - Cross-instance synchronization
External APIs
- **External API Overview** - Integration API guide
- **Auto-Dev API Reference** - Full reference for autonomous dev
---
🎓 Guides
Integration Guides
- **Integration Guide** - Core integration patterns
- **Auto-Dev Integration Guide** - Adding agents to workflows
- **WhatsApp Setup Guide** - Business messaging setup
User & Admin Guides
- **User Guide** - Platform-wide user manual
- **Auto-Dev User Guide** - Using autonomous developers
- **Training Maturity Admin Guide** - Managing agent growth
- **Training Workflows User Guide** - User training guide
---
🗃️ Archived Documentation
Legacy Documentation
- **Archived Session Reports** - Historical implementation summaries
- **Incident Reports** - Post-mortems and RCA reports
- **OAuth Migration Plans** - Completed security updates
---
📝 Documentation Maintenance
Documentation Standards
- Keep documentation up-to-date with code changes
- Use clear, concise language
- Include code examples where helpful
- Maintain consistent formatting
- Archive obsolete documentation rather than deleting
Adding New Documentation
- Place in appropriate category directory
- Add entry to this index
- Follow existing formatting conventions
- Include "Last Updated" date
- Archive related old documentation
---
🔍 Quick Search
By Topic
- **Marketplace & Federation:** See "Marketplace & Federation" section above
- **Deployment:**
deployment/ - **Testing:**
testing/ - **Integrations:**
integrations/ - **Architecture:**
core/,architecture/ - **API:**
api/
By File Type
- **Guides:**
guides/,user-guides/ - **Standards:**
core/*STANDARD.md - **Reference:**
api/,integrations/*API*.md - **Archive:**
archive/
Search Guide
**Looking for marketplace documentation?**
- Start here: Marketplace Quick Start
- User guide: guides/user_guide.md
- Developer reference: development/developer_guide.md
- API docs: api/marketplace-api.md
**Looking for architecture?**
- System overview: core/ARCHITECTURE.md
- Marketplace: architecture/marketplace_architecture.md
- Federation: api/federation_protocol.md
**Looking for how to integrate?**
- Implementation patterns: guides/integration_guide.md
- API reference: development/developer_guide.md
- Code examples: All marketplace docs include Python, JavaScript, Go, cURL examples
**Looking for deployment?**
- Production: deployment/PRODUCTION_RUNBOOK.md
- Setup: deployment/deployment_guide.md
**Looking for testing?**
---
📞 Support
For questions or issues:
- Check the Troubleshooting section
- Review Production Runbook
- Check E2E Testing Guide
- See Marketplace User Guide for marketplace troubleshooting
---
**Maintained By:** Development Team
**Documentation License:** See project LICENSE file