交接文档：品牌中心部门看板 · 第一阶段框架已完成（2026-08-15）

接手须知：本阶段代码已提交推送（f8db423 + 6c6c282），本地 dev 验证通过，尚未部署生产。下一步是蓝绿部署上线。

一、全局目标（必读）

用户（魔礼红，效率部 AI 开发工程师，非程序员）的最终目标：把「由壹点3D素材库」改造成「品牌中心部门看板」，素材库降级为其中一个模块。参考思维导图 资料/品牌中心部门看板（初版）.jpg（五大板块：中心仪表盘/组织管理/资产与AI自动化/业务经营/治理与设置）。

当前阶段：第一阶段框架搭建已完成（骨架+视觉统一），五大板块中的两个已上线（创意资产库=原素材库、组织管理=人员架构页），其余三个为规划中占位。

二、本轮完成的工作（两个提交，44 文件）

提交 `f8db423` — 框架切换

登录落点切换为看板首页 /（素材库整体迁至 /materials）
组织架构上移 /organization（旧 /admin/org 服务端跳转；API 迁 /api/organization）
后台删除组织架构跳转按钮（白屏问题源头消失）
middleware 新增路由门禁（/materials 登录门、/organization 管理员门）
看板首页采用 Zen Minimal × Future Organic 融合视觉（用户从 Stitch 六候选中裁定 3+4 融合）

提交 `6c6c282` — 全站视觉统一 + 功能升级

登录页：品牌→「由壹点·品牌中心」，白皮书语言
作品过稿：头部换白皮书，返回→「返回创意资产库」
绩效考核：桌面+移动双头部换白皮书，改名「绩效考核」
组织架构页：BoardShell+页面 76 处调色板全量替换
admin 后台：MaterialsHeader（面包屑「治理与设置」），Tab 栏白皮书化
深色主题废弃：globals.css 移除 prefers-color-scheme 媒体查询；tailwind darkMode:'class' 且不挂 .dark → 全站 dark: 变体永久失效
个人中心→我的档案：API 合并权威人员档案（花名/工号/部门/职位/M-P等级/主管/状态），白皮书化
顶栏平台化：MaterialsHeader 双模式（首页=五板块导航+全套工具+菜单 / 板块=面包屑）；菜单重排+改名
排行榜：换白皮书皮肤
素材库改名「创意资产库」：全站同步
构建修复：tsconfig 排除 output/，存储边界门禁豁免 output/

三、技术要点

视觉系统（DESIGN.md 是唯一权威）

方向：Zen Minimal × Future Organic（白皮书语言）
令牌：白 #fafafa / 墨 #1a1c1d / 正文灰 #6b7075 / 注脚灰 #86898e / 发丝线 #e7e8ea / 柔紫 #6e79c8（唯一彩色氛围）/ 绿信号 #157a4b / 琥珀 #a0671c
logo 双版本：浅底表面用 loginLogoUrl（深蓝+橙图案），黑底表面用 headerLogoUrl（亮色图案），不可混用
动效：GSAP + matchMedia(prefers-reduced-motion) + fromTo + clearProps + scope；入场"对焦"（blur+tracking 揭幕）→ 线条绘制 → 内容落位；悬停"物理重量"（quint 缓动 350ms）
禁止：深色主题、渐变文字、玻璃拟态装饰、同尺寸卡片网格、大灰面

核心组件

组件	位置	用途
`MaterialsHeader`	`components/board/MaterialsHeader.tsx`	平台顶栏（双模式）；含面包屑/淘宝搜索/内外网/性能监控/用户菜单
`BoardShell`	`components/board/BoardShell.tsx`	组织页专用壳（已换白皮书调色板）
`RankingPanel`	`components/RankingPanel.tsx`	排行榜悬浮窗（已换肤）
旧 `Header`	`components/Header.tsx`	仅剩 share/edit 页使用，菜单名已同步

权威人员架构（人员地基）

绑定：UserEmployeeBinding → PerformanceSurveyEmployeeProfile（钉钉唯一值）
查询：lib/employee-directory.ts 的 getEmployeeByUserId(userId)
每日同步：instrumentation.ts 调度（02:00 Asia/Shanghai）
未绑定账号（约 17-18 个无钉钉 ID）在个人档案页显示优雅降级提示

四、剩余工作（优先级排序）

🔴 蓝绿部署上线（代码只在本地，生产 sc.jiansun.vip 还是旧版）
- 本地 docker build → scp 到生产机 → 起待命容器 → 健康检查 → 切 nginx → 验收
- 部署后补跑 sync-organization.ts --apply（串档修复对存量生效）
- 部署前删除临时预览路由 app/board-preview/ 和 app/profile-preview/
- 详见 CLAUDE.md「生产实际部署形态」
🟡 分享页 /share/[id] 和编辑页 /edit/[id]：唯一还穿旧衣服的页面（对外/半对外，需单独评估后再统一）
🟡 品牌维度建模：六品牌（朴美/素菲亚/顾家/欧意朗/卓禾/亿家达）在代码里没有权威建档，仪表盘和业务经营板块依赖它
🟡 权限体系：DEPT_ADMIN 部门范围用旧 managedDepartment 字符串匹配，匹配不到降级看全部（已知问题）
🔵 阶段二：看板本身（仪表盘真实指标、业务经营流程、治理与设置功能）

五、用户工作偏好（必须遵守）

用户是非程序员，"做完了"意味着他在界面上能看到变化，不是后端数据对了
每改一处让他实际打开页面确认，不笼统说"完成"
视觉标准极高（视觉部门的门面必须有设计感），多轮被否后才通过白皮书方向
动效"略丰富但克制"，信息效率优先
前端工作必须走 $impeccable Skill + GSAP 官方 Skill（用户强令）
分清提交：不同对话的改动分开 commit，不混 git add .
凭据安全：绝不把密码写进 docs/代码/对话记录

六、快速上手

# 本地开发（注意 .env 连的就是生产库，跑脚本=动生产）
npm run dev

# 只读盘点人员数据
npx tsx scripts/diagnose-people-architecture.ts

# 组织同步（默认预演，--apply 才写）
npx tsx --env-file=.env scripts/sync-organization.ts

# 测试（基线：1815 通过 / 6 既有失败）
npm test

# SSH 到生产机（不是 prod，是 gongxiangp2-prod-legacy-freenas）
ssh gongxiangp2-prod-legacy-freenas

七、本次会话的关键决策记录

决策	内容	用户原话/背景
登录落点	`/` 让位给看板，素材库迁 `/materials`	"直接进品牌中心看板骨架"
视觉方向	Zen Minimal × Future Organic（Stitch 候选 3+4）	经历 4 版被否 + Stitch 6 候选评审
板块排序	01 创意资产库（全员）→ 02 组织管理（管理员）	"素材库可以放到组织管理的位置"
改名	素材库→创意资产库 / 个人中心→我的档案 / 考核调研→绩效考核 / 系统设置→治理与设置	用户逐个确认
深色主题	废弃，全站浅色单主题	"现在不需要有深色的主题了"
首页施工信息	移除（阶段说明/已落成等），只留定位语	"这个页面是面对用户的"
logo	浅底用 loginLogoUrl，黑底用 headerLogoUrl	用户提醒有两版 logo
顶栏工具	非素材库独有的功能全部升到首页	"只要不是素材库这个功能独有的都放到首页去"

7.2 KiB Raw Permalink Blame History Unescape Escape