3.4 KiB
3.4 KiB
Product
Platform
web
Stack
Next.js 14 (App Router) + React 18 + TypeScript + TailwindCSS + PostgreSQL(Prisma)。既有代码库已定栈。
Users
- 系统管理员：维护平台人员与组织数据，需要看到全量真实组织架构、人员归属、职级与汇报线。
- 部门负责人：查看本部门组织与人员情况（本部门范围内）。
- 用户为内部员工（非程序员），界面需日常语言、少术语、可直接读。
Product Purpose
把「由壹点3D素材库」逐步改造为「品牌中心部门看板」。当前阶段是人员架构地基的界面收尾：让后台界面真实展示 HR 花名册的组织结构（此前界面仍显示旧的 28 个手工部门，与权威组织树不一致）。
Positioning
以钉钉唯一值为唯一人员身份判定依据，统一接入公司 HR 报表库（非钉钉通讯录），人员/组织数据全平台一致；考核调研与素材库共用同一份权威人员主档，业务特殊数据隔离在各自专属表。
Operating Context
- 人员权威数据源：公司 SQL Server 报表库（
rptschema），每日 02:00（Asia/Shanghai）自动同步组织架构→在职状态→离职联动。 - 只有「开过素材库账号 + 已建立钉钉绑定」的人员进入展示/统计体系（约 503 人）；无账号的仓储/物流等约 1200 人不纳入。
- 在职判定用规范化
employmentState（ACTIVE/RESIGNED/UNKNOWN，UNKNOWN 视为在职），不用关键词匹配。
Capabilities and Constraints
- 组织架构页：组织树 + 人员列表，展示 M/P 等级、人员归属（部门路径）、直属主管、在职状态。
- 纯展示（只读），不改数据。
- 权限：系统管理员看全部；部门负责人看本部门。
- 离职人员默认隐藏，可切换「含离职」。
- 无绑定账号（无钉钉 ID，约 15 人）与部门未确定人员（约 57 人）单独分组，不消失、不硬塞部门。
- 数据缺口如实展示：直属主管覆盖率低（约 158/503）、部分人员无 M/P 等级。
Brand Commitments
- 平台名：由壹点3D素材库（改造中为品牌中心部门看板）。
- 视觉方向（2026-08-14 由用户从概念骰子中选定）：「云采石场」——浅色工业风，蓝白主调、石材切割纹理、工程数据卡片、层叠结构。首个应用面：组织架构页；确认后逐步推广到全平台。用户选择替代脚本分配的"深海潜水"方向。
Evidence on Hand
- 思维导图：
资料/品牌中心部门看板（初版）.jpg（5 大板块规划）。 - 交接文档：
docs/人员架构界面切换-交接文档-2026-08-14.md。 - 数据盘点：
scripts/diagnose-people-architecture.ts（只读，可重复跑）。
Product Principles
- 人员身份只认钉钉唯一值；姓名/邮箱仅人工排错，不自动建绑定。
- 只展示「有账号+绑定」的人，无账号的仓储/物流等不纳入统计。
- 在职判定用规范化
employmentState，UNKNOWN 视为在职（宁可多留）。 - 数据如实展示，不造假：主管/等级缺失就显示"未记录"。
- 归属与署名分离：素材归属与作者署名对不上通常是正确的，不"修正"。
Accessibility & Inclusion
内部后台工具，目标用户为内部员工；遵循基础可访问性（语义化、键盘可操作、对比度达标）。