大屏口径与计算逻辑说明

首页图表、排行榜与分类

• 今日、昨日查询只含一个日汇总值时，趋势图显示可见的数据点，并标明“单日汇总”；不会把日总额分摊成虚构小时数据。多日区间继续显示日曲线。
• 排行榜的销售额、销量、订单量、平均售价、广告费、广告销售额、ACOS、TACOS 可点击表头箭头切换升降序，未知值始终排末尾。页面每分钟读取已发布来源，保留筛选和排序；读取页面不触发领星采集，实际更新以成功时间为准。
• 新老品中的“待核对”单列展示：创建日期缺失、映射有歧义或未关联时不归为老品，其金额仍保留在单独分组中。

当前口径核对状态（2026-09-16）

2026 年 9 月已采用同源日明细汇总：首页、销售趋势和经营达成的销售额、销量、广告数据使用同一批店铺 / ASIN / 站点业务日期记录，原始金额保留 USD，负责人采用同一份最新来源。9 月 1–14 日已与独立区间报表逐项核对；15 日为未结束站点日，持续更新。其他月份明确未核对。

按用户确认，月值采用真实日明细相加，不将月金额倒摊成日数据。领星日金额先取两位小数，独立区间金额可能产生舍入尾差；金额按来源行数推导的半分精度区间逐店铺 / ASIN 核对，数量类必须完全一致，超出精度范围或来源不全时拒绝切换。核对范围 9 月 1–14 日，日合计减区间值分别为：销售额 −0.81 USD、广告费 −0.09 USD、广告销售额 −2.02 USD、下单毛利 +4.05 USD。来源说明与后台「数据中心 → 数据对账」保留这些尾差及核对范围。它们不是三个页面之间的差额。

销售10分钟、广告30分钟刷新当前站点日，跨日补取刚结束日期；财务月报60分钟更新。独立历史核对只证明上述日期及采集时点，不代表上游永不回写。历史广告可能被领星修订，需另行复核后重新发布历史分区；不能把计划频率理解为所有历史日期均实时重新采集。

日期选择器给领星的查询参数是各站点当地业务日期。北京日/美西日只改变选定的日历日期，不把站点订单转换成北京时间。更新时间、业务数据日期、时间进度是三个不同概念。10/30/60分钟是各来源的计划频率，接口失败或上游回写均可能导致数据延迟，不能把网页刷新时刻写成来源同步时刻。

广告订单占比=广告订单/全部订单，ACOS=广告费/广告销售额，TACOS=广告费/总销售额；分子分母必须来自相同日期、来源和人员范围。日度与月度尚未核对完成时，不把两种来源拼在同一个比率里。

AI 巡检入口：后台「系统管理 → AI 广告巡检」。外部 AI 管理模型、定时任务、Skills 与第三方 MCP；舵舱只发放专用密钥，提供商品上下文并接收报告，不保存第三方 MCP 凭据、不修改广告。登记执行计划不等于任务已运行，以收到的报告为准。

本文档记录大屏每一个指标的取值来源（领星 OpenAPI）与计算逻辑。

规则：每次新增或修改大屏功能、指标、口径时，必须同步更新本文档。

后台管理与页面范围（两大屏版）

