14.1 产能度量：人天与吞吐

{
  "project": "stardust-inn",
  "chapter": 14,
  "note": "示例参数：本套构造的产能模型，非任何真实团队或公司的数字。",
  "caliber": "出勤率与专注率为示例口径；人天成本为示例参数。人天（person-day）是游戏与外包行业公开使用的计价单位。",
  "workdays": 10,
  "availabilityPermille": 850,
  "focusPermille": 700,
  "roles": [
    { "id": "env", "name": "场景与家具", "people": 2 },
    { "id": "char", "name": "角色与头像", "people": 1 },
    { "id": "ui", "name": "UI 与图标", "people": 2 },
    { "id": "vfx", "name": "特效", "people": 1 }
  ],
  "demand": [
    { "id": "furn_icon", "role": "env", "units": 12, "costPerUnit100": 60 },
    { "id": "furn_prefab", "role": "env", "units": 4, "costPerUnit100": 250 },
    { "id": "portrait", "role": "char", "units": 2, "costPerUnit100": 400 },
    { "id": "ui_icon", "role": "ui", "units": 24, "costPerUnit100": 40 },
    { "id": "vfx_burst", "role": "vfx", "units": 1, "costPerUnit100": 300 }
  ]
}

#!/usr/bin/env python3
# file: sim/ta14_capacity.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/ta14_capacity.py
"""14.1 产能度量：人天与吞吐（S 层，卷二第 14 章）。

读 ``config/ta14_capacity.json`` 的示例产能模型，算三笔整数账：

1. **日历人天 → 有效人天**：有效系数 = 出勤率‰ × 专注率‰ // 1000（整数地板除）；
2. **角色产能 vs 需求**：``calendar100 = people × workdays × 100``，
   ``effective100 = calendar100 × factor‰ // 1000``；需求 ``demand100 = Σ units × costPerUnit100``；
3. **利用率与吞吐**：``util‰ = demand100 × 1000 // effective100``（>1000 即超产能），
   ``throughput100 = units × 10000 // effective100``（每有效人天的资产数 ×100）。

全整数、无浮点。数字是**示例参数**（本套构造），非任何真实团队。落 ``out/ta14_capacity.json``。
"""
import json
import os
import sys

ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
CFG = os.path.join(ROOT, "config/ta14_capacity.json")
OUT = os.path.join(ROOT, "out")


def build_report(cfg):
    """把示例产能模型算成整数账。"""
    workdays = cfg["workdays"]
    factor = cfg["availabilityPermille"] * cfg["focusPermille"] // 1000
    roles = {r["id"]: r for r in cfg["roles"]}
    calendar, capacity = {}, {}
    for rid, r in roles.items():
        c = r["people"] * workdays * 100
        calendar[rid] = c
        capacity[rid] = c * factor // 1000
    demand = {rid: 0 for rid in roles}
    units = {rid: 0 for rid in roles}
    for d in cfg["demand"]:
        demand[d["role"]] += d["units"] * d["costPerUnit100"]
        units[d["role"]] += d["units"]
    rows = []
    for rid in sorted(roles):
        eff, dem = capacity[rid], demand[rid]
        rows.append({
            "role": rid, "people": roles[rid]["people"],
            "calendar100": calendar[rid], "effective100": eff,
            "demand100": dem, "units": units[rid],
            "utilPermille": dem * 1000 // eff if eff else 0,
        })
    cal_total = sum(calendar.values())
    eff_total = sum(capacity.values())
    dem_total = sum(demand.values())
    unit_total = sum(units.values())
    return {
        "project": cfg["project"], "workdays": workdays,
        "availabilityPermille": cfg["availabilityPermille"],
        "focusPermille": cfg["focusPermille"], "effectiveFactorPermille": factor,
        "calendarTotal100": cal_total, "effectiveTotal100": eff_total,
        "demandTotal100": dem_total, "unitTotal": unit_total,
        "gap100": dem_total - eff_total,
        "utilPermille": dem_total * 1000 // eff_total if eff_total else 0,
        "naiveUtilPermille": dem_total * 1000 // cal_total if cal_total else 0,
        "throughput100": unit_total * 10000 // eff_total if eff_total else 0,
        "avgCost100": dem_total // unit_total if unit_total else 0,
        "roles": rows,
    }


def main() -> int:
    cfg = json.load(open(CFG, encoding="utf-8"))
    rep = build_report(cfg)
    os.makedirs(OUT, exist_ok=True)
    with open(os.path.join(OUT, "ta14_capacity.json"), "w", encoding="utf-8") as f:
        json.dump(rep, f, ensure_ascii=False, indent=2, sort_keys=True)
        f.write("\n")
    print(f"factor={rep['effectiveFactorPermille']}permille "
          f"calendar100={rep['calendarTotal100']} "
          f"effective100={rep['effectiveTotal100']} demand100={rep['demandTotal100']}")
    print(f"util={rep['utilPermille']}permille naive={rep['naiveUtilPermille']}permille "
          f"gap100={rep['gap100']} throughput100={rep['throughput100']} "
          f"avgCost100={rep['avgCost100']}")
    for r in rep["roles"]:
        print(f"  {r['role']:5s} ppl={r['people']} effective100={r['effective100']} "
              f"demand100={r['demand100']} util={r['utilPermille']}permille units={r['units']}")
    print("wrote out/ta14_capacity.json")
    return 0


if __name__ == "__main__":
    sys.exit(main())

factor=595permille calendar100=6000 effective100=3570 demand100=3780
util=1058permille naive=630permille gap100=210 throughput100=120 avgCost100=87
  char  ppl=1 effective100=595 demand100=800 util=1344permille units=2
  env   ppl=2 effective100=1190 demand100=1720 util=1445permille units=16
  ui    ppl=2 effective100=1190 demand100=960 util=806permille units=24
  vfx   ppl=1 effective100=595 demand100=300 util=504permille units=1
wrote out/ta14_capacity.json