qiuxiang
3e202ca9bf
期初余额取所选月份开始前聚水潭京东钱包每店铺账户最后一笔余额；期末余额统一按期初加收入减支出计算，并增加余额查询索引与定向测试。 > 开工时标题使用 `WIP: <任务名称>` 并先填写“任务占用与边界”。Codex 完成独立合并前自审后补齐其余内容并移除 `WIP:`。 ## 任务占用与边界 - 任务名称： - 实际开发者： - 任务来源/团队分工： - 目标结果： - 预计修改路径： - 将写入的公共契约（路由、Controller 方法、Repository、表/视图、`source_key`、`scope`、权限名、菜单键或共享组件）： - 仅复用、明确不修改的公共契约： - 数据源、表/视图和字段： - 上游 `source_key` / `scope`： - 权限名、菜单键或共享组件： - 明确不修改的范围： ## 开工碰撞检查 - [ ] Codex 已执行 `scripts/codex-task-preflight.ps1` - [ ] 已检查最新 `main` 和所有远程任务分支 - [ ] 已搜索主线既有页面、接口、Repository 和数据查询 - [ ] 已把“将写入”和“仅复用、不修改”的公共契约分开；仅复用项不作为单独阻断条件 - [ ] 未发现实际写入重叠；或已在下方写明相关分支、具体重叠项和协调结论 相关分支、重叠项与协调结论： ## 实际改动 - 完成内容： - Codex 实际修改的文件： - 新增或变更的公共契约： - 与原计划的差异： ## 验证证据 - 正常流程： - 空数据/错误输入/无权限场景： - 受影响旧功能： - 自动测试及结果： - 实际页面、接口或只读业务查询结果： ## 风险检查 - [ ] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复 - [ ] 如涉及上述高风险内容，已在下方写明影响、回滚和所需授权 - [ ] 未提交 `.env`、密码、Token、私钥、真实财务数据、生产日志或构建产物 - [ ] 前端改动符合 `DESIGN.md`；无前端改动则写“不适用” 高风险影响、回滚和授权状态： ## 合并前复查 - [ ] 已重新拉取远程引用并用实际修改范围再次运行碰撞检查 - [ ] PR 不再是 `WIP:`，所有测试结果已经补齐 - [ ] Codex 已重新读取原始需求和验收标准，并逐文件审核 `origin/main...任务分支` 的完整 diff - [ ] Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果 - [ ] 合并顺序不会覆盖其他未合并任务 - [ ] 已授权当前任务的 Codex 执行 Squash merge、验证 `main` 并清理任务分支 - [ ] 如涉及生产迁移、数据修复、删除、覆盖配置或部署，已另行取得对应高风险授权 Reviewed-on: #901
CaiWuXiTong 文档索引
本目录按“先启动、再协作、最后按业务深入”的顺序整理。文档中的规则发生冲突时，以根目录 AGENTS.md 和负责人最新明确要求为准；历史截图、聊天记录和临时排错方案不覆盖当前规则。
新电脑与本地开发
| 文档 | 用途 |
|---|---|
| 新电脑开发接续指南 | 在另一台 Windows 电脑克隆最新代码、启动本地环境、接入团队系统数据库并创建任务分支 |
| LOCAL_DEPLOY.md | 本地 Docker、临时引导库、共享系统数据库和常见命令的完整说明 |
| AGENTS.md | Git、协作、敏感信息、数据和部署边界 |
| DESIGN.md | VIP 黑金主题、组件和页面视觉规范 |
| SECURITY.md | 安全相关的最小基线 |
凭据说明：接续指南包含仓库地址、Git 用户名、服务器地址和 SSH 操作方式；Git 密码、服务器密码等敏感值只保存在每台电脑本地的 runtime/private/新电脑开发接续私密信息.md，该目录已被 .gitignore 忽略，不在远程仓库中。
协作、构建与发布
| 文档 | 用途 |
|---|---|
| 开发与部署 SOP | 团队协作、Docker 构建缓存、服务器初始化、正式发布、镜像和回滚 |
| 团队协作说明 | 任务预检、分支、WIP PR、冲突协调和交付要求 |
生产发布只使用已经合并的最新 main，并遵守 SOP 中的授权、备份和回滚要求。服务器不构建源码，私有配置和证书不进入 Git。
上游数据、镜像与电商财务
| 文档 | 用途 |
|---|---|
| 通用上游数据接入 | 新来源发现、数据字典、固定只读查询、镜像登记和验收 |
| 上游业务镜像清单 | 当前来源、表/视图、镜像表和分阶段迁移状态 |
| 电商财务扩展开发说明 | 订单、结算、成本、资金和利润分析的业务模型与扩展边界 |
| 商品成本占位行规则清单 | 商品成本同步的取数顺序、占位行去重、价格兜底和月度验收口径 |
| 主体维度经营报表需求说明 | 主体维度经营报表的字段、口径、来源和验收契约 |
| 业绩明细差额物化 | 业绩明细差额规则落库、物化命令、发布与回退步骤 |
上游数据库按只读黑盒处理。正式页面优先读取共享业务镜像；尚未迁移的旧页面才使用兼容快照。不要在网页中接受任意 SQL，也不要把真实业务数据或连接凭据写进文档、测试和截图。
集成与模块参考
| 文档 | 用途 |
|---|---|
| 电子签约集成说明 | 电子签约集成的接口和配置边界 |
| OfflinePayments README | 离线支付模块说明 |
| PaypalStandard README | PayPal Standard 模块说明 |
| 测试数据说明 | 可公开共享的脱敏测试数据约定 |
文档维护约定
- 新增开发流程或交接信息时，优先更新本索引和对应主题文档，不在多个文件复制同一套命令。
- 命令、路径和页面名称以当前代码为准；改动后使用 git diff --check 检查格式。
- 密码、Token、数据库连接串、APP_KEY、.env、SSH 私钥、生产日志和真实财务数据永远不进入 Git。