1.2 角色分工与职责矩阵

{
  "version": 1,
  "project": "stardust-inn",
  "note": "角色职责矩阵（RACI）。accountable=最终拍板（每行唯一，禁双主）；responsible=执行；consulted=会签；informed=知会。这是「谁判定」的唯一真源：P 层 TS 内核必须与本表逐行一致，漂移即测试失败。口径为可复现的组织模型；真实团队职责划分需真实生产环境，命令行不可复现（X）。",
  "rows": [
    { "deliverable": "style-guide", "accountable": "art-director", "responsible": ["concept-artist"], "consulted": ["lead-artist", "tech-artist"], "informed": ["art-pm", "engineer"] },
    { "deliverable": "concept-art", "accountable": "lead-artist", "responsible": ["concept-artist"], "consulted": ["art-director"], "informed": ["art-pm"] },
    { "deliverable": "3d-model", "accountable": "lead-artist", "responsible": ["modeler"], "consulted": ["tech-artist"], "informed": ["art-pm"] },
    { "deliverable": "texture", "accountable": "lead-artist", "responsible": ["texture-artist"], "consulted": ["tech-artist"], "informed": ["art-pm"] },
    { "deliverable": "animation", "accountable": "lead-artist", "responsible": ["animator"], "consulted": ["tech-artist", "engineer"], "informed": ["art-pm"] },
    { "deliverable": "ui-kit", "accountable": "lead-artist", "responsible": ["ui-artist"], "consulted": ["art-director", "engineer"], "informed": ["art-pm"] },
    { "deliverable": "vfx", "accountable": "tech-artist", "responsible": ["vfx-artist"], "consulted": ["engineer"], "informed": ["art-pm"] },
    { "deliverable": "asset-manifest", "accountable": "tech-artist", "responsible": ["tech-artist"], "consulted": ["lead-artist"], "informed": ["art-pm", "engineer"] },
    { "deliverable": "outsource-batch", "accountable": "art-pm", "responsible": ["art-pm"], "consulted": ["lead-artist", "tech-artist"], "informed": ["art-director"] }
  ]
}

// file: core/src/sp01/roles.ts
// tier: P
// verify: node --test 'core/test/sp01_*.test.ts'
// 角色分工与职责矩阵：把「交付物」映射到唯一拍板角色（RACI 里的 A），并列出执行/会签/知会。
// 关键不变量：任何交付物只能有一个拍板角色（禁双主），且拍板角色不得出现在自己的会签列表里。
// 只允许可擦除 TS 语法（禁 enum / namespace / 参数属性 / 装饰器）。

export type RoleId =
  | "art-director" | "lead-artist" | "concept-artist" | "modeler"
  | "texture-artist" | "animator" | "ui-artist" | "vfx-artist"
  | "tech-artist" | "art-pm" | "engineer";

export const ROLE_IDS: RoleId[] = [
  "art-director", "lead-artist", "concept-artist", "modeler", "texture-artist",
  "animator", "ui-artist", "vfx-artist", "tech-artist", "art-pm", "engineer",
];

export type MatrixRow = {
  deliverable: string;
  accountable: RoleId;   // A：最终拍板
  responsible: RoleId[]; // R：执行
  consulted: RoleId[];   // C：会签
  informed: RoleId[];    // I：知会
};

export const MATRIX: MatrixRow[] = [
  { deliverable: "style-guide", accountable: "art-director", responsible: ["concept-artist"], consulted: ["lead-artist", "tech-artist"], informed: ["art-pm", "engineer"] },
  { deliverable: "concept-art", accountable: "lead-artist", responsible: ["concept-artist"], consulted: ["art-director"], informed: ["art-pm"] },
  { deliverable: "3d-model", accountable: "lead-artist", responsible: ["modeler"], consulted: ["tech-artist"], informed: ["art-pm"] },
  { deliverable: "texture", accountable: "lead-artist", responsible: ["texture-artist"], consulted: ["tech-artist"], informed: ["art-pm"] },
  { deliverable: "animation", accountable: "lead-artist", responsible: ["animator"], consulted: ["tech-artist", "engineer"], informed: ["art-pm"] },
  { deliverable: "ui-kit", accountable: "lead-artist", responsible: ["ui-artist"], consulted: ["art-director", "engineer"], informed: ["art-pm"] },
  { deliverable: "vfx", accountable: "tech-artist", responsible: ["vfx-artist"], consulted: ["engineer"], informed: ["art-pm"] },
  { deliverable: "asset-manifest", accountable: "tech-artist", responsible: ["tech-artist"], consulted: ["lead-artist"], informed: ["art-pm", "engineer"] },
  { deliverable: "outsource-batch", accountable: "art-pm", responsible: ["art-pm"], consulted: ["lead-artist", "tech-artist"], informed: ["art-director"] },
];