• 前台仅保留销售大屏（/）与推新大屏（/transfer），后台（/admin）按管理总览、销售管理、转P管理、人员与权限、数据中心、系统管理六组组织。
• 销售管理保留年度总目标、SKU目标和交接；广告阈值、节点提醒、节日标签、经营告警四个独立管理页面已删除。转P管理直接打开前台对应页签，共用定级、档案、推新目标与年度新品例外流程，不维护重复结果。
• 用户账号自主设置账密并按需关联飞书。可分配的大屏菜单仅销售与转P；数据范围、转P操作权限和管理员权限分别控制。仅含退役菜单的历史账号不会自动获得其他大屏权限。
• 数据中心展示产品表现、订单利润、Listing、产品管理四类来源的本地状态。数据覆盖日期不等于同步成功时间；快照更新时间不等于资料创建日期；相关调度任务成功不等于每个来源都完整同步。没有可靠记录时显示“未知”。
• “同步当日经营快照”调用现有小时同步，更新当日产品表现、汇率与当月订单利润；“同步产品管理资料”只更新产品管理。两项都需再次确认。打开页面、切换模块和刷新状态不会触发同步。Listing等其他来源沿用既有定时任务，不在此新增同步或修改频率。
• 广告、供给、经营、周会等旧独立大屏，以及配置BI看板、设计器、分享页已退役。旧页面、专属读取接口、看板配置/数据集/通用CSV/旧BI订阅管理接口不再对外开放；旧BI订阅和周会看板快照不再产生新任务。历史配置、共享业务数据及独立经营报表保留，不执行历史数据删除。
• 后台“版本与状态”展示当前运行版本及只读健康检查。它不表示数据已经更新，也不代表尚未发布的本地改动已上线。

---

SKU目标与数据核对（2026.09.15.3）

• 月份×运营×SKU为目标范围，可进一步限定店铺、MSKU或ASIN；一份SKU目标不复制到每个ASIN。手工新增和Excel导入均先预览，现有格子失焦或Enter保存并即时推送前台。
• 未来开发商品允许SKU/MSKU/ASIN/店铺留空或暂定，建议填写计划名称。每份未关联计划有独立目标编号，目标计入总额，实际与达成率显示待关联。后台关联商品或导入时保留编号并将关联方式填为关联；匹配成功后原位更新，金额不变。
• 导出后保留目标编号再修改计划。首次无编号、且多行资料完全相同的计划按同类行次序生成编号；重新排序或改名应使用带编号的导出文件，避免将不同计划混淆。
• GMV、渠道利润等实际数据列不会自动成为目标；请使用明确的销售额目标、毛利润目标、广告预算、销量目标列。空白为未设置，0为明确零目标。
• 专员-SKU显示目标缺口、财务负毛利、预算进度等证据；建议是相应核对步骤，不能据此断言流量、转化或库存已发生异常。
• K转P逐日窗口不齐全时不判断转正；同一ASIN对应多个本地SKU，现有ASIN日汇总无法准确分配时显示待核对，不能任取一个SKU或复制业绩。
• 领星已发放、含预结算、订单日期等口径并不等价。核对须保持报表、店铺、期间、币种、交易状态与更新时间一致；每小时同步不等于上游所有报表秒级刷新。

0. 目标达成与领星运营计划口径

销售大屏目标达成按领星 运营计划 → 负责人 → 所选月份 核对：

• 销售额、销量、广告花费取 统计 → 产品表现，接口 /bd/productPerformance/openApi/asinList，字段 amount、volume、spend，月份完整查询区间，币种 USD。
• 毛利润、毛利率取 财务 → 利润报表 → ASIN → 按月 → 已发放 → USD，接口 /bd/profit/report/open/report/asin/list，monthlyQuery=1、summaryEnabled=1、orderStatus=Disbursed。必须逐店铺读取再汇总，不能把跨店铺合并行的负责人用于拆分业绩。
• 毛利润取 grossProfit；毛利率为毛利润合计除以 grossProfitIncome 合计，不能用产品表现销售额作分母，也不能平均各行毛利率。
• 财务按报表第一位负责人归属；产品表现多人姓名顺序可能不稳定，使用同店铺、同ASIN财务第一负责人核对。无法唯一核对时显示待核对，不把遗漏的实际值当成零。
• 每个店铺的完整页数、记录数均校验通过后，整体替换当月快照；小时同步失败保留上次完整数据。实际值悬停显示路径和同步时间。上游报表追溯调整、查询时点及逐行分位舍入可能造成短时或分位差异。
• 汇总包含有考核目标的负责人，无归属公共费用不并到个人。SKU/MSKU只能在店铺、ASIN与本地SKU映射能够唯一拆分时展示实际；待开发目标仍保留，实际待关联。年度缺少月份快照时不以局部合计冒充全年。
• SKU 达成读取产品表现嵌套 price_list[].seller_sku 的真实 MSKU 身份，按店铺＋MSKU＋ASIN关联，日明细汇总时保留该身份。两个包装版本可以合并计入同一目标，其他店铺或旧SKU不会混入。SKU 财务取同店铺、已发放、USD 的 MSKU 月度利润明细，整组明细与 ASIN 月报的利润及收入基数通过来源精度核对后才启用；独立行舍入尾差保留，不人为分摊，也不改写负责人及公司月报合计。未通过核对的来源继续保留待补齐，不能将不明金额当零。
• 转P首单90天及既有审批口径保留；转P目标的当月/当周实际继续使用已标明的日度 MSKU 财务路径，不使用月度快照相减计算周值。日度 KPI / 趋势沿用产品表现。

