Media Asset Manager Project
Lasted edited: February 19, 2025
A work in progress. Maybe.
Project Structure On March 6, 2025 - After refactoring 1200 line main.py
media-manager
├─ README.md
├─ backend
│ ├─ __init__.py
│ ├─ alembic
│ │ ├─ README
│ │ ├─ env.py
│ │ ├─ script.py.mako
│ │ └─ versions
│ │
│ ├─ alembic.ini
│ ├─ app
│ │ ├─ api
│ │ │ ├─ dependencies_endpoint.py
│ │ │ ├─ endpoints
│ │ │ │ ├─ admin_endpoint.py
│ │ │ │ ├─ analysis_endpoint.py
│ │ │ │ ├─ collection_endpoint.py
│ │ │ │ ├─ files_endpoint.py
│ │ │ │ ├─ jobs_endpoint.py
│ │ │ │ ├─ media_endpoint.py
│ │ │ │ ├─ object_detection_endpoint.py
│ │ │ │ ├─ search_endpoint.py
│ │ │ │ ├─ tags_endpoint.py
│ │ │ │ └─ thumbnails_endpoint.py
│ │ │ └─ router_api.py
│ │ ├─ config.py
│ │ ├─ core
│ │ │ ├─ config.py
│ │ │ └─ logging.py
│ │ ├─ db
│ │ │ ├─ base_db.py
│ │ │ ├─ init_db.py
│ │ │ ├─ models
│ │ │ │ ├─ __init__.py
│ │ │ │ ├─ base_model.py
│ │ │ │ ├─ collection_model.py
│ │ │ │ ├─ detection_model.py
│ │ │ │ ├─ media_asset_model.py
│ │ │ │ ├─ tag_model.py
│ │ │ │ └─ timestamp_mixin.py
│ │ │ └─ session_db.py
│ │ ├─ main.py
│ │ ├─ models
│ │ │ ├─ coco.names
│ │ │ └─ yolov4.cfg
│ │ ├─ schemas
│ │ │ ├─ admin_schema.py
│ │ │ ├─ collection_schema.py
│ │ │ ├─ detection_schema.py
│ │ │ ├─ media_schema.py
│ │ │ ├─ queue_schema.py
│ │ │ ├─ search_schema.py
│ │ │ └─ tag_schema.py
│ │ ├─ services
│ │ │ ├─ __init__.py
│ │ │ ├─ collections
│ │ │ │ ├─ __init__.py
│ │ │ │ └─ collection_service.py
│ │ │ ├─ opencv
│ │ │ │ ├─ __init__.py
│ │ │ │ ├─ audio_analyzer.py
│ │ │ │ ├─ document_analyzer.py
│ │ │ │ ├─ image_analyzer.py
│ │ │ │ ├─ object_detector.py
│ │ │ │ └─ video_analyzer.py
│ │ │ ├─ queue
│ │ │ │ ├─ config.py
│ │ │ │ ├─ status_queue.py
│ │ │ │ └─ tasks_queue.py
│ │ │ ├─ search
│ │ │ │ ├─ __init__.py
│ │ │ │ ├─ indexer_search.py
│ │ │ │ └─ search_service.py
│ │ │ └─ tags
│ │ │ ├─ __init__.py
│ │ │ └─ tag_service.py
│ │ └─ utils
│ │ ├─ error_handlers_util.py
│ │ ├─ exceptions_util.py
│ │ ├─ file_utils.py
│ │ └─ validators_util.py
│ ├─ create_detections_table.py
│ ├─ create_detections_table.sql
│ ├─ models
│ ├─ requirements.txt
│ ├─ run.py
│ ├─ services
│ │ ├─ opencv
│ │ └─ queue
│ └─ static
├─ frontend
├─ pyrightconfig.json
├─ scripts
│ └─ test_queue_reliability.sh
└─ server
├─ README.md
├─ docker
│ ├─ Dockerfile
│ ├─ backend
│ │ ├─ app
│ │ │ └─ models
│ │ └─ backend
│ │ └─ app
│ │ └─ models
│ └─ docker-compose.yml
├─ nginx
│ └─ sites-available
│ └─ media.sympile.com
└─ other_config_files
Project Structure on February 19, 2025
project_root/
├── backend/ # Backend directory for FastAPI application
│ ├── app/ # Application code for the backend
│ │ ├── __init__.py # Makes the app directory a package
│ │ ├── main.py # Entry point for the FastAPI application
│ │ ├── api/ # API endpoints
│ │ │ ├── __init__.py
│ │ │ ├── auth/ # User authentication endpoints
│ │ │ │ ├── __init__.py
│ │ │ │ └── auth.py # Authentication logic
│ │ │ ├── media/ # Media-related endpoints
│ │ │ │ ├── __init__.py
│ │ │ │ ├── upload.py # Endpoint for uploading media files
│ │ │ │ ├── process.py # Endpoint for processing media files
│ │ │ │ └── search.py # Endpoint for searching media assets
│ │ │ ├── metadata/ # Metadata-related endpoints
│ │ │ │ ├── __init__.py
│ │ │ │ └── metadata.py # Endpoint for managing metadata
│ │ │ └── health/ # Health check endpoints
│ │ │ ├── __init__.py
│ │ │ └── health.py # Health check logic
│ │ ├── services/ # Business logic and processing
│ │ │ ├── __init__.py
│ │ │ ├── opencv/ # OpenCV-related services
│ │ │ │ ├── __init__.py
│ │ │ │ ├── video_analysis.py # Video analysis logic
│ │ │ │ ├── image_processing.py # Image processing logic
│ │ │ │ └── models/ # Directory for OpenCV models (e.g., YOLOv4)
│ │ │ │ ├── __init__.py
│ │ │ │ └── yolov4.py # YOLOv4 model loading and inference logic
│ │ │ ├── whisper/ # Whisper-related services
│ │ │ │ ├── __init__.py
│ │ │ │ ├── transcription.py # Audio transcription logic
│ │ │ │ └── models/ # Directory for Whisper models
│ │ │ │ ├── __init__.py
│ │ │ │ └── whisper_model.py # Logic for loading and using Whisper models
│ │ │ ├── media_processes/ # General media processing services
│ │ │ │ ├── __init__.py
│ │ │ │ ├── video_resizing.py # Video resizing logic
│ │ │ │ └── color_conversion.py # Color conversion logic
│ │ │ └── database/ # Database interaction logic
│ │ │ ├── __init__.py
│ │ │ ├── models.py # Database models
│ │ │ └── queries.py # Database queries and operations
│ │ ├── alembic/ # Alembic migrations directory
│ │ │ ├── env.py # Alembic environment configuration
│ │ │ ├── script.py.mako # Alembic script template
│ │ │ └── versions/ # Directory for migration scripts
│ │ │ ├── __init__.py
│ │ │ └── <migration_file>.py # Individual migration scripts
│ │ ├── models/ # Pydantic models for request/response validation
│ │ │ ├── __init__.py
│ │ │ └── media.py # Models for media assets
│ │ ├── schemas/ # Database schemas (if using an ORM)
│ │ │ ├── __init__.py
│ │ │ └── media_schema.py # Schema definitions for media assets
│ │ └── utils/ # Utility functions and helpers
│ │ ├── __init__.py
│ │ └── file_management.py # File handling utilities
│ ├── requirements.txt # Your dependencies for the backend
├── frontend/ # Frontend directory for client-side code
│ ├── public/ # Public assets (e.g., images, favicon)
│ ├── src/ # Source code for the frontend application
│ │ ├── components/ # React/Vue components
│ │ ├── pages/ # Page components
│ │ ├── App.js # Main application file
│ │ └── index.js # Entry point for the frontend
│ ├── package.json # Frontend dependencies and scripts
│ └── README.md # Frontend documentation
├── media/ # Directory for storing uploaded media files
│ ├── audio/ # Subdirectory for audio files
│ ├── documents/ # Subdirectory for document files
│ ├── images/ # Subdirectory for image files
│ ├── other/ # Subdirectory for other file types
│ └── videos/ # Subdirectory for video files
└── server/ # Directory for server configuration files
├── nginx/ # Nginx configuration files
│ ├── sites-available/ # Nginx sites-available configurations
│ │ ├── your_site.conf # Example site configuration
│ ├── sites-enabled/ # Nginx sites-enabled configurations
│ │ └── your_site.conf # Symlink to sites-available
├── docker/ # Docker-related files
│ ├── Dockerfile # Dockerfile for the backend
│ └── docker-compose.yml # Docker Compose file
├── README.md # Documentation for server configurations
└── other_config_files # Any other server-related configuration files
Project Structure On February 18, 2025
project_root/
├── backend/ # Backend directory for FastAPI application
│ ├── main.py # Entry point for the FastAPI application
│ ├── api/ # API endpoints
│ │ ├── __init__.py
│ │ ├── auth/ # User authentication endpoints
│ │ │ ├── __init__.py
│ │ │ └── auth.py # Authentication logic
│ │ ├── media/ # Media-related endpoints
│ │ │ ├── __init__.py
│ │ │ ├── upload.py # Endpoint for uploading media files
│ │ │ ├── process.py # Endpoint for processing media files
│ │ │ └── search.py # Endpoint for searching media assets
│ │ ├── metadata/ # Metadata-related endpoints
│ │ │ ├── __init__.py
│ │ │ └── metadata.py # Endpoint for managing metadata
│ │ └── health/ # Health check endpoints
│ │ ├── __init__.py
│ │ └── health.py # Health check logic
│ ├── services/ # Business logic and processing
│ │ ├── __init__.py
│ │ ├── opencv/ # OpenCV-related services
│ │ │ ├── __init__.py
│ │ │ ├── video_analysis.py # Video analysis logic
│ │ │ ├── image_processing.py # Image processing logic
│ │ │ └── models/ # Directory for OpenCV models (e.g., YOLOv4)
│ │ │ ├── __init__.py
│ │ │ └── yolov4.py # YOLOv4 model loading and inference logic
│ │ ├── whisper/ # Whisper-related services
│ │ │ ├── __init__.py
│ │ │ ├── transcription.py # Audio transcription logic
│ │ │ └── models/ # Directory for Whisper models
│ │ │ ├── __init__.py
│ │ │ └── whisper_model.py # Logic for loading and using Whisper models
│ │ ├── media_processes/ # General media processing services
│ │ │ ├── __init__.py
│ │ │ ├── video_resizing.py # Video resizing logic
│ │ │ └── color_conversion.py # Color conversion logic
│ │ └── database/ # Database interaction logic
│ │ ├── __init__.py
│ │ ├── models.py # Database models
│ │ └── queries.py # Database queries and operations
│ ├── models/ # Pydantic models for request/response validation
│ │ ├── __init__.py
│ │ └── media.py # Models for media assets
│ ├── schemas/ # Database schemas (if using an ORM)
│ │ ├── __init__.py
│ │ └── media_schema.py # Schema definitions for media assets
│ └── utils/ # Utility functions and helpers
│ ├── __init__.py
│ └── file_management.py # File handling utilities
├── frontend/ # Frontend directory for client-side code
│ ├── public/ # Public assets (e.g., images, favicon)
│ ├── src/ # Source code for the frontend application
│ │ ├── components/ # React/Vue components
│ │ ├── pages/ # Page components
│ │ ├── App.js # Main application file
│ │ └── index.js # Entry point for the frontend
│ ├── package.json # Frontend dependencies and scripts
│ └── README.md # Frontend documentation
├── media/ # Directory for storing uploaded media files
│ ├── audio/ # Subdirectory for audio files
│ ├── documents/ # Subdirectory for document files
│ ├── images/ # Subdirectory for image files
│ ├── other/ # Subdirectory for other file types
│ └── videos/ # Subdirectory for video files
└── server/ # Directory for server configuration files
├── nginx/ # Nginx configuration files
│ ├── sites-available/ # Nginx sites-available configurations
│ │ ├── your_site.conf # Example site configuration
│ ├── sites-enabled/ # Nginx sites-enabled configurations
│ │ └── your_site.conf # Symlink to sites-available
├── docker/ # Docker-related files
│ ├── Dockerfile # Dockerfile for the backend
│ └── docker-compose.yml # Docker Compose file
├── README.md # Documentation for server configurations
└── other_config_files # Any other server-related configuration files