From 7aa6a72bbc24896da12b105ac9bc52debf538cf7 Mon Sep 17 00:00:00 2001 From: Young581 Date: Fri, 18 Sep 2026 19:49:49 +0800 Subject: [PATCH 1/4] chore: add readiness failure diagnostics --- server/src/health.controller.ts | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/server/src/health.controller.ts b/server/src/health.controller.ts index da66c2b..6836139 100644 --- a/server/src/health.controller.ts +++ b/server/src/health.controller.ts @@ -1,4 +1,4 @@ -import { Controller, Get, Header, ServiceUnavailableException } from '@nestjs/common' +import { Controller, Get, Header, Logger, ServiceUnavailableException } from '@nestjs/common' import { HeadBucketCommand, S3Client } from '@aws-sdk/client-s3' import { constants } from 'node:fs' import { access } from 'node:fs/promises' @@ -11,6 +11,7 @@ type ReadinessResult = { status: 'ready' | 'unavailable'; time: string; checks: @Controller('health') export class HealthController { + private readonly logger = new Logger(HealthController.name) private readonly s3 = new S3Client({ region: 'auto', endpoint: process.env.R2_ENDPOINT, @@ -50,6 +51,7 @@ export class HealthController { private async runChecks(): Promise { const timeout = this.timeoutMilliseconds() const checks: Record = {} + const startedAt = Date.now() const outcomes = await Promise.allSettled([ this.withTimeout(this.prisma.$queryRaw`SELECT 1`, timeout), this.withTimeout(this.redis.ensureConnected().then(() => this.redis.client.ping()), timeout), @@ -61,12 +63,25 @@ export class HealthController { checks[names[index]] = outcome.status === 'fulfilled' ? index < 2 ? 'ok' : outcome.value as CheckStatus : 'failed' + if (outcome.status === 'rejected') { + this.logger.warn(JSON.stringify({ + event: 'readiness_check_failed', + check: names[index], + error: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason), + timeoutMs: timeout, + durationMs: Date.now() - startedAt + })) + } }) - return { + const result = { status: Object.values(checks).every((status) => status === 'ok' || status === 'skipped') ? 'ready' : 'unavailable', time: new Date().toISOString(), checks } + if (result.status === 'unavailable') { + this.logger.warn(JSON.stringify({ event: 'readiness_unavailable', ...result, durationMs: Date.now() - startedAt })) + } + return result } private async checkStorage(timeout: number): Promise { From c2c8b02dd3ad27a19c2c02c33128a9df3f5846e7 Mon Sep 17 00:00:00 2001 From: Young581 Date: Fri, 18 Sep 2026 19:57:06 +0800 Subject: [PATCH 2/4] fix: preserve readiness result type --- server/src/health.controller.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/server/src/health.controller.ts b/server/src/health.controller.ts index 6836139..c6cd1e8 100644 --- a/server/src/health.controller.ts +++ b/server/src/health.controller.ts @@ -73,7 +73,7 @@ export class HealthController { })) } }) - const result = { + const result: ReadinessResult = { status: Object.values(checks).every((status) => status === 'ok' || status === 'skipped') ? 'ready' : 'unavailable', time: new Date().toISOString(), checks From 652887f415109e61bcb92435dfbc247c7fced29a Mon Sep 17 00:00:00 2001 From: Young581 Date: Sat, 19 Sep 2026 11:07:16 +0800 Subject: [PATCH 3/4] docs: remove superseded project reports --- docs/QA_CLOSURE_2026-08-27.md | 56 -- ...36\346\226\275\350\256\241\345\210\222.md" | 510 ------------------ ...245\346\212\245\345\221\212-2026-09-13.md" | 319 ----------- ...230\346\270\205\345\215\225-2026-09-17.md" | 241 --------- ...215\346\270\205\345\215\225-2026-09-15.md" | 378 ------------- 5 files changed, 1504 deletions(-) delete mode 100644 docs/QA_CLOSURE_2026-08-27.md delete mode 100644 "docs/\346\225\264\344\275\223\345\256\236\346\226\275\350\256\241\345\210\222.md" delete mode 100644 "docs/\351\241\271\347\233\256\346\216\222\346\237\245\346\212\245\345\221\212-2026-09-13.md" delete mode 100644 "docs/\351\241\271\347\233\256\347\216\260\347\212\266\345\244\215\346\237\245\344\270\216\351\227\256\351\242\230\346\270\205\345\215\225-2026-09-17.md" delete mode 100644 "docs/\351\241\271\347\233\256\350\241\245\345\205\205\345\256\241\346\237\245\344\270\216\345\276\205\344\277\256\345\244\215\346\270\205\345\215\225-2026-09-15.md" diff --git a/docs/QA_CLOSURE_2026-08-27.md b/docs/QA_CLOSURE_2026-08-27.md deleted file mode 100644 index fcab59a..0000000 --- a/docs/QA_CLOSURE_2026-08-27.md +++ /dev/null @@ -1,56 +0,0 @@ -# 梨苑儿(BITerStore)双端前端 QA 收尾记录 - -日期:2026-08-27 - -## 本轮范围 - -本轮仅处理 `miniProgram/` Taro H5、微信小程序客户端及 `web/` Golden Reference 的前端验收。后端接口、服务端、管理后台和数据库不在本轮范围内。 - -## 自动验收结果 - -| 验收面 | 结果 | 说明 | -| --- | --- | --- | -| `web/` Golden Reference | 通过 | ESLint、6 项单测、生产构建通过 | -| `miniProgram/` 静态与领域测试 | 通过 | ESLint、16 项单测通过 | -| Taro H5 构建 | 通过 | 生产构建通过,无空白页或运行时诊断 | -| Taro H5 视觉回归 | 17/17 | 覆盖 360、390、430、820、1280 px 及核心页面/状态 | -| Taro H5 性能门槛 | 通过 | 首屏 368.3 KiB;门槛为首屏 400 KiB、单资源 384 KiB、总静态资源 3 MiB | -| 微信小程序构建 | 通过 | E2E fixture 构建通过,私有 AppID 仅注入 ignored 构建产物 | -| 微信开发者工具 E2E | 6/6 | route、稳定元素、交互、持久化、结构与截图均通过 | -| 微信运行时诊断 | 通过 | 应用 console error 0、exception 0 | - -微信自动化覆盖以下流程: - -1. 欢迎页 → 三步引导 → 游客访问 → 首页。 -2. 搜索 → 商品详情 → 收藏 → 联系卖家。 -3. 图片 fixture → Tobby 成文 → 草稿 → 预览 → 发布成功。 -4. 消息 → 通知详情 → 聊天 → 文字与图片消息。 -5. 收藏 → 我的 → 重置演示数据 → 重播引导。 -6. Loading、Searching、Empty、No Results、Network Error、Maintenance、Unavailable、Success 与 404 状态。 - -## 本轮修复与守门 - -- 统一双端底栏为“首页 / 搜索 / 发布 / 消息 / 我的”。 -- H5 视觉脚本自行启动静态 SPA 服务,避免依赖人工启动预览进程。 -- H5 浏览器 profile 与双端 QA 工件位于微信项目监听目录之外,避免截图/缓存写入触发连续重编译和 `appLaunch timeout`。 -- H5 图片适配层对首屏图片使用 eager/high,其余图片默认 lazy,并统一异步解码。 -- 新增版本化 H5 性能检查,预算超限会直接令 QA 失败。 -- 微信 E2E 保留原始 DevTools 日志,只精确标记已知的失效 WebView `routeDone` 工具噪声;任何应用错误或异常仍会阻断通过。 -- 微信独立 `launch` 验收发现旧通道时使用 CLI `quit → auto` 刷新并等待模拟器,再由官方 `miniprogram-automator.connect` 驱动页面并在结束时安全关闭;`connect` 只复用人工 watch 会话。 - -## 仍需人工完成 - -至少使用一台实体微信真机完成以下冒烟,之后才可勾选 `TODO.md` Phase 7: - -- 首次打开显示“托比正在准备 App 资源包……”,再次打开不重复等待。 -- 五个底栏入口、页面返回栈和 Safe Area 正常。 -- 搜索、筛选、详情、收藏、联系卖家流程可用。 -- 发布页实际选择相册图片,输入法顶起时表单和按钮不被遮挡。 -- 聊天输入、图片入口、长列表滚动和页面恢复正常。 -- 360–430 px 等效手机宽度下无横向溢出、错位或不可点击区域。 - -真机冒烟只做本地预览/调试,不上传体验版,不提审,不发布。 - -## 已知环境风险 - -仓库锁定 Node 22.13.x;本轮执行机器为 Node 25.2.1。当前构建及自动化均通过,但最终真机验收和团队持续开发应使用锁定版本。Taro 4.2.1 的上游传递依赖告警仍按 `TODO.md` 记录处理,不使用 `npm audit fix --force` 破坏精确版本约束。 diff --git "a/docs/\346\225\264\344\275\223\345\256\236\346\226\275\350\256\241\345\210\222.md" "b/docs/\346\225\264\344\275\223\345\256\236\346\226\275\350\256\241\345\210\222.md" deleted file mode 100644 index d292b4e..0000000 --- "a/docs/\346\225\264\344\275\223\345\256\236\346\226\275\350\256\241\345\210\222.md" +++ /dev/null @@ -1,510 +0,0 @@ -# 梨苑儿(BITerStore)校内二手书交易平台整体实施计划 - -> 当前决策(2026-08-26):正式重启 Taro 双端迁移,以 `miniProgram/` 作为微信小程序与 H5 的唯一新客户端;现有 `web/` H5 保留为 Golden Reference 和回滚版本。 - -> 文档版本:v0.1 -> 制定日期:2026-08-25 -> 当前阶段:纯前端交互原型已完成,准备进入产品验证、认证对接与工程化实施阶段 - -## 1. 结论先行 - -梨苑儿第一阶段应被定义为:**仅面向北京理工大学已认证成员、以信息撮合和校内当面交易为核心、不承接线上支付的二手书平台**。 - -建议采用以下路线: - -1. 保留当前 `web/` React 原型,作为产品需求、视觉规范和交互验收基线。 -2. 正式客户端新建 **Taro + React + TypeScript** 工程,优先发布微信小程序,同时保留编译 H5 的能力。 -3. 新建独立后端,采用“模块化单体”而非一开始拆微服务;共用一套 API 服务于小程序和 H5。 -4. 校园身份认证必须通过 BIT101/学校授权的认证服务完成;梨苑儿不保存学校统一身份认证密码,也不自行模拟或抓取学校登录流程。 -5. MVP 不做在线支付、物流、评价体系、AI 识别和复杂推荐。先验证“有书可找、发布够快、能安全联系、交易能闭环”。 - -推荐的最终形态不是简单的 H5 套壳。`web-view` 可以用于早期内测或承载少量辅助页面,但不应作为小程序首页、发布、聊天等主流程的长期方案。 - -## 2. 已有资产与现状判断 - -### 2.1 当前前端 - -现有仓库已经具备一个完成度较高的 React 19 + TypeScript 移动端原型,主要能力包括: - -- 首页、分类、搜索、组合筛选和商品详情; -- 图片上传、发布、草稿恢复和发布预览; -- 收藏、我的发布、消息中心和聊天演示; -- Loading、Empty、Error、Maintenance、404 等完整状态; -- 360px、390px、430px 移动端适配; -- `DemoRepository` 数据边界、本地持久化、单元测试和 Service Worker; -- 已建立的品牌、Design Tokens、Tobby 角色和视觉资产。 - -它目前仍是**纯前端演示系统**:数据主要在 LocalStorage/IndexedDB 中,默认用户已认证,没有真实账户、后端、内容审核、实时聊天和生产安全能力。 - -### 2.2 BIT101 与 BIT-Login 可复用内容 - -BIT101 的公开前端和 Go 后端展示了两代相关流程: - -- 旧流程:WebVPN 初始化、统一身份验证、邮件验证、注册,登录后通过 JWT 形式的 `fake-cookie` 鉴权; -- 较新前端:调用独立登录服务,以 challenge、短期 access token 和短信二次验证完成教务相关身份认证。 - -`BIT101-dev/BIT-Login` 当前主分支则已经提供较完整的 Kotlin/Ktor 认证服务:异步 challenge、短信二次验证、短期 session,以及面向指定 `audience` 签发的 Ed25519 注册 JWT。它可以作为梨苑儿的校园认证适配器,优先使用 `/api/auth/*` 与 `/registration-token`,无需复制旧版 WebVPN 实现。 - -但它不是学校官方 OAuth/OIDC 服务,生产使用前仍需完成以下确认和加固: - -- 当前仓库根目录未发现明确的 `LICENSE` 文件,公开可读不等于允许复制、修改和部署;应请维护者补充许可证或给予书面许可; -- 默认 CORS 配置使用 `anyHost()`,生产实例必须改为域名白名单; -- 服务同时暴露成绩、课程、Cookie 等接口,梨苑儿专用实例应通过代码或网关只开放 `/api/auth/*` 和健康检查; -- 确认部署责任、上游认证变化、故障联络、限流以及用户凭据处理披露。 - -BIT101 前后端采用 AGPL-3.0,当前梨苑儿前端采用 Apache-2.0。可以参考其公开设计和文档;若复制、修改或部署其代码,必须先做许可证兼容性评估,不能默认保持梨苑儿原有许可不变。 - -## 3. 客户端方案选择 - -| 方案 | 研发速度 | 小程序体验 | 复用现有前端 | 长期维护 | 结论 | -| --- | --- | --- | --- | --- | --- | -| 继续现有 H5 | 最快 | 用户需从浏览器进入 | 最高 | 双端能力弱 | 可用于封闭内测 | -| 小程序 `web-view` 套 H5 | 较快 | 登录、导航、分享、文件能力存在割裂 | 高 | 容易形成平台边界问题 | 只作临时过渡 | -| 原生微信小程序 | 较慢 | 最佳 | 很低 | 单端维护清晰 | 团队只做微信时可选 | -| Taro React:微信小程序 + H5 | 中等 | 接近原生 | 可复用 React 思维、类型和部分业务代码,不能直接复用 DOM 页面 | 一套业务核心支持两端 | **推荐** | - -### 推荐落地方式 - -采用渐进迁移,而不是直接改造当前 `web/`: - -```text -BITerStore/ -├─ web/ # 现有原型,继续作为 UI/交互基准与内测 H5 -├─ clients/ -│ └─ miniProgram/ # Taro React,输出 weapp 与 h5 -├─ packages/ -│ ├─ contracts/ # API DTO、状态枚举、校验规则 -│ ├─ design-tokens/ # 色彩、字号、圆角、间距 -│ └─ domain/ # 无平台依赖的业务逻辑 -├─ server/ # 独立后端 -├─ admin/ # 最小化治理后台 -└─ docs/ -``` - -迁移时可以复用:产品信息架构、文案、图片资产、Design Tokens、TypeScript 类型、种子数据和部分纯业务函数。不能预期直接复用:Next/Vinext 路由、浏览器 DOM 组件、LocalStorage/IndexedDB、Service Worker 和依赖浏览器 API 的 CSS/动画。 - -若团队必须在 4 周内让真实用户试用,可先发布 HTTPS H5 内测;但此阶段仍要使用真实后端,不能继续用本地演示数据。完成关键数据验证后再发布 Taro 小程序。 - -### 可采用的开源小程序框架 - -可以使用其他开源框架,但应该选择“维护活跃、许可证明确、团队技术栈匹配”的基础框架,不建议直接套一个来源不明的二手商城成品项目。 - -| 开源方案 | 主要技术 | 优点 | 对本项目的代价 | 建议 | -| --- | --- | --- | --- | --- | -| [Taro](https://github.com/NervJS/taro) | React/Vue、MIT | 支持微信小程序与 H5;与现有 React/TypeScript 团队最接近 | 仍需重写 DOM、路由和浏览器存储层 | **首选** | -| [uni-app](https://github.com/dcloudio/uni-app) | Vue、Apache-2.0 | 多端生态和插件丰富,上手资料多 | 团队需从 React 切到 Vue;现有组件复用更少 | 团队更熟 Vue 时选择 | -| [Mpx](https://github.com/didi/mpx) | 增强小程序 DSL | 小程序能力和性能优化较深入 | 社区规模与团队熟悉度需单独验证 | 有既有 Mpx 经验时选择 | -| [微信原生示例](https://github.com/wechat-miniprogram/miniprogram-demo) + 原生框架 | WXML/WXSS/JS/TS | 平台能力最直接、依赖最少 | H5 需要单独实现,现有 React 复用最低 | 确定只做微信小程序时选择 | - -最终选型用一个 2 天 spike 决定:分别验证商品长列表、图片上传、登录 challenge、底部导航、分享和 360–430px 真机效果。若没有明显阻断项,沿用 Taro React,避免仅因“还有其他开源项目”而更换技术栈。 - -## 4. 产品范围 - -### 4.1 MVP 必须完成 - -- 校园身份认证、微信身份绑定、登录与注销; -- 浏览、关键词搜索、分类和校区筛选; -- 商品详情、收藏; -- 发布、编辑、下架、重新上架、标记预留/已售; -- 文本会话、未读数、系统通知; -- 举报商品/用户、拉黑、违规内容处置; -- 我的发布、我的收藏、会话和基础个人资料; -- 最小管理后台:用户、商品、举报、封禁、审计日志; -- 用户协议、隐私政策、交易安全提示、账号注销与数据删除入口; -- 监控、备份和基础运营指标。 - -### 4.2 MVP 明确不做 - -- 在线支付、担保交易、退款和平台抽成; -- 快递/跑腿履约; -- 竞价、复杂订单、优惠券、积分和会员体系; -- 公布手机号、精确宿舍或实时位置; -- 图片消息、语音、群聊和音视频; -- AI 自动识书、个性化推荐和复杂搜索集群; -- 扩展到数码、代购、票务等高风险品类。 - -### 4.3 核心业务闭环 - -```mermaid -flowchart LR - A[微信进入] --> B[微信会话] - B --> C[校园身份认证] - C --> D[浏览 / 搜索] - D --> E[商品详情] - E --> F[站内联系] - F --> G[卖家设为预留] - G --> H[校内当面验货交易] - H --> I[卖家标记已售] - - C --> J[发布书籍] - J --> K[审核 / 风控] - K --> D -``` - -## 5. 认证与账户设计 - -### 5.1 两类身份必须分开 - -- **微信身份**:用于识别当前小程序设备/微信用户和建立应用会话;`wx.login` 只能证明微信侧身份,不能证明其为北理学生。 -- **校园身份**:用于授予“北理认证”资格,必须来自学校或 BIT101 明确授权的可信认证结果。 - -数据库中将两者绑定到一个梨苑儿用户,而不是把学号直接当作主键。 - -### 5.2 确定方案:BIT-Login 注册 JWT - -在取得使用许可后,部署梨苑儿专用的 BIT-Login 实例,采用以下接口: - -1. `POST /api/auth/start`:提交学号、统一认证密码和所需服务,创建 challenge; -2. `GET /api/auth/{challenge_id}`:轮询 `running / waiting_sms / authenticated / failed / expired`; -3. `POST /api/auth/{challenge_id}/sms`:需要时提交短信验证码; -4. `POST /api/auth/{challenge_id}/registration-token`:认证成功后,为 `audience=biterstore` 签发短期 Ed25519 JWT; -5. `DELETE /api/auth/{challenge_id}`:梨苑儿完成注册/绑定后立即销毁 challenge 和关联会话。 - -梨苑儿后端仅信任 registration token,不接收学校密码、短信码或教务 Cookie。它必须验证 JWT 的 Ed25519 签名、`iss`、`aud=biterstore`、`exp`、`iat`、`purpose=registration`、`sub` 和 `jti`,并将 `jti` 作为一次性凭证消费,防止重放。 - -BIT-Login 只用于证明校园身份,不调用或保存成绩、课表、学分等与交易无关的数据。学校邮箱验证码可作为认证服务长时间中断时的人工审核备选,但不得静默等同于完整统一身份认证。 - -### 5.3 推荐登录流程 - -```mermaid -sequenceDiagram - participant M as 小程序 - participant B as 梨苑儿后端 - participant W as 微信接口 - participant I as BIT-Login 专用实例 - - M->>B: wx.login 临时 code - B->>W: code2Session(仅服务端调用) - W-->>B: openid / session_key - B-->>M: 未认证的短期应用会话 - M->>I: /api/auth/start(仅本次使用学校凭据) - I-->>M: challenge_id + challenge token - M->>I: 轮询状态;需要时提交短信码 - I-->>M: authenticated - M->>I: 申请 audience=biterstore 的 registration JWT - I-->>M: 5 分钟短期 JWT - M->>B: 提交 registration JWT - B->>B: 验签、校验 claims、单次消费 jti - B-->>M: 已认证的 access token + refresh token - M->>I: 删除 challenge -``` - -### 5.4 最小化存储 - -建议仅保存: - -- 内部 `user_id`; -- 微信 `openid`(如确有跨应用需求再评估 `unionid`); -- 认证方 `issuer` 与不可逆/稳定的外部主体标识; -- 校园认证状态、认证时间、到期时间; -- 用户主动填写的昵称、头像、校区。 - -默认不保存:统一身份认证密码、WebVPN Cookie、短信验证码、教务 Cookie、成绩、课程表、身份证号。若业务确需保存学号,应先论证必要性,并做字段级加密、访问审计和展示脱敏。 - -## 6. 技术架构 - -### 6.1 总体结构 - -```mermaid -flowchart TB - MP[微信小程序 / Taro] --> API[HTTPS API 网关] - H5[H5 / Taro] --> API - ADM[管理后台] --> API - API --> APP[模块化业务服务] - APP --> PG[(PostgreSQL)] - APP --> REDIS[(Redis,可按需启用)] - APP --> OSS[(对象存储)] - APP --> AUTH[BIT101 / 学校认证] - APP --> MSG[WebSocket / 消息通道] - APP --> OBS[日志、指标、告警] -``` - -### 6.2 后端建议 - -第一阶段使用模块化单体: - -- 推荐栈:团队熟悉 TypeScript 时使用 NestJS/Fastify;熟悉 Go 时使用 Gin。两者都可满足 MVP,团队能力比框架偏好更重要。 -- API:REST;实时聊天使用 WebSocket。若早期部署环境不稳定,可先用 5–10 秒增量轮询。 -- 数据库:PostgreSQL,作为唯一事实来源。 -- 搜索:MVP 先使用 PostgreSQL 全文搜索/模糊匹配和规范化 ISBN;数据量或相关性出现瓶颈后再引入 Meilisearch。 -- 缓存与限流:初期可用进程内限流;多实例或消息规模上升后启用 Redis。 -- 图片:S3 兼容对象存储,客户端直传临时凭证/签名 URL,服务端记录元数据并执行格式、大小和内容检查。 -- 校园认证:隔离部署 BIT-Login Ktor 服务;网关只允许必要认证路由,SQLite 放持久化加密磁盘,注册私钥独立保管。 -- 部署:中国大陆 HTTPS 域名、自动化构建、数据库迁移、每日备份;正式上线前确认 ICP、校方和小程序主体/类目要求。 - -不要在 MVP 直接照搬 BIT101 的 PostgreSQL + Redis + Meilisearch + Gorse 全套部署;交易平台初期的数据规模不需要推荐系统,额外组件会显著增加运维成本。 - -## 7. 核心数据模型 - -| 实体 | 关键字段 | -| --- | --- | -| `users` | id、nickname、avatar、campus、status、created_at | -| `identities` | user_id、provider、external_subject、verified_at、expires_at | -| `wechat_accounts` | user_id、openid、unionid_nullable、last_login_at | -| `sessions` | user_id、refresh_token_hash、device、expires_at、revoked_at | -| `listings` | seller_id、title、isbn、author、category、condition、price、campus、description、status | -| `listing_images` | listing_id、object_key、sort_order、moderation_status | -| `favorites` | user_id、listing_id、created_at,联合唯一约束 | -| `conversations` | listing_id、buyer_id、seller_id、last_message_at | -| `messages` | conversation_id、sender_id、type、content、created_at、read_at | -| `reports` | reporter_id、target_type、target_id、reason、evidence、status | -| `blocks` | user_id、blocked_user_id、created_at | -| `moderation_actions` | operator_id、target、action、reason、created_at | -| `audit_logs` | actor、action、resource、request_id、created_at | - -商品状态统一为: - -```text -DRAFT → PENDING_REVIEW → ACTIVE → RESERVED → SOLD - ↘ OFF_SHELF - ↘ BLOCKED -``` - -关键约束:价格使用整数分;删除优先软删除;状态变更使用乐观锁;收藏、会话和幂等请求建立唯一约束;卖家不能联系或收藏自己的商品。 - -## 8. API 分组 - -```text -POST /v1/auth/wechat/session -POST /v1/auth/campus/start -POST /v1/auth/campus/callback -POST /v1/auth/refresh -POST /v1/auth/logout -GET /v1/me -PATCH /v1/me -DELETE /v1/me - -GET /v1/listings -POST /v1/listings -GET /v1/listings/:id -PATCH /v1/listings/:id -POST /v1/listings/:id/state -POST /v1/listings/:id/favorite -DELETE /v1/listings/:id/favorite - -POST /v1/uploads/presign -POST /v1/uploads/:id/complete - -GET /v1/conversations -POST /v1/conversations -GET /v1/conversations/:id/messages -POST /v1/conversations/:id/messages -POST /v1/conversations/:id/read - -POST /v1/reports -POST /v1/blocks/:userId -GET /v1/notifications -``` - -所有写接口应具备:身份校验、对象级权限检查、输入校验、限流、幂等策略、结构化审计日志和统一错误码。前后端通过 OpenAPI 生成类型或共享 `contracts`,不手工维护两套接口类型。 - -## 9. 安全、隐私与平台治理 - -### 9.1 安全底线 - -- 全站 HTTPS,密钥通过部署环境管理,不进入 Git; -- access token 短期有效,refresh token 轮换并只存哈希; -- 小程序令牌通过授权头传输;H5 优先使用 `HttpOnly + Secure + SameSite` Cookie; -- 密码、学校 Cookie 和微信 `session_key` 不发给客户端、不写日志; -- 图片校验 MIME、扩展名、尺寸、容量,重新编码后再公开; -- 登录、发布、私信、举报均做分层限流和异常告警; -- 对越权、批量爬取、刷屏、SQL 注入、XSS、CSRF、SSRF、恶意文件上传做专项测试; -- 管理员启用强认证,所有处置动作留审计记录。 -- BIT-Login 强制 HTTPS、来源白名单和速率限制;关闭或拦截成绩、Cookie、课程等无关路由;challenge 数据按最短期限清理。 - -### 9.2 隐私原则 - -依据最小必要原则,只收集完成功能所需信息;明确告知处理目的、保存期限和第三方共享情况;提供查阅、更正、注销和删除渠道。校园认证信息与公开资料分离,默认只展示“已认证”徽章,不公开学号、真实姓名、手机号或具体宿舍。 - -### 9.3 交易和内容治理 - -- 上线前由校方/法律顾问确认平台主体责任、用户协议和交易规则; -- 仅允许书籍,建立禁售清单:盗版、内部涉密材料、非法出版物、含个人信息的资料等; -- 商品详情明确“平台仅提供信息撮合,建议校内公共场所当面验书”; -- 举报入口必须在商品、用户和会话中可达; -- 建立举报受理时限、申诉、封禁、证据留存和紧急下架流程; -- 平台是否构成电子商务平台、实名核验和信息报送义务,应在公测前取得专业判断,不能仅因“不做支付”而忽略平台责任。 - -## 10. 管理后台与运营 - -管理后台不是上线后的附加项,MVP 至少需要: - -- 待审核/被举报商品列表; -- 用户状态、认证状态和风险记录; -- 商品下架、用户禁言/封禁、申诉恢复; -- 举报工单流转和处置备注; -- 敏感操作二次确认和审计日志; -- 基础指标看板。 - -首批关注指标: - -- 校园认证成功率、失败原因和耗时; -- 新用户首日发布率; -- 搜索有结果率、商品详情到发起会话转化率; -- 发布完成率和平均发布时间; -- 7/30 日有效商品数、预留率、已售率; -- 举报率、处置时长、封禁率; -- API 错误率、P95 延迟、消息到达率。 - -不要把注册量、PV 当成唯一成功指标。MVP 的北极星指标建议采用:**每周完成的有效校内交易数**,由“双方确认完成”或卖家标记已售并结合会话行为估算。 - -## 11. 分阶段实施计划 - -以下按 3–4 名兼职学生开发者估算,共约 8 周。若认证协调或小程序资质尚未完成,时间应顺延,而不是绕过认证上线。 - -### 第 0 阶段:立项与关键验证(第 1 周) - -- 明确产品负责人、技术负责人、治理负责人和校方联系人; -- 联系 BIT-Login/BIT101 团队,完成使用许可、认证边界、测试环境和维护责任确认; -- 确认小程序主体、服务类目、域名备案、隐私指引和发布资质; -- 用 10–20 名同学访谈验证找书、卖书、联系和安全痛点; -- 冻结 MVP 范围、数据字典、状态机和验收指标; -- 产出认证技术验证 Demo,不接业务数据库。 - -**退出条件**:BIT-Login 许可证/书面许可明确,专用实例通过安全验证;小程序资质路线明确;团队接受 MVP 边界。 - -### 第 1 阶段:工程骨架(第 2 周) - -- 初始化 Taro 客户端、后端、共享 contracts 和 CI; -- 建立 PostgreSQL schema、迁移、种子数据和本地开发环境; -- 建立错误码、日志、request ID、配置管理和 API 文档; -- 将 Design Tokens 和核心资产迁入小程序; -- 搭建最小管理后台骨架。 - -**退出条件**:测试环境可自动部署;小程序和 H5 能调用健康检查及演示 API。 - -### 第 2 阶段:账户与校园认证(第 3 周) - -- 完成微信会话、校园认证、账户绑定、刷新、注销; -- 实现认证失败、短信二次验证、服务维护和过期重认证状态; -- 完成隐私授权、用户协议、账号删除和会话撤销; -- 对认证接口做重放、越权、过期和日志泄露测试。 - -**退出条件**:测试用户能够完成首次认证和再次登录;系统不保存学校密码/Cookie。 - -### 第 3 阶段:商品主链路(第 4–5 周) - -- 完成图片上传、商品 CRUD、审核状态和状态机; -- 迁移首页、分类、搜索、详情、收藏和我的发布; -- 完成价格、ISBN、校区、成色和描述校验; -- 接入基础内容安全与人工复核; -- 做搜索索引、分页、并发更新和上传失败恢复测试。 - -**退出条件**:真实用户可以发布、找到、收藏和管理商品;不存在客户端伪造卖家身份的问题。 - -### 第 4 阶段:联系与交易闭环(第 6 周) - -- 完成一物一买卖双方会话、文本消息、已读和未读数; -- 完成预留、取消预留、已售和重新上架; -- 完成拉黑、举报、系统通知和公共场所交易提示; -- 处理断线重连、消息幂等、顺序和重复发送。 - -**退出条件**:从商品详情到沟通、预留和已售可以完整走通。 - -### 第 5 阶段:治理、测试与灰度(第 7 周) - -- 补全管理后台和处置 SOP; -- 单元测试、API 集成测试、关键 E2E 和安全测试; -- 进行数据库备份恢复演练、认证服务故障演练; -- 20–50 名认证用户封闭测试,收集指标和问题; -- 修复阻断级问题并完成隐私/合规检查。 - -**退出条件**:无 P0/P1 缺陷;举报可闭环;备份可恢复;核心指标可观测。 - -### 第 6 阶段:小范围上线(第 8 周) - -- 微信小程序提审并准备审核补充材料; -- 按校区或学院逐步放量,不一次全校推广; -- 建立值班、告警、用户反馈和紧急下线机制; -- 上线后一周只修稳定性和安全问题,不扩需求; -- 根据有效交易数、供给密度和举报率决定是否扩大范围。 - -## 12. 测试与上线门槛 - -### 功能门槛 - -- 认证、发布、搜索、详情、会话、预留/已售、举报全部具备 E2E; -- 关键写操作支持重试且不产生重复数据; -- 商品状态和权限在服务端强制校验; -- 360–430px 小程序真机和主流微信版本通过验收。 - -### 性能与可靠性门槛 - -- 核心读取 API P95 小于 500ms(不含外部认证); -- 图片经过压缩与缩略图处理,弱网可展示占位和重试; -- 认证服务不可用时不影响已认证用户浏览已有内容; -- 数据库每日备份,至少完成一次恢复演练; -- 关键错误、登录异常、内容风险和管理员操作可追踪。 - -### 安全与合规门槛 - -- 仓库和构建物无密钥、Cookie、真实学号和个人测试数据; -- 完成权限矩阵、数据保留期限和第三方清单; -- 用户可注销,刷新令牌和关联会话随之撤销; -- 隐私政策、用户协议、交易规则、举报与申诉路径已上线; -- 校方/BIT101 接口授权、小程序资质和许可证评估均有记录。 - -## 13. 主要风险与应对 - -| 风险 | 影响 | 应对 | -| --- | --- | --- | -| BIT-Login 无明确许可证或维护承诺 | 无法合法部署或登录不稳定 | 第 0 周取得书面许可/补充许可证;自托管、监控并保留学校认可的替代方案 | -| BIT-Login 默认暴露无关接口与宽松 CORS | 凭据、Cookie 或教务数据风险 | 专用实例只开放认证路由,收紧 CORS、网关、限流和日志 | -| 学校认证流程变化或要求短信 | 登录中断 | challenge 状态机、超时/重试、维护页、服务端可观测性 | -| 现有 React 原型无法直接编译成小程序 | 迁移延期 | 以页面为单位迁移,先共享 contracts/domain/tokens,不承诺 DOM 代码零成本复用 | -| 小程序主体、类目或域名资质不足 | 无法提审 | 立项时同步推进,不等开发结束后才处理 | -| 书源不足、搜索总为空 | 用户流失 | 按学院/课程定向冷启动,先建设供给再扩大用户 | -| 私聊诈骗或线下安全事件 | 信任和责任风险 | 校园认证、站内沟通、拉黑举报、公共地点提醒、治理 SOP | -| 盗版和违规资料 | 法律/校方风险 | 禁售规则、图片/文本审核、快速下架与申诉 | -| 过早引入支付或综合品类 | 范围和合规失控 | MVP 明确只做书和线下交易,达到阶段指标后再立项评估 | -| 直接复制 AGPL 代码 | 许可证义务不清 | 仅以接口和思想作参考;复制或派生前做专项许可证评估 | - -## 14. 团队分工建议 - -- 产品/设计:需求边界、流程、Design Tokens、文案、可用性测试; -- 小程序前端:Taro 页面迁移、平台 API、状态管理、性能与真机适配; -- 后端:认证、数据模型、API、消息、对象存储、部署和监控; -- 治理/运营:校方沟通、认证授权、规则、审核、冷启动和反馈; -- 全员共同负责:接口评审、隐私检查、E2E 验收和上线值班。 - -每周只维护一份可交付看板,任务必须带负责人、验收条件和截止日期。架构决策以 ADR 记录,特别是认证协议、客户端技术栈、令牌存储、内容审核和许可证决策。 - -## 15. 立刻可执行的下一步 - -1. 由一名团队成员联系 BIT-Login/BIT101 维护者,确认许可证或取得书面部署许可。 -2. 确认团队能否取得微信小程序主体、所需服务类目和已备案 HTTPS 域名。 -3. 用现有原型对 10–20 名学生做任务测试,记录发布一本书、找到教材和联系卖家的完成率。 -4. 创建 `contracts`,先冻结 `User`、`Listing`、`Conversation`、`Report` 和商品状态枚举。 -5. 做两个限时技术验证:Taro 迁移一个商品列表页;通过 BIT-Login 完成一次不落业务库的 challenge → registration JWT → 验签流程。 -6. 技术验证通过后,再开始后端 schema 和全量页面迁移。 - -### 向 BIT-Login/BIT101 团队确认的问题 - -- 当前仓库采用什么许可证?是否允许梨苑儿修改并自托管专用实例? -- `biterstore` 是否可以加入 `REGISTRATION_JWT_ALLOWED_AUDIENCES`?注册 JWT 的 `issuer`、`kid` 和公钥如何分发/轮换? -- `sub` 是否保证为本次成功认证的统一身份账号,是否可提供不暴露学号的稳定匿名主体? -- registration JWT 是否计划增加 JWKS、撤销或更明确的版本兼容机制? -- 是否支持小程序环境,域名是否可加入 request 合法域名,是否存在 CORS/Referer 限制? -- 自托管实例是否可只保留认证路由,关闭成绩、Cookie、课表等业务接口? -- 是否有上游变更通知、版本策略、已知风控限制和维护联系人? -- BIT-Login 如何处理和暂存密码、短信码、学校 Cookie/session,梨苑儿需要向用户披露哪些事项? - -## 16. 参考资料 - -- [BIT101 前端仓库](https://github.com/BIT101-dev/BIT101):Vue3 前端、统一身份认证入口和登录服务调用参考。 -- [BIT101 Go 后端](https://github.com/BIT101-dev/BIT101-GO):旧版 WebVPN 验证、JWT `fake-cookie` 和服务端部署参考。 -- [BIT101 API 文档](https://bit101-api.apifox.cn/):用户、上传、消息等接口的公开说明。 -- [BIT-Login](https://github.com/BIT101-dev/BIT-Login):Kotlin/Ktor challenge、短信二次验证和 Ed25519 registration JWT 实现。 -- [梨苑儿当前前端(BITerStore)](https://github.com/AnonymousUser443/BITerStore):现有移动端产品原型和视觉基线。 -- [Taro 官方文档](https://docs.taro.zone/docs/):React、多小程序平台与 H5 的跨端开发能力。 -- [uni-app](https://github.com/dcloudio/uni-app):基于 Vue 的多端框架备选。 -- [Mpx](https://github.com/didi/mpx):增强型跨端小程序框架备选。 -- [微信小程序 `wx.login` 文档](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html):微信登录临时凭证。 -- [微信小程序 `code2Session` 文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/user-login/code2Session.html):服务端交换微信会话信息。 -- [微信小程序 `web-view` 文档](https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html):H5 嵌入小程序时的平台边界。 -- [《中华人民共和国个人信息保护法》](https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm):个人信息处理、最小必要和用户权利要求。 -- [《中华人民共和国电子商务法》](https://www.samr.gov.cn/wljys/gzzd/art/2023/art_3e75434c954b4cb9bd14867dacff26d1.html):平台经营者、身份核验和平台治理相关义务。 - ---- - -本计划的第一个硬门槛不是“开始写后端”,而是**确认合法、稳定、最小化的校园认证路径**。认证、主体资质和治理责任明确后,现有原型已经足以支撑快速进入真实 MVP 开发。 diff --git "a/docs/\351\241\271\347\233\256\346\216\222\346\237\245\346\212\245\345\221\212-2026-09-13.md" "b/docs/\351\241\271\347\233\256\346\216\222\346\237\245\346\212\245\345\221\212-2026-09-13.md" deleted file mode 100644 index 47db600..0000000 --- "a/docs/\351\241\271\347\233\256\346\216\222\346\237\245\346\212\245\345\221\212-2026-09-13.md" +++ /dev/null @@ -1,319 +0,0 @@ -# 梨苑儿(BITerStore)项目排查报告 - -审查日期:2026-09-13 -状态更新:2026-09-14 -审查对象:`F:\BITerstore\app` -审查分支:`codex/admin-governance-console` -同步基线:`cda3fa05e6affcde571d0e692addeb3383b39017` -整改提交:`676ef0cb4c8ea334b762935d9805d482eeaba8e4` -Pull Request:[#21](https://github.com/AnonymousUser443/BITerStore/pull/21) - -## 1. 结论摘要 - -本轮先成功执行 `git fetch --prune origin`,确认远程 `origin/main` 从 `c0f6d76` 更新到 `cda3fa0`,随后将当前分支快进同步到该提交。Web、Server、Admin 的当前代码已重新完成 lint、测试和构建;MiniProgram 已在完整本地依赖树上完成 lint、48 个测试、H5/WeApp 构建、包体门禁和微信开发者工具自动化验证。隔离本地环境的全新 `npm ci` 仍被 registry 权限阻断,但 Young 服务器的 H5 生产镜像构建已在真实 registry 上完成在线依赖审计并通过。H5 视觉回归脚本覆盖 65 个页面/视口组合,`diagnostics: []`。 - -基础功能链路目前可构建、可测试,路由和页面清单没有发现明显缺页,H5 的主要响应式布局也没有自动化几何异常。已有微信项目使用私有配置中的真实 AppID 完成了模拟器/自动化 E2E;搜索、发布、收藏、消息、反馈、资料重置和全部状态页均有通过证据。本轮继续完成第二批运营前整改:举报目标与配额、图片魔数/结构/尺寸校验、pending 生命周期清理、公共安全响应头和 `MUTED` 服务端边界均已落地并有回归测试。隔离本地环境无法重现全新依赖在线 audit,但生产 H5 构建已通过真实在线审计;真机网络与授权弹窗抽查仍需设备。 - -本报告记录本地审查、代码整改、生产部署和验证;整改提交 `676ef0c` 已推送至 `Young581/BITerStore:codex/admin-governance-console`,并创建目标为 `AnonymousUser443/BITerStore:main` 的 PR #21。GitHub fetch 本轮已成功,下面的远程提交号是实际获取到的结果;本地 npm registry 访问仍受环境权限限制,但生产构建已完成真实在线审计,详见第 6、8、11 节。 - -## 2. 审查范围与方法 - -- 对比 Git 分支、远程跟踪引用、提交差异和工作区状态。 -- 检查 `web/` Golden Reference、`miniProgram/`、`server/`、`admin/` 及 `deploy/` 的路由、认证、缓存、上传、媒体、用户、审核和反向代理配置。 -- 执行各子项目已有的 lint、单元测试和构建命令。 -- 执行 H5 65 个页面/视口的视觉检查及 WeApp 构建后包检查。 -- 检索限流、安全响应头、JWT/会话撤销、上传校验和注销清理实现。 -- 未修改 `docs/项目交接文档.md`,未修改或删除 `Assets/generated/`。 - -## 3. 同步与远程对比 - -### 3.1 当前同步结果 - -| 项目 | 结果 | -| --- | --- | -| 当前分支 | `codex/admin-governance-console` | -| 同步基线 | `cda3fa0`(2026-09-03,合并 PR #20) | -| 本地 `origin/main` | `cda3fa0`,与同步基线完全一致 | -| 整改提交 | `676ef0c`(第二批整改及此前 P0/P1 修复) | -| 相对 `origin/main` | PR #21 包含本轮整改提交及本次报告状态更新 | -| 远端分支 | `Young581/BITerStore:codex/admin-governance-console` | -| 生产发布 | `b76e825` 已切换(旧版本 `97fe3f7`) | -| 回退分支 | `backup/pre-sync-20260913-131721`,指向同步前的 `3c60800` | -| 安全加固提交 | `97fe3f7` 已作为 PR #20 合并进 `origin/main`;`cda3fa0` 是合并提交 | -| 推送 | 已执行 | -| Pull Request | [#21:security: 完成第二批运营前安全整改](https://github.com/AnonymousUser443/BITerStore/pull/21) | - -PR #20 已将 `codex/build-security-alignment@97fe3f7` 合并进 `origin/main`,内容包括客户端依赖 overrides、Node 22 引擎约束和 `npm run audit:dependencies` 门禁。本轮同步的是该合并后的远程状态。 - -### 3.2 远程获取结果 - -本轮提权只读 fetch 已成功: - -```text -From https://github.com/AnonymousUser443/BITerStore - c0f6d76..cda3fa0 main -> origin/main -``` - -随后执行 `git merge --ff-only origin/main` 成功,没有覆盖工作区已有交接文档、生成素材或本报告。 - -## 4. 构建、测试与质量门禁 - -| 子项目 | 检查 | 结果 | -| --- | --- | --- | -| `web` | lint | 通过 | -| `web` | 测试 | 40 通过 | -| `web` | build | 通过 | -| `miniProgram` | lint | 通过(Node 22.13.1;在完整本地依赖树上复验) | -| `miniProgram` | 测试 | 48 通过 | -| `miniProgram` | H5 build | 通过 | -| `miniProgram` | WeApp build | 通过(普通构建与 `build:weapp:e2e` 均通过) | -| `miniProgram` | WeApp 包检查 | 通过:94 文件,生产构建 raw 1280.3 KiB/预计上传 1707.1 KiB;E2E 构建 raw 1271.8 KiB/预计上传 1695.7 KiB;均为 0 个 WebP、17 个页面脚本 | -| `server` | TypeScript lint | 通过 | -| `server` | 测试 | 90 通过(Node 22.13.1) | -| `server` | build | 通过 | -| 生产 Docker 构建 | `api`、`h5`、`admin` | 通过;H5 在线依赖审计通过 | -| `admin` | 测试 | 8 通过 | -| `admin` | build | 通过 | -| H5 视觉检查 | 页面/视口组合 | 65 组完成,`diagnostics: []` | - -补充说明: - -- `weapp:doctor` 在提权后通过全部检查:现有项目路径为 `miniProgram/dist`,私有配置中的真实 AppID 已同步到构建产物,Node 22.13.1、服务端口 24495 和自动化端口 9420 均可用。 -- 微信开发者工具自动化已完成:完整会话首轮 12 个场景中 9 个通过,3 个因 automator 长会话响应超时;随后在新会话中分别重试搜索详情/收藏联系、消息文字与图片、收藏/资料重置 3 个场景,全部通过。重试及首轮结果均无应用异常、无 actionable console error、无未捕获异常;证据见 `qa-artifacts/weapp/2026-09-13T12-40-43-824Z`、`2026-09-13T12-51-21-331Z`、`2026-09-13T12-51-45-994Z`、`2026-09-13T12-52-17-206Z`。 -- 本次 E2E 使用已有微信开发者工具项目和 `project.private.config.json` 中的 AppID,未新建项目、未上传、未预览发布;因此可作为模拟器/自动化验收证据,真机网络、授权弹窗和硬件相册仍需在实际设备上抽查。 -- 依赖 overrides 更新前曾执行 `npm run audit:dependencies`,门禁报告未批准 advisory `1193734`、`1193727`;当时漏洞路径数为 moderate 3(上限 2)、high 6(上限 5)、total 12(上限 10)。本轮在隔离临时目录以 Node 22.13.1 执行全新 `npm ci --ignore-scripts`,registry 下载 `adm-zip@0.6.1` 时被系统网络权限拒绝(`EACCES`,代理地址 `198.18.0.156:443`)。 -- `audit:dependencies` 现在显式使用 `--prefer-online`,并在 `npm_config_offline` 时 fail closed,避免把空的离线缓存报告误判为通过。本地隔离环境因网络权限无法完成全新安装,不能据此宣称本地审计可重现;生产 H5 构建已完成真实在线 audit 并通过。 -- Young 服务器本次 H5 Docker 构建实际执行了 `npm run audit:dependencies`,输出为 10 条依赖路径、8 个已审查 advisory,复核期限 2026-12-03,审计步骤通过;因此“本地隔离安装受阻”不再等同于生产构建未审计。 -- `TODO.md` 仍记录 Taro 传递依赖 advisory、H5 包体预算、Open Library 覆盖率和 R2 清理规则等上线前事项。 - -## 5. 安全与数据问题 - -严重级别定义:P0 = 上线阻断或可直接导致账户/权限失守;P1 = 高风险,应尽快修复;P2 = 中风险或需要在正式运营前补齐。以下 P0/P1 条目保留同步前的证据与影响说明,已修复与未复验状态统一见第 6 节。 - -### P0:生产配置缺失时使用固定默认密钥 - -证据: - -- `server/src/common/auth.ts:6`:`ACCESS_TOKEN_SECRET` 缺失时回退到 `development-only-secret-change-me`。 -- `server/src/common/totp.ts:6`:`ADMIN_TOTP_ENCRYPTION_KEY` 缺失时回退到 `development-totp-key`。 - -影响:生产环境若漏配变量,攻击者可利用已知 JWT 密钥伪造访问令牌;TOTP 加密数据也使用可预测密钥。应在生产启动时强制校验变量存在、长度和随机性,禁止默认值;开发环境可使用显式 `ALLOW_DEV_AUTH`,但不能复用生产路径。 - -### P1:远程最新提交中的依赖安全门禁当前不通过 - -证据: - -- 远程合并提交 `cda3fa0` 新增 `miniProgram/scripts/audit-dependencies.mjs` 和 `miniProgram/security/npm-audit-policy.json`。 -- 实际执行 `npm run audit:dependencies` 得到:未批准 advisory `1193734`、`1193727`;moderate 3 > 2、high 6 > 5、total 12 > 10。 - -影响:新提交虽然引入了 overrides 和审计门禁,但当前依赖树仍不能通过自身发布门禁;按 `miniProgram/Dockerfile.h5`,生产 H5 镜像构建会在审计步骤失败。应在 Node 22 环境确认 advisory 对应包和修复版本,升级到 Taro 兼容版本或补充经过安全评审的例外,不能直接放宽阈值或使用 `--force`。 - -### P1:校园身份过期/撤销没有在每次授权时阻断 - -证据: - -- `server/src/modules/identity/identity.service.ts:60,84-86,103` 只保存并返回 `expiresAt`,没有在状态读取或请求授权时拒绝过期身份。 -- `server/src/common/auth.ts:28-32` 的 `VerifiedGuard` 只信任 JWT 中的 `campusStatus === 'VERIFIED'`。 - -影响:校园身份过期或撤销后,已有 access token 仍可发布、聊天、举报等需要认证的操作。应在 Guard/认证服务查询最新 `campusIdentity.expiresAt`、`revokedAt` 和用户状态,或引入可撤销的 token version;过期时同步降级 `campusStatus`。 - -### P1:公开商品详情和媒体接口未统一限制商品状态 - -证据: - -- `server/src/modules/listings/listings.service.ts:17` 的列表查询在非 `mine` 时限制 `status: ACTIVE`,但 `:20` 的详情查询只有 `deletedAt: null`。 -- `server/src/modules/uploads/media.controller.ts:20-22` 只限制图片已上传、已挂载、非 ISBN 和商品未删除,没有限制 `listing.status`。 - -影响:`DRAFT`、`PENDING_REVIEW`、`BLOCKED`、`OFF_SHELF` 商品可能通过详情 ID 或媒体 URL 继续被公开访问,绕过审核和下架策略。公共接口应只暴露 `ACTIVE`(如需展示 `RESERVED/SOLD`,应明确定义);所有者和管理员使用受控接口。 - -### P1:Web 微信登录状态可重复读取令牌 - -证据:`server/src/modules/auth/auth.service.ts:111-116` 的 `webStatus()` 使用 Redis `GET`;认证成功后 `:146` 将令牌写回同一个 key,但没有一次性消费。 - -影响:同一个 state 在 60 秒内可多次返回 access/refresh token。state 若经日志、跳转参数、浏览器历史或 Referer 泄漏,可重复建立会话。建议使用原子 `GETDEL` 或 Lua 脚本完成一次性兑换,兑换后立即删除 key,并缩短轮询响应中的敏感数据暴露时间。 - -### P1:Refresh Token 轮换不是原子操作 - -证据:`server/src/modules/auth/auth.service.ts:171-177` 先 `findUnique` 校验,再单独 `update revokedAt`,最后创建新 session。 - -影响:并发请求可同时通过校验并各自生成新 session,扩大 refresh token 重放窗口。应使用带 `revokedAt: null` 条件的原子 `updateMany`/事务,并检查影响行数;失败的并发请求必须返回 401。 - -### P1:管理员 TOTP 验证缺少失败限流和锁定 - -证据:`server/src/modules/admin/admin-security.controller.ts:34-46` 的 verify/enable 接口未见 IP、账户级限流、失败计数、冷却或锁定。 - -影响:6 位 TOTP 可被自动化猜测,且失败行为缺少告警。应按账户和来源 IP 限制频率,连续失败触发指数退避/短时锁定,并记录安全审计事件。 - -### P1:Taro H5 将 access/refresh token 持久化到可读存储 - -证据:`miniProgram/src/domain/auth.ts:4-10,13-22,36-46` 调用 `sessionStore.set()`;`miniProgram/src/domain/api.ts:75-95` 通过 `storageAdapter` 持久化完整 `ApiSession`;`miniProgram/src/platform/index.ts:7-28` 使用 Taro 本地存储。 - -影响:H5 与 Web Golden Reference 的 HttpOnly Cookie 方案不一致,XSS 或恶意脚本可直接读取长期 refresh token。优先让 H5 使用 HttpOnly、Secure、SameSite Cookie transport;若暂时保留 Bearer,至少不持久化 refresh token、缩短有效期并增加 CSP 和 token 轮换。 - -### P1:注销/换账号没有清理 Taro 草稿、媒体和个人快照 - -证据: - -- `miniProgram/src/domain/api-repository.ts:28-29` 使用全局 `api-draft`;`miniProgram/src/platform/index.ts:136-192` 使用全局 `media` 和 IndexedDB `biterstore-taro-media-v1`。 -- `miniProgram/src/domain/auth.ts:46` 注销只调用 `sessionStore.clear()`。 -- 其他快照虽然部分按 userId 命名(`api-repository.ts:13-16`),但草稿和媒体没有用户隔离。 - -影响:同一设备切换账号后可能闪现上一账号的草稿、图片和个人数据,发布流程还可能携带他人图片 ID。应按 userId 命名所有缓存,注销时删除当前用户草稿、媒体、IndexedDB 对象和个人快照;会话过期也要走同一清理路径。 - -### P1:封禁/撤销后旧 access token 仍可使用 - -证据:`server/src/common/auth.ts:13-23` 的 `AuthGuard` 只校验 JWT 签名和过期时间,不查询用户 `status`、身份撤销或 token version;管理员撤销主要影响数据库 session/refresh token。 - -影响:旧 access token 在默认约 15 分钟 TTL 内仍可调用敏感接口。对管理、发布、消息和举报等操作增加实时用户状态校验,或在 JWT 中加入可撤销版本并在服务端缓存/查询。 - -### P1:注销用户的商品没有同步下架或公共过滤 - -证据:`server/src/modules/users/users.controller.ts:48` 只撤销 session 并将 User 标为 `DELETED`,没有批量更新该用户商品;商品公共详情也未检查 seller 状态。 - -影响:已注销用户的商品可能继续出现在详情或历史缓存中,造成交易和隐私问题。注销事务中应将商品统一 `OFF_SHELF`/匿名化,媒体按策略处理;公共查询同时过滤 seller `status = ACTIVE`。 - -### P2:举报接口缺少目标存在性、重复和频率控制 - -证据:`server/src/modules/moderation/moderation.controller.ts:8` 只检查 `targetId` 和 `reason` 非空,直接创建 Report。 - -影响:任意字符串目标均可制造无效举报,重复举报会增加后台和数据库压力。应限定 `targetType` 枚举,验证 listing/user/message 是否存在,按用户/目标做幂等或去重,并增加限流和审核告警。 - -### P2:上传只校验 MIME 与声明大小,没有校验文件魔数 - -证据:`server/src/modules/uploads/uploads.controller.ts:21-30,33-40,43-55` 依据客户端 `mime`、`size` 创建上传票据并检查长度;未见图片解码或 magic number 校验。 - -影响:攻击者可提交伪造 MIME 的文件,异常内容可能进入对象存储或后续处理。服务端应读取文件头并用图片解码器验证真实格式,限制像素尺寸、压缩/重编码,并清理超时的 `pending/` 对象。 - -### P2:关键接口缺少统一限流 - -检索 `server/src` 未发现 Nest/Fastify rate-limit 或 Throttler 配置。应重点覆盖校园登录、微信登录和 state 轮询、TOTP verify、ISBN 识别/查询、上传 presign/complete、举报、反馈和消息发送;同时设置请求体、并发和单用户配额。 - -### P2:后台“禁言”状态尚未落实到业务动作 - -证据:后台可以把用户状态改为 `MUTED`(`server/src/modules/admin/admin.controller.ts`),但 `AuthGuard` 目前只阻断 `BANNED/DELETED`;消息、发布、举报等接口使用 `AuthGuard/VerifiedGuard`,没有统一的 `MUTED` 行为定义或专门 Guard。 - -影响:管理员执行“禁言”后,账号仍可能继续发送消息或执行其他写操作,后台展示状态与实际治理效果不一致。应先明确禁言范围(至少消息发送、会话创建/举报等互动动作),再在服务端统一执行并补充恢复/审计测试;不要只在前端隐藏按钮。 - -### P1:Web 商品详情“举报”按钮原先只显示提示 - -证据:Web Golden Reference 的商品详情按钮此前只调用 `notify('举报入口已记录')`,没有调用 `/reports`;MiniProgram 同一入口已经提交服务端举报。 - -影响:同一账号从 H5 举报时不会生成审核工单,造成跨端安全能力不一致。本轮已将 Web 仓储接入 `/reports`,保留登录失效处理,并补充请求回归测试;举报目标存在性、重复和频率控制仍按 P2 待完善。 - -### P2:H5/API 的安全响应头不统一 - -证据:`deploy/nginx.conf:48-57` 只在 `/admin/` 配置 CSP、X-Frame-Options、nosniff、Referrer-Policy;公共 H5、`/api/` 和 `/media/` 未统一设置 HSTS、nosniff、frame-ancestors/CSP 等。 - -影响:公共入口的浏览器防护基线仍不一致。媒体缓存的历史配置还曾使用一年 `immutable`,会放大错误公开资源的影响;本轮已将 `deploy/nginx.conf` 的兼容 `/media/` 路径改为转发到 `/api/v1/media/`,并统一为 5 分钟 `must-revalidate`,但公共 H5、`/api/` 和 HTTPS/HSTS 仍需在网关层补齐。应在确认所有子域名均支持 HTTPS 后添加 HSTS、X-Content-Type-Options、Referrer-Policy 和合适的 CSP/frame-ancestors,并分别评估 API 与媒体缓存。 - -### P2:下架商品的历史会话仍可能出现失效图片 - -证据:`server/src/modules/conversations/conversations.service.ts` 会把会话关联商品的图片 URL 返回给参与者;本轮公共 `media/:id` 已限制为 `ACTIVE` 商品和 `ACTIVE` 卖家,因此已下架或注销卖家的历史图片请求会得到 404。 - -影响:聊天历史仍会保留商品元数据,但图片可能显示为破图,造成界面衔接不完整。应明确“历史会话保留”策略:要么提供仅会话成员可访问的鉴权媒体路由,要么在会话响应中移除不可用图片并由客户端显示已下架占位状态。 - -## 6. 本轮 P0/P1 修复状态与最终验证边界 - -第 5 节记录的是同步时的基线问题清单;本轮已按用户确认修改 P0 与 P1。下面是当前代码状态,避免把历史证据误读成仍未修复。 - -| 问题 | 当前状态 | 主要改动/证据 | -| --- | --- | --- | -| P0:生产默认 JWT/TOTP 密钥 | 已修复,待生产配置验收 | 新增 `server/src/common/security-config.ts`;生产缺失、过短或重复密钥在启动时抛错,非生产仅使用进程随机临时密钥;`main.ts` 启动前调用校验。 | -| P1:校园身份过期/撤销、封禁和旧 access token | 已修复 | `AuthGuard` 每次查询用户状态、最新校园身份和 session;`VerifiedGuard`/`AdminGuard` 使用实时有效状态;生产拒绝无 `sid` 的旧 JWT;refresh、微信登录也检查身份有效期。 | -| P1:公开商品/媒体状态 | 已修复 | 公共列表、详情、收藏、媒体只返回 `ACTIVE` 商品和 `ACTIVE` 卖家;所有者更新/状态操作走内部查询;注销事务下架并软删除商品。 | -| P1:我的商品详情/状态更新回归 | 已修复 | 新增受保护的 `GET /listings/mine/:id`;Web 与 MiniProgram 的状态更新、个人商品详情均使用 owner endpoint,保留版本号并覆盖草稿/下架/已售商品。 | -| P1:Web 微信 state 重放 | 已修复 | pending 标记改为原子可声明的 `PENDING`,回调用 Redis Lua 原子 claim;认证结果用 `GETDEL`/条件 Lua 一次性消费;Cookie transport 保留 `status: AUTHENTICATED` 让 Taro H5 轮询在写入 Cookie 后立即结束;补充一次性消费、回调和轮询响应测试。 | -| P1:refresh token 并发重放 | 已修复 | 使用 `updateMany({ id, revokedAt: null })` 条件更新并检查影响行数;并发失败返回 401;补充竞争测试。 | -| P1:TOTP 暴力尝试 | 已修复 | Redis 按账号/IP 以 Lua 原子计数,5 次/300 秒,Redis 不可用时 fail closed;成功后清理计数;TOTP session 纳入数据库 session 撤销链。 | -| P1:H5 token 持久化 | 已修复 | H5 登录、Web 轮询、refresh、logout 使用 HttpOnly Cookie transport,客户端只保存用户元数据和过期时间,不保存 access/refresh token。 | -| P1:换账号/注销缓存泄漏 | 已修复,待跨端实机复核 | Taro 与 Web 的草稿、快照、媒体存储按 userId/账号作用域隔离;IndexedDB、listing/favorite 内存缓存和个人资料快照不再跨账号复用;注销、过期或切换游客模式时清理本地草稿、媒体和个人快照。 | -| P1:会话失效后的页面衔接 | 已修复,待跨端实机复核 | refresh/401 失败统一清理会话并派发事件;Web/Taro H5 重定向登录页,WeApp reLaunch 登录页;登录页显示“登录已失效”提示并清理一次性 Web state;R2 预签名上传不再错误携带 Cookie。 | -| P1:Web 商品详情举报未提交服务端 | 已修复 | Web `reportBook()` 与 MiniProgram 使用同一 `/reports` 接口,未登录时先回退登录页;补充 API 请求测试。 | -| P1:管理员 elevated session 注销 | 已修复 | TOTP session 绑定数据库 session;管理员退出调用 `/auth/logout`,服务端验证 access token 的 `sid` 并撤销对应 session。 | -| P1:依赖审计 | 生产在线门禁通过,本地全新安装受环境阻断 | `adm-zip` 已升至 `0.6.1`,`js-yaml` 已升至 `4.3.2`;审计脚本强制 `--prefer-online` 并拒绝离线缓存。Young 服务器 H5 构建在线 audit 通过;本地隔离环境的全新安装仍被 registry 网络权限拒绝。 | -| P2:举报目标、重复和配额 | 已修复 | `ModerationController` 仅接受 `LISTING/USER/MESSAGE`,验证目标存在性和自举报,数据库复合唯一索引 + 竞态 `P2002` 处理实现幂等;Redis Lua 按用户/目标/IP 限制窗口,Redis 不可用时生产 fail closed,非生产有数据库兜底。 | -| P2:上传魔数/结构/尺寸与 pending 生命周期 | 已修复 | 新增 `image-validation.ts`,校验 JPEG/PNG/WebP 魔数、结构/解码、宽高和像素上限;本地/R2 完成时再次读取校验并写入 `width/height`;新增 `uploads:cleanup-pending` 清理本地/R2 孤儿对象及数据库 pending 记录,R2 lifecycle 作为兜底。 | -| P2:公共 H5/API 安全响应头与 HTTPS | 已修复,生产验收通过 | Nest `onSend` 和 Nginx `/api/`、`/media/`、`/admin/`、H5、`BIT-Login` 均统一 nosniff、frame、Referrer、Permissions、CSP;反向代理按有效 `X-Forwarded-Proto` 重定向 HTTP,生产 HTTPS 请求才发送 HSTS;生产 `nginx -t` 与公网头部探针已通过。 | -| P2:`MUTED` 禁言边界 | 已修复 | `AuthGuard` 注入实时状态;`VerifiedGuard`/`NotMutedGuard` 及控制器防御性检查阻止发消息、创建会话、发布/状态变更、收藏、举报、拉黑、反馈和上传;会话/消息读取、通知、公开浏览仍可用;新增回归测试。 | - -### 当前可复现的验证结果 - -- 使用项目自带 Node `22.13.1`:`server` lint/90 个测试/build 通过;`web` lint/40 个测试/build 通过;`admin` 8 个测试/build 通过;MiniProgram lint、48 个测试、H5/WeApp build 和包检查在既有本地依赖树上通过。 -- MiniProgram 的全新本地 `npm ci` 已实际尝试,因 registry 下载 `adm-zip@0.6.1` 被环境 `EACCES` 拒绝;审计脚本已拒绝离线缓存结果。生产 H5 Docker 构建已完成真实在线 audit 并通过;生产容器内 `nginx -t` 也已通过。 -- H5 65 组视觉检查通过(`diagnostics: []`);微信开发者工具已有项目的自动化 E2E 已完成,首轮长会话的 3 个 automator 超时在独立新会话重试后全部通过,应用异常/未捕获异常均为 0。真机网络、授权弹窗和硬件相册仍需实际设备抽查。 - -### 仍未纳入本轮 P0/P1 范围的 P2/运营事项 - -Cookie transport 的 CSRF/跨站域名复核、会话历史图片占位策略、Open Library 覆盖率,以及真实 R2 权限/生命周期执行仍需进一步运营验收;Web/Taro 聊天页的图片消息与商品链接分享按钮仍显示“暂未开放”,属于跨端功能未闭环的 P2。本轮第二批的举报、上传校验/清理、安全响应头和 `MUTED` 边界已关闭并有测试。 - -## 7. 界面、路由与跨端衔接 - -### 已验证正常的部分 - -- H5 65 个页面/视口组合视觉脚本完成,`diagnostics: []`,未发现自动化检测到的溢出、空白或几何错位。 -- Web、Server、Admin 当前构建已通过;MiniProgram 最后的会话/缓存/上传/owner 商品改动已在完整本地依赖树上复跑 lint、测试和 H5/WeApp 构建。现有路由与页面清单及自动化导航未发现缺失页面。 -- MiniProgram WeApp 包共 94 个文件、17 个页面脚本,包大小和 WebP 检查通过;已有微信项目的 E2E 覆盖引导、导航、搜索详情、发布、我的发布、消息、反馈、收藏重置及全部状态页。 -- Taro WeApp 使用自定义应用内 dock;H5 使用重定向/路由适配,主导航结构已对齐 Golden Reference。 - -### 当前衔接状态与剩余风险 - -1. **认证方案已统一到 Cookie transport**:`web/` Golden Reference 与 Taro H5 现在都使用 HttpOnly Cookie;客户端只保留用户元数据。Cookie 的跨域部署、CSRF 策略仍需在生产域名上复核。 -2. **会话失效与微信轮询已接通 UI 回退**:401/refresh 失败会清理账号数据并触发 H5 redirect 或 WeApp reLaunch;H5 微信 Cookie 轮询保留认证完成标记,不再因响应缺少状态而超时;本轮完成静态与服务端验证,仍需真实浏览器/小程序设备复核并发请求下的体验。 -3. **我的商品链路已对齐**:Web 与 MiniProgram 从“我的发布”打开草稿/下架/已售商品时使用受保护 owner endpoint,状态更新先读取 owner 版本再提交乐观并发更新;公共详情仍只显示 ACTIVE 商品。 -4. **举报入口已对齐**:Web 与 MiniProgram 商品详情均向 `/reports` 提交举报,未登录时回退登录;服务端现在校验商品/用户/消息目标、阻止自举报,按用户/目标/IP限额,并用唯一索引保证重复请求幂等。 -5. **缓存已按账号隔离**:草稿、媒体、IndexedDB、资料快照和 listing/favorite 内存缓存均加入账号边界;冷启动会恢复 Taro 媒体 owner,注销/过期会清理当前账号数据及旧共享媒体空间,同时保留 onboarding 与全局偏好。 -6. **注销后的商品可见性已收敛**:后端注销事务下架并软删除商品,公共列表/详情/媒体过滤非活动卖家和非 ACTIVE 商品;旧客户端本地快照仍需在真机上验证刷新时序。 -7. **真机抽查缺口**:微信开发者工具模拟器/自动化链路已完成;导航 loading、微信授权回调、真实文件上传、返回栈和不同网络条件仍需在真实设备复核。 - -## 8. 依赖、配置与运维待办 - -- overrides 已将 `adm-zip`/`js-yaml` 更新到修复版本;审计脚本强制在线优先并拒绝 `npm_config_offline`。本地隔离临时目录的全新安装仍被 registry 网络权限拒绝,但生产 H5 Docker 构建已在线执行 `npm run audit:dependencies` 并通过。 -- `server` 新增 `uploads:cleanup-pending`(本地/R2 孤儿对象和数据库记录清理),`deploy/README.md` 记录每小时任务计划与 R2 lifecycle 双重兜底;`deploy/nginx.conf` 和 Nest onSend 均已覆盖公共安全响应头与有效 HTTPS 判断。 -- `TODO.md:110-116` 仍记录 Node 22 引擎约束、Taro 4.2.1 传递依赖 advisory、H5 包体预算、Open Library 覆盖率和真实 R2 权限验收等未闭环事项。 -- `codex/build-security-alignment@97fe3f7` 已合并进 `origin/main`;其审计门禁本身已暴露出当前依赖树尚未达标的问题。 -- 生产环境必须确认 JWT/TOTP 密钥、BIT-Login 公钥、微信 AppID/Secret、R2 凭据、HTTPS 域名、Cookie 属性和日志脱敏策略均通过密钥管理系统注入,不能写入仓库或镜像。 -- H5 使用 HttpOnly Cookie 后,必须将 `H5_ORIGIN` 配置为明确的允许来源并复核跨站部署:当前 Cookie 为 `SameSite=Lax`,适合同站/同站点部署;若 API 与 H5 跨站点,需改用安全的 `SameSite=None; Secure` 配置并增加 CSRF 防护,不能仅依赖 `credentials: include`。 - -## 9. 修复优先级建议 - -以下清单保留基线整改顺序;其中第 1–8 项对应的 P0/P1 已在本轮实现,当前状态和验证边界以第 6 节为准。未完成项主要是依赖全新安装复验、真机抽查以及 P2/运营事项。 - -### 立即(上线前阻断) - -1. **已完成**:删除生产 JWT/TOTP 固定默认密钥,增加启动时配置校验;仍需在生产配置中心完成密钥轮换验收。 -2. **已完成**:在认证 Guard 中实时校验用户状态、校园身份 `expiresAt/revokedAt`,并以 session `sid` 支持 access token 撤销。 -3. **已完成**:将公共详情和媒体查询限制为允许公开的商品状态,并过滤已删除/非活动卖家。 - -### 第一批(高风险修复) - -4. **已完成**:用原子 GETDEL/Lua 实现 Web 微信 state 一次性兑换。 -5. **已完成**:将 refresh token 轮换改为条件原子更新并补充并发重放测试。 -6. **部分完成**:管理员 TOTP 已增加 Redis 账户/IP 限流;登录、上传、举报和消息的统一限流仍待补齐。 -7. **已完成**:统一 H5 Cookie 会话方案,并接通 refresh 失败后的全局登出和 UI 回退。 -8. **已完成**:按用户隔离并在注销/过期时清理草稿、媒体、IndexedDB 和个人快照;Web 与 MiniProgram 的 owner 商品详情/状态链路也已对齐。 - -### 第二批(运营前完善) - -9. **已完成**:举报目标校验、去重/幂等和用户/目标/IP 配额;数据库迁移 `202609130001_report_dedupe` 会先保留每组最早记录再建立唯一索引。 -10. **已完成**:上传魔数、真实格式结构/解码、宽高/像素限制;本地/R2 完成阶段复核并记录尺寸,`uploads:cleanup-pending` 和 R2 lifecycle 负责 pending 生命周期。 -11. **已完成**:Nest 与 Nginx 统一公共 H5/API 安全响应头;按有效代理协议执行 HTTP→HTTPS,生产安全请求发送 HSTS;生产容器内 `nginx -t` 和公网头部/状态探针均已通过。 -12. **生产构建已完成,本地复验受环境阻断**:Node 22 H5 Docker 构建已通过在线依赖审计;本地隔离安装仍因 registry 权限无法重现,微信 DevTools 模拟器自动化已完成,真机网络/授权/相册仍需设备抽查。 -13. **已完成**:明确 `MUTED` 边界并在 Guard 与控制器双层拒绝消息/互动/发布/上传写操作;读取会话、消息、通知和公开内容保留,新增 3 个禁言回归测试。 - -## 10. 提交边界与工作区保留文件 - -同步、排查和提交过程中保留了用户已有改动;PR #21 的提交边界如下: - -- 已有修改:`docs/项目交接文档.md`(未由本轮覆盖)。 -- 已有未跟踪素材:`Assets/generated/biterstore-app-icon.png`(未修改、未删除、未加入报告补丁)。 -- PR #21 已提交:服务端密钥与认证、身份、会话、TOTP、管理员 session 注销、商品 owner endpoint、媒体/注销逻辑及测试;举报目标/配额/去重、图片魔数与尺寸校验、pending 清理命令、`MUTED` Guard/回归;Web 与 MiniProgram Cookie 会话、账号缓存隔离、owner 商品详情/状态链路、举报入口、媒体上传凭据、冷启动媒体 owner 和失效会话路由;`deploy/nginx.conf` 媒体兼容路径/缓存策略与安全响应头;依赖 overrides/在线审计门禁;`docs/项目排查报告-2026-09-13.md`。 -- 本轮验证产物:`qa-artifacts/weapp/` 下的构建包检查、微信开发者工具 E2E 截图和结果 JSON;验证结束后已退出 DevTools,并恢复 `miniProgram/node_modules` 原目录。 - -提交与推送后已再次执行 `git status --short --branch` 和 `git diff --check`;工作区只保留上述用户文件,PR 不包含真实密钥、私有 AppID 配置、CLI token 或 E2E 产物。生产迁移、`nginx -t`、在线 audit 和公网状态/头部探针已完成,仍需真机抽查及跨站 CSRF/R2 运营验收。 - -## 11. 生产部署记录(2026-09-14) - -- 按发布快照流程将 `b76e82512a2891fa42acfc8972899a8a43a9ede0` 上传并在服务器端校验 SHA-256:`b97a939ce834f7a26b7515d6db94b6b33dfdd63aa88057a10c08a6824e18fbc7`;未携带 `.env`、私有配置、依赖或 QA 产物。 -- 发布前版本标记为 `97fe3f77fd52026f02b3e1f40434fb482593bdcf`;解压后构建 `api`、`h5`、`admin` 镜像成功,H5 在线依赖审计通过,随后 Compose 切换并重启 Nginx。 -- Prisma 迁移 `202609130001_report_dedupe` 已完成,`Report_reporterId_targetType_targetId_key` 唯一索引存在;8 个 Compose 服务均处于 running,近期 API 日志无 error/exception/fatal/migration failed,重启次数均为 0。 -- 本机 HTTPS 代理语义下 API 健康、首页和公开列表均返回 200;公网 `/`、`/api/v1/health`、`/api/v1/listings?limit=50`、`/admin/` 和 `/bit-login/` 均返回 200,首页已加载新资源 `js/app.3c7c32f3.js`,安全响应头和 HSTS 已探针确认。 diff --git "a/docs/\351\241\271\347\233\256\347\216\260\347\212\266\345\244\215\346\237\245\344\270\216\351\227\256\351\242\230\346\270\205\345\215\225-2026-09-17.md" "b/docs/\351\241\271\347\233\256\347\216\260\347\212\266\345\244\215\346\237\245\344\270\216\351\227\256\351\242\230\346\270\205\345\215\225-2026-09-17.md" deleted file mode 100644 index d4b41ef..0000000 --- "a/docs/\351\241\271\347\233\256\347\216\260\347\212\266\345\244\215\346\237\245\344\270\216\351\227\256\351\242\230\346\270\205\345\215\225-2026-09-17.md" +++ /dev/null @@ -1,241 +0,0 @@ -# 梨苑儿项目现状复查与问题清单 - -> 2026-09-18 更新:C01–C09 已完成本地代码修复,验证结果及未完成的上线前验收见[问题修复记录](问题修复记录-2026-09-18.md)。下文保留 2026-09-17 的审查证据与基线,不代表修复后的当前工作区;修改尚未部署。 - -审查日期:2026-09-17(UTC+8) - -代码基线:`codex/public-routes-chat-fixes`,`79560aebce401653a5e2151153d3bfca77f1790e` - -交接依据:[项目交接文档](项目交接文档.md),最后更新于 2026-09-17 23:20。 - -## 1. 结论 - -**项目目前能够构建、现有测试通过,公网基础入口正常,但仍有 9 项代码或脚本问题需要修复,其中 4 项应优先处理。** 重点是商品复审可以被绕过、R2 上传校验与最终文件不一致、恢复演练脚本无法正常解密,以及默认昵称包含完整学号。 - -本次重新执行的 **261 项现有测试全部通过**。这些测试没有覆盖下述关键状态组合和并发场景,不能据此认定业务、安全和灾备已经全部验收。 - -2026-09-17 23:32–23:34 的少量公网只读检查结果: - -- [readiness](https://store.young581.com/api/v1/health/ready) 返回 200,数据库、Redis、存储、BIT-Login 均为 `ok`。 -- 首页、`/sw.js`、`/admin/` 和公开商品列表均返回 200;公开列表返回 1 条商品,带 ETag 和缓存响应头。 -- [PR #24](https://github.com/AnonymousUser443/BITerStore/pull/24) 仍为 Open、未合并,head 与本地代码基线一致。 - -以上只是检查时刻的状态。本轮没有通过 SSH 重新核对生产提交标记、容器、数据库迁移和备份目录,也没有进行真实账号写操作、生产压力测试或部署。 - -### 优先级总表 - -本报告的 P1 表示建议在扩大使用范围前修复;P2 表示应安排近期修复。交接文档中的外部 P0 待办在第 5 节另外保留。 - -| 编号 | 优先级 | 问题 | 证据程度 | -| --- | --- | --- | --- | -| C01 | P1 | 商品编辑后可通过下架、再上架跳过文本复审 | 真实服务方法+模拟数据库复现 | -| C02 | P1 | R2 校验后的源对象仍可被替换,最终保存未校验内容 | 真实控制器+模拟 S3 复现 | -| C03 | P1 | 恢复脚本解密到已存在临时文件时失败 | 本地真实 GPG 等价命令复现 | -| C04 | P1 | 默认昵称包含完整学号,并进入公开卖家资料 | 代码链路确认;当前公开样本未观察到泄露 | -| C05 | P2 | 第 51 个及更早的会话无法正常打开 | H5 真实仓库方法+模拟 API 复现;小程序同逻辑 | -| C06 | P2 | 卖家自己的非在售商品缺少可用图片读取路径 | 接口与查询条件交叉确认 | -| C07 | P2 | 并发已读请求可能使已读游标倒退 | 真实服务方法+模拟并发复现 | -| C08 | P2 | 禁言用户无法重新登录或刷新会话 | 真实认证服务方法复现 | -| C09 | P2 | Server 构建通过后 `npm start` 启动失败 | 实际命令复现 | - -## 2. 优先修复的问题 - -### C01:商品编辑后的文本复审可被绕过 - -**位置:** [listings.service.ts](../server/src/modules/listings/listings.service.ts),第 8–9、135–151、162–188 行。 - -编辑已经上架的商品时,`update()` 会将其改成 `PENDING_REVIEW`,清空 `moderationDecision`,但保留图片的 `APPROVED` 状态。与此同时,状态机允许 `PENDING_REVIEW → OFF_SHELF → ACTIVE`,重新上架只检查必需图片及图片审核状态,不检查当前文本版本是否审核通过。 - -**复现顺序:** 使用有已审核封面和 ISBN 页的在售商品,修改标题或描述,再依次请求下架、上架,每次携带正确的递增版本号。本地结果为: - -```text -编辑后:PENDING_REVIEW -下架再上架后:ACTIVE -moderationDecision:null -``` - -**影响:** 卖家可以让修改后未经复审的文本重新进入公开列表。单纯禁止 `PENDING_REVIEW → ACTIVE` 不足以封闭这条路径。 - -**建议:** 记录审核通过的内容版本;只有当前内容与已审核版本一致时才允许卖家直接重新上架,否则进入审核。不要把“图片已通过审核”当作“整个商品已通过审核”。 - -**验收:** 编辑标题、描述等字段后,无论经过何种允许的状态转换,都不能在管理员复审前公开;未经编辑的正常下架、再上架仍符合产品规则。 - -### C02:R2 上传校验存在文件替换窗口 - -**位置:** [uploads.controller.ts](../server/src/modules/uploads/uploads.controller.ts),第 59–61、82–116 行。 - -`complete()` 先读取 `pending/` 对象并校验字节,再通过 `CopyObjectCommand` 从同一对象键复制到 `media/`。复制没有绑定刚才读取的对象 ETag 或版本,也没有直接保存已校验的那份字节。 - -预签名 PUT 的有效期为 600 秒;R2 预签名地址在过期前可以重复使用。因此,在读取和复制之间覆盖源对象,会造成校验对象与最终保存对象不同。[Cloudflare R2 官方说明](https://developers.cloudflare.com/r2/api/s3/presigned-urls/) - -**本地复现:** 模拟 S3 在返回合法 PNG 的读取结果后,将源对象替换为相同长度的非图片字节。真实控制器仍返回上传完成,最终对象再次执行 `inspectImage()` 时失败。此复现没有访问或写入生产 R2。 - -**影响:** 文件魔数、尺寸等校验不能保证最终存储内容有效,数据库记录的 MIME、尺寸也可能与对象不符。此结论不等于图片已绕过管理员审核,也不代表发现了代码执行漏洞。 - -**建议:** 优先将校验通过的字节直接写入最终对象;或使用读取时获得的 ETag 对复制执行条件约束,并在条件失败时拒绝完成。最终对象应由服务端控制,完成操作还应具备并发与重试保护。 - -**验收:** 在上传完成的读取、校验、复制各阶段注入同键覆盖和重复完成请求,最终对象必须与通过校验的字节一致,或整个完成操作明确失败。 - -### C03:恢复演练脚本在解密阶段被已有临时文件阻断 - -**位置:** [restore-drill.sh](../deploy/backup/restore-drill.sh),第 23–26 行。 - -脚本先用 `mktemp` 创建空文件,再执行 `gpg --batch ... --output "$plain_file" --decrypt ...`,但没有 `--yes`。在没有其他覆盖配置的情况下,GPG 批处理模式不会确认覆盖这个已经存在的文件,脚本在 `set -e` 下退出,无法继续执行 `pg_restore`。 - -**本地验证:** 使用 GnuPG 2.4.5、虚构内容和测试口令生成加密文件;解密到预先创建的空文件时退出码为 **2**,输出长度仍为 0;加入 `--yes` 后退出码为 **0**,恢复内容与原文件哈希一致。未使用生产备份或生产口令,也未执行真实数据库恢复。[GPG 选项说明](https://www.gnupg.org/documentation/manuals/gnupg/GPG-Configuration-Options.html) - -**影响:** 交接材料中的恢复脚本目前不能作为可直接执行的灾备工具;“备份可解密校验”与“该恢复脚本可完成恢复”是两个不同验收项。 - -**建议:** 对脚本自行创建并控制的临时文件明确允许覆盖,保持临时文件权限和退出清理机制;然后在隔离容器与一次性数据库中完成整个脚本的演练。 - -**验收:** 从加密归档恢复到空白临时数据库,核对迁移记录、关键表数量及图片引用,并记录恢复耗时。不能只验收 `pg_restore --list`。 - -### C04:默认公开昵称包含完整学号 - -**位置:** [identity.service.ts](../server/src/modules/identity/identity.service.ts),第 66、96–100 行;[listings.service.ts](../server/src/modules/listings/listings.service.ts),第 37–40 行。 - -校园认证为新账号生成的昵称是 `BITer${studentNumber}`;账号恢复和部分旧默认昵称更新也采用这一规则。公开商品接口虽然没有直接返回 `studentNumber` 字段,但会返回卖家的完整 `nickname`。 - -**触发条件:** 新用户保留系统默认昵称,发布商品并通过审核。此时游客可以从公开卖家昵称中读出完整学号,无需登录。 - -**证据边界:** 当前公开列表只返回 1 条商品,其卖家昵称没有匹配该默认格式。本次确认的是默认数据生成与公开输出之间的泄露路径,没有确认当前公开样本已经发生泄露,也没有将真实学号写入报告。 - -**建议:** 默认昵称改为与校园身份无关的随机公开别名;评估已经生成的默认昵称并制定替换策略,避免覆盖用户自行设置的昵称。 - -**验收:** 新注册及恢复账号的默认公开昵称不包含完整学号;公开商品、聊天成员和其他展示资料不会因系统默认值暴露身份编号。 - -## 3. 功能与稳定性问题 - -### C05:聊天详情隐含“前 50 个会话”限制 - -**位置:** [H5 api-repository.ts](../web/app/lib/api-repository.ts),第 245–251 行;[小程序 api-repository.ts](../miniProgram/src/domain/api-repository.ts),第 65 行。 - -两个客户端的 `getThread(id)` 都读取目标会话消息,同时读取 `/conversations?limit=50`,然后只在这 50 条摘要中寻找目标。H5 找不到就返回 `null`,小程序则抛出“会话不存在”;均没有继续使用 `nextCursor`。 - -**影响与复现:** 用户有超过 50 个会话时,列表分页能展示的旧会话,进入详情后却可能加载失败。即使消息接口已经成功返回数据,详情仍会失败。本地执行真实 H5 仓库方法,在返回有更多页的 50 条摘要时已复现返回 `null`。 - -**建议:** 增加带成员鉴权的单会话摘要接口,让详情按 ID 查询;短期可正确遍历分页,但不宜让每次轮询都读取大量无关摘要。 - -**验收:** 至少准备 51 个会话,验证从列表、直达链接和冷启动均能打开最旧会话;无权访问的会话继续被拒绝。 - -### C06:自己的非在售商品没有完整的图片读取路径 - -**位置:** [listings.service.ts](../server/src/modules/listings/listings.service.ts),第 12–40、83–101 行;[media.controller.ts](../server/src/modules/uploads/media.controller.ts),第 19–38 行。 - -`getMine()` 已能返回卖家的非公开商品,但仍使用公开商品的图片过滤器和 `/api/v1/media/:id` URL。该图片接口只允许 `ACTIVE` 商品;另一条 `/media/review/:id` 路径又要求管理员权限。 - -**影响:** 已下架或已售商品仍可能返回图片 URL,但实际取图会得到 404;待审核图片在 owner 查询时就被过滤掉。缓存可能短暂掩盖问题,冷启动或缓存失效后更明显。历史聊天中的非在售商品卡片也存在同类取图限制。 - -**建议:** 区分公开媒体、卖家本人媒体和管理员审核媒体权限,提供经过所有权鉴权的私有读取路径。聊天是否保留交易图片需明确产品规则并单独限制会话成员访问,不能放宽现有公开接口来解决。 - -**验收:** 卖家可查看自己的待审、下架、已售商品所需图片;其他用户不能借此读取私图;ISBN 页仍不进入公开响应。当前结论来自代码链路检查,本轮未修改真实商品状态做线上复现。 - -### C07:并发已读请求会使已读位置倒退 - -**位置:** [conversations.service.ts](../server/src/modules/conversations/conversations.service.ts),第 97–105 行。 - -`read()` 先读取 `lastReadMessageId`,在 JavaScript 中比较,然后执行无游标条件的 `update()`。两个请求可能同时看到旧值:较新的消息 ID 先写入,较旧的请求随后覆盖它。 - -**本地复现:** 两个请求分别标记消息 `10`、`20` 已读,控制 `20` 先落库、`10` 后落库,最终游标变成 `10`。 - -**影响:** 多标签页、多设备或网络延迟可能使已经阅读的消息重新计入未读。现有单次请求中的大小比较不能保证并发单调性。 - -**建议与验收:** 在数据库更新条件中加入“当前游标为空或小于目标 ID”,或采用原子取最大值。并发及乱序提交后,最终游标必须始终等于已确认的最大 ID,并保留消息所属会话校验。 - -### C08:禁言状态实际会升级为无法维持登录 - -**位置:** [auth.service.ts](../server/src/modules/auth/auth.service.ts),第 190–192、212–219 行;[auth.ts](../server/src/common/auth.ts),`AuthGuard`、`CampusVerifiedGuard`、`NotMutedGuard`。 - -现有权限设计允许 `MUTED` 用户读取个人数据和会话,只禁止互动写操作;但 `issue()` 拒绝所有非 `ACTIVE` 用户,`refresh()` 也只接受 `ACTIVE`。 - -**本地复现:** 对已认证的 `MUTED` 用户,校园登录返回 **403**,有效刷新凭证也返回 **401**。既有访问令牌未过期时可能仍可读取,过期后则无法继续维持登录。 - -**影响:** 禁言表现随访问令牌是否过期发生变化,与“保留读取、禁止互动”的边界不一致;现有禁言测试主要检查写操作拦截,没有覆盖重新登录和刷新。 - -**建议与验收:** 统一禁言语义。如果维持当前产品定义,允许禁言用户建立和刷新受限会话,写操作继续由服务端阻止;分别验证禁言前后、令牌过期、重新登录以及解除禁言。 - -### C09:Server 的标准启动命令指向错误产物 - -**位置:** [server/package.json](../server/package.json),第 9 行;[tsconfig.json](../server/tsconfig.json),第 6、15 行;[Dockerfile](../server/Dockerfile),末行。 - -`npm run build` 实际生成 `dist/src/main.js`,而 `npm start` 执行 `node dist/main.js`。 - -**实际验证:** 构建成功,随后 `npm start` 报 `MODULE_NOT_FOUND`,退出码为 1。 - -**影响:** 按标准 npm 流程启动服务失败,影响接手开发和非 Docker 运维。当前生产 Dockerfile 使用正确的 `dist/src/main.js`,因此本项不能解释为生产 API 已不可用。 - -**建议与验收:** 将启动脚本与构建输出统一;在配置好隔离数据库和 Redis 的环境中补做“构建→标准启动→健康检查”验证。 - -## 4. 交接文档存在的矛盾 - -### D01:正式发布是否需要审核的说明与实现冲突 - -[项目交接文档](项目交接文档.md)第 157 行写的是“已认证用户正式发布进入 `ACTIVE`;`PENDING_REVIEW` 仅保留兼容能力”。当前 [创建商品实现](../server/src/modules/listings/listings.service.ts)第 118 行实际将非草稿设为 `PENDING_REVIEW`,现有发布流程也支持待审状态。 - -应由负责人确认产品规则并修正文档。按当前代码检查时,应以“正常发布进入审核”为验收基准,否则接手者可能把审核导致的未公开误判为故障,甚至破坏已有审核机制。C01 也因此需要按完整审核流程修复。 - -### D02:包体数字和旧 TODO 容易误导验收 - -- 交接文档第 85 行将微信包写为“约 1.73 MiB”,没有说明原始体积与上传载荷的区别。本次现有产物门禁输出为 **1294.4 KiB 原始体积、1725.8 KiB 估算上传载荷**;后者约为 **1.69 MiB**。应按相同单位分别记录,避免误判超过 1.5 MiB 的原始包预算。 -- 根目录 [TODO.md](../TODO.md)仍有已经实现或部署的内容未勾选,例如第 135、138、142–143 行。应逐项核对;客户端、后台、服务端已存在,但完整 CI、真机验收等仍未闭环,不能整组勾选。 -- 历史审查文档包含不同时间的商品数量、测试数量和部署状态。建议保留其历史属性,在入口处链接当前报告和交接快照,避免将已修复旧问题再次当作当前缺陷。 - -本次没有改写原交接文档及 TODO,避免覆盖用户已经存在的未提交交接内容。 - -## 5. 仍需推进的交付和运维事项 - -以下多数已被交接文档识别。本轮没有访问相应管理控制台;除 PR 状态和本地仓库证据外,其完成情况应标记为“交接记录仍待完成,需负责人补证据”,不应凭公网 200 推断已经解决。 - -| 事项 | 当前依据 / 风险 | 完成标准 | -| --- | --- | --- | -| PR #24 审阅合并 | 本次确认仍 Open;交接记录称同一代码已部署 | 在修复高优先级问题后完成审阅,核对主分支与实际发布版本 | -| Cloudflare Bot/WAF、边缘限流 | 应用已有缓存和限流,外部防护仍是交接待办 | 规则、触发验证、例外和应急开关均有记录 | -| 异地加密备份与完整恢复 | 交接记录中的备份仍在同一服务器;另有 C03 脚本缺陷 | 先修复恢复脚本,再完成异地同步、临时库恢复及恢复责任移交 | -| R2、BIT-Login 与配置灾备 | PostgreSQL 归档不能单独恢复图片、登录状态和全部配置 | 明确备份范围、密钥保管、恢复顺序和负责人 | -| R2 `pending/` 生命周期 | 应用清理任务已存在,Bucket 规则仍待权限配置 | 在具备对应权限的账号下配置并核验规则,保留应用清理作为补充 | -| 微信真机与业务验收 | DevTools 历史通过不能替代真机;本次未重跑真机 | 验证登录、授权、扫码、相册、真实上传、发布、聊天与返回栈 | -| 容量基线与告警 | 没有本次可核验的隔离压测结果和告警投递证据 | 隔离环境测缓存命中、数据库 QPS、延迟和资源;实际测试告警送达 | -| Nginx 上游地址刷新 | [nginx.conf](../deploy/nginx.conf)使用静态 `proxy_pass`;交接明确要求重建后重启网关 | 改善上游解析或把重启和探测固化到发布流程,验证容器地址变化场景 | -| 发布回滚与 CI | 仓库无 `.github/workflows`;发布回滚依赖手工流程 | 将已有门禁接入 PR,建立可校验版本、迁移兼容检查和快速回滚路径 | -| 依赖复核 | 交接记录 Server 2 个 moderate;小程序 8 个已接受 advisory,策略复核日期为 2026-12-03 | 在线审计确认实际依赖树、影响路径和上游修复,保留依据;本次未重新做完整在线 audit | -| 外部主体、许可与运营 | 微信平台资料、BIT-Login 许可/维护责任、真实学生试用仍是交接待办 | 负责人提供确认记录,完成实际试用和问题闭环 | - -## 6. 本次验证记录与边界 - -### 已执行 - -本地运行时为仓库外工具目录中的 **Node.js v22.13.1**。初始终端 PATH 未包含 Node,定位已有运行时后完成以下检查;未重新安装或升级依赖。 - -| 范围 | 本次结果 | -| --- | --- | -| Server | 26 个测试文件,143/143 tests;TypeScript 检查和构建通过 | -| Server 标准启动 | **失败**,见 C09 | -| Web Golden Reference | 48/48 tests;ESLint 和 production build 通过 | -| MiniProgram | 50/50 tests;ESLint 通过 | -| 当前已有 WeApp 产物 | 包体门禁通过:94 文件、1294.4 KiB、17 页面脚本、0 WebP | -| Admin | 9/9 tests;TypeScript 与 production build 通过 | -| 书目 Worker | 11/11 tests | -| 定向复现 | 商品复审、R2 文件替换、已读并发、禁言认证、旧会话查找;另执行 owner 媒体路由契约检查 | -| 恢复脚本解密参数 | 本地真实 GPG 样本验证,见 C03 | -| 公网与 GitHub | 少量公开 GET;结果见第 1 节,无业务写入 | -| 工作区 | `git diff --check` 通过,仅有已有交接文档的 LF/CRLF 提示 | - -定向复现使用本地真实服务代码和内存模拟的数据库、Redis、S3 或 API,均为虚构数据。这类验证能确认程序逻辑缺陷,但不替代真实 PostgreSQL 并发、生产 R2 或容器集成验收。 - -### 本轮未执行 - -- 未重新构建 Taro H5/WeApp,也未重新执行 H5 视觉巡检、微信 DevTools E2E 和真机测试;现有包体检查不证明产物与当前源码逐字对应。 -- 未重做全新环境 `npm ci` 或完整在线依赖审计;沿用已有依赖运行的结果不等于安装可复现性结论。 -- 未恢复真实数据库、未向 R2 上传测试对象,未压测生产,未读取私密学生数据。 -- 未核验 Cloudflare/微信平台控制台、SSH 环境、实际备份时效及告警投递。 - -交接文档中的历史通过记录应继续保留时间戳,不应被写成本轮重新通过。 - -## 7. 建议整改顺序 - -1. **先修 C01–C04。** 封闭商品复审和上传文件一致性缺口,修复恢复工具,调整系统默认公开身份信息;分别补能稳定复现问题的回归验证。 -2. **再修 C05–C09。** 补单会话接口、私有媒体路径、原子已读更新、禁言会话规则与启动入口,覆盖超过 50 个会话、商品状态变化和令牌过期场景。 -3. **同步校正文档并接入 CI。** 明确审核状态机、包体指标和当前待办,让现有测试成为 PR 的自动门禁。 -4. **完成外部验收。** 隔离恢复、异地同步、告警、边缘防护、容量压测和真机验证均需产出可追溯记录,再决定是否扩大使用范围。 - -本报告只完成审查和问题整理,未修改业务实现、提交代码、推送或部署;原有交接文档修改和 `Assets/generated/` 用户素材保持原状。 diff --git "a/docs/\351\241\271\347\233\256\350\241\245\345\205\205\345\256\241\346\237\245\344\270\216\345\276\205\344\277\256\345\244\215\346\270\205\345\215\225-2026-09-15.md" "b/docs/\351\241\271\347\233\256\350\241\245\345\205\205\345\256\241\346\237\245\344\270\216\345\276\205\344\277\256\345\244\215\346\270\205\345\215\225-2026-09-15.md" deleted file mode 100644 index 7f3faab..0000000 --- "a/docs/\351\241\271\347\233\256\350\241\245\345\205\205\345\256\241\346\237\245\344\270\216\345\276\205\344\277\256\345\244\215\346\270\205\345\215\225-2026-09-15.md" +++ /dev/null @@ -1,378 +0,0 @@ -# 梨苑儿项目补充审查与待修复清单 - -审查日期:2026-09-15 - -审查对象:`F:\BITerstore\app` - -审查分支:`codex/liyuaner-brand` - -审查基线:`8f1d8337d30d90277d5f3f6a395c5ceb4a567fed` - -关联文档:`docs/项目排查报告-2026-09-13.md`、`docs/项目交接文档.md` - -当前状态:代码整改与生产部署已于 2026-09-17 完成;代码侧批次 A–F 已闭环,外部平台、合规、压测、异地容灾和真机事项仍需继续执行。 - -## 1. 结论摘要 - -项目现有自动化测试和基础构建质量较好,但本轮补充审查发现,仍有若干安全能力和产品行为没有形成真正闭环。建议在扩大真实用户范围前,优先处理以下事项: - -1. 让 H5 游客读取真实公开商品,同时为公开读取接口补齐缓存、限流、查询约束和监控。 -2. 收窄公网 BIT-Login 路由,并修复 Cookie 会话降级和退出登录不彻底的问题。 -3. 在服务端真正执行拉黑关系和图片审核状态,不能只保存数据库标记。 -4. 修复聊天未读、通知、历史分页、上传孤儿对象和商品分页筛选问题。 -5. 补齐依赖升级、容器网络隔离、健康检查、备份恢复和真机验收。 - -关于“游客真实浏览是否会耗尽数据库流量”的决定如下: - -> **允许游客查看真实商品,但必须与公开读接口抗刷措施同批上线。保留演示商品不能作为数据库保护措施。** - -原因是 `GET /api/v1/listings` 和 `GET /api/v1/listings/:id` 当前已经是匿名公开接口。即使 H5 游客继续显示本地演示数据,恶意请求者仍可跳过页面直接调用 API。切换真实数据主要增加的是正常用户流量,而不是新建一个原本不存在的攻击入口。 - -## 2. 游客真实商品与数据库流量风险 - -### 2.1 当前实现 - -- 公开列表控制器没有认证 Guard:`server/src/modules/listings/listings.controller.ts:8`。 -- 公开详情同样无需登录:`server/src/modules/listings/listings.controller.ts:12`。 -- 每次列表请求都会直接执行 Prisma/PostgreSQL 查询,没有 API 缓存:`server/src/modules/listings/listings.service.ts:22-32`。 -- 单次请求数量已限制在 1–50 条,但搜索词长度、过滤枚举和请求频率没有统一约束。 -- Nginx 的 `/api/` 路由当前没有 `proxy_cache` 或 `limit_req`;只有 `/media/` 设置了客户端缓存头:`deploy/nginx.conf:62-88`。 -- H5 只有登录用户才使用真实 API;游客走本地种子仓储:`web/app/lib/repository.ts:174-180`。 - -### 2.2 风险判断 - -恶意重复请求确实可能带来以下消耗: - -- 重复列表和详情查询增加 PostgreSQL QPS、连接占用和网络流量。 -- 不断改变 `q`、`cursor`、`campus` 等参数可以制造大量不同查询,绕过简单 URL 缓存。 -- 当前搜索对标题、作者、ISBN、课程四列执行不区分大小写的包含匹配;数据增大后,随机搜索词可能造成高成本扫描。 -- 批量抓取商品详情和图片会同时消耗 API、数据库、对象存储和公网出站流量。 -- 校园网/NAT 下可能有大量正常用户共享一个公网 IP,因此仅做严格的单 IP 限流也可能误伤。 - -风险是可控的。正确方案不是强制游客登录,而是让公开内容通过缓存承接绝大多数重复读取,并在边缘层和应用层共同限制异常流量。 - -### 2.3 建议防护方案 - -#### 第一层:边缘与 Nginx - -- 在可信代理链上取得真实客户端 IP;只信任明确的 Cloudflare/NPM/内层 Nginx 地址或固定代理跳数,不能继续无条件 `trustProxy: true`。 -- 对公开列表、搜索、详情分别设置限流区,返回标准 `429` 和 `Retry-After`。 -- 初始建议值只作为压测起点: - - 无搜索列表:每 IP 60 次/分钟,允许约 20 次短时突发。 - - 搜索请求:每 IP 30 次/分钟,允许约 10 次短时突发。 - - 商品详情:每 IP 120 次/分钟,允许约 30 次短时突发。 -- Cloudflare 层增加按路径的速率规则、Bot/异常流量规则和紧急封禁开关。 -- 不能只依赖单 IP:应用层还应结合匿名设备标识、已登录用户 ID、请求路径和全站总速率。匿名标识只能作为辅助维度,不能视为可信身份。 - -#### 第二层:公开响应缓存 - -- 无搜索的首页列表优先使用 Nginx/CDN 或 Redis 缓存,建议 TTL 15–30 秒,并允许短时间 `stale-while-revalidate`。 -- 商品详情建议缓存 30–60 秒;商品下架、封禁、删除或审核拒绝时主动失效对应缓存。 -- 搜索结果只缓存经过规范化且长度受限的参数;使用有容量上限的 LRU/Redis 缓存,避免攻击者用随机搜索词填满缓存。 -- 缓存键只包含白名单参数:`q`、`campus`、`category`、`condition`、价格区间、排序、`cursor`、`limit`。未知参数直接拒绝,不能进入缓存键。 -- 只缓存公开、与用户无关的 GET 响应;不得缓存包含收藏状态、私聊、个人资料或管理信息的响应。 -- 增加 `ETag`/`If-None-Match`,让未变化数据返回 `304`,降低响应流量。 -- 对首页第一页可保留最近一次安全快照;数据库短暂不可用时可以返回短期 stale 数据,但被封禁/删除内容必须有主动失效通道。 - -#### 第三层:应用接口约束 - -- 使用 Redis 支持的分布式限流,覆盖所有 API 实例;Nginx 限流作为第一道保护。 -- 将公开列表默认 `limit` 保持在 20,最大 50;验证 cursor 格式并拒绝无效值。 -- 搜索词设置最大长度(建议 50)和合理的最小有效长度;去除首尾空格并统一大小写/Unicode 规范。 -- 校区、分类、成色和排序只接受服务端枚举;价格必须是合法非负整数区间。 -- 前端搜索增加约 300ms debounce,并取消已经过时的请求。 -- 对高成本搜索设置独立配额;必要时只对输入完成后的搜索提交请求。 -- 限流服务故障时,公开读取可由 Nginx 的保守限流继续保护;登录、上传、举报等敏感写操作应采用更严格的失败策略。 - -#### 第四层:数据库与查询 - -- 为公开列表建立匹配查询顺序的复合索引,例如活动状态、创建时间和 ID;按真实查询量评估校区、分类组合索引。 -- 当前四字段 `contains/ILIKE` 搜索在数据增长后应改为 PostgreSQL trigram/全文索引,或独立搜索服务。 -- 设置数据库连接池上限、查询超时和慢查询日志,防止单类请求占满全部连接。 -- 避免列表响应展开不必要的数据库字段和全部图片内部字段,使用明确的公开 DTO。 -- 为数据库 QPS、活动连接、查询 P95/P99、慢查询数和出站流量设置告警。 - -#### 第五层:容量与异常监控 - -- 监控每条公开路由的请求速率、`429` 比例、缓存命中率、响应大小和错误率。 -- 监控参数基数,尤其是单位时间内不同 `q` 和 cursor 的数量。 -- 记录经过脱敏/散列的来源维度,避免在日志中保存校园密码、令牌或完整敏感查询串。 -- 预留紧急模式:关闭搜索、降低最大 `limit`、只提供缓存首页、临时启用挑战页面。 - -### 2.4 游客真实列表的验收标准 - -1. 游客首页和商品详情来自真实公开 API,不再使用演示种子商品。 -2. 收藏、发布、私聊、举报等写操作仍要求登录和对应权限。 -3. 在缓存 TTL 内连续请求同一列表 100 次时,数据库查询次数应保持在可解释的极低数量,而不是 100 次。 -4. 超过配置阈值的流量稳定返回 `429`,正常页面短时并发不会被误伤。 -5. 随机超长搜索词、未知过滤参数和无效 cursor 返回 `400`,不进入数据库高成本查询。 -6. 商品下架、封禁或删除后,其列表、详情和媒体缓存能够主动失效;不得长期继续公开。 -7. 缓存响应不包含任何账号相关或后台字段。 -8. 压测只在本地或隔离测试环境执行,不对生产环境实施破坏性压力测试。 - -## 3. 本轮补充发现的待修复问题 - -### 3.1 高优先级 - -#### H1:H5 游客展示演示商品而非真实商品 - -证据:`web/app/lib/repository.ts:174-180` 仅在存在非 `guest` 学号时选择 API;`web/app/components/mobile-app.tsx:349` 将游客标记为 `guest`。 - -影响:游客看不到真实在售商品;真实分享链接在未登录且无缓存时可能显示不存在;H5 与小程序行为不一致。 - -整改:完成第 2 节的缓存、限流和输入约束后,让所有公开读操作使用真实 API,仅对写操作进行登录拦截。 - -#### H2:拉黑记录没有在聊天链路执行 - -证据:`server/src/modules/moderation/moderation.controller.ts:93-111` 只保存/删除 Block;`server/src/modules/conversations/conversations.service.ts` 创建会话、发送、读取时均不查询 Block。 - -影响:被拉黑者仍可新建会话或继续发送消息,安全功能名义上存在但实际上无效。 - -整改:在创建会话、发送消息、会话列表/详情入口执行双向拉黑检查;明确已有会话变为不可发送还是完全隐藏;补充客户端拉黑及管理入口。 - -#### H3:图片审核状态没有形成公开访问边界 - -证据:`server/prisma/schema.prisma:176` 默认 `PENDING`;项目没有修改该状态的完整流程;`server/src/modules/listings/listings.service.ts:17` 和 `server/src/modules/uploads/media.controller.ts:21` 未按审核状态过滤。 - -影响:待审核图片可直接出现在公开商品中。生产只读抽样已经复现 `PENDING` 图片公开且媒体返回成功。 - -整改:保守方案是只有 `APPROVED` 图片能够公开;补充审核队列、后台操作、拒绝原因和缓存失效。若产品决定暂不做内容审核,也应明确记录这一风险,不能把 `PENDING` 字段视作已经存在的安全能力。 - -#### H4:公网暴露了完整 BIT-Login 服务 - -证据:`deploy/nginx.conf:44-60` 代理整个 `/bit-login/`。锁定的 BIT-Login 上游提交除认证 challenge 外,还提供成绩、课程、学生数据、下游 Cookie、ICS 和临时文件接口;这些接口可接收原始学号密码或 challenge token。 - -影响:没有证据表明可以在无凭据情况下读取学生数据,但当前公网攻击面显著超出梨苑儿登录所需范围,可能被用于凭据代理、暴力尝试和资源消耗。 - -整改:按前端实际调用建立精确路由白名单;拒绝数据、Cookie、文档和临时文件路由;对 `/api/auth/start` 增加 IP/账号/全局并发限流,并确保密码和 challenge token 不进入访问日志。 - -#### H5:Cookie 会话可被客户端请求降级为 body token - -证据:`server/src/modules/auth/auth.controller.ts:46-55` 从 Cookie 取得 refresh token 后,仍信任请求体中的 `sessionTransport`。 - -影响:一旦出现同源 XSS,脚本可请求 body transport,将本应只存在于 HttpOnly Cookie 的长期 token 导出,扩大 XSS 的持久化影响。 - -整改:会话传输方式由服务端根据登录流程和 token 来源决定;Cookie refresh 只能继续签发 Cookie,不能被请求体覆盖。认证、刷新和个人数据响应统一增加 `Cache-Control: no-store`。 - -#### H6:H5 退出登录失败时会显示为已退出 - -证据:`web/app/components/mobile-app.tsx:610` 在服务端退出失败后仍于 `finally` 清理界面并跳转;浏览器 JavaScript 无法自行清除 HttpOnly Cookie。`web/app/components/mobile-app.tsx:111-117` 也没有删除聊天、通知、收藏和个人商品快照。 - -影响:刷新页面后可能恢复登录;共享设备上可能残留上一账号的聊天和账号数据。 - -整改:只有服务端成功清 Cookie/撤销 session 后才确认退出;失败时明确提示并重试,或进入阻止自动恢复的“待退出”状态。所有账号缓存按用户命名并在退出、过期、换号时统一清除。 - -### 3.2 中优先级 - -#### M1:聊天未读、实时刷新、历史分页和通知不完整 - -- 会话列表为每个会话附带最近 50 条消息,且会话本身没有分页:`server/src/modules/conversations/conversations.service.ts:7-22`。 -- Redis 未读数会被增加和删除,但列表接口从未读取,客户端把缺失的 `unread` 映射成 0。 -- H5 聊天页只加载一次,没有轮询、SSE 或 WebSocket,也没有提交已读。 -- 消息历史只支持读取更新消息,没有向前加载旧消息的客户端流程。 -- 通知只有查询接口,项目中没有可靠的通知创建和标记已读链路。 - -整改:会话列表只返回摘要和准确未读数;消息独立双向游标分页;统一数据库中的已读真相;H5 与小程序采用相同的实时/有限轮询策略;补齐通知产生、查询和已读接口。 - -#### M2:已完成但未关联商品的上传对象不会清理 - -证据:`server/src/modules/uploads/uploads.controller.ts:33` 只限制未完成 pending 数量;完成后记录具有 `uploadedAt` 且 `listingId` 仍为空。`server/src/maintenance/cleanup-pending-uploads.ts:109-127` 只清理 `uploadedAt: null`。 - -影响:用户完成上传后放弃发布,或商品创建失败,会永久留下数据库记录和 R2 对象;完成一批后即可继续申请下一批,绕过 pending 数量限制。 - -整改:为已完成但未绑定的对象设置 TTL 清理;增加用户总文件数/字节数/频率配额;提供取消上传或发布预留机制;商品创建时用事务和条件更新原子绑定图片。 - -#### M3:同步图片处理和条码识别可能阻塞 API - -证据:`server/src/common/image-validation.ts` 在 Node 主线程同步执行图片结构、CRC 和解压检查;`server/src/modules/books/books.service.ts` 使用高强度条码识别。 - -影响:重复上传特殊图片或高频识别可能占用事件循环和 CPU。 - -整改:增加上传/识别限流、并发信号量和超时;将高成本处理移入 worker thread/独立任务进程;保持严格的文件、像素和解压输出上限。 - -#### M4:请求 DTO 和错误边界不严格 - -证据:没有全局 ValidationPipe;多个控制器使用 `body: any`。`server/src/modules/listings/listings.service.ts:70` 的更新接口可接受空标题、非法价格和任意校区;消息 cursor/read ID 直接执行 `BigInt()`。 - -影响:非法数据可能进入数据库,或把应为 `400` 的客户端错误变成 `500`;版本字段虽然递增,但更新接口没有真正执行乐观并发检查。 - -整改:增加白名单 DTO、枚举、长度和数值范围;禁止未知字段;所有 ID/cursor 在服务层前验证;PATCH 使用期望版本条件更新并在冲突时返回 `409`。 - -#### M5:商品筛选和分页只覆盖前 50 条 - -证据:`web/app/lib/api-repository.ts:167-177` 和 `miniProgram/src/domain/api-repository.ts` 只请求最多 50 条,再在客户端执行价格、成色和价格排序;客户端忽略 `nextCursor`。 - -影响:商品超过 50 条后,筛选可能错误显示为空,价格排序只对第一页有效,“我的发布”也无法继续加载。 - -整改:服务端实现全部过滤和排序参数;客户端使用 cursor 分页/无限加载;搜索 debounce 和请求取消与第 2 节同时实施。 - -#### M6:依赖存在待升级安全公告 - -- 服务端锁定 `fastify@5.11.3`,低于两项高危请求校验问题的修复版本 5.12.2: - - - - -- 当前代码未发现使用公告涉及的特殊 schema,因此不能据此断言生产路由已可利用,但依赖本身应升级并回归。 -- `web` 的独立 Next.js 依赖为 16.2.6,处于 2026 年 8 月关键漏洞修复版本之前:。生产 H5 当前由 Taro 静态构建,不运行 Next 服务端,因此主要影响 Golden Reference 被独立启动或部署的场景。 -- MiniProgram 自定义依赖门禁当前通过,但仍依赖审核例外;应按复核日期继续升级 Taro/webpack 工具链,不能把“门禁通过”理解为零漏洞。 - -### 3.3 其他应改事项 - -1. `server/src/main.ts:13` 在生产无条件 `trustProxy: true`,应限制可信代理。 -2. Redis 没有密码/ACL,所有 Compose 服务处于同一默认网络;应拆分网络并限制可访问服务。 -3. `deploy/book-metadata-worker/src/index.js:167` 在未配置 `PROXY_TOKEN` 时会放行;应改为缺少配置即拒绝。生产探测显示当前 token 已配置,但代码仍存在配置回归风险。 -4. 健康检查只验证 PostgreSQL,没有覆盖 Redis、R2、BIT-Login 和必要的外部依赖。 -5. H5 会注册 `/sw.js`,但生产请求返回 404;应正确复制 service worker,或删除不真实的离线能力声明。 -6. Swagger 的全局前缀、Nginx 路由和 CSP 不一致,生产 `/api/v1/docs` 返回 404;应明确关闭生产文档或仅在受控内网正确发布。 -7. API 安全响应头由 Nest 和 Nginx 重复发送,应确定唯一责任层。 -8. 小程序把未知/空校区映射成“良乡”,可能错误展示交易地点;应统一为“未设置”。 -9. 小程序选择图片后统一声明 `image/jpeg`;PNG/WebP 真机文件可能因 MIME 不匹配被服务端拒绝,应检测真实类型。 -10. 消息举报只验证消息存在,没有验证举报人属于该会话;应增加成员关系检查。 -11. 账号删除会保留学号/身份关联并阻止重新注册;应明确恢复、匿名化和依法保留策略,并向用户准确说明。 -12. 管理端幂等 request ID 没有数据库唯一约束,并发重复操作可能被执行两次。 -13. `ConversationMember.userId`、`ListingImage.listingId` 等增长路径缺少适合查询的索引,管理列表还会加载过多审核记录,应在数据增长前补齐。 -14. `deploy/npm/README.md` 含具体 SSH 连接信息,与交接规则冲突;应改为占位符。历史提交中的真实 AppID 也应按既定协作流程处理。AppID 本身不是 AppSecret,但不应继续违反仓库规则。 - -## 4. 建议整改批次 - -为降低一次性改动风险,建议拆为以下独立、可回归的提交/批次。 - -### 批次 A:公开商品真实化与抗刷 - -- 公开列表/详情限流、缓存、DTO 和输入校验。 -- 服务端价格、成色、排序和 cursor 分页。 -- H5 游客切换真实 API;搜索 debounce/取消;加载更多。 -- 数据库索引、指标和本地/测试环境负载验证。 - -### 批次 B:认证与公网边界 - -- BIT-Login 精确路由白名单和专用限流。 -- Cookie transport 服务端绑定、认证响应 no-store、日志查询串脱敏。 -- 退出登录、换号和本地私密缓存清理。 -- 可信代理、客户端 IP 和安全响应头责任层整理。 - -### 批次 C:用户安全与内容治理 - -- 双向拉黑在会话创建/发送/查询中的强制执行。 -- 图片审核状态机、审核后台、公开媒体过滤和缓存失效。 -- 消息举报会话成员校验。 -- 账号删除/保留/恢复策略。 - -### 批次 D:聊天与通知 - -- 会话摘要分页、消息双向分页、准确未读状态。 -- H5/小程序统一的实时更新或有限轮询。 -- 通知事件生成、已读和客户端展示。 -- 消息发送频率和内容长度配额。 - -### 批次 E:上传、资源和数据完整性 - -- 完成但未关联上传的 TTL 清理和总量配额。 -- 图片绑定事务、并发条件更新和取消上传。 -- 图片/条码高成本任务限流、并发隔离和超时。 -- DTO、错误码、乐观并发和数据库索引。 - -### 批次 F:基础设施、依赖与运维 - -- Fastify/Nest 兼容升级及全套测试;处理其他开发/构建依赖公告。 -- Redis ACL、Compose 网络分段、容器最小权限和镜像 digest/锁定依赖。 -- worker fail closed、完整 readiness、监控告警。 -- 异地加密备份、备份完整性校验和真实恢复演练。 -- service worker、Swagger、移动端 MIME/校区显示和仓库文档清理。 - -## 5. 整改后的总体验收要求 - -- Server、Web、MiniProgram、Admin、Worker 的现有测试全部通过,并为每个修复点新增回归测试。 -- Server TypeScript 检查、Web/MiniProgram ESLint、H5/WeApp 构建和包体门禁通过。 -- 公开接口在本地/隔离环境完成正常流量、突发流量、缓存命中和限流测试;不得对生产进行破坏性压力测试。 -- 未登录、普通用户、被拉黑用户、被禁言用户、封禁用户和管理员权限矩阵均有自动化覆盖。 -- 图片从上传、待审、通过、拒绝、下架到清理的状态变化均有端到端测试。 -- 退出失败、Cookie 过期、网络中断、换号和共享设备场景不会泄露或恢复上一账号数据。 -- 生产发布前完成数据库迁移审查、回滚方案、Nginx 配置校验和只读 smoke test。 -- 不提交真实密钥、AppSecret、SSH 连接细节、CLI token、私有配置或测试用户隐私数据。 - -## 6. 本轮验证记录与边界 - -本轮补充审查已执行: - -- Server:91 项测试通过,TypeScript 检查通过。 -- MiniProgram:48 项测试通过,ESLint 通过;当时的依赖门禁仅代表既有本地策略通过,不等同于完整在线公告审计。 -- Web:40 项测试通过,ESLint 通过。 -- Admin:8 项测试通过。 -- Worker:10 项测试通过。 -- 合计:197 项测试通过。 -- 生产只读探测:健康、首页、公开列表和 BIT-Login OpenAPI 可访问;同时确认待审核图片公开、`/sw.js` 404、Swagger 路径不可达和重复安全响应头。 - -上述记录是整改前的审查基线。整改过程中没有进行生产压力测试、真实学生数据访问、破坏性安全测试、发布、推送或远程配置修改,也没有覆盖审查前已有的文档修改和 `Assets/generated/`。 - -## 7. 本地整改结果(2026-09-15) - -已完成的主要闭环: - -- 游客使用真实公开商品 API;列表、搜索和详情具备参数白名单、游标分页、Redis 短缓存/请求合并、应用与 Nginx 双层限流、全站总量兜底、公开 DTO、ETag、数据库复合索引及 trigram 搜索索引。100 个相同并发读取只触发一次缓存加载器的回归测试已通过。 -- 收窄 BIT-Login 公网路由;可信代理改为明确跳数/CIDR;访问日志移除查询串并对来源地址做带密钥散列;Cookie 会话不能被客户端降级;退出失败不再伪装成功,账号私密快照会在退出/换号时清除。 -- 双向拉黑在建会话和发消息时强制执行;消息举报验证会话成员;公开图片只允许已批准、已绑定且商品/卖家有效的对象,后台可查看待审图并记录拒绝原因。 -- 会话摘要、会话分页、消息双向分页、准确未读、已读、有限轮询和通知产生/读取链路已补齐;消息发送增加 Redis 用户级与会话级配额。 -- 上传增加频率、未绑定文件数/字节数配额、取消接口、并发安全绑定,以及未完成和完成未绑定对象的定时清理;图片结构校验和条码识别在生产中移到 worker thread,并具备并发与超时上限。 -- 商品写入使用严格字段/范围校验和乐观并发;筛选、价格排序、公开列表与“我的发布”均由服务端分页,“我的发布”总数单独统计。 -- 账号注销会撤销会话、下架商品、解绑微信、清除公开资料与非必要数据;校园身份使用独立密钥 HMAC,30 天内可认证恢复,超期关联由维护任务删除。 -- 管理操作的 request ID 增加数据库唯一约束;商品审核摘要进入 Listing 表,后台不再为每页列表读取全部历史处置记录。 -- Fastify 固定到 5.12.2,Next.js 与 `eslint-config-next` 固定到 16.3.3;生产 Swagger 关闭,H5 构建会包含真实 `/sw.js`,小程序校区与上传 MIME 行为已修正。 -- Redis 默认账号关闭、ACL 密码启用,Compose 拆分 edge/app/data/egress 网络;readiness 覆盖 PostgreSQL、Redis、上传存储和 BIT-Login。 -- 数据库备份改为完整性校验、带完整性保护的 OpenPGP AES-256 加密、解密复检和原子落盘,并增加拒绝生产库名称的隔离恢复脚本与监控运行手册。 - -新增但尚未应用的数据库迁移为 `202609150001` 至 `202609150004`。其中内容安全迁移会把存在未批准公开图片的历史在售商品移回待审状态;发布前必须审查数据影响、备份并准备回滚方案。 - -本地最终验证包括 Server 132 项、Web 40 项、MiniProgram 48 项、Admin 8 项及 Worker 11 项测试,共 239 项;Server/Web/Admin/H5/WeApp 构建以及 lint/类型检查均通过。生产图片 worker 和条码 worker 另以真实 1×1 PNG 做了编译产物 smoke test。2026-09-16 通过已配置的微信开发者工具服务端口运行仓库自动化验收,12/12 个 WeApp E2E 场景通过,应用控制台错误与未捕获异常均为 0;验收后已重新生成不含 E2E 固定数据和测试登录入口的标准生产模式微信包。 - -仍需外部/生产环境执行: - -- Cloudflare Bot/速率规则、紧急挑战开关与告警接收渠道配置。 -- 加密归档和图片的异地私有存储同步。 -- 使用真实 Docker/Nginx 执行 Compose、ACL、readiness 和网关语义验证;当前工作机没有 Docker/Nginx,只完成 YAML 解析和静态回归。 -- 隔离环境 k6 压测、缓存命中/数据库 QPS 观测、数据库迁移演练、真实备份恢复演练及移动端真机验收。 -- 完整在线依赖公告审计;当前只按已确认的官方公告完成定向升级,离线 npm 审计不能证明不存在其他公告。门禁保持失败关闭,并会显示 registry/网络错误;本轮受限环境不允许向 npm 审计端点发送完整依赖树,故未将其记为通过。 - -## 8. 最终复查与生产部署记录(2026-09-17) - -### 8.1 复查结论与计划完成度 - -- 本清单的代码整改批次 A–F 已完成并部署,包括游客真实商品、公开接口抗刷、认证边界、内容审核、聊天通知、上传清理、数据完整性、依赖升级、容器隔离、就绪检查和加密备份。 -- 《整体实施计划》不能标记为全部完成。仍依赖外部主体或运营执行的事项包括:BIT-Login 许可/维护责任确认、微信主体/类目/域名/隐私审核、10–20 名真实用户访谈、Cloudflare Bot/速率规则与告警渠道、异地私有备份同步、隔离环境容量压测、一次真正恢复到临时数据库的演练、移动端真机验收和完整在线依赖公告审计。 -- 生产当前共有 25 条未删除商品,其中 `ACTIVE=0`、`PENDING_REVIEW=13`。游客读取的是真实 API,但当前公开目录为空,这是内容安全迁移和审核规则的预期结果;需要管理员审核合格商品后才会重新公开,不能通过绕过审核来“恢复展示”。 - -### 8.2 游客抗刷与数据库流量结论 - -游客可以查看真实公开商品,但单纯隐藏真实数据不能保护数据库,因为攻击者可直接调用公开 API。现已形成以下纵深防护: - -- 列表、搜索和详情使用参数白名单、严格游标/枚举/长度约束、数据库索引、Redis 短缓存、并发请求合并、ETag,以及应用层和 Nginx 双层限流;随机查询参数不能无限制造有效缓存键。 -- 列表、搜索、详情分别使用独立的每 IP 限额,并有全局 API 速率/并发兜底;公开媒体另设每 IP 180 次/分钟和全局 3600 次/分钟保护。 -- ISBN 查询改为仅已认证且已验证用户可访问,并设置每 IP 30 次/分钟和全局 2 次/秒限制;登录交换/刷新/注销等入口也有每 IP 与全局限额。 -- 图片和商品只有满足审核与状态条件才公开;ISBN 凭证只允许受保护的管理员审核接口读取。 -- 这些措施显著降低重复请求直接消耗 PostgreSQL 的风险,但不能替代容量监控和边缘防护。Cloudflare 规则、告警和隔离环境 QPS/缓存命中基线仍是上线扩量前的外部任务;未对生产实施破坏性压力测试。 - -### 8.3 最终本地门禁 - -- Server:142 项测试通过,TypeScript 检查和构建通过。 -- Web:41 项测试、ESLint 和构建通过。 -- Admin:9 项测试和构建通过。 -- MiniProgram:48 项测试、ESLint、H5 构建和标准 WeApp 构建通过。 -- Worker:11 项测试通过。 -- 合计 251 项自动化测试通过;微信开发者工具自动化 12/12 场景通过,应用错误和未捕获异常均为 0,随后重新生成了不含 E2E 固定数据的标准生产包。 -- `git diff --check` 未发现空白错误;仅有 Windows 工作区的 LF/CRLF 提示。`Assets/generated/` 为审查前已有的用户文件,本轮未覆盖或清理。 - -### 8.4 发布与生产验收 - -- 发布归档共 487 个条目,不含 `.env`、私钥、备份、`node_modules`、构建产物、QA 产物和 `Assets`;初始归档 SHA-256 为 `a696b86d04a4ccffcd421acd1cb9e091253c240ab0cb698ff9fd72c99e2c524f`,本地与服务器校验一致。 -- 首次并行镜像构建因 npm 出口 `ECONNRESET` 中断;确认服务器资源正常且 registry 恢复后改为串行重试,API、H5、Admin、Backup 四个候选镜像均成功构建。该失败未触碰现网容器。 -- 候选运行时预检验证了 API 非 root 权限、备份容器 UID/GID 与密钥/目录权限、GPG 往返、唯一待执行迁移、Nginx 配置和 Redis 受限 ACL。正式切换由带自动回滚的脚本完成,未触发回滚。 -- 迁移 `202609150001_public_catalog_indexes`、`202609150002_content_safety`、`202609150003_audit_request_id`、`202609150004_listing_moderation_summary` 和 `202609170001_required_listing_images` 均已完成。切换前后用户数保持 9、商品数保持 25,异常激活商品和重复审计 request ID 均为 0。 -- 8 个 Compose 服务均为 running,具备健康检查的 PostgreSQL、Redis、BIT-Login、API、Backup 均为 healthy,重启次数均为 0。公网首页、后台、Service Worker、公开列表和 readiness 返回 200;BIT-Login OpenAPI 返回 404;匿名 ISBN 查询返回 401。 -- 就绪检查曾出现一次约 2.15 秒的瞬时 503,随后内部与公网立即恢复;追加 90 秒、45 次连续采样全部返回 200,数据库、Redis、存储和 BIT-Login 四项均为 `ok`,未发现持续故障。 -- 已安装两项带 `flock` 的维护任务:每小时清理废弃上传、每日清理过期账户恢复关联。 - -### 8.5 备份安全收尾 - -- 新备份容器以非 root UID/GID 运行,使用真实健康检查;新归档先完成 `pg_dump`/`pg_restore` 检查、AES-256 加密、完整解密到临时文件、与原文件逐字节比较和再次 `pg_restore` 检查,之后才原子落盘并标记健康。 -- 部署切换和备份热修复后均成功产生新的 `0600` 加密归档,并通过独立完整解密与 `pg_restore --list` 复核;日志中不再出现流式校验的 `Broken pipe`。 -- 经负责人明确同意,生产目录、回滚目录和发布证据目录中的 25 份历史明文数据库/归档备份均先生成加密副本,再完整解密并与删除前 SHA-256 对比,全部一致后删除明文。原内容仍可使用受控口令从对应 `.gpg` 恢复,但明文文件本身不再保留。 -- 当前加密副本仍位于同一台服务器,不能视为异地容灾;异地私有同步和恢复到一次性临时数据库的正式演练仍需执行。 From 3de8819fb5c642390008e79bc11711b03116a251 Mon Sep 17 00:00:00 2001 From: Young581 Date: Sat, 19 Sep 2026 11:09:47 +0800 Subject: [PATCH 4/4] docs: keep deployment records out of repository --- ...266\350\256\260\345\275\225-2026-09-18.md" | 43 ------------ ...215\350\256\260\345\275\225-2026-09-18.md" | 30 --------- ...266\350\256\260\345\275\225-2026-09-18.md" | 57 ---------------- ...215\350\256\260\345\275\225-2026-09-18.md" | 67 ------------------- 4 files changed, 197 deletions(-) delete mode 100644 "docs/\344\275\223\351\252\214\344\277\256\345\244\215\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" delete mode 100644 "docs/\345\233\233\351\241\271\344\275\223\351\252\214\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" delete mode 100644 "docs/\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" delete mode 100644 "docs/\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" diff --git "a/docs/\344\275\223\351\252\214\344\277\256\345\244\215\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" "b/docs/\344\275\223\351\252\214\344\277\256\345\244\215\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" deleted file mode 100644 index 4e71039..0000000 --- "a/docs/\344\275\223\351\252\214\344\277\256\345\244\215\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" +++ /dev/null @@ -1,43 +0,0 @@ -# 四项体验修复部署验收记录 - -完成时间:2026-09-18 01:43(UTC+8)。用户明确要求“将本次修复推送并部署”。 - -## 发布结果 - -- 站点:https://store.young581.com;后台:https://store.young581.com/admin/。 -- 分支:`codex/public-routes-chat-fixes`,已推送至 fork,对应 [PR #24](https://github.com/AnonymousUser443/BITerStore/pull/24),未合并。 -- 修复提交:`a66d41fc7b772598289f50942430db6e207ad078`。 -- 生产快照及 `.release-commit`:`0e12c5f22dda6dcfe52c809338bfffeda051d187`,包含修复及发布前状态文档;随后提交的验收文档不改变运行代码,无需重复部署。 -- 上一生产版本:`b5590bb79a03f6a7ec10e8630cde55f43f06f2b1`。 -- 更新 API、H5、Admin,并重启 Nginx;保留生产私有配置、密钥、数据库及存储卷。 -- H5 资源:`js/app.be513661.js`、`css/app.70aa105d.css`。 - -本次上线后台待审核详情、H5 返回稳定性、滚动条隐藏和举报进度信息补全。实现及本地验证见 [四项体验问题修复记录](四项体验问题修复记录-2026-09-18.md)。微信普通生产包已经本地构建和验收,本次未上传、提审或发布微信平台版本。 - -## 构建与备份 - -1. 从精确提交生成归档,检查不包含私有配置、凭据、依赖、QA 工件或用户未跟踪素材;本地和服务器 SHA-256 一致。 -2. 在独立目录构建三个镜像;H5 受控依赖审计通过,8 个已审查上游 advisory 的例外仍按原记录管理。 -3. 隔离 PostgreSQL/Redis 完整应用 13 个迁移,标准 API 启动和 readiness 通过;隔离测试的 BIT-Login 为 skipped,生产另行真实检查。 -4. 切换前生成 `deploy/backups/biterstore-predeploy-20260918-0e12c5f22dda.dump.gpg`(85,011 字节);解密后逐字节比较及 `pg_restore --list` 均通过。此次未向生产执行恢复操作。 -5. 旧镜像保留为 `biterstore-rollback-api:b5590bb79a03`、`biterstore-rollback-h5:b5590bb79a03`、`biterstore-rollback-admin:b5590bb79a03`。私有配置切换前后校验一致。 -6. 无新增迁移;生产 13 个迁移全部 current。验收后清理临时归档、隔离目录及其容器/网络,保留加密备份和回滚镜像。 - -## 线上验证 - -- 8 个 Compose 服务均 running;API、PostgreSQL、Redis、BIT-Login 和 backup 健康检查通过。 -- 公网 26 项 HTTP 检查通过:首页及版本化资源、Service Worker、后台、真实公开列表/详情/图片、ETag 304、安全响应头、未知路由与旧详情路由相对跳转、私有媒体鉴权、BIT-Login 非认证路径限制。 -- 新增 `/api/v1/admin/listings/:id` 和 `/api/v1/reports/mine` 匿名请求均返回 401,响应 `no-store`。 -- 公网连续 3 次 readiness 及最终内网复检通过:database、redis、storage、bitLogin 全部 ok。 -- 浏览器打开真实首页、商品详情和后台登录页,检查截图;应用 exception、console error、5xx、损坏图片及横向溢出计数均为 0。 -- 对真实商品连续 10 次进入详情、点击左上角返回:同一应用 DOM 保留,只有一个应用容器,滚动位置保持,滚动条样式为隐藏。 -- H5/网关 Nginx 配置检查通过;运行中的 API/H5/Admin 镜像 ID 与本次构建一致;从切换开始统计 API 错误日志及 Nginx error/critical 日志均为 0。 -- 完成公网验收后写入生产版本标记。 - -## 验证边界与剩余事项 - -后台已登录审核和个人历史举报完整展示由本地受控浏览器、服务端单测及微信 E2E 验证;本次未使用真实生产账号执行治理或举报写操作。生产浏览器仍有既有 CSP 拦截内联/统计脚本及 favicon 404 提示,游客身份探测返回预期的 401;不能把应用错误为 0 描述成浏览器所有诊断为 0。 - -GitHub API 确认 PR head 已更新,但发布提交的 Actions run 数量为 0,不能声称 CI 已通过。微信平台发布、真机联调、外部运维和依赖风险继续按交接清单推进。 - -实际截图、HTTP 检查和返回回归结果保存在忽略的本地 QA 目录,不提交生产工件、私密信息或真实 AppID。 diff --git "a/docs/\345\233\233\351\241\271\344\275\223\351\252\214\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" "b/docs/\345\233\233\351\241\271\344\275\223\351\252\214\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" deleted file mode 100644 index d725079..0000000 --- "a/docs/\345\233\233\351\241\271\344\275\223\351\252\214\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" +++ /dev/null @@ -1,30 +0,0 @@ -# 四项体验问题修复记录 - -日期:2026-09-18(UTC+8)。对应用户反馈:审核期间无法看详情、返回偶发刷新、侧边滚动条、举报进度缺少对象和结果。 - -## 实际修改 - -| 问题 | 原因与修复 | -| --- | --- | -| 审核期间详情不可见 | 后台“查看详情”错误跳到公开商品页,公开接口会隐藏待审核商品。新增受 `AuthGuard`/`AdminGuard` 保护的后台详情接口和详情弹窗;商品治理、举报工单均从后台查看完整描述、价格、状态、卖家及审核图片/ISBN 凭证。没有放开待审核商品的公开访问。前台卖家原有 owner 详情接口另经回归确认可用。 | -| 返回偶发刷新感 | Golden Reference 与 Taro 同时消费 `popstate`,Taro 异步重挂页面,导致页面已显示后再次切换。H5 入口在 Taro 之前分发由本应用创建的历史项;应用只处理一次返回,并手动恢复滚动位置。浏览器回归持续检查同一应用 DOM、滚动位置和卡片动画,修复前可复现重挂载,修复后连续 10 次通过。 | -| 侧面滚动条 | 原有规则只覆盖部分滚动容器,弹窗等容器仍可能显示滚动条;视觉工具还使用浏览器强制隐藏滚动条参数,掩盖了问题。H5/后台统一隐藏轨道但保留滚动;微信聊天显式关闭原生滚动条。巡检移除强制隐藏参数,实际检查页面 CSS。 | -| 举报进度过少 | 旧通知只有处理人填写的说明。新增仅允许举报人查看的 `/reports/mine` 游标分页接口,双端系统通知页显示举报对象、完整编号、原因、状态、处理说明及提交/更新时间。历史工单也从现有 Report 数据读取,缺失说明明确标注,不编造结论。新通知同时记录对象、编号、原因及状态/结果,不再截断到 300 字。 | - -通知分类页标题统一使用“系统通知”等分类名,避免把最新一条通知标题当作整个页面标题。 - -## 验证 - -- Server:原有 163 项测试通过,新增 10 项测试通过,合计 173;TypeScript/构建通过。新增测试覆盖待审核详情、隐私字段、举报人范围、他人游标拒绝、分页、目标缺失及三种处理状态的通知内容。 -- Web:48 项测试、ESLint、生产构建通过。 -- MiniProgram:52 项测试、ESLint、独立 TypeScript 检查、H5/WeApp 构建通过。 -- Admin:9 项测试及 TypeScript/生产构建通过;浏览器实际点击待审核商品详情,确认使用受保护接口、完整描述及两类审核图片。 -- H5:72 个页面/视口全量巡检无诊断;最终追加卖家待审核详情与通知分类的 4 个目标检查。返回测试连续 10 次稳定,后台详情专门验收通过。最终首屏 377.6 KiB,性能预算通过。 -- 微信 DevTools:13/13 场景通过,包含新增举报进度场景;应用 console error 0、exception 0,已检查路由、稳定元素、结构与截图。测试后恢复普通生产构建。 -- 测试截图、合成数据和探针结果保留在忽略的 QA 目录,不提交真实 AppID、端口、凭据或运行工件。 - -## 发布范围与边界 - -修复提交:`a66d41fc7b772598289f50942430db6e207ad078`。用户明确授权后,已推送到 PR #24,并于 2026-09-18 01:43 完成 Server、H5 和 Admin 生产发布;发布快照为 `0e12c5f22dda6dcfe52c809338bfffeda051d187`,无需新增数据库迁移。公网 26 项检查及真实页面连续 10 次返回通过,详见 [体验修复部署验收记录](体验修复部署验收记录-2026-09-18.md)。小程序普通生产包已恢复:94 个文件、1300.0 KiB 原始体积、1733.4 KiB 估算上传载荷,17 个页面脚本、0 WebP;平台发布未执行。 - -历史通知本身缺少可关联的举报编号,不猜测回填;“我的举报进度”直接列出现有历史工单和当前处理结果。已删除对象无法恢复原始名称时显示对象类型及编号。真实账号权限、真机联调及此前交接文档中的外部运维事项仍按原清单推进。 diff --git "a/docs/\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" "b/docs/\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" deleted file mode 100644 index c7ed2ca..0000000 --- "a/docs/\351\203\250\347\275\262\351\252\214\346\224\266\350\256\260\345\275\225-2026-09-18.md" +++ /dev/null @@ -1,57 +0,0 @@ -# 2026-09-18 部署验收记录 - -验收完成时间:2026-09-18 00:45(UTC+8)。用户已明确授权“推送、部署”。 - -## 发布结果 - -| 项目 | 结果 | -| --- | --- | -| 生产站点 | | -| 发布代码 | `b5590bb79a03f6a7ec10e8630cde55f43f06f2b1` | -| 推送分支 | `fork/codex/public-routes-chat-fixes` | -| PR | [#24](https://github.com/AnonymousUser443/BITerStore/pull/24),已收到修复提交,仍为 Open | -| 上一生产版本 | `79560aebce401653a5e2151153d3bfca77f1790e` | -| 本次更新服务 | API、H5、Admin、backup;随后重启 Nginx | -| 生产版本标记 | 内外网验收后才将 `.release-commit` 更新为上述完整 SHA | -| H5 资源 | `js/app.b2e0996a.js`、`css/app.2afdcf42.css` | -| Admin 资源 | `assets/index-CysZHBSz.js`、`assets/index-m0-XFhBx.css` | -| 数据库迁移 | 13 个全部 current,包含 `202609180001_private_default_nicknames` | - -发布包来自 `git archive HEAD`,本地和服务器 SHA-256 均为 `70e8f85c686f54acde5105d874db13b48168296bb047ec6e4d9f37929d9e3e8c`。包内没有环境文件、密钥、私有配置、依赖目录、QA 工件和 `Assets/generated/`。生产 `.env` 与 secret 文件在解包前后校验一致,数据卷保留。 - -这份验收记录及同步的交接文档会另作纯文档提交;其 Git HEAD 可以晚于生产代码 SHA,不代表服务代码尚未发布。 - -## 发布前验证与恢复保障 - -- 本地既有门禁:283 项测试、各端相应 lint/typecheck/build、H5 71 个目标及最终 5 个相关页面、WeApp E2E 12/12,通过情况见[修复记录](问题修复记录-2026-09-18.md)。 -- 服务器使用独立镜像标签构建四个更新组件,再切换已验证镜像;H5 受控依赖审计通过。 -- 临时 PostgreSQL 17/Redis 容器执行全部 13 个迁移,`npm start` 正常运行,数据库/Redis/本地存储 readiness 通过;该隔离环境不配置 BIT-Login,因此该项为 skipped。 -- 执行仓库 `deploy/backup/verify-ci.sh`:真实 PostgreSQL 中验证旧默认昵称被迁移、自定义昵称保留;真实 `pg_dump` → GPG 加密 → 实际恢复脚本 → 临时数据库恢复成功。这里使用合成数据,不代表生产备份已恢复到独立灾备环境。 -- Nginx 配置语法通过。 -- 切换前创建生产加密备份 `deploy/backups/biterstore-predeploy-20260918-b5590bb79a03.dump.gpg`,84713 字节;解密结果与源归档一致,`pg_restore --list` 成功,临时明文已清理。 -- 保留上一生产 API/H5/Admin/backup 镜像标签 `biterstore-rollback-:79560aebce40`。迁移不自动回滚;旧默认昵称替换属于数据变化,不能用回退镜像恢复原值。 - -## 生产验收 - -| 检查 | 结果 | -| --- | --- | -| 服务 | 8 个 Compose 服务 running;API、PostgreSQL、Redis、BIT-Login、backup 健康检查通过 | -| Readiness | 公网连续 3 次 200,收尾内网再次 200;database、redis、storage、bitLogin 均为 ok | -| 新迁移 | Prisma status current;只读聚合确认“BITer + 本人学号”的默认昵称剩余 0 条 | -| HTTP 冒烟 | 24 项通过:首页、JS/CSS、SW、Admin、列表、真实详情、公开媒体、旧媒体路径、路由跳转、权限、BIT-Login 隔离与 readiness | -| 缓存及安全头 | 首页 CSP/HSTS 存在,列表 ETag 条件请求返回 304;本次媒体公网响应为更严格的 `no-store` | -| 私有接口 | 未登录读取单会话、owner/会话媒体及旧 `/media/` 兼容路径返回 401;媒体错误响应为 `no-store` | -| BIT-Login 边界 | 非认证 schedule 和 OpenAPI 路径均返回 404;未创建真实校园登录 challenge | -| 路由 | 未知路径相对 302 到站内 404;旧详情相对 302 到规范 query 路由,无 HTTPS 降级 | -| 浏览器 | 390×900、DPR=2,真实生产首页、真实商品详情及后台登录卡片加载;没有 mock API,已查看截图;应用 console error、运行时 exception、HTTP 5xx、缺图、横向溢出均为 0 | -| 日志 | 切换稳定后采样窗口内 API ERROR/FATAL/未处理异常及 Nginx error/crit/alert/emerg 均为 0 | - -已清理本次服务器发布归档、独立验证目录及临时脚本,隔离容器和网络已销毁;生产加密备份和回滚镜像保留。浏览器截图和实际探针结果仅保存在被忽略的本机 QA 目录。 - -## 仍需处理或验证 - -1. **浏览器 CSP 提示**:生产 CSP 拦截 H5 模板的两段内联脚本及 Cloudflare 统计脚本;首页还请求了缺失的 `favicon.ico`。本次三页可用且无应用异常,但不能描述为“浏览器控制台完全零错误”。后续应将必要内联逻辑移至允许的静态脚本或采用精确 hash/nonce,并补齐 favicon、明确统计脚本策略。游客 `/me`、refresh 和后台安全状态的 401 属于未登录边界。 -2. **CI 首次执行**:工作流已推送,但本次 GitHub API 查询仍没有 Actions run,不能记为 GitHub CI 通过。本次是在本地及服务器隔离环境实际完成对应门禁;PR 审阅合并、Actions 启用/执行和必需检查仍待处理。 -3. **真实登录联调**:私有媒体成功响应、真实 R2 并发上传/取消、审核并发及已读并发压力仍需测试账号验证。未登录 401 检查不能代替这些场景。 -4. **微信发布**:普通生产包已构建,仍需下载合法域名核对、真机私有图片与交易流程验收;未执行平台上传、提审或发布。 -5. **灾备与运维**:合成数据库恢复和生产备份解密校验已完成;生产数据隔离恢复、异地备份、R2 生命周期、Cloudflare WAF/告警、容量验证和 Nginx 动态上游等事项仍按交接文档推进。 diff --git "a/docs/\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" "b/docs/\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" deleted file mode 100644 index ad2e982..0000000 --- "a/docs/\351\227\256\351\242\230\344\277\256\345\244\215\350\256\260\345\275\225-2026-09-18.md" +++ /dev/null @@ -1,67 +0,0 @@ -# 项目问题修复记录 - -修复日期:2026-09-18(UTC+8) - -对应审查:[项目现状复查与问题清单](项目现状复查与问题清单-2026-09-17.md)。 - -本次完成 C01–C09 的代码修复,并补充回归测试、CI 配置及文档校正。用户随后授权推送和部署:**修复已作为 `b5590bb` 推送至 PR #24,并于 2026-09-18 00:45(UTC+8)完成生产验收,13 个迁移 current。** 详见[部署验收记录](部署验收记录-2026-09-18.md)。`Assets/generated/` 未修改。 - -## 修复结果 - -| 编号 | 实际修改 | 验证方式 | -| --- | --- | --- | -| C01 商品复审 | 内容编辑清空的审核标记成为重新上架的必要条件;未获当前内容批准时回到待审核。管理员操作携带页面读取的版本,并在事务中条件更新;双端按服务端实际状态显示“已提交审核”。 | 覆盖编辑→下架→再上架、正常再次上架、旧审核页面及审核中并发编辑。 | -| C02 上传一致性 | R2 写入已校验字节,移除对可再次 PUT 的 pending 对象复制。每次完成请求使用独立最终键和数据库条件更新,重复请求幂等;失败请求不会删除成功请求的文件。限制 GET 读取大小,取消操作校验对象键。 | 覆盖读取后替换源对象、并发完成、数据库响应丢失和取消抢先完成;使用真实控制器与模拟 S3/数据库,另验证真实本地文件。 | -| C03 恢复脚本 | GPG 解密增加 `--yes`,允许覆盖 `mktemp` 已建立的文件。 | 本地实际 GPG 验证通过;发布前进一步在隔离 PostgreSQL 完成合成数据的真实加密归档与完整恢复。 | -| C04 默认昵称 | 新注册、恢复及历史默认昵称改为随机 `BITer-…`;新增数据迁移,仅替换与本人学号精确匹配的旧默认昵称。 | 单测及真实隔离 PostgreSQL 验证通过;生产迁移后旧默认昵称剩余 0 条。 | -| C05 旧会话 | 新增受成员权限约束的 `GET /conversations/:id`;H5 和小程序直接取单会话,不再依赖最近 50 条摘要。 | 覆盖直接读取旧会话、非成员拒绝、完整历史合并及已读。 | -| C06 非在售图片 | 卖家列表和详情使用 owner 媒体接口;会话使用成员媒体接口读取允许状态下的已审核图片。ISBN 保持私有,删除/封禁/待审核商品不向会话开放图片。微信通过带请求头的下载获取图片,退出或切换账号清理临时文件。 | 覆盖接口鉴权、查询约束、私有缓存策略、令牌刷新、不向外域发送令牌;双端构建及页面回归。真实私有图片上传和下载仍需真机联调。 | -| C07 已读游标 | 在同一条数据库更新中要求旧游标为空或小于目标,防止旧请求覆盖新进度。 | 模拟低序号请求最后完成,游标仍保持高序号。真实 PostgreSQL 并发压力验证待补。 | -| C08 禁言会话 | `MUTED` 可以登录及刷新,继续保留只读边界;`BANNED`/`DELETED` 仍拒绝发放会话。 | 覆盖禁言登录和刷新、封禁/注销拒绝;既有写操作禁言测试继续通过。 | -| C09 启动入口 | `npm start` 改为实际构建路径 `dist/src/main.js`。 | 构建通过;发布前在隔离 PostgreSQL/Redis 环境执行标准启动,readiness 通过。 | - -此外修正了 Nginx `/media/` 兼容路径强制公共缓存的问题,保留上游的私有媒体缓存头;修复小程序独立类型检查发现的联合类型、异步请求测试类型及 H5 图片适配器映射问题。 - -审核标记复用现有 `moderationDecision`:内容编辑与清空批准发生在同一版本更新内;“忽略”操作不会覆盖已有的 `ACTIVE` 批准。历史商品若没有明确的批准标记,重新上架会进入复审,不自动推断其已经通过审核。 - -## 本地验证 - -运行时:Node.js 22.13.1;沿用现有锁文件和已安装依赖,没有批量升级依赖。 - -| 范围 | 结果 | -| --- | --- | -| Server | 27 个测试文件,163 项测试通过;TypeScript 检查和构建通过 | -| Web Golden Reference | 48 项测试、ESLint、生产构建通过 | -| MiniProgram | 52 项测试、ESLint、独立 TypeScript 检查通过;H5/WeApp 构建通过 | -| Admin | 9 项测试、TypeScript 和生产构建通过 | -| 书目 Worker | 11 项测试通过 | -| 测试总数 | 283 项通过(审查基线为 261 项) | -| H5 页面 | 71 个页面/视口全量巡检通过;最终类型修正后再跑 5 个相关页面,诊断均为 0;已查看关键截图 | -| 微信 DevTools | 12/12 场景通过,应用 console error 0、exception 0;检查了路由、稳定元素、截图和验收记录 | -| 最终普通 WeApp 包 | 94 文件、1296.2 KiB 原始体积、1728.3 KiB 估算上传载荷,17 个页面脚本、0 WebP,包体门禁通过 | -| 恢复脚本 | 真实 GPG 加解密通过;shell 语法检查通过,数据库部分未在本机运行 | -| CI 配置 | YAML 解析和任务结构检查通过;尚无 GitHub Actions 运行结果 | - -自动化工件存放在被忽略的 `qa-artifacts/` 目录,没有加入源码。微信验收使用测试构建;完成后重新生成普通生产包。真实 AppID、开发者工具状态、私有配置及凭据未写入本文。 - -## 持续检查 - -新增 [CI 工作流](../.github/workflows/ci.yml): - -- PR、main 更新或手动触发,GitHub 权限仅 `contents: read`,不部署,不使用生产密钥。 -- 使用锁文件安装 Server、Web、Admin 和 MiniProgram,执行对应 lint、typecheck、测试及构建。 -- 执行 H5 性能预算和 WeApp 包体门禁,以及书目 Worker 测试。 -- 使用临时 PostgreSQL 17/Redis 服务,执行 Prisma 迁移、标准启动及 readiness。 -- 用 [合成数据验证脚本](../deploy/backup/verify-ci.sh) 验证历史昵称迁移和加密归档恢复至临时库,并检查 Nginx 配置语法。 - -工作流使用官方 [checkout v6](https://github.com/actions/checkout/tree/v6) 和 [setup-node v6](https://github.com/actions/setup-node/tree/v6)。本机没有可用 Docker/PostgreSQL;发布前已在服务器隔离容器实际完成迁移、标准启动、合成数据恢复和 Nginx 检查。**GitHub API 在推送后仍未返回 Actions run,不能记为 GitHub CI 通过。** 首次 Actions 执行及分支保护所需检查仍待处理。 - -## 上线后仍需完成 - -1. 完成真实 R2 并发上传和取消验证;已有隔离数据库迁移、标准启动、合成数据完整恢复及 Nginx 检查通过记录。 -2. Server、Admin、H5 与 backup 已同步发布,昵称迁移已应用;微信平台发布仍待完成。新版后台审核请求需要 `version`,旧后台会收到冲突提示;新版聊天依赖单会话接口。 -3. 微信私有图片使用 `downloadFile`,需核对 `store.young581.com` 的下载合法域名配置,并在真机验收待审核、下架、已售、退出和切换账号的图片显示。DevTools 使用测试数据,不能代替这一步。 -4. Nginx 已重启并探测,私有媒体及兼容路径未登录响应均为 401/`no-store`;实际登录后的媒体成功响应仍需联调。动态上游解析和本次发现的 CSP/favicon 提示仍待处理。 -5. PR 审阅合并、Cloudflare WAF/告警、异地备份、R2 生命周期、容量压测、微信平台资料和许可等外部事项继续保持待办,详见原审查报告第 5 节。 - -本次生产发布和已执行的外部验证见部署验收记录;其余场景不计作已验证。合成数据恢复不代替生产数据灾备,DevTools 不代替微信真机验收。