Amebo Architecture¶
Understanding Amebo's internal architecture and design decisions.
High-Level Architecture¶
graph TB
A[HTTP API] --> B[Router]
B --> C[Authentication]
B --> D[Event Handler]
B --> E[Application Handler]
D --> F[Schema Validator]
D --> G[Event Store]
D --> H[Webhook Dispatcher]
G --> I[Database]
H --> J[External Services]Core Components¶
HTTP Server¶
- FastAPI-based REST API
- JWT authentication
- Request validation
- Error handling
Event Processing¶
- Schema validation using JSON Schema
- Asynchronous event publishing
- Batch processing for performance
- Retry logic for failed deliveries
Database Layer¶
- PostgreSQL for production
- SQLite for development
- Connection pooling
- Migration support
Webhook Delivery¶
- Asynchronous delivery
- Exponential backoff retry
- Signature verification
- Dead letter queue
Design Principles¶
- Simplicity: Only 4 core concepts
- Performance: Sub-10ms response times
- Reliability: ACID transactions and retries
- Scalability: Horizontal scaling support