How cfi21/m3-nvocc-erp works
M3 NVOCC ERP is a FastAPI application for freight-forwarding operations, finance, equipment/container management, and administration. The principal workflow is an authenticated user submitting work through the API, where domain modules manage operational and financial records in the database; screen and reporting endpoints expose that work. The README describes PostgreSQL/Supabase as the database target and states that production traffic, live providers, and real-money movement are off. Connections among unsampled modules are omitted unless the source index or excerpts establish them.
Main entry points: main.py FastAPI runtime · db.py Database adapter · screen_integration.py Screen integration · bulk.py Bulk processing
Components 21
API and access
- FastAPI runtime
app/main.py - Identity and admin
app/admin.py - Screen integration
app/screen_integration.py - Screen catalog
app/screen_catalog.py
Freight operations
- Operational workflows
app/operations_workbench.py - Business-day simulation
app/business_day.py - External integrations
app/integration.py - Bulk processing
app/bulk.py
Finance and treasury
- Finance controls
app/clx032_finance_controls.py - General ledger
app/gl.py - Treasury
app/treasury.py - GL reporting
app/clx045_gl_reporting.py
Equipment control
- Container master control
app/clx070_container_master_control.py - Container journey
app/clx071_container_journey.py - Equipment network
app/clx072_equipment_network.py
Data and readiness
- Master data governance
app/masterdata.py - Preproduction checks
app/preprod.py - Provider runtime
app/live_provider_runtime.py - Database adapter
app/db.py
Other components
- ERP user
- PostgreSQL
Connections 32
- ERP user → FastAPI runtime: submits work
app/main.py - FastAPI runtime → Identity and admin: registers routes
app/main.py - FastAPI runtime → Screen integration: registers routes
app/main.py - FastAPI runtime → Business-day simulation: registers routes
app/main.py - FastAPI runtime → Operational workflows: imports
app/main.py - FastAPI runtime → External integrations: imports
app/main.py - FastAPI runtime → Bulk processing: imports
app/main.py - FastAPI runtime → General ledger: imports
app/main.py - FastAPI runtime → Treasury: imports
app/main.py - FastAPI runtime → Master data governance: imports
app/main.py - FastAPI runtime → Preproduction checks: imports
app/main.py - FastAPI runtime → Provider runtime: imports
app/main.py - Screen integration → Screen catalog: builds catalog
app/screen_integration.py - Screen integration → GL reporting: uses report rows
app/screen_integration.py - Business-day simulation → Database adapter: connects to
app/business_day.py - Container master control → Database adapter: connects to
app/clx070_container_master_control.py - Container journey → Database adapter: connects to
app/clx071_container_journey.py - Container journey → Container master control: resolves containers
app/clx071_container_journey.py - Equipment network → Container master control: uses container control
app/clx072_equipment_network.py - Equipment network → Container journey: uses journey data
app/clx072_equipment_network.py - Finance controls → Database adapter: reads and writes
app/clx032_finance_controls.py - General ledger → Database adapter: connects to
app/gl.py - Treasury → General ledger: uses ledger
app/treasury.py - Treasury → Finance controls: uses approval fast-track
app/treasury.py - Master data governance → Database adapter: connects to
app/masterdata.py - Preproduction checks → Business-day simulation: ensures default run
app/preprod.py - Preproduction checks → Database adapter: checks database
app/preprod.py - Provider runtime → Database adapter: connects to
app/live_provider_runtime.py - Identity and admin → Database adapter: reads and writes
app/admin.py - Bulk processing → Database adapter: reads and writes
app/bulk.py - Bulk processing → FastAPI runtime: recovers JSON arrays
app/bulk.py - Database adapter → PostgreSQL: connects when configured