export function accountableFor(deliverable: string): RoleId | null {
  const row = MATRIX.find((r) => r.deliverable === deliverable);
  return row ? row.accountable : null;
}

/** 单行检查：返回该行的冲突（空数组即无冲突）。 */
export function checkRow(row: MatrixRow): string[] {
  const out: string[] = [];
  if (!ROLE_IDS.includes(row.accountable)) out.push(`${row.deliverable}: 未知拍板角色 ${row.accountable}`);
  if (row.consulted.includes(row.accountable)) out.push(`${row.deliverable}: 拍板角色不应同时是会签`);
  if (row.responsible.length === 0) out.push(`${row.deliverable}: 缺执行角色`);
  return out;
}

/** 全表检查：逐行冲突 + 交付物名唯一。 */
export function conflicts(): string[] {
  const out: string[] = [];
  const seen = new Set<string>();
  for (const row of MATRIX) {
    if (seen.has(row.deliverable)) out.push(`${row.deliverable}: 交付物名重复`);
    seen.add(row.deliverable);
    out.push(...checkRow(row));
  }
  return out;
}

// file: core/test/sp01_roles.test.ts
// tier: P
// verify: node --test 'core/test/sp01_*.test.ts'
// 职责矩阵断言：D 层配置与 TS 内核逐行一致、全表无冲突、每个交付物有唯一拍板角色。
// 负例：把拍板角色塞进自己的会签列表，checkRow 必须抓到。
import test from "node:test";
import assert from "node:assert/strict";
import { readFileSync } from "node:fs";
import { dirname, resolve } from "node:path";
import { fileURLToPath } from "node:url";
import { MATRIX, ROLE_IDS, accountableFor, checkRow, conflicts } from "../src/sp01/roles.ts";
import type { MatrixRow } from "../src/sp01/roles.ts";

const HERE = dirname(fileURLToPath(import.meta.url));
const ROOT = resolve(HERE, "../..");
const cfg = JSON.parse(readFileSync(resolve(ROOT, "config/sp01_matrix.json"), "utf8"));

test("D 层矩阵配置与 TS 内核逐行一致（防漂移）", () => {
  assert.equal(cfg.rows.length, MATRIX.length);
  assert.deepEqual(MATRIX, cfg.rows);
});

test("职责矩阵全表无冲突", () => {
  assert.deepEqual(conflicts(), []);
});

test("每个交付物有唯一拍板角色，且都在角色表内", () => {
  const seen = new Set<string>();
  for (const row of MATRIX) {
    assert.equal(seen.has(row.deliverable), false, `${row.deliverable} 重复`);
    seen.add(row.deliverable);
    assert.ok(ROLE_IDS.includes(row.accountable), `${row.accountable} 不在角色表`);
  }
  assert.equal(accountableFor("style-guide"), "art-director");
  assert.equal(accountableFor("asset-manifest"), "tech-artist");
  assert.equal(accountableFor("不存在的交付物"), null);
});

test("风格与规格的拍板权不在同一角色（避免双主）", () => {
  assert.notEqual(accountableFor("style-guide"), accountableFor("asset-manifest"));
});

test("负例：拍板角色同时出现在会签列表必须被抓到", () => {
  const bad: MatrixRow = {
    deliverable: "style-guide",
    accountable: "art-director",
    responsible: ["concept-artist"],
    consulted: ["lead-artist", "art-director"],
    informed: ["art-pm"],
  };
  const errs = checkRow(bad);
  assert.ok(errs.length > 0, "预期报冲突，实际无");
  assert.ok(errs.some((e) => e.includes("会签")), errs.join("|"));
});

test("负例：未知拍板角色必须被抓到", () => {
  const bad: MatrixRow = {
    deliverable: "x",
    accountable: "not-a-role" as never,
    responsible: ["modeler"],
    consulted: [],
    informed: [],
  };
  assert.ok(checkRow(bad).some((e) => e.includes("未知拍板角色")));
});

✔ D 层矩阵配置与 TS 内核逐行一致（防漂移） (1.077583ms)
✔ 职责矩阵全表无冲突 (0.132917ms)
✔ 每个交付物有唯一拍板角色，且都在角色表内 (0.157042ms)
✔ 风格与规格的拍板权不在同一角色（避免双主） (0.073958ms)
✔ 负例：拍板角色同时出现在会签列表必须被抓到 (0.818916ms)
✔ 负例：未知拍板角色必须被抓到 (0.580125ms)
ℹ tests 6
ℹ pass 6
ℹ fail 0