How a7medrajab1/mini-rag works
This is a FastAPI backend for project-scoped file ingestion and text chunking. Its main workflow accepts an upload, validates and stores the file while recording an asset, then processes selected or project-wide files into ordered chunks. The graph also preserves health checking and the settings, controller, persistence-model, and schema layers. Source excerpts show route-to-controller/model calls and processing behavior; persistence-model internals were not excerpted, so their database connections are shown only as unverified.
Main entry points: data.py Data Routes · ProjectController.py Project Files · main.py FastAPI App · DataController.py Upload Validation
Components 18
HTTP API
- FastAPI App
src/main.py - Health Route
src/routes/base.py - Data Routes
src/routes/data.py - Process Request
src/routes/schemes/data.py - Settings
src/helpers/config.py
File Ingestion
- Upload Validation
src/controllers/DataController.py - Project Files
src/controllers/ProjectController.py - Controller Base
src/controllers/BaseController.py
Text Processing
- File Processing
src/controllers/ProcessController.py - File Types
src/models/enums/ProcessingEnum.py
Persistence
- Asset Records
src/models/AssetModel.py - Project Records
src/models/ProjectModel.py - Asset Schema
src/models/db_schemes/Asset.py - Asset Types
src/models/enums/AssetTypeEnum.py - Chunk Records
src/models/ChunkModel.py - Chunk Schema
src/models/db_schemes/DataChunk.py
Other components
- API Client
- MongoDB
Connections 24
- API Client → FastAPI App: sends requests
src/main.py - FastAPI App → Health Route: mounts route
src/main.py - FastAPI App → Data Routes: mounts route
src/main.py - API Client → Health Route: checks health
src/routes/base.py - API Client → Data Routes: uploads or processes
src/routes/data.py - Data Routes → Settings: reads settings
src/routes/data.py - Data Routes → Upload Validation: validates uploads
src/routes/data.py - Upload Validation → Project Files: gets project path
src/controllers/DataController.py - Data Routes → Project Files: gets project path
src/routes/data.py - Upload Validation → Controller Base: inherits
src/controllers/DataController.py - Project Files → Controller Base: inherits
src/controllers/ProjectController.py - Data Routes → Project Records: creates or gets project
src/routes/data.py - Data Routes → Asset Records: creates asset record
src/routes/data.py - Data Routes → Asset Schema: builds asset
src/routes/data.py - Data Routes → Asset Types: sets asset type
src/routes/data.py - Data Routes → Process Request: accepts parameters
src/routes/data.py - Data Routes → File Processing: loads and splits files
src/routes/data.py - File Processing → Project Files: gets project path
src/controllers/ProcessController.py - File Processing → File Types: selects file loader
src/controllers/ProcessController.py - Data Routes → Chunk Records: resets and stores chunks
src/routes/data.py - Data Routes → Chunk Schema: builds chunks
src/routes/data.py - Asset Records → MongoDB: persists records
- Project Records → MongoDB: persists records
- Chunk Records → MongoDB: persists chunks