f8db4232ce
- 看板首页 / ：Zen Minimal × Future Organic 融合（用户裁定），编号索引+柔光光晕+GSAP克制动效，白皮书气质 - 素材库首页整体迁移至 /materials（含colocated测试），全站返回素材库链接同步清扫 - 组织架构页上移为顶层 /organization（保留云采石场契约注释），旧路径 /admin/org 服务端跳转；API 迁移 /api/organization（逻辑零改动） - 后台删除组织架构跳转按钮（白屏问题源头消失）；middleware 增 /materials 登录门、/organization 管理员门 - 品牌统一：浅色顶栏用 loginLogoUrl（深色图案版），标题「由壹点·品牌中心」；字体自托管 @fontsource - 可访问性收尾（评审fix项）：全文对比度过WCAG、焦点环、加载骨架防闪灰、移动端状态可见、::selection - PRODUCT.md/DESIGN.md 记录方向契约；测试基线 1815 通过/6 既有失败（无劣化）
4.2 KiB
4.2 KiB
Product
Platform
web
Stack
Next.js 14 (App Router) + React 18 + TypeScript + TailwindCSS + PostgreSQL(Prisma)。既有代码库已定栈。
Users
- 系统管理员：维护平台人员与组织数据，需要看到全量真实组织架构、人员归属、职级与汇报线。
- 部门负责人：查看本部门组织与人员情况（本部门范围内）。
- 用户为内部员工（非程序员），界面需日常语言、少术语、可直接读。
Product Purpose
把「由壹点3D素材库」逐步改造为「品牌中心部门看板」（对内品牌：由壹点·品牌中心，隶属由壹点软件集团）。第一阶段（2026-08-15）已完成：登录落点切换为看板首页 /，素材库整体迁至 /materials，组织架构上移为顶层 /organization（旧路径 /admin/org 服务端跳转）。
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-15 用户裁定）：Zen Minimal × Future Organic 融合——白纸(#fafafa)黑字(#1a1c1d)的瑞士编辑排印、发丝线、超大留白、编号索引列表（作品集语言）、右上角唯一柔紫光晕(#6e79c8 系)缓慢呼吸；平面化无阴影，黑实心按钮 8px 圆角。方向源自用户在 Stitch 自生成的候选 3/4 + 作品集文件夹两份 DESIGN.md（Monochrome/Studio Minimalist）。此前的「云采石场」语言仅保留在组织架构页（BoardShell），后续按新方向对齐。
- logo 双版本规则：黑底表面（素材库旧顶栏）用
headerLogoUrl（亮色图案）；浅底表面（看板首页、BoardShell）用loginLogoUrl（深蓝+橙图案）。两者内容不同，不可混用。 - 动效标准：略丰富但克制（用户既定），GSAP + matchMedia(prefers-reduced-motion) + fromTo + clearProps，200-500ms，信息效率优先。
Evidence on Hand
- 思维导图：
资料/品牌中心部门看板（初版）.jpg（5 大板块规划）。 - 交接文档：
docs/人员架构界面切换-交接文档-2026-08-14.md。 - 数据盘点：
scripts/diagnose-people-architecture.ts（只读，可重复跑）。
Product Principles
- 人员身份只认钉钉唯一值；姓名/邮箱仅人工排错，不自动建绑定。
- 只展示「有账号+绑定」的人，无账号的仓储/物流等不纳入统计。
- 在职判定用规范化
employmentState，UNKNOWN 视为在职（宁可多留）。 - 数据如实展示，不造假：主管/等级缺失就显示"未记录"。
- 归属与署名分离：素材归属与作者署名对不上通常是正确的，不"修正"。
Accessibility & Inclusion
内部后台工具，目标用户为内部员工；遵循基础可访问性（语义化、键盘可操作、对比度达标）。