---

1. 数据来源（领星 OpenAPI，已取消 MCP）

• 地址：https://openapi.lingxing.com（AppID/AppSecret 签名，见 src/lingxing_openapi.py）
• 同步频率：销售10分钟、广告30分钟、财务/汇率每小时；销售使用独立任务线程，财务耗时不阻塞销售任务；每日 09:10~09:15（listing/FBA库存/补货/产品/店铺）
• 领星 OpenAPI 部分接口有令牌桶限流（103「请勿频繁请求」），客户端内置跨线程 20s 请求间隔与有界退避重试。

用到的主要接口（OpenAPI path）与字段：

汇率：asinListNew 同一日期分别用 currency_code=CNY/USD 拉取，汇率 = CNY 总额 ÷ USD 总额，落 exchange_rates。

---

2. 关键口径

2.1 归属人（专员）

以下仅为未核对月份的旧日度指标归属。已核对月份以同一份最新来源统一整月的店铺 / ASIN 负责人，原始日记录保留采集时负责人；多负责人不能唯一解析时标记待核对，禁止猜测分摊。

• 领星 principal_names 是 JSON 数组，取 第 0 个（$[0]）作为主归属人。
• 若含逗号（多人共担），只保留逗号前的主名："龚靓妮Bunny,徐娟 Lexie" → 龚靓妮Bunny。
• 无归属 → 未分配。

2.2 SKU 口径

• 统一用领星的 local_sku（本地 SKU）。
• 同一 ASIN 有 FBA/FBM 多条时，优先保留 local_sku 非空（FBA）的一条；无本地 SKU 时回退显示 ASIN。

2.3 产品创建日期 / 新老品

• 权威来源为领星「产品管理」的创建时间（products.create_time，Unix 秒转北京时间日期），使用本地 SKU 关联。
• 新品：产品创建日期不早于 2026-01-01，且统计日减创建日期的自然日差为 0–365 天（含）；2026 年之前创建或超过 365 天均为老品。创建当天为第 0 天，第 366 天开始为老品；不按自然年重置。
• 统计日使用系统站点日，页面标签悬停显示本次统计日期及关联产品创建日期。
• 日期缺失、非法、晚于统计日，或关联商品分类不一致时显示“待核对”；不回退 Listing 上架日、首单日，也不以转P状态判断新老品。
• 推新统计应用已保存的人工新品例外；历史转P记录保留。规则变更前后的周环比快照不混用。

2.4 站点日（今日）

• 「今日」按站点当地日期（默认美西 America/Los_Angeles，可在 .env 的 SITE_TIMEZONE 覆盖）。
• 站点当天还没过完时，大屏「今日」仍是当天（站点当地午夜才翻页）。
• 小时快照 / 逐小时趋势的横轴 = 站点当地小时（美西时间），不是中国时间。

2.4.1 美西日 / 北京日 一键切换

• 美西站点日（默认）：大屏「今日」= 美西当地当天，数据为当天累计（partial，未走完）。

跨站点汇总时，欧洲站可能已走完、美西站还在累积，以美西（最晚跨日）为基准。

