Files
persionalBrand/PROJECT_STATUS.md
T

5.0 KiB

Project Status

最后更新:2026-09-19

当前目标

先为餐饮摊主朋友交付一个真正能带来订单的个人品牌小程序,再根据真实使用把通用能力产品化。产品方的收益、运营和平台化目标不能牺牲朋友的实际使用效果。

当前阶段

后端基础、数据库环境和订单 API 已完成首轮验证,管理后台和小程序静态页面已接入首版结构,下一步进行真实资源与微信登录/预约联调。

已完成

  • 产品 PRD、原型规格、架构决策、数据/API 设计和实施计划。
  • 餐饮试点画像与首轮需求访谈决策。
  • 可点击低保真原型:prototype/index.html。
  • Git 仓库、main 分支和远程仓库。
  • pnpm workspace + Turborepo Monorepo。
  • TypeScript 严格配置、ESLint、Prettier、EditorConfig、环境变量模板。
  • NestJS + Fastify API 骨架。
  • Prisma PostgreSQL schema:品牌、服务、客户身份、订单、订单明细、标签、管理员。
  • 微信官方 jscode2session 登录交换边界。
  • 客户登录 token、客户订单提交/查询/取消。
  • 普通套餐价格快照和私厨需求人工报价模型。
  • 管理员账号密码登录和角色 token。
  • 管理员订单列表、状态、未读、标签和内部备忘能力。
  • DTO 校验、全局异常响应、请求 ID和订单状态流转规则。
  • Docker PostgreSQL Compose、seed 和 Prisma 脚本说明。
  • 初始 Prisma migration,已在本地 PostgreSQL 应用并验证数据库 schema up to date。
  • seed 已写入品牌、服务、标签和管理员数据,并完成数量核验。
  • 管理员订单详情、状态/未读/标签筛选和未读数量接口。
  • API 自动化业务规则测试:订单创建、客户取消、状态流转和标签品牌隔离,共 6 项通过。
  • 修复 ESM 下 bcryptjs 导入和 Fastify 请求 ID middleware 的运行时问题。
  • API 已通过真实 HTTP 验证:健康检查、公开品牌/服务读取和管理员登录。
  • HTTP 集成测试:公开接口、管理员登录、错误密码、管理员权限边界、客户会话、预约 DTO 校验、创建/取消和状态流转,共 8 项通过。
  • OpenAPI 3.1 契约:docs/openapi.yaml,覆盖当前公开、客户和管理员接口。
  • 类型化 @personal-brand/api-client:支持公开内容、客户预约、管理员订单和统一错误处理,并有 2 项客户端测试。
  • 已根据 /home/que01/桌面/个人品牌设计图/ 确认 C 端页面视觉规范:暖白、米黄、砖红、深炭黑,16px 卡片圆角和大字号优先。
  • 小程序已完成首页、服务列表、预约套餐和我的订单静态页面,页面标题使用微信原生导航栏。
  • 服务分类、预约数量步进器、订单状态卡和底部导航已按设计图完成首版还原。
  • 已执行多轮 Codex 代码审查并修复关键认证和权限问题。

最近提交

fee3c77 fix: 按设计图优化预约套餐数量和商品卡
13ead2d fix: 对齐服务分类和订单视觉结构
255756c feat: 增加小程序品牌首页
本次工作:数据库初始化、订单管理接口、业务规则测试和运行时修复
f2687c5 chore: prepare portable postgres development environment
0e8b8e1 feat: add api http conventions and booking state rules
0d4caab feat: add admin order tags and read state
bb5ccb1 feat: add admin authentication
b89853b fix: harden api authentication and validation

远程:https://git.app.que01.top/que01/persionalBrand.git

下一步优先级

  1. 接入真实品牌图片、电话和微信配置,并替换当前图片占位区域。
  2. 在微信开发者工具/真机完成 wx.login、预约提交、订单查询和取消联调。
  3. 完善管理后台订单详情、筛选和状态处理视觉页面。
  4. 继续补充页面截图回归和真实素材下的移动端溢出检查。

未决问题

  • 普通套餐采用固定菜单、每日菜单,还是固定套餐加每日可用状态。
  • 朋友最终品牌名称、图片、联系方式、营业时间和配送范围。
  • 微信小程序主体、AppID、服务类目和订阅消息模板是否可用。
  • 生产部署使用哪家 PostgreSQL、对象存储和 API 托管服务。
  • 当前 token 是开发阶段的签名 Bearer token;生产前应替换为带撤销能力的正式 session/Cookie 方案。

当前明确不做

  • 支付、退款、发票、财务对账。
  • 复杂库存、自动配送判断和每日菜单编排。
  • 多商户注册、套餐计费、会员和营销系统。
  • 自动发布微信小程序。

跨电脑恢复

git clone https://git.app.que01.top/que01/persionalBrand.git
cd persionalBrand
cat PROJECT_STATUS.md
cat agent.md
cp .env.example .env

有 Docker 的机器再执行:

docker compose up -d postgres
pnpm install
pnpm db:migrate
pnpm db:seed

更新规则

每完成一个可验证的开发任务,更新“当前阶段”“已完成”“最近提交”和“下一步优先级”。只记录已经发生或已经确认的事实;未确认内容放入“未决问题”。