chajia/README.md

查价中台（chajia）

MotherShip / Flock Freight 卡派查价中台（Next.js + Prisma + Playwright RPA）。

远程仓库（团队拉取）：https://git.shipro.ltd/nanchuanbeizi/chajia.git

克隆与本地启动

git clone https://git.shipro.ltd/nanchuanbeizi/chajia.git
cd chajia
npm ci
cp .env.example .env
# 按需编辑 .env（JWT_SECRET、数据库、HOST_SERVICE_TOKENS 等）

本地基础设施与开发（Windows PowerShell 示例）：

# 详见 scripts/dev、deploy/README.md
npm run db:deploy   # 或 db:migrate
npm run dev
# 另开终端：npm run worker:rpa

生产 / BT 主机部署见 deploy/README.md、deploy/RELEASE-NOTES.md。

必读文档

文档	说明
api调用文档/api对接文档.md	第三方 OpenAPI + iframe 嵌入直登（§2.5）
api调用文档/api调用文档.md	完整 API / 管理端说明
deploy/README.md	部署与环境变量
docs/	PRD、技术设计、RPA SOP

仓库已包含（可开发）

• 应用：app/、components/、modules/、lib/、workers/
• 数据库：prisma/schema.prisma + prisma/migrations/
• 依赖锁：package-lock.json
• 部署：Dockerfile*、deploy/
• 单测：__tests__/
• 环境模板：.env.example、deploy/.env.*.example

不会进库（本地自行生成）

• .env / .env.local（密钥，勿提交）
• node_modules/、.next/
• .rpa/（Playwright storage / 截图）
• .dev/、上传到服务器/、*.zip

嵌入页（CC iframe）

https://<域名>/embed-demo?login_type=api_key&api_key=<API_Key>&embed=1

详见对接文档 §2.5。

常用脚本

npm run lint          # tsc --noEmit
npm test              # vitest
npm run worker:rpa    # RPA Worker