• 北京日：选择北京时间的日历日期，并按该日期查询各站点当地业务数据；不把站点订单转为北京时间，不保证所选站点日已结束。
• 美西与北京可能处于不同日历日期。核对时须确认日期参数、数据更新时间、站点、负责人及币种，不能把任何差异都归因于时差。
• 使用方式：销售大屏右上角「美西日 / 北京日」开关，一键切换并记住偏好（localStorage）。

切换后日期预设（今日/昨日/近7天/本月等）与后端「今日」基准同步联动。

2.5 币种与汇率

• 已核对月份保留领星原始 USD 日明细，月度实际金额直接相加；USD 目标不变。显示 CNY 时，金额与目标均乘同步汇率。
• 未核对月份的旧日快照仍为 CNY，展示 USD 时除以当前同步汇率；界面明确标识未核对，不与已核对月份宣称为同一来源。
• 汇率来源仍为领星同日期 CNY / USD 总额之比。不同币种不能直接对比；页内比率由同币种、同区间和同人员范围的分子分母计算。

---

3. 指标计算逻辑

说明：广告订单占比 = 领星产品表现里的 adv_rate 字段（值一致）。

SKU 排行是跨多天/多 ASIN 汇总，用「广告订单总数 ÷ 订单总数」加权计算，不能对每天的 adv_rate 简单平均。

---

4. 达成进度（本月目标 vs 时间进度）

按所选月份的完整运营快照计算；目标与实际源金额均为 USD，切换 CNY 时金额和目标同时换算：

• 销售达成率 = 本月销售额(USD) ÷ 销售目标(USD) × 100%
• 利润达成率 = [1 + (实际毛利润 − 目标毛利润) ÷ |目标毛利润|] × 100%；正目标等价于实际÷目标，负目标越接近盈利越高，零目标按领星公式为0%。
• 预算使用率 = 本月广告费(USD) ÷ 广告预算(USD) × 100%
• 时间进度 = (end - 月初 + 1) ÷ 当月天数 × 100%

销售实际来自产品表现，利润实际来自ASIN月度利润报表。缺失快照或无法唯一归属不显示伪造的0；预算使用取产品表现广告花费。毛利率实际使用财务收入基数，毛利率目标沿用后台销售目标和毛利润目标计算。

达成等级（比值 = 达成率 ÷ 时间进度）：

---

5. 维度汇总

• 专员达成：按专员汇总目标与销量。
• 按组 / 按品线：后台维护「专员 → 行政组(grp) / 业务品线(line)」，按组/品线汇总；未分配 → 未分组 / 未分类。
• 新老品：按 专员 × (新品/老品)。
• 专员-SKU：按 专员 × SKU（支持按专员、按新品/老品筛选）。

---

6. 年度目标达成

• 年度目标 = 该年有目标的月份（如只有 8-12 月就只算 8-12 月）所有专员销售目标之和。
• 目标期起点 = 最早有目标的月份 1 号（如 8 月 1 日）。
• 累计销量 = 目标期起点 → 今天。
• 时间进度 = (今天 - 起点 + 1) ÷ (12月31 - 起点 + 1) × 100%。

---

7. 离职 / 删除专员

• 后台「组 / 品线管理」点「删除」→ 标记为离职（hidden_principals 表）。
• 被标记专员从大屏的排行、达成进度、按组、按品线及后台专员列表中全部排除；历史数据保留，可「恢复」。

---

8. 目标导入

后台「年度目标」以专员为行、1—12 月为列，支持逐格保存及年度 Excel 模板导入。负责人由当前 Listing 带入，也可手动添加；空白为未设置，0 为明确零目标。销售额、毛利润、广告预算、销量可编辑，毛利率由毛利润目标除以销售额目标自动计算。

年度表保存专员月度总目标（ASIN 为空）。每项指标有总目标时优先使用总目标，未设置则沿用商品明细合计；月度和年度考核不把两者重复相加。清空格子即取消该指标的总目标覆盖。SKU、店铺、新老品等细分目标仍保留原商品明细，不自动分摊专员总目标。旧数据的导入、修改、删除入口保留在折叠区。

