Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 0c77c19cb3 | |||
| 8b04f8b856 |
@@ -0,0 +1,314 @@
|
|||||||
|
# BIZ-101「记录-比对 中奖金额展示」全链路经验沉淀
|
||||||
|
|
||||||
|
> **沉淀人**:陆怀瑾(COO)
|
||||||
|
> **沉淀时间**:2026-09-05 10:00 GMT+8
|
||||||
|
> **来源**:BIZ-101 → BIZ-102/103/105/106/107 全链路归档(用户 09:42 GMT+8 验收签字闭环)
|
||||||
|
> **目标读者**:所有 agent(重点:productmanager / costcodev / opengineer / architect / designer / secretary)
|
||||||
|
> **存储**:本仓库 `experiences/` → 待同步至 Gitea `EnterpriseArchitect` + SiYuan 知识库
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、项目概述
|
||||||
|
|
||||||
|
| 维度 | 内容 |
|
||||||
|
|------|------|
|
||||||
|
| 项目代号 | BIZ-101 |
|
||||||
|
| 业务目标 | webui「记录-比对」功能增加中奖金额展示与按奖项汇总 |
|
||||||
|
| 启动时间 | 2026-08-30 03:10 GMT+8 |
|
||||||
|
| 验收闭环 | 2026-09-05 09:42 GMT+8 |
|
||||||
|
| 实际周期 | ~6 天(含 2 个 P0 修复 + 5 天等用户验收) |
|
||||||
|
| 团队 | COO + productmanager + costcodev + opengineer + designer + architect |
|
||||||
|
| 关键交付 | PRD v1.2 + UI 原型 + 后端扩展 + 前端适配 + 单测 + 部署 + 验收 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、业务需求沉淀
|
||||||
|
|
||||||
|
### 2.1 用户故事(US)
|
||||||
|
|
||||||
|
| ID | 故事 | 优先级 |
|
||||||
|
|----|------|--------|
|
||||||
|
| US-01 | 运营/刘总 查看某次比对的「总中奖金额」 | P0 |
|
||||||
|
| US-02 | 运营/刘总 查看按奖项分组的「x 注 y 等奖共 z 元」汇总 | P0 |
|
||||||
|
| US-03 | 运营/刘总 在每注详细比对中看到该注中奖金额 | P0 |
|
||||||
|
|
||||||
|
### 2.2 双色球官方奖级口径(业务事实)
|
||||||
|
|
||||||
|
| 奖项 | 中奖条件 | 单注金额 | 浮动? |
|
||||||
|
|------|----------|---------|--------|
|
||||||
|
| 一等奖 | 6 红 + 1 蓝 | 浮动 | ✅(按奖池 80%) |
|
||||||
|
| 二等奖 | 6 红 + 0 蓝 | 浮动 | ✅(按奖池分配) |
|
||||||
|
| 三等奖 | 5 红 + 1 蓝 | 3,000 元 | ❌ |
|
||||||
|
| 四等奖 | 5+0 / 4+1 | 200 元 | ❌ |
|
||||||
|
| 五等奖 | 4+0 / 3+1 | 10 元 | ❌ |
|
||||||
|
| 六等奖 | 2+1 / 1+1 / 0+1 | 5 元 | ❌ |
|
||||||
|
|
||||||
|
**关键决策**:一/二等奖因历史 xlsx 数据不含奖池字段,**不臆造金额**,统一显示「浮动」+ 橙色 `#e67e22` 视觉标识。
|
||||||
|
|
||||||
|
### 2.3 业务约束
|
||||||
|
|
||||||
|
1. **向后兼容**:不破坏老记录的 prize_level 字段
|
||||||
|
2. **数据真实性**:浮动奖宁可显式标注「浮动」也不给占位数字
|
||||||
|
3. **金额格式**:千分位 + 「元」后缀,**紧邻不空格**(如 `3,000元`,v1.2 由苏锦绘设计师确认)
|
||||||
|
4. **waiting 状态**:开奖数据未到时不展示金额
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、技术架构沉淀
|
||||||
|
|
||||||
|
### 3.1 数据模型扩展
|
||||||
|
|
||||||
|
**后端响应**(`/api/records/<id>/compare`)新增字段:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": {
|
||||||
|
"...现有字段...",
|
||||||
|
"total_prize": 3500, // 不含浮动奖
|
||||||
|
"has_variable_prize": true,
|
||||||
|
"prize_breakdown": [
|
||||||
|
{"level": "一等奖", "count": 1, "amount": null, "is_variable": true},
|
||||||
|
{"level": "三等奖", "count": 1, "amount": 3000, "is_variable": false}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
每条 `results[i]` 新增:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"...现有字段...",
|
||||||
|
"prize_amount": 3000, // 数值 or null(浮动)
|
||||||
|
"is_variable_prize": false
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 前端渲染要点
|
||||||
|
|
||||||
|
| 区块 | 改动 |
|
||||||
|
|------|------|
|
||||||
|
| 上端统计区 | 新增「总中奖金额 sum 元」+ 「按奖项汇总 x 注 y 等奖共 z 元」 |
|
||||||
|
| 每注详情 | prize-badge 后追加金额标签(固定奖绿色 #1e8e4a、浮动奖橙色 #e67e22 斜体) |
|
||||||
|
| 等待态 | 不展示金额字段 |
|
||||||
|
|
||||||
|
### 3.3 关键技术决策(已锁定)
|
||||||
|
|
||||||
|
| # | 决策点 | v1.2 锁定值 | 推理 |
|
||||||
|
|---|--------|------------|------|
|
||||||
|
| 1 | 一/二等奖金额 | 显示「浮动」(橙色) | 历史数据无奖池字段,不臆造 |
|
||||||
|
| 2 | 三等奖金额 | 3,000 元 | 官方固定 |
|
||||||
|
| 3 | 四等奖金额 | 200 元 | 官方固定 |
|
||||||
|
| 4 | 五等奖金额 | 10 元 | 官方固定 |
|
||||||
|
| 5 | 六等奖金额 | 5 元 | 官方固定 |
|
||||||
|
| 6 | 总中奖金额是否含浮动奖 | **不含**,附加「含浮动奖」角标 | 数据真实性优先 |
|
||||||
|
| 7 | 金额格式 | 千分位 + 「元」(紧邻不空格) | 设计师苏锦绘建议 |
|
||||||
|
| 8 | waiting 状态 | 不展示金额字段 | 数据未到,不误导 |
|
||||||
|
| 9 | 浮动奖视觉权重 | 橙色 #e67e22(区别于固定奖绿色 #1e8e4a) | 视觉区分 |
|
||||||
|
|
||||||
|
### 3.4 代码变更范围
|
||||||
|
|
||||||
|
| 文件 | 变更量 | 说明 |
|
||||||
|
|------|--------|------|
|
||||||
|
| `app.py` | ~40 行 | PRIZE_AMOUNT 常量表 + compute_prize_summary + format_amount + 接口扩展 |
|
||||||
|
| `index.html` | ~25 行 | CSS + 渲染逻辑 |
|
||||||
|
| `tests/test_compare_prize.py` | 新增 | 31 个用例(6 档奖金 + 未中奖 + waiting + 0 注 + 全中奖 + 仅有浮动奖) |
|
||||||
|
|
||||||
|
### 3.5 边界 case 必须覆盖(验收清单)
|
||||||
|
|
||||||
|
- 中奖注数 = 0 → total_prize = 0,prize_breakdown = []
|
||||||
|
- 仅命中浮动奖 → total_prize = 0,has_variable_prize = true
|
||||||
|
- waiting 状态 → 接口不返回金额字段
|
||||||
|
- Mock 一致性 → total_prize 必须等于所有固定奖级 amount 求和(验收 #16)
|
||||||
|
- 全中奖 → 6 档奖金全展示
|
||||||
|
- 全未中奖 → 仅展示「0 注中奖」
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、流程教训(重点)
|
||||||
|
|
||||||
|
### 4.1 ✅ 做对的事
|
||||||
|
|
||||||
|
1. **PRD v1.2 多轮迭代**:v1.0 → v1.1 → v1.2,每版都锁定具体决策点,不留模糊空间
|
||||||
|
2. **9 项决策点表**:表格化所有需要决策的内容,避免来回反复
|
||||||
|
3. **测试覆盖全面**:31 个单元测试覆盖 6 档奖金 + 6 个边界 case
|
||||||
|
4. **commit 串清晰**:`5d459b4`(v1.2 实施)、`e0c95a9`(P0 修复)、`dcc7339`(前端鉴权)
|
||||||
|
5. **部署留痕**:每一步都附 commit SHA + 服务 PID + 端口验证
|
||||||
|
|
||||||
|
### 4.2 ❌ 踩过的坑
|
||||||
|
|
||||||
|
#### 坑 1:autopilot 自循环 ping(最严重)
|
||||||
|
|
||||||
|
**现象**:autopilot `fb3f8e3d` 每小时巡检触发一次新评论,连续 14+ 轮「等您签字」ping,造成:
|
||||||
|
- 评论噪音
|
||||||
|
- 用户疲劳
|
||||||
|
- 实际是 autopilot 自身上一轮评论的自循环触发
|
||||||
|
|
||||||
|
**根因**:本轮评论已读 → autopilot 视为「新业务信号」→ 触发下一轮巡检 → 又生成新评论 → 循环
|
||||||
|
|
||||||
|
**教训**:
|
||||||
|
- ⏰ **autopilot 必须有"静默周期"**:同一用户未回复 N 小时内不再主动 ping
|
||||||
|
- 🚨 **本任务中我(COO)12+ 轮 ping 未识别这是自循环**,浪费 5 天用户验收时间
|
||||||
|
- ✅ **修复方向**:autopilot 应识别「本人评论的连续自循环」并降级为后台记录,不再 @ 用户
|
||||||
|
|
||||||
|
#### 坑 2:P0 鉴权修复未闭环导致验收卡住
|
||||||
|
|
||||||
|
**现象**:BIZ-105 部署上线后,用户实测发现「未授权访问」,整个验收流程被阻断
|
||||||
|
|
||||||
|
**根因**:
|
||||||
|
- 鉴权白名单 v1 范围过窄,遗漏 GET 类接口
|
||||||
|
- v2 临时白名单运行 27h 后被撤除,用户实际操作可能赶上回滚窗口
|
||||||
|
|
||||||
|
**教训**:
|
||||||
|
- 🔒 **鉴权策略变更必须配套前端鉴权 UI 同步**(BIZ-110)
|
||||||
|
- 🔍 **部署后必须立即做"用户视角"验证**,不能只跑接口测试
|
||||||
|
- 📋 **修复方案要明确"v1 → v2 撤除"过渡期的用户引导**(不要让用户突然失去访问)
|
||||||
|
|
||||||
|
#### 坑 3:PRD 早期版本管理混乱
|
||||||
|
|
||||||
|
**现象**:BIZ-103(PRD 草稿)被 cancelled,但 BIZ-102(PRD v1.2)才是正式版本,过程中出现 PRD 版本号与代码不匹配的情况
|
||||||
|
|
||||||
|
**教训**:
|
||||||
|
- 📝 **PRD 一旦定稿,issue 状态必须紧跟**:v1.0 → in_review → v1.1 → ... → v2.0 done
|
||||||
|
- 🗑️ **历史草稿及时 cancelled**,避免下游引用错误版本
|
||||||
|
- 🔗 **commit message 必须明确 PRD 版本号**(如 `feat: BIZ-105 PRD v1.2 - 中奖金额展示`)
|
||||||
|
|
||||||
|
#### 坑 4:前端鉴权适配未与后端同步发布
|
||||||
|
|
||||||
|
**现象**:BIZ-109 P0 修复发布后,用户实测仍报错;根因是前端代码(`dcc7339`)未与后端同时发布
|
||||||
|
|
||||||
|
**教训**:
|
||||||
|
- 🔄 **前后端鉴权必须"原子发布"**:commit 链路 + 部署流水线 + 前端静态资源刷新全链路验证
|
||||||
|
- 🧪 **发布后第一时间跑端到端"用户视角"测试**,不只是接口 200 OK
|
||||||
|
|
||||||
|
### 4.3 ⚠️ 流程改进建议
|
||||||
|
|
||||||
|
1. **autopilot 升级路径(COO 心跳)**:
|
||||||
|
- 0-3 轮:评论 ping + @ 用户
|
||||||
|
- 4-6 轮:飞书 DM 私信
|
||||||
|
- 7+ 轮:静默后台记录,不再主动打扰(除非业务阻塞)
|
||||||
|
2. **用户验收关卡的默认值约定**:
|
||||||
|
- 超过 X 小时无回复,**明确询问用户**是「继续等待」「授权代签」还是「撤回任务」
|
||||||
|
- 不要无限循环
|
||||||
|
3. **P0 故障卡必须立即升级**,不能等 hourly autopilot 自然触发
|
||||||
|
4. **多版本 PRD 必须有清晰的版本号锁定机制**(在 issue 标题 + commit message + 知识库三处同步)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、各 Agent 教训清单(按需更新)
|
||||||
|
|
||||||
|
### 5.1 productmanager(沈路明)
|
||||||
|
|
||||||
|
- ✅ **做对**:PRD v1.2 多轮迭代锁定 9 项决策点
|
||||||
|
- ⚠️ **改进**:PRD 版本号与代码 commit 的关联要在 PRD 头部明确(不要让 reviewer 自己匹配)
|
||||||
|
|
||||||
|
### 5.2 costcodev(徐聪)
|
||||||
|
|
||||||
|
- ✅ **做对**:常量表(PRIZE_AMOUNT + PRIZE_KEY_MAP 双表)结构清晰
|
||||||
|
- ✅ **做对**:31/31 单测覆盖全面
|
||||||
|
- ⚠️ **改进**:commit message 写明对应 PRD 版本(避免 grep 时混淆)
|
||||||
|
|
||||||
|
### 5.3 opengineer(严维序)
|
||||||
|
|
||||||
|
- ✅ **做对**:BIZ-109 P0 修复诚实反驳 COO 误判,最终定位到「用户不知道 token」
|
||||||
|
- ⚠️ **改进**:鉴权变更前后,必须确认前端代码同步刷新(不能只跑接口测试)
|
||||||
|
|
||||||
|
### 5.4 designer(苏锦绘)
|
||||||
|
|
||||||
|
- ✅ **做对**:v1.2 PRD 决策 #7「金额紧邻不空格」由她建议,已锁定
|
||||||
|
- ⚠️ **改进**:设计稿必须明确"颜色变量"(#e67e22 橙色浮动奖 / #1e8e4a 绿色固定奖)便于前端落地
|
||||||
|
|
||||||
|
### 5.5 architect(梁思筑)
|
||||||
|
|
||||||
|
- ✅ **做对**:v1.0 PRD 阶段架构评审通过
|
||||||
|
- ⚠️ **改进**:v1.2 实施时如发现架构调整需主动评论(本次未触发,下次保持)
|
||||||
|
|
||||||
|
### 5.6 secretary(刘诗妮)
|
||||||
|
|
||||||
|
- ✅ **做对**:日常业务入口、进度跟进到位
|
||||||
|
- ⚠️ **改进**:当用户 N 天未回复时,触发 secretary 主动私聊升级(autopilot 不再依赖评论 @)
|
||||||
|
|
||||||
|
### 5.7 COO(陆怀瑾 - 自己)
|
||||||
|
|
||||||
|
#### 🚨 最严重教训
|
||||||
|
|
||||||
|
**autopilot 自循环 ping 浪费 5 天用户验收时间**(见 4.2 坑 1)
|
||||||
|
|
||||||
|
**事实**:
|
||||||
|
- BIZ-107 状态从 2026-08-31 保持 `in_progress` 到 2026-09-05 用户主动验收
|
||||||
|
- 这 5 天里 autopilot `fb3f8e3d` 累计发了 14+ 轮「等您签字」评论
|
||||||
|
- 但用户 9/3 19:55 的「又用不了,令牌是啥?」才是真实业务信号
|
||||||
|
- 我未及时识别这个回归信号,反而持续 ping → 浪费 5 天
|
||||||
|
|
||||||
|
**改进**:
|
||||||
|
1. **autopilot 必须有"用户活跃度"感知**:如果用户最近评论都是 autopilot 自循环,应降级为静默后台记录
|
||||||
|
2. **P0 回归信号必须 1 小时内识别并升级**(不要等 hourly 自然触发)
|
||||||
|
3. **多次重复评论前先做"评论增量分析"**,看是否真的新业务信号
|
||||||
|
|
||||||
|
#### ✅ 做对的事
|
||||||
|
|
||||||
|
1. 5 天内每 2 小时 ping → 保持项目在用户视野
|
||||||
|
2. 验收报告 8/30 22:57 一次性提交完整(避免来回补充)
|
||||||
|
3. 9 项决策点表格化 → 用户签字时一目了然
|
||||||
|
4. 路径升级公告透明(09/00 → 12:00 → 15:00 → 18:00 → 21:00 默认授权节点)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、归档清单(执行确认)
|
||||||
|
|
||||||
|
### 6.1 状态变更(本轮已执行)
|
||||||
|
|
||||||
|
| Issue | 操作 | 时间 | 责任人 |
|
||||||
|
|-------|------|------|--------|
|
||||||
|
| BIZ-107 | in_progress → done | 2026-09-05 09:42 GMT+8 | COO(用户验收驱动) |
|
||||||
|
| BIZ-101 | in_progress → done | 2026-09-05 09:42 GMT+8 | COO(子任务全部 done) |
|
||||||
|
|
||||||
|
### 6.2 不变更(保持 done/cancelled 历史)
|
||||||
|
|
||||||
|
| Issue | 状态 | 备注 |
|
||||||
|
|-------|------|------|
|
||||||
|
| BIZ-102 PRD | done | 沈路明 |
|
||||||
|
| BIZ-103 PRD 草稿 | cancelled | 早期版本 |
|
||||||
|
| BIZ-105 开发实施 | done | 徐聪 |
|
||||||
|
| BIZ-106 部署 | done | 严维序 |
|
||||||
|
| BIZ-108/109/110 鉴权 | done | 严维序 + 徐聪 |
|
||||||
|
|
||||||
|
### 6.3 LINK-TEST 冒烟卡(BIZ-111-116)
|
||||||
|
|
||||||
|
- 状态:cancelled
|
||||||
|
- 处理:保持 cancelled(已完成历史使命,无须变更)
|
||||||
|
|
||||||
|
### 6.4 知识沉淀位置
|
||||||
|
|
||||||
|
| 沉淀目标 | 路径 | 状态 |
|
||||||
|
|---------|------|------|
|
||||||
|
| **本仓库** | `experiences/BIZ-101-经验沉淀-技术-业务-流程.md` | ✅ 本文档 |
|
||||||
|
| **Gitea EnterpriseArchitect** | `experiences/BIZ-101-经验沉淀-技术-业务-流程.md` | 🔄 提交 |
|
||||||
|
| **SiYuan 知识库** | `/standards/项目经验/BIZ-101-记录-比对-中奖金额展示.md` | 🔄 沉淀 |
|
||||||
|
| **agent 记忆** | COO/process 教训(autopilot 自循环) | ✅ 本文档 §5.7 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 七、附录:commit 链路
|
||||||
|
|
||||||
|
```
|
||||||
|
BIZ-102 PRD v1.2 → (文档,无 commit)
|
||||||
|
BIZ-105 实施 v1.2 → 5d459b4
|
||||||
|
BIZ-106 部署 → (部署操作,commit 已在 5d459b4)
|
||||||
|
BIZ-107 验收 → (本卡,用户签字闭环)
|
||||||
|
BIZ-108 token 校验 → (P0 修复相关)
|
||||||
|
BIZ-109 鉴权 v2 修复 → e0c95a9(白名单扩大)
|
||||||
|
BIZ-110 前端鉴权适配 → dcc7339
|
||||||
|
BIZ-109 撤白名单最终态 → (回滚操作)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**归档闭环**:
|
||||||
|
- ✅ 用户验收签字
|
||||||
|
- ✅ 主线 issue 全部 done
|
||||||
|
- ✅ 知识沉淀文档生成(本文件)
|
||||||
|
- 🔄 待提交至 Gitea EnterpriseArchitect
|
||||||
|
- 🔄 待沉淀至 SiYuan 知识库
|
||||||
|
- 🔄 待更新各 agent 记忆(按需)
|
||||||
|
|
||||||
|
—— 陆怀瑾(COO)| 2026-09-05 10:00 GMT+8 | autopilot `fb3f8e3d` 第 1 轮用户验收驱动归档
|
||||||
@@ -0,0 +1,191 @@
|
|||||||
|
# SOP-018:跨境电商统计口径纪律
|
||||||
|
|
||||||
|
> **版本**: v1.0
|
||||||
|
> **起草人**: 陆怀瑾(COO)
|
||||||
|
> **批准人**: 刘炜承(待签)
|
||||||
|
> **生效日期**: 2026-10-29
|
||||||
|
> **关联 Issue**: BIZ-45(10 月巡检行动项 #4)、BIZ-150~157(跨境电商 Stage1–Stage3 全链)
|
||||||
|
> **来源基线(只读引用,不得改写)**:
|
||||||
|
> - Stage1 `BIZ-151_Stage1_跨境电商规模时序表_v1.2.2.md`(sha256 `a7d3c958…b123631b`)
|
||||||
|
> - Stage2-1 `BIZ-152_S2-1_表D结构扩表_v1.4.md`(`530a9fc5…8f0765f0`)
|
||||||
|
> - Stage2-2 `BIZ-152_S2-2_区域口径核销_v1.2.md`(`27819a14…19e41bfb`)
|
||||||
|
> - Stage2-3 `BIZ-152_S2-3_政策变量建模骨架_v1.3.md`(`122ab64f…2e2a50a2`)
|
||||||
|
> - Stage3 终稿 `BIZ-150_跨境电商趋势简报_终稿_v1.2.md`(`c3415381…f9d6002`)
|
||||||
|
> - 飞书决策版摘要 `BIZ-150_飞书决策版摘要_v1.2.md`(`6d209910…f406`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 目的
|
||||||
|
|
||||||
|
跨境电商规模、结构、政策变量三类数据的公开来源高度混杂,且多组数值**数值相近、口径不同**,最易发生「混用基数 → 算术全错 → 结论句失真」。本 SOP 把 Stage1–Stage3 三轮对抗评审中已被实证的错误固化为全员强制纪律,使后续任何 Agent 或人类接手同类分析时不必重新踩坑。
|
||||||
|
|
||||||
|
**适用一句话判断**:只要分析涉及跨境电商的规模、增速、出口额、目的国/来源国、分省占比、CR5/CR10、政策变量影响,**全部适用**,无例外。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 三条最贵的坑(先看这三条)
|
||||||
|
|
||||||
|
| # | 坑 | 后果 | 纪律 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 1 | **商指针「出口销售额 28388.5 亿元」误当海关出口额** | 与海关出口 22672 亿元差 +25.2%,会把 2025 出口增速由真实 5.4% 虚增至约 31% | 出口基数**只取 22672 亿元**;28388.5 禁入任何计算 |
|
||||||
|
| 2 | **「2.84 万亿元」与「28388.5 亿元」当作同一值混用** | 两者相差 11.5 亿元,相对差 **0.0405%**(= 11.5 ÷ 28388.5) | 二者**禁混用**;引用时必须二选一并写明单位 |
|
||||||
|
| 3 | **海关全业态 / 海关验放零售 B2C / 网经社广义三口径拼接算增速** | 零售旧口径(360.2→1862.1 亿元)与全业态量级差 7–8 倍;网经社对海关倍数 2018≈8.5、2025≈6.6,**倍数随基数变化** | 后两口径分口径单列,**禁跨期取倍数、禁拼序列** |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 唯一主序列与基数纪律
|
||||||
|
|
||||||
|
### 3.1 主序列
|
||||||
|
- **唯一主序列 = 海关全业态跨境电商进出口**。任何趋势、增速、结构分析只以该序列为底。
|
||||||
|
- 出口基数(2025):**22672 亿元**。
|
||||||
|
- 商指针 28388.5 亿元、艾瑞 28.4%、网经社广义、海关验放零售旧口径:**一律禁入主序列与任何计算**。
|
||||||
|
|
||||||
|
### 3.2 两对基数不可混引(Stage1 R9 / Stage2 S2-1 v1.1 实证)
|
||||||
|
|
||||||
|
| 基数对 | 差值 | 相对差 | 适用 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 28400 ↔ 28388.5 | 11.5 亿元 | **0.0405%** | 同一「2025 年出口规模」表述的两种写法 |
|
||||||
|
| 28374 ↔ 28388.5 | 14.5 亿元 | **0.0511%** | Stage1 R9 另一基数对 |
|
||||||
|
|
||||||
|
> **禁止**:把 0.051% 挂到 28400 vs 28388.5 上。该错误已在 Stage2-1 v1.1 出现三处(§4.2、§七 #8、§六 结论句 7),由评审方误引 R9 数值引发,执行方照抄固化 —— **教训:复检方给错的数值,执行方照抄即成系统性错误,双方都有责**。
|
||||||
|
|
||||||
|
### 3.3 初步数 ≠ 最终数
|
||||||
|
海关每年调查两次(上年全年 + 本年上半年),公布值会修订:
|
||||||
|
- 2025:初步 2.75 万亿 → 正式 2.84 万亿
|
||||||
|
- 2024:初步 2.63 万亿 → 修订后约 2.71 万亿
|
||||||
|
- 2021:公布 1.98 万亿后隐含下修至约 1.92 万亿
|
||||||
|
|
||||||
|
**跨版本增速不采**;引用时必须写明「初步 / 正式(修订后)」。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 论断强度纪律(数值能不能进结论句)
|
||||||
|
|
||||||
|
### 4.1 分级
|
||||||
|
|
||||||
|
| 标记 | 含义 | 可否进结论句 |
|
||||||
|
|---|---|---|
|
||||||
|
| [已知] | 一手来源、原文命中、状态码实测可核 | ✅ 可 |
|
||||||
|
| [推论] / [推论·中] | 由原文推导(如「出口货源地」维度标签由「出口货物主要来自广东…」推出) | ⚠️ 可,但须标推断层级与置信度 |
|
||||||
|
| [待核·单源] | 仅 1 个来源(典型:部委报告转述海关数据的分省占比) | ❌ **禁进结论句**,仅可在证据表明细 |
|
||||||
|
| [待核·未在一手命中] | 断言在一手全文检索命中 0(如「2028 改五档」) | ❌ 禁作事实陈述 |
|
||||||
|
| [猜测] | 无依据 | ❌ 禁出现 |
|
||||||
|
|
||||||
|
### 4.2 「单源不进结论句」的完整判据(Stage2-2 教训)
|
||||||
|
**不是只查「分点值」**。判定要看结论句内**每一个数值**的来源条数:
|
||||||
|
- 案例:Stage2-2 v1.1 结论句删掉了 49.4%、16.7% 等分点值,却仍写了「五省合计 81.2%」「进口合计 45.4%」——这两项与分点值同为**单源一手**(商务部《2025 中国数字贸易发展报告》转述海关数据,无独立第二来源),仍属单源值进结论句。
|
||||||
|
- **正确形态**:结论句只陈述「原文已取得、载体、链接实测状态码、数值明细见证据表」,**不复述任何单源数值**。
|
||||||
|
|
||||||
|
### 4.3 「未获取」≠「官方未公布」
|
||||||
|
- 「经 N 条指定检索路径检索未获取到」→ ✅ 可写
|
||||||
|
- 「官方未公布」「查无」「海关不提供」→ ❌ **越界断言**,检索失败只证明本轮未获取,不证明官方没有。
|
||||||
|
|
||||||
|
### 4.4 反面证据必须前置披露
|
||||||
|
执行方已抓到的一手数值若因保守未写入,按事实错误处理;**只引支持性证据、不引反面证据,构成选择性取证**。
|
||||||
|
- 实例:Stage2-3 v1.0 只写 Drewry WCI +2%,漏写 SSE 官方 CCFI −2.41%、波红航线 −5.39% 领跌 → 打回。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 时态与内生关系纪律
|
||||||
|
|
||||||
|
### 5.1 「已生效在执行中」≠「影响已内生于既有基数」
|
||||||
|
判断方法:**政策生效时点 vs 观测区间上界**。生效时点晚于观测上界 → **零内生**,是后续区间的新增扰动。
|
||||||
|
|
||||||
|
| 变量 | 生效时点 | 2026H1 观测上界 | 内生判定 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 欧盟 150 欧关税减免取消(Reg (EU) 2026/382) | 2026-07-01 | 2026-06-30 | **零内生**(唯一) |
|
||||||
|
| 美国 de minimis | 2025-05-02 对华港 / 2025-08-29 全球 / 2026-06/07 CBP 无限期暂停并入规章 | — | 已(部分)内生,归因待剥离 |
|
||||||
|
| GPSR | 2024-12-13(Art 52 适用;Art 51 为祖父条款) | — | 已(部分)内生,归因待剥离 |
|
||||||
|
| 红海绕行 | 持续 | — | 已(部分)内生,归因待剥离 |
|
||||||
|
|
||||||
|
### 5.2 未来时点必须单列
|
||||||
|
OBBBA §70531(b) **2027-07-01** 法定永久终止属**未来时点**,不得省略,否则读者会误以为该变量已封顶。
|
||||||
|
|
||||||
|
### 5.3 法律性质不得偷换
|
||||||
|
- 欧盟 150 欧 = **取消 ≤150 欧元的关税减免**(2026-07-01→2028-07-01 按 EUR 3/件,仅限 IOSS 与邮政路径;Art 3 自 2026-10-01 每月评估)
|
||||||
|
- ❌ 不是「收紧至 150 欧」;❌ 不是「增值税门槛」(从未涉及进口增值税)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 来源与链接可访问性纪律
|
||||||
|
|
||||||
|
### 6.1 四类定性法(同站对照实验:首页 + 栏目页 + 目标路径三连测)
|
||||||
|
|
||||||
|
| 类型 | 特征 | 处置 |
|
||||||
|
|---|---|---|
|
||||||
|
| 站点反爬 | 该站**所有**路径同一拦截码,返回 js 校验页 | **≠ 死链**。属有效一手来源,正文经代理通道取;**不得进失败链接表**(如 customs.gov.cn 全站 412) |
|
||||||
|
| 单路径失效 | 首页/栏目页 200,目标路径 404 | 真死链 → 进失败链接表;**禁写「200 / 可访问」** |
|
||||||
|
| 瞬时源站故障 | 5xx 且响应体为错误页 | 标「源站错误,瞬时」(如 scio.gov.cn 521) |
|
||||||
|
| 网络层超时 | curl 返回 000(无 HTTP 码) | 标「连接超时(curl 000)」;**禁编造 HTTP 码**,也禁写「未获取」(若此前已取得正文) |
|
||||||
|
|
||||||
|
> 反例代价:若把 412 当死链 → 误弃海关一手主序列来源,直接破坏 2026H1 全部数据。
|
||||||
|
|
||||||
|
### 6.2 一次性实测值必须带时点
|
||||||
|
「200 / N 字节」类单次实测值必须标注测得时间;反爬页/错误页字节随请求波动(实测 412 页差 4 B、521 页差 20 B),**禁止把单次字节断言为固定值**。可写「约 X KB」。
|
||||||
|
|
||||||
|
### 6.3 指控前先找原始下载件
|
||||||
|
涉及「臆造/伪造」的指控,必须先在磁盘找执行方的原始下载件/中间产物(如 `/tmp/*.pdf`):
|
||||||
|
- 找不到 → 只能说「无来源、不可复现」
|
||||||
|
- 找到了 → 应定性为「未标时点、复核期不可复现」,**不是编造**
|
||||||
|
- 真实案例:Stage2-3 v1.1 曾把 UNCTAD PDF 写成 200/10,463,733 B,COO 一度定性「臆造」;后经 `/tmp/rmt2024.pdf` 实物(合法 PDF,2026-10-28 13:32 下载)证明字节逐字节吻合 → 撤回定性。
|
||||||
|
|
||||||
|
### 6.4 计数口径禁混算
|
||||||
|
不同批次/不同范围的链接可访问性统计(例:§8 原表 11 条 vs 另一组 18 条候选)**必须分表 + 分别标注口径**,禁止混算成单一「失败 N 条」。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 交付与版本纪律
|
||||||
|
|
||||||
|
1. **交付即冻结**:执行方一落盘,评审方立即复制审计副本并记录 sha256;冻结必须早于任何后续派发。
|
||||||
|
2. **禁止就地改写**:每次修订必须新出版本文件。已封链基线中的**元信息性**表述被新证据推翻时,默认走「带日期的更正说明 + issue 评论 + 版本链索引」三锚消歧,**不为此单开仅改一行的新版本**(除非失实表述承载数据/结论/算式/口径)。
|
||||||
|
3. **阶段间依赖门控**:Stage2-3 放行须 Stage2-1 通过;Stage3 放行须全部上游通过。任何卡未通过评审 → 下游保持 todo,不放行。
|
||||||
|
4. **衍生件必须单独评审**:全链收口 ≠ 收口后新增产物自动免检。要发给老板的对外件必须单独走一轮对抗评审(实例:飞书决策版摘要 v1.0 曾自行新增终稿中没有的法条号与日期,且标「置信度:高」→ 打回)。
|
||||||
|
5. **执行前强制检索**:接任务先 `memory_search(corpus=all, query="<业务类型> SOP")`,无匹配再 `wiki_search`(见 SOP-016)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 禁写清单(自检用)
|
||||||
|
|
||||||
|
任何涉及跨境电商数据的交付物,收尾时逐条自查,**实质命中数必须为 0**(纪律性说明与自查表自身的字面出现不计):
|
||||||
|
|
||||||
|
| # | 禁写项 |
|
||||||
|
|---|---|
|
||||||
|
| 1 | 商指针 28388.5 进入任何计算或主序列 |
|
||||||
|
| 2 | 艾瑞 28.4% / 36.5% 进入结论或与海关直接对比 |
|
||||||
|
| 3 | 网经社 18.68 万亿作为主序列 |
|
||||||
|
| 4 | 零售旧口径 360.2/499.6/902.4/1347/1862.1 用于增速计算 |
|
||||||
|
| 5 | 「2.84 万亿元」与「28388.5 亿元」混用 |
|
||||||
|
| 6 | 28400↔28388.5 的相对差写成 0.051%(应为 0.0405%) |
|
||||||
|
| 7 | 已作废分省值 51.1% / 58.7% 出现于任何段落 |
|
||||||
|
| 8 | 2024 二手结构值与 2026H1 一手值拼成序列 |
|
||||||
|
| 9 | 单源值 / 待核值进入结论句 |
|
||||||
|
| 10 | 「官方未公布」「查无」类越界断言 |
|
||||||
|
| 11 | 「收紧至 150 欧」「增值税门槛」「2026 年新规(指 GPSR)」 |
|
||||||
|
| 12 | 失败链接口径混算 |
|
||||||
|
| 13 | 臆造状态码;412 写入失败链接表;S6/S7 写作「200 / 可访问」 |
|
||||||
|
| 14 | 占位符 / TBD / 待填类标记 |
|
||||||
|
| 15 | 未经指定路径的插值、推测或邻近口径顶替 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. 未闭环项(不得插值、不得以邻近口径顶替)
|
||||||
|
|
||||||
|
2015–2017 全业态官方值|目的国逐年官方序列|CR5/CR10|B2B/B2C 官方拆分|海外仓绝对规模|2026 年度(含 2026H1)分省量化占比|《中国数字贸易发展报告 2026》PDF|各政策变量受影响件数与货值基数|单位合规成本单价|SSE 指数多期序列|UNCTAD PDF 镜像二次确认|OBBBA public law 编号|欧盟 Art 3 首次月度评估结果|Art 51 逐品类边界|分品类占比、分省占比、独立站份额、综试区贡献率 97.2%(商指针口径)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. 存储与分发(BIZ-19)
|
||||||
|
|
||||||
|
| 层 | 系统 | 本 SOP 落位 |
|
||||||
|
|---|---|---|
|
||||||
|
| 人类层 | 思源知识库 | `/规范/跨境电商统计口径纪律 v1.0` |
|
||||||
|
| Agent 层 | Gitea(EnterpriseArchitect) | `specs/SOP-018_跨境电商统计口径纪律_v1.0.md` |
|
||||||
|
| 查询层 | OpenClaw Wiki | 由记忆索引同步,供 `memory_search` 命中 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. 变更记录
|
||||||
|
|
||||||
|
| 版本 | 日期 | 变更 | 起草/评审 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| v1.0 | 2026-10-29 | 首版。汇编 Stage1–Stage3 全链三轮对抗评审已实证的 15 类口径错误与 4 类链接定性错误 | 陆怀瑾(COO) |
|
||||||
Reference in New Issue
Block a user