25982b12bf
Add box_mode field to BoxSaveRequest and DuplicateZongpaiBindError exception. In one-to-one mode, prevent the same zongpai from being packed into multiple boxes, returning 409 with existing box info. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
CargoTrace FastAPI Backend
FastAPI backend service for the CargoTrace platform.
Getting Started
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# or .venv\Scripts\activate # Windows
pip install -r requirements.txt
uvicorn app.main:app --reload
Configuration
Configuration is managed via YAML files in the config/ directory.
Configuration File
Edit config/settings.yaml to configure your environment:
database:
active: sql_server # sql_server or postgresql
sql_server:
host: your-host
port: 1433
database: your-database
username: your-username
password: your-password
postgresql:
host: your-postgres-host
port: 5432
database: your-database
username: your-username
password: your-password
Set database.active to choose the database backend. Both backends expect the
same database name, schemas, and table structure.
Local Overrides
For local development, create config/settings.local.yaml to override specific values without committing them.