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

V2 Local Development

Run Tests

python -m pytest

Run APIs Without Docker

Contract API:

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

AI Platform API:

$env:PYTHONPATH='yuqei-ai-platform/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='yuqei-ai-platform/services/worker/src'
python -m yuqei_worker.main --health

Run Infrastructure With Docker

Copy-Item yuqei-infra/compose/.env.example yuqei-infra/compose/.env -ErrorAction SilentlyContinue
docker compose --env-file yuqei-infra/compose/.env -f yuqei-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