年度 Excel 导入先预览、再确认：有值覆盖对应格、空白跳过，其他人员和年份不受影响；不接受公式、重复人员行、年份不一致和无效数值。目标版本变化时需重新预览。单格保存和批量导入都沿用审计、一致性补偿与前台即时通知。

• 后台目标保存成功后，已登录且打开的销售达成页、转P目标表自动更新，无需等待每分钟刷新。保留当前月份、币种、筛选和分页；网络中断时显示更新状态，恢复网络或回到页面时立即核对最新目标。保存失败或回滚不会通知前台显示未保存的值。

• 表头：月份,专员,SKU,ASIN,销售目标,利润目标,广告预算。
• 金额单位 = USD；负数保留（如新品清库存期为负值，不强制取正）。
• 合并键 = (月份, 专员, ASIN)；只给 SKU 时自动解析为 ASIN；不填月份默认当月。
• 支持 .xlsx / .csv / 粘贴 CSV 文本，可一次导入多个月。
• 转P页面的月度目标导入按 月份 + 专员 + ASIN 局部更新，未匹配本次上传的目标保持不变。同次上传中归到同一目标的行累加；重传则替换该目标的四项指标，不叠加历史值。
• 转P目标导入要求已有转P操作权限，且目标属于该账号可管理的人员范围；一个 MSKU 对应不同商品或负责人时需先核对。出现越权、歧义或格式硬错误，整份文件不写入。
• 后台「目标微调与划拨」明细支持单元格手工调整：点击销售额、利润、销量、广告预算数值单元格，Enter 或失焦保存、Esc 取消。按 (月份, 专员, ASIN) 唯一匹配已有目标行，只改该行一个字段，不允许 implicit upsert；金额最多两位小数且绝对值不超过现有划拨上限，销量为非负整数，允许 0 与负利润。乐观锁用行 revision，版本过期返回 409。手工调整只改变该项目标值，保留导入入口与其他数据，并写入审计记录。

---

9. 季节性节点提醒 + 营销日历

• 节点：后台「节点提醒」维护「节点名 + 类型 + 提醒日期(YYYY-MM-DD) + 动作文案 + 主词 + 启用」。
• 关联 SKU：只对「有目标的 SKU」做提醒；每个节点勾选适用 SKU。
• 去年趋势（按周）：领星 query_product_performance_asin_lists（date_view_type=week、summary_field=sku、search_field=local_sku），按 SKU 拉取某年每周销售额，存 sku_weekly_history。
• 自动推荐主词：领星 ad_campaign_search_term_report（搜索词报告，group_type=query），按该 SKU 主 ASIN 拉去年搜索词，按「订单数降序 + ACOS 升序」聚合排序，取 Top N 作为推荐主词。
• 推送：内置调度器每天 09:00 检查；remind_date == 今天 的启用节点 → 推飞书，消息带「SKU + 主专员 + 动作 + 主词」，每个 SKU 只推一次（season_remind_log 防重）。

营销日历（节日表 + 自动生成提醒节点）

• 节日表 promo_holidays：内置美欧节日（按站点 US/UK/EU/ALL 区分），日期规则 5 种：

fixed(固定月-日) / nth_weekday(某月第 N 个周 X) / offset_from(参照某节日±N天) / easter(复活节算法±N天) / manual(手动，如 Prime Day)。

• 多里程碑时间线：一个节日生成 5 段提醒（相对节点日）：

下单生产 T-79（生产30+海运35+入仓14）→ 发货海运 T-49 → 广告预热 T-45 → 旺季预热 T-20 → 到港入仓 T-14。

例：万圣节 10-31 → 下单生产 08-13、发货海运 09-12、广告预热 09-16、旺季预热 10-11、到港入仓 10-17。

• 先预览后生成：后台「营销日历」先预览各节日日期+里程碑，勾选后「一键生成提醒节点」写入 season_nodes（每个节日 5 个节点）。
• 自动建议：按 sku_weekly_history 找峰值周，强度 = 峰值 ÷ 周均值；若峰值 ≥ 2 倍且落在某节日的「提前窗口」内，建议关联到该节日。

