1.4 KiB
1.4 KiB
Delivery Desk 开发约定
- 包管理器使用 pnpm；提交前运行
pnpm check、pnpm lint、pnpm build、pnpm test:review-rounds、pnpm test:collection-status、pnpm test:postgres-runtime、pnpm db:postgres:validate和python tests/test_upload_skill.py。 - 业务术语统一为“运营组 → 项目 → 作品 → 验收轮次”；每轮只有一个方案。
collections和work_versions是迁移期内部兼容结构，不得出现在新产品界面或新 API 命名中。 - 新接口使用
/api/projects/:projectId/works和/api/works/:workId/rounds；notes、collections、versions路由只做一个兼容周期，不再扩展。 - 数据库结构变更必须同时更新
api/db.ts、db/postgres/schema.sql和迁移验证。 data/、uploads/、.env*、COS 凭证、数据库文件及用户上传内容不得提交。- 本地开发可使用 SQLite；正式部署使用 PostgreSQL。COS 凭证只通过平台管理界面录入；
COS_CONFIG_ENCRYPTION_KEY通过部署密钥注入。 - 不把
.trae/中的早期原型文档作为现行依据；以 README、docs/和当前代码为准。 - Agent 通过 API 上传作品或创建验收轮次时必须使用
.agents/skills/upload-delivery-desk-work；接口或层级变化后同步更新该 Skill，并运行powershell -ExecutionPolicy Bypass -File scripts/package-upload-skill.ps1重新打包。