csxj2026/junhong_cmp_fiber

Files

构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m12s

Details

fix: 修正零售价架构错误 + 清理旧微信配置 + 归档提案 + 前端接口文档

1. 修正 retail_price 架构：
   - 删除 batch-pricing 接口的 pricing_target 字段和 retail_price 分支
     （上级只能改下级成本价，不能改零售价）
   - 新增 PATCH /api/admin/packages/:id/retail-price 接口
     （代理自己改自己的零售价，校验 retail_price >= cost_price）

2. 清理旧微信 YAML 配置（已全部迁移到数据库 tb_wechat_config）：
   - 删除 config.yaml 中 wechat.official_account 配置节
   - 删除 NewOfficialAccountApp() 旧工厂函数
   - 清理 personal_customer service 中的死代码（旧登录/绑定微信方法）
   - 清理 docker-compose.prod.yml 中旧微信环境变量和证书挂载注释

3. 归档四个已完成提案到 openspec/changes/archive/

4. 新增前端接口变更说明文档（docs/前端接口变更说明.md）

5. 修正归档提案和 specs 中关于 pricing_target 的错误描述

2026-03-19 17:39:43 +08:00

2.1 KiB

Raw Blame History

client-token-management Specification

Purpose

TBD - created by archiving change client-auth-system. Update Purpose after archive.

Requirements

Requirement: 登录 JWT 签发与 Redis 状态存储

系统 MUST 在 A2/A3 登录成功后签发个人客户 JWT，并将 token 状态写入 Redis。

JWT payload 字段：
- customer_id uint，MUST
- exp int64，MUST
Redis Key：RedisPersonalCustomerTokenKey(customerID)
Redis Value：当前有效 token（或 token 集合，取决于实现）
TTL：MUST 与 JWT 过期时间一致

Scenario: 登录成功写入 Redis

WHEN 客户完成微信登录
THEN 系统 SHALL 签发 JWT
THEN 系统 SHALL 将 token 写入 Redis 并设置 TTL

Requirement: PersonalAuthMiddleware 双重校验

系统 SHALL 在个人客户认证中间件执行双重校验：JWT 解析校验 + Redis 状态校验。

Scenario: JWT 与 Redis 均有效

WHEN 请求携带有效 JWT 且 Redis 中存在有效状态
THEN 中间件 SHALL 放行并写入 customer_id 到上下文

Scenario: JWT 有效但 Redis 不存在

WHEN JWT 仍在有效期但 Redis 中不存在该客户 token 状态
THEN 中间件 MUST 返回未认证错误 1002

Requirement: A7 退出登录接口

系统 MUST 提供需认证接口 POST /api/c/v1/auth/logout，用于删除 Redis token 状态。

HTTP Method + Path: POST /api/c/v1/auth/logout
请求体字段：无
响应体字段：
- success bool，MUST
错误码：
- 1001 缺失认证令牌
- 1002 认证令牌无效

Scenario: 退出登录成功

WHEN 登录客户调用 A7
THEN 系统 SHALL 删除 RedisPersonalCustomerTokenKey(customerID)
THEN 系统 SHALL 返回成功

Requirement: 服务端主动失效能力

系统 MUST 支持服务端主动使 token 失效（如封禁/强制下线），且无需等待 JWT 自然过期。

Scenario: 服务端主动踢出

WHEN 管理动作触发客户强制下线
THEN 系统 SHALL 删除对应 Redis token 状态
THEN 该客户后续请求 MUST 被中间件拒绝

2.1 KiB Raw Blame History Unescape Escape