归档

openspec/changes/add-export-time-filter-standards/design.md

@@ -13,7 +13,7 @@
 ### 导出任务快照
 
 - 创建临期、佣金明细、达量预警导出时，先复用页面 Query 构造器解析全部筛选和时间边界，再保存规范化过滤器、操作者 ID、创建时可见店铺/资产范围、时区、创建时间和口径版本。Worker 只读取该快照，不重新从请求、当前角色或当前页面解析筛选。
-- 临期导出以资产为粒度，选择当前有效主套餐最终到期时间和剩余天数；加油包不单独生成行。佣金导出以钱包变动明细为粒度，保存每次变动提交后的实际余额，允许回溯负数。预警导出以预警记录为粒度，套餐/流量/阈值/到期字段读触发快照，店铺/业务员/用户组可按执行时当前归属补全，但必须同时落在创建时冻结范围。
+- 临期导出以资产为粒度，选择当前有效主套餐最终到期时间和剩余天数；加油包不单独生成行。佣金明细导出的粒度与列定义由 `add-commission-clawback-records` 确定（佣金记录粒度，原佣金与回溯记录各一行，入账后/回溯后余额可为负）；本 Change 只负责统一 `start_time`/`end_time` 参数、闭区间语义与筛选、权限快照冻结，不改变既有导出粒度与列定义。预警导出以预警记录为粒度，套餐/流量/阈值/到期字段读触发快照，店铺/业务员/用户组可按执行时当前归属补全，但必须同时落在创建时冻结范围。
 - 导出完成记录结果文件、行数、完成时间和失败安全摘要；任何权限变化、筛选条件变化或后台归属变化不得扩大已创建任务的数据集。失败重试继续使用原快照，不创建第二份不同口径文件。
 
 ## Migration Plan

openspec/changes/add-export-time-filter-standards/proposal.md

@@ -8,7 +8,7 @@
 
 ## What Changes
 
-- 统一日期/时间解析、左闭右开区间和最大范围校验。
+- 统一日期/时间解析、闭区间（`start_time <= t <= end_time`，参数为带时区 RFC3339 秒级时间，任一端可省略）和最大范围校验。
 - 导出冻结列表筛选、时区和数据范围。
 
 ## Capabilities

openspec/changes/add-export-time-filter-standards/specs/export-time-filter/spec.md

@@ -8,7 +8,7 @@
 - **THEN** 系统仅返回权威时间大于等于开始时间且小于等于结束时间的记录
 
 ### Requirement: 三类异步导出及冻结口径
-临期列表、佣金明细和套餐流量达量预警 SHALL 复用既有异步导出任务，并在创建时冻结全部页面筛选条件、操作者和可见店铺范围。临期导出一行对应一项资产，仅取当前生效主套餐最终到期时间和剩余天数，加油包不得单独成行。预警导出一行对应一条预警记录，套餐、用量、总量、阈值和到期时间使用触发快照，店铺、业务员和用户组在执行时按当前归属补充。佣金明细必须导出每次佣金钱包变动后的实际余额，回溯记录可为负数。
+临期列表、佣金明细和套餐流量达量预警 SHALL 复用既有异步导出任务，并在创建时冻结全部页面筛选条件、操作者和可见店铺范围。临期导出一行对应一项资产，仅取当前生效主套餐最终到期时间和剩余天数，加油包不得单独成行。预警导出一行对应一条预警记录，套餐、用量、总量、阈值和到期时间使用触发快照，店铺、业务员和用户组在执行时按当前归属补充。佣金明细导出的记录粒度、列定义与余额口径不属于本需求：本需求只要求其冻结创建时筛选条件、操作者与可见店铺范围，且 MUST NOT 改变既有粒度与列定义。
 
 异步执行不得重新解释时间、扩大创建时店铺范围或遗漏页面筛选；文件结果只含创建时有权读取的事实。
 

openspec/changes/add-export-time-filter-standards/tasks.md

@@ -1,8 +1,8 @@
 ## 1. 统一筛选
 - [ ] 1.1 清点本期后台导出/列表入口及现有时间字段和权限 Query。
-- [ ] 1.2 实现上海时区日期解析、左闭右开区间、最大范围校验和筛选快照。
-- [ ] 1.3 改造导出任务以冻结范围并复用列表 Query；更新 DTO/OpenAPI。
+- [ ] 1.2 实现上海时区日期解析、闭区间（`start_time <= t <= end_time`，参数为带时区 RFC3339 秒级时间，任一端可省略）、最大范围校验和筛选快照。
+- [ ] 1.3 改造导出任务以冻结范围并复用列表 Query；更新 DTO/OpenAPI。仅覆盖统一 `start_time`/`end_time` 参数、闭区间语义与筛选、权限与筛选快照冻结；不改变任何导出的记录粒度、列定义与余额口径。
 
 ## 2. 验证
-- [ ] 2.1 验证日期边界、时间格式、空范围、超限、权限变更和导出/列表一致性。
+- [ ] 2.1 验证日期边界、时间格式、空范围、超限、权限变更和导出/列表一致性，并核对佣金明细导出任务的记录粒度、列定义与余额口径未被本 Change 改变。
 - [ ] 2.2 运行 `gofmt -w`、`go build ./cmd/api ./cmd/worker`、`go run cmd/gendocs/main.go`、`openspec validate add-export-time-filter-standards --strict` 和 `openspec doctor --json`；自动化测试按项目决策为 N/A。