How meizuflux/private-destination works
Main Components
a) Frontend Layer:
• Static Assets (CSS/JS)
• Jinja2 Templates
• Client-side TypeScript/JavaScript
• Organization into different sections (dashboard, admin, errors)
b) Backend Layer:
• Flask Application Structure
• Blueprints Architecture
• Models Layer
• Utils/Helpers
• Authentication System
c) Database Layer:
• PostgreSQL Database
• Migration System
Core Application Structure
[Client Browser] → [Nginx (Production)] → [Flask Application]
• ↓
• [Blueprint Router]
• ↓
• [Database] ← [Models] ← [Controllers (Blueprints)] → [Templates]
• Admin Blueprint (Purple)
• Users Management
• Application Management
• Dashboard Blueprint (Blue)
• Notes Management
• URL Shortener
• Settings
• Auth Blueprint (Red)
• Authentication
• Session Management
Utility Services (Green)
• Database Utilities
• Authentication Utilities
• Form Handling
• Time Utilities
• Shortener Logic
Data Flow Patterns
• HTTP request flow
• Template rendering process
• Database interactions
• Authentication flow
Key Visualization Guidelines:
Specific features
• URL shortening flow
• Notes management system
• User authentication process
• Admin management interface
• Static asset handling
Security Layer
• Authentication flow
• Admin access control
• API key management
• Password handling
Database Interactions
• Migration system
• Model relationships
• Data access patterns
Frontend Architecture
• Static asset compilation
• Template inheritance
• JavaScript/TypeScript integration
Development Tools
• Docker development environment
• Build scripts
• Migration tools
Remember to:
• Notes for future planned features
• Document the development environment setup