SKU 维度 + SIF 数据源

• 趋势/提醒维度用 local_sku（领星 erp_listing 的 local_sku 字段，即卖家 SKU，回退 asin）。
• SIF MCP（https://mcp.sif.com/mcp?secret-key=...）：
• ops_get_asin_sales_trend → ASIN 月销量趋势（近三年 boughtHistoryDates + boughtList）；
• market_get_asin_keyword_signals → 关键词信号（gaining 上升 / declining 下滑 / rank_gaps 排名缺口），用于推荐主词。

10. SKU 自动诊断（每日飞书提醒）

• 数据源：领星已同步的日指标（v_daily：销售额/销量/广告费/广告销售额），按 local_sku 汇总。
• 诊断规则（近 N 天 vs 前 N 天，默认 7 天）：
• 断货/零销量：近 N 天销量=0 且前 N 天>0；
• 销量下滑：环比 ≤ -40%；销量暴增：环比 ≥ +100%；
• 高 ACOS：近 N 天 ACOS ≥ 60%。
• SIF 交叉验证：对异常 SKU 拉 market_get_asin_keyword_signals，附「上升主词 / 排名缺口主词」建议。
• 推送：每天 09:15 汇总成一条飞书「【SKU 诊断】」，列出异常 SKU + 专员 + 主词信号（最多 20 条，超出提示看后台）。

11. 共享库存与补货数据

供给独立大屏已退役，相关页面及专属概览接口不再开放。FBA库存、补货建议、SKU销量等共享数据和既有同步任务保留，本次没有删除历史库存或改变数据口径。

12. 订单利润与经营报表

经营独立大屏已退役，相关页面及专属概览接口不再开放。销售大屏依赖的订单利润、财务数据和独立经营简报仍保留，不能因删除页面而删除共用数据或停止业务报表。

13. 广告健康目标 + 踩线报警（ad_goals）

• 目标：ad_goals 表（principal='*' 全局默认，可覆盖到专员）三个阈值：投产比(ROAS=广告销售额÷广告费，低于报警)、ACOS(高于报警)、单均成本 CPA(广告费÷广告订单，高于报警)。默认投产比≥10、ACOS≤40%。
• 使用范围：广告独立大屏已退役；阈值仍供既有广告健康检查与经营提醒使用，不作为一个额外大屏。
• 报警：每天 09:20 飞书「【广告踩线报警】」按专员汇总近 7 天踩线项。
• 配置：后台「销售管理 → 广告阈值」，或 GET/POST /api/ad-goals。

14. 广告异常 SOP（操作建议）

• 规则（src/sop.py 的 SOP_RULES，阈值/文案可改）：ACOS过高(≥60%)、花费突增(环比+50%)、转化率骤降(CVR环比-50%)、曝光骤降(-50%)、点击骤降(-50%)。
• 每条异常附操作建议（如「降低竞价10%~20%→添加否词→优化listing」），每天 09:25 飞书「【广告异常SOP】」，初级运营照着操作。
• 接口：GET /api/sop。

15. 推新大屏（/transfer）

