docs: 第一阶段交接文档（2026-08-15）
This commit is contained in:
chenpei
parent
6c6c282203
commit
cc6f6578be
126
docs/品牌中心看板第一阶段-交接文档-2026-08-15.md
Normal file
126
docs/品牌中心看板第一阶段-交接文档-2026-08-15.md
Normal file
@ -0,0 +1,126 @@
|
||||
# 交接文档：品牌中心部门看板 · 第一阶段框架已完成（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）在个人档案页显示优雅降级提示
|
||||
|
||||
---
|
||||
|
||||
## 四、剩余工作（优先级排序）
|
||||
|
||||
1. **🔴 蓝绿部署上线**（代码只在本地，生产 sc.jiansun.vip 还是旧版）
|
||||
- 本地 `docker build` → scp 到生产机 → 起待命容器 → 健康检查 → 切 nginx → 验收
|
||||
- 部署后补跑 `sync-organization.ts --apply`（串档修复对存量生效）
|
||||
- 部署前删除临时预览路由 `app/board-preview/` 和 `app/profile-preview/`
|
||||
- 详见 CLAUDE.md「生产实际部署形态」
|
||||
|
||||
2. **🟡 分享页 `/share/[id]` 和编辑页 `/edit/[id]`**：唯一还穿旧衣服的页面（对外/半对外，需单独评估后再统一）
|
||||
|
||||
3. **🟡 品牌维度建模**：六品牌（朴美/素菲亚/顾家/欧意朗/卓禾/亿家达）在代码里没有权威建档，仪表盘和业务经营板块依赖它
|
||||
|
||||
4. **🟡 权限体系**：DEPT_ADMIN 部门范围用旧 `managedDepartment` 字符串匹配，匹配不到降级看全部（已知问题）
|
||||
|
||||
5. **🔵 阶段二：看板本身**（仪表盘真实指标、业务经营流程、治理与设置功能）
|
||||
|
||||
---
|
||||
|
||||
## 五、用户工作偏好（必须遵守）
|
||||
|
||||
- 用户是非程序员，**"做完了"意味着他在界面上能看到变化**，不是后端数据对了
|
||||
- 每改一处让他实际打开页面确认，不笼统说"完成"
|
||||
- **视觉标准极高**（视觉部门的门面必须有设计感），多轮被否后才通过白皮书方向
|
||||
- 动效"略丰富但克制"，信息效率优先
|
||||
- 前端工作必须走 `$impeccable` Skill + GSAP 官方 Skill（用户强令）
|
||||
- 分清提交：不同对话的改动分开 commit，不混 `git add .`
|
||||
- 凭据安全：绝不把密码写进 docs/代码/对话记录
|
||||
|
||||
---
|
||||
|
||||
## 六、快速上手
|
||||
|
||||
```bash
|
||||
# 本地开发（注意 .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 |
|
||||
| 顶栏工具 | 非素材库独有的功能全部升到首页 | "只要不是素材库这个功能独有的都放到首页去" |
|
||||
Loading…
x
Reference in New Issue
Block a user