How richbs/colourlens works
Main Components
A. Web Application Layer (Django)
• Primary Components:
• colourlens (Main Django App)
• coloursite (Project Configuration)
B. Data Processing Layer
• Management Commands
• Data Migration Tools
C. External Integrations
• Museum APIs (Harvard, etc.)
• Image Processing Services
D. Storage Layer
• SQLite Database (as seen in db.sqlite3)
• Static File Storage
┌─────────────────────────────────────────────────┐
• Client Browser │
• ┘
• ↕ HTTP
┌─────────────────────────────────────────────────┐
• Django Application │
• ┌─────────────┐ ┌─────────────┐ ┌─────────┐ │
• Views │ │ URLs │ │ Models │ │
• ┘ └─────────────┘ └─────────┘ │
• ┘
• ↕
┌─────────────────────────────────────────────────┐
• ┌─────────────┐ ┌─────────────────────────┐ │
• ┘ └─────────────────────────┘ │
• ┘
• ↕ ↕
┌─────────────┐ ┌─────────────────────────────┐
• Database │ │ External Museum APIs │
• ┘ └─────────────────────────────┘
Important Elements to Highlight
a. Request Flow:
• How user requests flow from browser through Django's URL routing to views
• Data flow between components
b. Key Processing Points:
• API integration points
• Data storage and retrieval paths
Technical Details
• Django MVT (Model-View-Template) pattern
• Image processing dependencies (libjpeg-dev)
• Virtual environment setup
• Database connections
• API authentication points
Deployment Notes
Different deployment configurations:
• Development (local)
• Production (webfaction)
• Gondolin deployment