How logicalpath/photomanage works
Main Components
a) File Processing Layer
• File processing scripts (shown in /scripts directory)
• Media file handling components (rename, move, thumbnail creation)
b) Data Processing Layer
• EXIF data extraction system
• UUID generation and mapping system
• Date conversion utilities
• GPS/location processing
c) Storage Layer
• SQLite Database (mediameta.db)
• File System Storage (for original files and thumbnails)
• B2 Cloud Storage integration
d) Web Interface Layer (Datasette)
• Media viewer components
• Clustering/mapping features
• Enrichment plugins
• API endpoints
Flow and Relationships
Input Files → File Processing → Data Processing → Storage → Web Interface
Specific Implementation Details
File Processing:
• Media file detection
• Thumbnail generation (224x224)
• UUID renaming
• File movement
Data Processing:
• EXIF extraction
• Date normalization
• GPS coordinate processing
• Language detection
Storage:
• SQLite with spatial extensions
• File system organization
• B2 backup integration
Web Interface:
• Datasette server
• Media plugins
• Mapping features
• Enrichment capabilities
Important Architectural Notes
Annotations for:
• Asynchronous processing capabilities
• File system to database relationships
• Plugin architecture for Datasette
• Security considerations for media access
Integration Points
External service connections:
• B2 Cloud Storage
• OpenCage Geocoding
• Spatial data processing
• Vector embeddings support
This architecture emphasizes the system's capability to handle large-scale media processing while maintaining organized storage and accessible viewing options.