• K 释义与考核时钟：推新大屏面向「2026-01-01 起创建且不超过365天的新品」——按本地 SKU 统计（每个 SKU 合并其全部 ASIN，不按子 ASIN计数），进入推新管理的口径见 2.3，并应用人工新品例外。90 天考核从首单日起算：首单日 = Day1（该 SKU 全部 ASIN 最早有销量日，metrics_daily.volume>0），Day90 = Day1 + 89 天。不再以上架时间计算转P时效。
• 90天内毛利转正（核心指标）：某 SKU（合并全部 ASIN）在「首单 Day1 至 min(Day90, 数据截止日)」的日粒度窗口内，累计日度下单毛利（metrics_daily.gross_profit，界面简称推新期毛利）最终值 > 0 即为转正；曾短暂转正后回落 ≤0 不算成功（turn_date 仅信息性）。没有首单 / 数据待同步 / 首单比档案上架日期早超过7天 的 SKU 不可判定，不自动转正/风险/成功率。
• KPI「90天内毛利转正率」 = 90天内毛利转正的新品数 ÷ 当前新品总数 ×100%；分母含尚未走满90天的 SKU（非仅完整考核样本）。「90天后仍在售率」分母 = 首单 Day1 满90天（同一 SKU 任一映射 ASIN 在售，active_asins）。
• 人工定级（不用规则自动定级）：产品定级 K0/K1/K2 与最终定级 P0/P1/P2/EOL 均由产品经理手动确定（P0 最高，EOL=停售）。人工最终定级与 90天盈利判定分离（盈利转正不自动改定级）。转P权限已下放：管理员（scope=*）或勾选「转P定级权限」（can_transfer=1）的产品经理账号，可直接在每行「定级」按钮内联编辑，操作留痕（updated_by 记录操作人）。
• 转P看板主表字段：上架时间 / 首单时间（Day1）/ 已上架天数 / 推新期毛利 / 推新期毛利率 / 转P动作；另有 SKU / ASIN / 产品经理 / 品名 / 季节性 / 产品定级 / 最终定级。
• 推新期毛利固定 USD：主表「推新期毛利」用 fmtUsd(profit_90d_value_usd) 固定 USD 展示，不随顶部币种切到 CNY；CNY 原值与 FX 仅用于溯源/导出。推新期毛利率（比率）不受币种影响。其余随币种换算的金额（如明细下钻/趋势环比/综合 ROI 相关金额）按其自身口径单独处理，此处不混写。
• 推新期毛利/毛利率：推新期毛利 = 首单 Day1 至 min(Day90, 数据截止日) 窗口内累计日度下单毛利（metrics_daily.gross_profit，界面简称推新期毛利；区别于月度 order_profit 订单毛利）；毛利率 = 同窗口累计日度下单毛利 ÷ 同窗口累计销售额 ×100%（销售额>0 才计算）。无数据=金额待同步、真实0=$0.00，绝不拿 CNY 冒充 USD。
• 转P动作：满足「90天内转正」可一键转P；临界风险（首单起考核中且已满70天未转正）显示剩余天数与90天毛利差倒计时。
• 产品经理联动：选择产品经理后，顶部 KPI、决策 Tab 数量、明细统一为该经理范围，并展示与「全员/权限范围」的基准对比（占比/百分点/ROI 差值）；权限按账号 resolve_scope 隔离。
• 明细下钻：点击 SKU/ASIN 可下钻该 ASIN 日粒度明细；普通趋势支持日/3日/自然周粒度、本期 vs 紧邻等长上期的环比对比（经营+广告指标）；另有推新期三阶段对比；本轮新增放大沉浸查看（应用内铺满视口，不动 Fullscreen API）。
• 原项目周会看板已退役，不再提供页面或新增看板快照；独立业务周报不受影响。

16. 已知边界

• 领星只给「日粒度 + 今日累计」，无小时粒度历史；大屏「逐小时曲线」是每小时对「今日累计」打点攒出来的，粒度为「累计值随时间增长」，非每小时独立增量。
• 广告/销量数据约 1 小时 ~ 1 天延迟；大屏实时数字 = 领星当前已回传的「今日累计」。
• 跨站点汇总时，「今日」里欧洲站可能已走完、美西站还在累积——这是跨区看板的固有现象，以美西（最晚跨日）为基准。

17. 销售趋势独立时间 + KPI/趋势隔离（061）

• 销售大屏销售趋势「数据时间」独立：趋势模块使用自己的「数据时间起止」（trendStartDate/trendEndDate，默认近30天），不再跟随顶部 KPI 主日期（今日/近7天/本月/自定义）。/api/trend 的 start/end 只取趋势自己的数据时间。
• KPI 与趋势状态隔离：顶部 KPI 的 applyPreset/applyCustom 只刷新 /api/overview，不触发也不改写趋势；趋势筛选/下钻/搜索/分页只影响趋势。/api/overview 不再携带趋势专属参数（line/new_old/open_start/open_end）。
• 校验：趋势查询要求数据时间起止必填且 start<=end，否则模块内可见错误（不请求）。
• 币种切换、登录首载、定时刷新仍可并行刷新 overview+trend，但 trend 保持自己的数据时间。

