ai-contract-platform/docs/architecture/local-development.md

V2 Local Development

Run Tests

python -m pytest

Run APIs Without Docker

Contract API:

$env:PYTHONPATH='services/contract-api/src'
python -m uvicorn yuqei_contract_api.main:app --host 0.0.0.0 --port 8100

AI Platform API:

$env:PYTHONPATH='services/ai-platform-api/src'
python -m uvicorn yuqei_ai_platform_api.main:app --host 0.0.0.0 --port 8101

Worker health:

$env:PYTHONPATH='services/worker/src'
python -m yuqei_worker.main --health

Run Infrastructure With Docker

Copy-Item infra/compose/.env.example infra/compose/.env -ErrorAction SilentlyContinue
docker compose --env-file infra/compose/.env -f infra/compose/docker-compose.yml up --build

Health checks:

• Contract API: http://localhost:8100/health
• AI Platform API: http://localhost:8101/health
• MinIO Console: http://localhost:9001