Found while working #729(PR #1010)。PR #1010 修的是同一页上紧邻的一行(对象数 13 → 17),这一行是修那一行时看见的,属另一类缺陷(不只是数字旧,架构描述也已被取消),故不搭车,单独记录。
现象
content/docs/getting-started/introduction.mdx:58(及 .zh-Hans:58 / .zh-Hant:54)在「What ships in the box / 你第一天拿到的系统已经包含」清单里写:
- en:
- **A 10-role hierarchy** mapped to typical sales / service / marketing org structures.
- zh-Hans:
- **10 级角色层级**,映射到典型的销售 / 服务 / 市场营销组织结构。
- zh-Hant:
- **10 級角色層級**,映射到典型的銷售 / 服務 / 市場行銷組織結構。
两处都不对:
- 数字:
src/sharing/positions.ts 的 CrmPositions 有 12 项,pnpm validate 摘要也报 Security: 12 Positions 6 Permissions。README 写的就是 12。
- 架构:
objectstack.config.ts:130-132 明确注明 —— ADR-0090 D3: positions are flat capability-distribution groups — the v1 role hierarchy's parent links are gone (hierarchy belongs to the business-unit tree, which this app does not model). 也就是说 position 之间已经没有层级了。这一页仍然把它当作一棵「层级」卖给读者,而且是在 getting-started 面上 —— 新用户对这个应用的第一印象。
第 2 点比第 1 点严重:把 12 改成 10 之外,「hierarchy / 层级」这个词本身就描述了一个已经不存在的结构。同一页往下 content/docs/index.mdx:70 的 role hierarchy / 角色层级 一格可能是同一处残留,一并核对。
复现
cd /home/user/hotcrm
grep -n 'role hierarchy\|角色层级\|角色層級' content/docs/getting-started/introduction*.mdx content/docs/index*.mdx
grep -c 'name:' src/sharing/positions.ts # => 12
pnpm validate | grep Security # => Security: 12 Positions 6 Permissions
sed -n '130,133p' objectstack.config.ts # => ADR-0090 D3,层级已取消
建议
按 ADR-0090 的实际形态重写这一条(例如「12 个岗位(position),按销售 / 服务 / 市场职能分组,用于分发权限」),三个语言面同改,并核对 content/docs/index.mdx 安全一行的同类措辞。
守卫方面:PR #1010 新增的计数守卫覆盖 objects / flows / dashboards / datasets,未覆盖 positions —— 若这一单改完,把 positions 加进那条规则的 CLAIMS/REGISTERED 即可(期望值是运行时从注册 stack 现读的,不需要硬编码)。但「hierarchy 这个词该不该出现」不是计数守卫能管的,属措辞层面。
Filed unassigned。
Found while working #729(PR #1010)。PR #1010 修的是同一页上紧邻的一行(对象数 13 → 17),这一行是修那一行时看见的,属另一类缺陷(不只是数字旧,架构描述也已被取消),故不搭车,单独记录。
现象
content/docs/getting-started/introduction.mdx:58(及.zh-Hans:58/.zh-Hant:54)在「What ships in the box / 你第一天拿到的系统已经包含」清单里写:- **A 10-role hierarchy** mapped to typical sales / service / marketing org structures.- **10 级角色层级**,映射到典型的销售 / 服务 / 市场营销组织结构。- **10 級角色層級**,映射到典型的銷售 / 服務 / 市場行銷組織結構。两处都不对:
src/sharing/positions.ts的CrmPositions有 12 项,pnpm validate摘要也报Security: 12 Positions 6 Permissions。README 写的就是 12。objectstack.config.ts:130-132明确注明 ——ADR-0090 D3: positions are flat capability-distribution groups — the v1 role hierarchy's parent links are gone (hierarchy belongs to the business-unit tree, which this app does not model).也就是说 position 之间已经没有层级了。这一页仍然把它当作一棵「层级」卖给读者,而且是在 getting-started 面上 —— 新用户对这个应用的第一印象。第 2 点比第 1 点严重:把 12 改成 10 之外,「hierarchy / 层级」这个词本身就描述了一个已经不存在的结构。同一页往下
content/docs/index.mdx:70的role hierarchy/角色层级一格可能是同一处残留,一并核对。复现
建议
按 ADR-0090 的实际形态重写这一条(例如「12 个岗位(position),按销售 / 服务 / 市场职能分组,用于分发权限」),三个语言面同改,并核对
content/docs/index.mdx安全一行的同类措辞。守卫方面:PR #1010 新增的计数守卫覆盖 objects / flows / dashboards / datasets,未覆盖 positions —— 若这一单改完,把 positions 加进那条规则的
CLAIMS/REGISTERED即可(期望值是运行时从注册 stack 现读的,不需要硬编码)。但「hierarchy 这个词该不该出现」不是计数守卫能管的,属措辞层面。Filed unassigned。