一、看板数据源
- 主体收支情况【模版】.xlsx — 销售额、推广费、技术服务费、仓储快递费、货款、其他支出、进项票
- 主体绑定店铺情况【模版】.xlsx — 公司主体、绑定店铺、当前（新/旧）承接状态
两个文件都必须存在，默认读 Sheet1；原始 Excel 只读、不回写。Excel 按公式缓存值读取，公式改了必须先重算并保存，否则可能读到旧值。
二、主体经营状态判定（核心）
按固定顺序判定，不能调整：
优先级条件判定结果
1总销售额 ≥ 400 万元超标主体
2总销售额 ≤ 25 万元安全
325万 < 总销售额 < 400万 且 总支出占比 < 64%需发票
425万 < 总销售额 < 400万 且 总支出占比 ≥ 64%安全
⚠️「需发票」不是按进项票金额判定 —— 只看销售额区间和总支出占比。进项票金额与占比目前只用于展示，不参与经营状态判断。
边界值：销售额正好 400 万 → 超标；正好 25 万 → 安全；总支出占比正好 64% → 安全；63.99% → 需发票；销售额 0 但有支出 → 安全（金额显示 0）。
三、比例计算与颜色预警
所有比例分母统一为 总销售额：推广、技术、仓储、货款、其他、总支出、进项票各自占比 = 该项 ÷ 总销售额。总销售额 ≤ 0 时全部比例记为 0（避免除零）。内部保留 4 位小数，页面显示 2 位。
占比颜色
< 45%绿色
≥ 45% 且 < 55%橙色
≥ 55%红色
边界：45.00% 显示橙色，55.00% 显示红色。颜色只表示比例区间，不直接代表经营状态。
四、核心金额公式
- 总销售额 = 销售类「业绩」合计
- 推广费 = 销售类「转账推广费」合计
- 技术服务费 = 销售类「技术服务费」合计
- 仓储快递费 = 销售类 + 纯支出类「仓储快递（支出）」
- 货款 = 销售类 + 纯支出类「货款转账（支出）」
- 其他支出 = 销售类 + 纯支出类「其他花费(支出）」
- 总支出 = 推广费 + 技术服务费 + 仓储快递费 + 货款 + 其他支出
- 进项票金额 = 销售类 + 纯支出类「【进项票】开票金额」
所有金额最终保留两位小数。
五、数据行分类
- 销售类：平台不为空 或 店铺名不为空 → 参与业绩、推广费、技术服务费、仓储、货款、其他、进项票
- 纯支出类：平台和店铺名都为空 → 不计算业绩、推广费、技术服务费，但参与仓储快递费、货款、其他支出、进项票
即：一条有店铺名的行即使业绩为空、只填了进项票或支出，仍算销售类。
六、期间口径（累计 / 季度 / 月度）
- 累计：排除主体后全部有效记录，不受季度月份范围限制
- 季度：按「公司 + 年份 + 季度」匹配。该季度没有销售额时，销售额必须保持 0，不允许用累计或其他季度补充
- 月度：按「公司 + 年份 + 月份」匹配。未填写月份的数据计入累计与对应季度，不分摊到具体月份
📌 所以「季度金额 ≠ 三个月金额之和」不一定是错误。正确关系是：
季度金额 = 季度内三个具体月份金额 + 该季度未填写月份的金额
七、排除主体
永久剔除：徐州鲁刘种植有限公司（销售额/推广/技术/仓储/货款/其他/进项票、主体数量、店铺绑定、全部季月与累计 —— 全都不计入）。原始 Excel 数据不删除，只在生成看板时排除。
八、全零主体隐藏
选择任意期间或筛选后，若某公司这 8 项全部为 0 才隐藏：总销售额、推广费、技术服务费、仓储快递费、货款、其他支出、总支出、进项票金额。
只要任意一项不为 0 就显示 —— 例如「销售额 0 + 仓储费 1 万」要显示；「销售额 0 + 进项票 5 千」要显示。隐藏规则同时作用于明细表、统计卡片与各汇总数。
九、排序规则
初次打开按总销售额从高到低排序；销售额相同时按公司名称升序。点击任意表头按该列升序，再点一次切换降序，方向由表头箭头显示。数字列按数值排，文字列按文字排。
十、统计卡片与筛选
- 顶部统计卡片必须基于当前筛选后的明细数据重新计算 —— 不允许「表格筛了季度、卡片还是累计」这种情况
- 所有筛选条件之间是 AND（同时满足）关系
- 「重置筛选」= 恢复全部状态 + 清空搜索 + 回到累计期间 + 关闭月份选择行 + 重算卡片与表格
支持的筛选：使用状态 / 经营状态 / 公司或店铺搜索 / 销售额区间 / 时间（月份 > 季度 > 累计，选季度才显示对应 3 个月份）/ 占比区间（推广、仓储、货款、总支出）。
十一、金额与百分比格式
- 金额：
¥1,234,567.89 —— 千分位、两位小数，表格金额下方同时显示万元值
- 百分比：保留两位小数，如
45.00%
- 进项票金额为 0 显示弱化的 ¥0；金额与占比同时为 0 时占比显示「-」
- 公司名、店铺名、期间文字做 HTML 转义，防止特殊字符破坏页面
十二、容易出错的关键点
- 季度无销售额时，错误地用累计销售额补充
- 把未填写月份的季度支出平均分摊到三个月
- 只统计纯支出行，漏掉销售行里填的仓储/货款/其他
- 只统计销售行进项票，漏掉纯支出行进项票
- 把「需发票」误解成按进项票金额判断
- 把「销售额 0 但有支出」的主体错误隐藏
- 统计卡片没跟随筛选变化
- 公司名多空格或用简称，导致同一主体被拆成两个
- 绑定表同时有新旧记录时，错误判成旧主体
- Excel 公式未重算保存，网页读到旧值
- 新增年份/季度却未同步扩展期间配置
- 只看页面外观、没有从 Excel 独立重算核对
- 把密码门槛误认为财务数据加密
🧭 执行口诀：先验源表，再分行类；公司统一，期间精准；销售不补，支出不漏；季度含空月，月份不分摊；全零才隐藏，非零必须现；筛选、明细、卡片三方一致。
⚠️ 密码只是普通访问门槛，不是数据加密：令牌与全部数据都在 HTML 文件内，掌握源文件的人仍可分析内容。机密级财务数据不能只靠此密码保护。