Infrastructure & Operations Overview
Infrastructure & Operations Overview
Complete technology stack, infrastructure architecture, and operational tooling for the ReptiDex platform.
Quick Navigation
Tech Stack
Languages & frameworks
Architecture
System design & deployment
Infrastructure
AWS services & hosting
Operations
Monitoring & DevOps
Current Infrastructure: ReptiDex is deployed on AWS using ECS Fargate for serverless container orchestration, with host-based routing via Application Load Balancer. All services run on ARM64 Graviton2 processors for cost optimization. Infrastructure is fully managed via CloudFormation templates.For detailed deployment information, see Current Deployment Guide.
Technology Stack
Overview
ReptiDex is built on a modern, scalable technology stack designed for rapid development, high performance, and long-term maintainability.Backend Services
Python 3.11+ with FastAPI framework for high-performance APIs and microservices architecture
Frontend Applications
Vite + React 19 with TypeScript and Tailwind CSS for modern, responsive web applications
Database & Storage
PostgreSQL 15+ for relational data with Redis for caching and S3 for media storage
Technology Matrix
- Backend Technologies
- Frontend Technologies
- Development Tools
Core Backend Stack
| Technology | Version | Usage | Purpose |
|---|---|---|---|
| Python | 3.12+ | All backend services | Primary programming language |
| FastAPI | 0.115+ | API framework | High-performance REST APIs |
| Pydantic | 2.10+ | Data validation | Request/response models |
| Pydantic Settings | 2.6+ | Configuration management | Settings and environment variables |
| SQLAlchemy | 2.0+ | ORM | Database abstraction layer |
| Alembic | 1.14+ | Database migrations | Schema version control |
| Asyncpg | 0.29+ | Database driver | Async PostgreSQL connectivity |
| Redis-py | 5.2+ | Cache client | Session & data caching |
| Celery | 5.4+ | Task queue | Background job processing |
| Boto3 | 1.35+ | AWS SDK | Cloud service integration |
API & Communication
| Technology | Version | Usage | Purpose |
|---|---|---|---|
| FastAPI | 0.104+ | REST API framework | Primary API layer |
| Pydantic | 2.0+ | API validation | Request/response schemas |
| Starlette | 0.27+ | ASGI framework | FastAPI foundation |
| Uvicorn | 0.23+ | ASGI server | Production API server |
| Gunicorn | 21.2+ | WSGI server | Process management |
| WebSockets | Built-in | Real-time communication | Live updates |
Data & Processing
| Technology | Version | Usage | Purpose |
|---|---|---|---|
| PostgreSQL | 15+ | Primary database | Relational data storage |
| Redis | 7.0+ | Cache & sessions | In-memory data store |
| Pandas | 2.1+ | Data analysis | Analytics & reporting |
| NumPy | 1.25+ | Numerical computing | Mathematical operations |
| Pillow | 10.0+ | Image processing | Photo optimization |
System Architecture
High-Level Architecture
ReptiDex System Architecture
Frontend Layer (ECS Fargate)
- • web-public (dev.reptidex.com)
- • web-breeder (breeder-dev.reptidex.com)
- • web-admin (admin-dev.reptidex.com)
- • web-embed (embed-dev.reptidex.com)
API Services (ECS Fargate)
- • repti-core (api-dev.reptidex.com)
- • repti-animal (animal-api-dev.reptidex.com)
- • repti-commerce (commerce-api-dev.reptidex.com)
- • repti-media (media-api-dev.reptidex.com)
- • repti-community (community-api-dev.reptidex.com)
- • repti-ops (ops-api-dev.reptidex.com)
Data & Infrastructure
- • RDS PostgreSQL 15.7
- • ElastiCache Redis 7.0
- • S3 (Media Storage)
- • CloudFront (CDN)
- • ALB (Traffic Routing)
Service Access & URLs
All services are accessible via subdomain-based routing through the Application Load Balancer: Frontend Applications (Development):- Public Site: https://dev.reptidex.com
- Breeder Portal: https://breeder-dev.reptidex.com
- Admin Dashboard: https://admin-dev.reptidex.com
- Embeddable Widgets: https://embed-dev.reptidex.com
- Core API: https://api-dev.reptidex.com/api/v1 | Docs
- Animal Service: https://animal-api-dev.reptidex.com/api/v1 | Docs
- Commerce Service: https://commerce-api-dev.reptidex.com/api/v1 | Docs
- Media Service: https://media-api-dev.reptidex.com/api/v1 | Docs
- Community Service: https://community-api-dev.reptidex.com/api/v1 | Docs
- Ops Service: https://ops-api-dev.reptidex.com/api/v1 | Docs
- Interactive API documentation at
/docs(Swagger UI) - Alternative documentation at
/redoc(ReDoc) - OpenAPI schema at
/openapi.json
Service Communication Patterns
- Synchronous Communication
- Asynchronous Communication
- Data Access Patterns
Direct API Calls
HTTP/REST APIs:- Frontend applications → Backend services
- Service-to-service communication for real-time data
- Authentication via JWT tokens
- Request/response timeout: 30 seconds
- Unified API gateway
- Cross-service data fetching
- Type-safe API consumption
- Real-time updates for care reminders
- Live marketplace activity feeds
- Collaborative editing features
Infrastructure
AWS Cloud Infrastructure
ReptiDex leverages AWS services for scalable, reliable cloud infrastructure with a focus on cost optimization and operational simplicity.Compute & Networking
ECS Fargate, VPC, ALB
- Serverless container orchestration (ARM64 Graviton2)
- Host-based routing via Application Load Balancer
- Multi-AZ deployment for high availability
Storage & Data
RDS, ElastiCache, S3
- Managed PostgreSQL 15.7 with automated backups
- Redis 7.0 for caching and sessions
- S3 with CloudFront for media delivery
Infrastructure Components
- Compute Infrastructure
- Storage & Databases
- Networking & Security
- Deployment Pipeline
Container Orchestration
Amazon ECS Fargate (Current):- Serverless container orchestration
- ARM64 architecture (Graviton2 processors)
- No infrastructure management required
- Automatic scaling based on demand
- Per-service resource allocation
- Host-based routing to services
- SSL/TLS termination with ACM certificates
- Health check monitoring
- Multi-AZ distribution
Resource Allocation
| Service Type | vCPU | Memory | Architecture |
|---|---|---|---|
| Frontend Apps | 0.25 | 512MB | ARM64 |
| Backend Services | 0.5 | 1024MB | ARM64 |
| Database (RDS) | 2 vCPU | 2GB | AMD64 |
| Redis (ElastiCache) | 2 vCPU | 1.5GB | AMD64 |
- Each service runs as a separate ECS task
- Health checks on
/health(frontend) and/api/v1/health(backend) - Container logs to CloudWatch Logs
- Secrets via AWS Secrets Manager
Operations
Monitoring & Observability
Comprehensive monitoring strategy combining application performance monitoring, infrastructure monitoring, and business metrics tracking.Application Monitoring
Grafana
- Performance monitoring across all services
- Error tracking and alerting
- Database query optimization
Infrastructure Monitoring
Grafana + Prometheus
- ECS instance metrics
- RDS database monitoring
- Custom application metrics
Error Tracking
Loki
- Real-time error monitoring
- Performance issue detection
- Release health tracking
Operational Tools & Practices
- Monitoring Stack
- DevOps Practices
- Operational Procedures
- Performance & Scaling
Metrics & Visualization
Grafana:- Dashboards: Unified metrics visualization
- Service Maps: Microservice dependency tracking
- Alerting: Multi-source alert management
- Role-Based Access: Team-specific views
- Container response times
- Service error rates
- Task scaling metrics
- Resource utilization
- Service dependencies
Metrics Collection
Prometheus:- Container Metrics: CPU, memory, network stats
- Service Discovery: ECS auto-detection
- PromQL: Advanced query capabilities
- Service Health: Container lifecycle tracking
Log Management
Loki:- Container Logs: Centralized logging
- Label-Based: Service-specific filtering
- LogQL: Structured log queries
- Integration: Native Grafana support
Infrastructure Monitoring
AWS CloudWatch:- ECS Services: Task and service metrics
- Container Insights: Cluster performance
- ALB Metrics: Load balancer statistics
- Custom Metrics: Business KPIs
Operational Metrics & SLAs
Service Level Objectives
99.9%
Uptime Target
<3s
Page Load Time
<500ms
API Response Time
<0.1%
Error Rate
This infrastructure overview provides the foundation for ReptiDex’s scalable, reliable technology platform. The stack balances modern development practices with operational simplicity, enabling rapid feature development while maintaining high availability and performance standards.