How bluesky-social/indigo works
High-Level Architecture Components
The system should be divided into these main components:
a) Core Services:
• BigSky (BGS) - Graph service
• Palomar - Full-text search service
• Hepa - Auto-moderation service
b) Core Libraries:
• API Packages (atproto, bsky)
• Identity Management
• Cryptographic Operations
• Repository Management
• Protocol Syntax
• Data Structures (MST)
Component Relationships
[External Clients/Apps] <---> [API Layer (XRPC)]
• ↓
[Core Services Layer]
• BigSky (Social Graph)
• Palomar (Search)
• Hepa (Moderation)
• ↓
[Core Libraries Layer]
• Identity (DID/Handle Resolution)
• Crypto (Signing/Keys)
• Repo (Data Storage)
• MST (Merkle Search Tree)
• Syntax (Protocol Parsing)
• ↓
[Storage/Infrastructure Layer]
• Redis
• Database
• Event System
Detailed Component Breakdown
For each major service:
BigSky (BGS):
• Connections to repo management
• Event processing system
• Social graph data flow
• Integration with identity services
Palomar:
• Search indexing flow
• Query processing
• Integration with storage
• Full-text search components
Hepa:
• Moderation rules engine
• Event processing
• Integration with Ozone
• Auto-moderation flow
Cross-Cutting Concerns
Aspects across all components:
• Metrics/Monitoring
• Authentication/Authorization
• Event Processing
• Caching Layers
Data Flow Indicators
Show:
• API request/response paths
• Event propagation
• Data persistence flows
• Authentication flows
Integration Points
Highlight:
• External API endpoints
• Inter-service communication
• Storage interfaces
• Event bus connections
Specific Implementation Details
Include:
• XRPC client/server communication
• DID resolution flow
• Repository management
• Cryptographic operations flow
Remember to emphasize the modular nature of the system and how components can be deployed independently while maintaining protocol compatibility.
This architecture represents a distributed system implementing the AT Protocol, focusing on scalability, security, and maintainability while enabling social networking features through a decentralized approach.