How mrunsten/solita-dev-academy-2023-exercise works
Component Details
a. Client Layer:
• Web browsers connecting to the system
• Both desktop and mobile clients (as mobile support is implemented)
b. Application Layer (Container Level):
• Nginx Reverse Proxy Container
• Port 3000 exposed to clients
• Routes traffic to appropriate services
• Frontend Container (SvelteKit)
• Main routes (/journeys, /stations, /station/[id])
• TypeScript and Svelte components
• Backend Container (Rust)
• Main API endpoints
• Modules:
• API handlers (journey.rs, station.rs)
• Database interfaces
• Data source handlers
• Model definitions
c. Data Layer:
• PostgreSQL Database Container
• Port 5432
• Main tables:
• cities
• station_operators
• stations
• journeys
• Materialized views:
• journey_list
• station
• station_list
• Client requests → Nginx
• Nginx → Frontend/Backend routing
• Backend → Database queries
• Data source imports → Backend → Database
• Response paths back to clients
Special Elements
• A "Data Import" section showing:
• CSV data sources
• Validation rules (10s minimum duration, 10m minimum distance)
• Duplicate checking
Additional Details
Annotations for:
• Docker container boundaries
• Environment variable configurations
• Port mappings
• Data validation rules
• Technology stack labels (Rust, SvelteKit, PostgreSQL, Nginx)
Important Architectural Patterns to Highlight
• Microservices architecture (containerized services)
• RESTful API design
• MVC-like pattern in the backend
• Data validation pipeline
• View materialization for performance