4ea833d0d8
业绩明细页的「差额合计」「差额异常备注」「差额（有/无）」原先都在查询时 逐行现算同一套规则链（生成 SQL 24KB/50KB，含 36 处 ops_jst_orders 关联 子查询）。整月 32.4 万行实测：联动统计 14.5～41.6 秒，页面主体 2.7～4.6 秒。 - 新增物化列 difference_reason_index / base_difference / has_difference， 以及 (report_month, difference_reason_index)、(report_month, has_difference)、 (report_month, store_name, platform) 三个索引和物化状态表； - 新增 store-receipt:materialize-differences 命令（分批写入、支持 --dry-run 三项一致性校验，默认连带重算相邻月份以覆盖跨月备注）； - store-receipt:order-match:sync 成功后自动物化（--skip-materialize 可关闭）； - 页面聚合、联动统计、备注/差额筛选改读物化列，规则指纹不匹配或未物化时 自动回退实时表达式，功能不受影响； - 月份下拉缓存 6 小时、指标卡聚合 5 分钟、联动统计 1 小时，缓存键带规则 指纹、物化状态与数据版本，物化后自动失效； - 前端联动统计改为展开下拉时按需请求，页面加载不再同步统计整月。 规则表达式仍以 Pages 的静态方法为唯一口径，物化命令直接复用，不在 PHP 中 重写规则。本地用 7,907 行副本验证：三项一致性差异为 0，数字与实时口径完全 一致；联动统计 76ms→21ms、页面 56ms→41ms（同一数据）。详见 docs/业绩明细差额物化.md。
53 lines
3.6 KiB
Markdown
53 lines
3.6 KiB
Markdown
# CaiWuXiTong 文档索引
|
||
|
||
本目录按“先启动、再协作、最后按业务深入”的顺序整理。文档中的规则发生冲突时，以根目录 [AGENTS.md](../AGENTS.md) 和负责人最新明确要求为准；历史截图、聊天记录和临时排错方案不覆盖当前规则。
|
||
|
||
## 新电脑与本地开发
|
||
|
||
| 文档 | 用途 |
|
||
| --- | --- |
|
||
| [新电脑开发接续指南](新电脑开发接续指南.md) | 在另一台 Windows 电脑克隆最新代码、启动本地环境、接入团队系统数据库并创建任务分支 |
|
||
| [LOCAL_DEPLOY.md](../LOCAL_DEPLOY.md) | 本地 Docker、临时引导库、共享系统数据库和常见命令的完整说明 |
|
||
| [AGENTS.md](../AGENTS.md) | Git、协作、敏感信息、数据和部署边界 |
|
||
| [DESIGN.md](../DESIGN.md) | VIP 黑金主题、组件和页面视觉规范 |
|
||
| [SECURITY.md](../SECURITY.md) | 安全相关的最小基线 |
|
||
|
||
凭据说明：接续指南包含仓库地址、Git 用户名、服务器地址和 SSH 操作方式；Git 密码、服务器密码等敏感值只保存在每台电脑本地的 `runtime/private/新电脑开发接续私密信息.md`，该目录已被 `.gitignore` 忽略，不在远程仓库中。
|
||
|
||
## 协作、构建与发布
|
||
|
||
| 文档 | 用途 |
|
||
| --- | --- |
|
||
| [开发与部署 SOP](开发与部署SOP.md) | 团队协作、Docker 构建缓存、服务器初始化、正式发布、镜像和回滚 |
|
||
| [团队协作说明](team-collaboration.md) | 任务预检、分支、WIP PR、冲突协调和交付要求 |
|
||
|
||
生产发布只使用已经合并的最新 main，并遵守 SOP 中的授权、备份和回滚要求。服务器不构建源码，私有配置和证书不进入 Git。
|
||
|
||
## 上游数据、镜像与电商财务
|
||
|
||
| 文档 | 用途 |
|
||
| --- | --- |
|
||
| [通用上游数据接入](通用上游数据接入.md) | 新来源发现、数据字典、固定只读查询、镜像登记和验收 |
|
||
| [上游业务镜像清单](上游业务镜像清单.md) | 当前来源、表/视图、镜像表和分阶段迁移状态 |
|
||
| [电商财务扩展开发说明](ecommerce-finance-development.md) | 订单、结算、成本、资金和利润分析的业务模型与扩展边界 |
|
||
| [商品成本占位行规则清单](商品成本占位行规则清单.md) | 商品成本同步的取数顺序、占位行去重、价格兜底和月度验收口径 |
|
||
| [主体维度经营报表需求说明](主体维度经营报表需求说明.md) | 主体维度经营报表的字段、口径、来源和验收契约 |
|
||
| [业绩明细差额物化](业绩明细差额物化.md) | 业绩明细差额规则落库、物化命令、发布与回退步骤 |
|
||
|
||
上游数据库按只读黑盒处理。正式页面优先读取共享业务镜像；尚未迁移的旧页面才使用兼容快照。不要在网页中接受任意 SQL，也不要把真实业务数据或连接凭据写进文档、测试和截图。
|
||
|
||
## 集成与模块参考
|
||
|
||
| 文档 | 用途 |
|
||
| --- | --- |
|
||
| [电子签约集成说明](esign-agreement-integration.md) | 电子签约集成的接口和配置边界 |
|
||
| [OfflinePayments README](../modules/OfflinePayments/README.md) | 离线支付模块说明 |
|
||
| [PaypalStandard README](../modules/PaypalStandard/README.md) | PayPal Standard 模块说明 |
|
||
| [测试数据说明](../test-data/README.md) | 可公开共享的脱敏测试数据约定 |
|
||
|
||
## 文档维护约定
|
||
|
||
- 新增开发流程或交接信息时，优先更新本索引和对应主题文档，不在多个文件复制同一套命令。
|
||
- 命令、路径和页面名称以当前代码为准；改动后使用 git diff --check 检查格式。
|
||
- 密码、Token、数据库连接串、APP_KEY、.env、SSH 私钥、生产日志和真实财务数据永远不进入 Git。
|