18. 应用内沉浸查看（转P下钻 / 销售趋势，061）

• 转P ASIN 明细下钻与销售趋势标题栏新增「放大查看/退出放大」icon-only 按钮：点击后进入应用内沉浸（fixed 铺满视口，不动浏览器 Fullscreen API）；再次点击或按 Esc 退出。
• 沉浸切换不重新请求、不重渲染，保留当前筛选/下钻层级/搜索/分页/图表与滚动位置；切换后图表 resize()。
• Esc 在转P只退出转P放大，在销售只退出销售放大，互不污染；关闭转P下钻时强制复位非放大态。
• 转P下钻沉浸态无 body scroll lock 残留；销售沉浸态进入时 body overflow:hidden、退出/关闭时移除。

19. 全局版本号与说明文档入口（061）

• 各大数据屏头部右侧统一注入「版本号 chip + 说明文档按钮」（app-meta-group，7 大屏共用，经 common.js renderAppMetaGroup() 去重注入）。
• 版本号只取真实运行数据：一次 GET /api/health/live，取响应顶层 version/commit/build_time 展示（版本号 chip 展示 version，tooltip/title 展示真实 short commit 与 build_time）。接口失败或任一字段为 unknown/缺失时明确显示「版本未提供」/「未提供」，不硬编码、不伪造时间。
• 说明文档按钮打开 /口径（新页、可键盘），图标用本地官方 Bootstrap Icons（file-text.svg），无 emoji。

人员状态、目标追溯与数据核对（2026-09-15）

• 年度目标可登记休假或离职、生效月份及说明；勾选“显示休假／离职／归档人员”后办理复工。复工月份起允许新目标，此前休假区间保留。当前/未来目标未交接时拒绝暂停考核；操作不改变领星归属、历史实际或登录权限。
• “目标变更记录”从本版开始记录每次保存的人员、月份、商品及指标前后值，与目标保存同事务；旧操作仍查审计日志。待开发计划继续使用稳定目标编号，补齐信息后经原导入入口关联。
• 后台“数据对账”读取目标达成当前使用的产品表现与ASIN月度财务快照，展示分页/店铺覆盖和分别采集的时间。当前月超过2小时未更新提示过期；历史月份标识为历史快照。
• 领星界面参考值由核对人录入，保存查询时刻和当时的快照/目标版本；差额为舵舱减领星。只有实际比较过的字段才显示数值一致。来源或目标更新后，该记录标为历史核对，不自动沿用“已核对”结论。此入口不覆盖实际或目标。
• SKU缺口分析可选销售额或毛利润，均为 max(目标−实际,0)，只累加可核对且已设目标的商品；毛利润支持负目标。处理建议是基于现有证据的排查步骤，不是已证实的流量/库存原因。
• K转P“判断依据／下一步”展示既有首单日起90天累计毛利规则、日期和覆盖证据；有完整转P快照时使用快照，不自动定级。
• 右上角个人中心仅展示本人资料、角色及有效数据范围；修改密码要求原密码，保存不改变权限。

---

指标定义（自动生成）

月度指标（来源 order_profit 订单利润，达成率/经营/财务的订单毛利口径）：

派生指标（由基础指标计算，见 derive()）：

• ACOS（acos）：广告费 ÷ 广告销售额 × 100%
• ROAS（roas）：广告销售额 ÷ 广告费
• CTR（ctr）：点击 ÷ 曝光 × 100%
• CPC（cpc）：广告费 ÷ 点击
• CVR（cvr）：广告订单 ÷ 点击 × 100%
• 广告订单占比（ad_order_ratio）：广告订单 ÷ 订单数 × 100%
• CPA（cpa）：广告费 ÷ 广告订单