Files

T

yuqei af057ff165 chore: archive project history and preserve delivery controls

Keep current plans and release controls discoverable without losing historical evidence, and include the reviewed Windows start/stop workflow.

2026-10-08 19:05:30 +08:00

2.7 KiB

Raw Permalink Blame History

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

Windows 本地启动（合同与 Prompt 测试）

在 PowerShell 中执行：

cd D:\yuqei-project\ai-contract-platform
powershell -ExecutionPolicy Bypass -File .\start-dev.ps1

看到 Ready: http://localhost:3000/login 后，在谷歌浏览器访问这个地址，用已有账号登录。脚本优先打开 Chrome；只想启动服务、自己打开浏览器时，加上 -NoBrowser。

启动脚本检查已有的 .venv-project 和前端依赖，执行两个 API 的数据库迁移，然后在后台启动前端（3000）、合同 API（8100）、AI 平台 API（8101）、合同审查任务和起草续处理任务。关闭 PowerShell 窗口不会关闭这些后台服务。-WithReviewWorker 参数仍兼容，但现在默认已经启动审查任务。

配置继续使用两个 API 目录的 .env 和前端目录的 .env.local。脚本从前端配置读取内部服务通信密钥，使前后端保持一致，保留现有数据库和模型供应商配置。数据库需要能够从本机访问；模型调用需要已配置的供应商可用。本机服务通信会自动绕过系统代理。

重复执行启动命令会复用本项目已正常运行的服务。端口被其他程序占用、数据库迁移失败或服务未就绪时，脚本会报错。日志位于项目根目录的 .runtime\dev-logs\，每个服务分别保存 .out.log 和 .err.log；数据库迁移也有单独日志。

停止脚本管理的服务：

powershell -ExecutionPolicy Bypass -File .\stop-dev.ps1

停止脚本会核对进程编号、创建时间和命令，只停止记录中仍属于本项目的进程。修改配置或升级代码后，先停止再启动。重启电脑后，重新执行启动命令即可。

2.7 KiB Raw Permalink Blame History Unescape Escape