How tejoesperanto/pasportaservo works
Main Components
a. Frontend Layer:
• Static assets (CSS, JavaScript, images)
• Templates organized by apps (core, hosting, blog, etc.)
• User interface components
• Client-side validation and interactions
b. Backend Layer:
• Django applications:
• Core (authentication, base templates)
• Hosting (main hospitality service)
• Blog (news and updates)
• Maps (geographical features)
• Shop (reservations system)
• Pages (static content)
• Links (URL management)
c. Database Layer:
• PostgreSQL with PostGIS extension
• Models for:
• User profiles
• Places/Locations
• Family members
• Phones
• Preferences
• Countries/Regions
d. External Services:
• Email service (MailDump for development)
• Services (Mapbox GL)
• Analytics (Google Analytics)
• Sentry for error tracking
Component Relationships
• User requests → Nginx → Gunicorn → Django
• Django → PostgreSQL/PostGIS for data storage
• Django → External services
• Template rendering flow
• Authentication flow
• Geographic data processing flow
Key Architectural Patterns
• MVC/MTV pattern (Django's implementation)
• Service-oriented architecture for external integrations
• Modular app structure
• Middleware chain
• Template inheritance system
Infrastructure Components
Include:
• Nginx web server
• Gunicorn WSGI server
• Memcached for caching
• Static file serving
• Media file handling
Security Layer
Show:
• HTTPS implementation
• Authentication middleware
• Permission systems
• CSRF protection
• Session management
[Client Layer]
• ↓ ↑
[Web Server (Nginx)]
• ↓ ↑
[Application Server (Gunicorn)]
• ↓ ↑
[Django Framework]
• ↓ ↑
[Database Layer]
• Blue: Core components
• Green: External services
• Orange: Security features
• Purple: Caching layer
• Gray: Infrastructure components
Specific notes about:
• Internationalization support (focusing on Esperanto)
• Geographic data handling
• User role management
• Content management features
• Testing infrastructure
This system design should reflect both the Django-specific architecture and the custom implementations for the hospitality service features, making it clear how all components work together to deliver the application's functionality.