chengkai3
79 lines
4.0 KiB
Markdown
79 lines
4.0 KiB
Markdown
## Work Log - 后台首页按 Ant Design 规范优化（2026-04-27）
|
||
|
||
- 背景：
|
||
- 用户要求“按照 ant design 规范优化页面”。
|
||
- 本次按最小闭环默认命中后台首页 `/admin`，不改接口、权限与路由，仅优化页面组织与组件用法。
|
||
|
||
- 本次改动：
|
||
- `web/src/app/admin/page.tsx`
|
||
- 新增模块分组筛选：使用 `Segmented` 展示“全部 + 各业务分类”并联动卡片列表。
|
||
- 新增筛选结果统计：在顶部统计区增加“筛选结果”卡片。
|
||
- 卡片内容结构标准化：模块卡片改为 `Card.Meta + Typography.Paragraph(ellipsis) + Tag`，信息层级更符合 AntD 卡片模式。
|
||
- 加入分类色标映射（`CATEGORY_COLORS`），保持类别可读性。
|
||
- 保留仓库既有 `Card` 类型兼容方案（`AntCard` 强转），并扩展 `Meta` 子组件，兼容 React 19 + 当前 AntD 类型约束。
|
||
- 权限逻辑不变：仍由 `visible(hasPermission)` 决定模块可见性。
|
||
|
||
- AntD CLI 校验（按技能要求）：
|
||
- 变更前 API 查询（JSON）：
|
||
- `info Card/Grid/Statistic/Typography/Tag/Avatar/Empty/Space/Segmented/Badge/Flex --format json`
|
||
- 变更后规范检查：
|
||
- `npx @ant-design/cli lint web/src/app/admin/page.tsx --format json` -> 无问题（`total=0`）。
|
||
|
||
- 验证：
|
||
- `npm --workspace web exec tsc --noEmit --pretty false` -> 通过。
|
||
|
||
- 风险与影响：
|
||
- 影响范围仅前端后台首页展示层（`/admin`）。
|
||
- 未改动后端接口、RBAC、菜单数据与路由注册，功能行为保持不变。
|
||
|
||
## Work Log - 左侧菜单收缩按钮下沉到左下角并补齐菜单图标（2026-04-27）
|
||
|
||
- 背景：
|
||
- 用户要求“左侧菜单收缩按钮放到左下角，给菜单都配上图标”。
|
||
|
||
- 本次改动：
|
||
- `web/src/app/admin/layout.tsx`
|
||
- 桌面端收缩按钮从顶部 `Header` 移除，改为侧栏底部按钮（左下角）。
|
||
- 侧栏菜单构建函数新增图标注入：优先使用后端 `menu.icon`，其次按 `menu.path` 回退，最后按“目录/叶子”使用默认图标兜底，确保每个菜单都有图标。
|
||
- 增加默认菜单图标映射，覆盖当前 seed 中 `LayoutDashboard/Users/ShieldCheck/MenuSquare/Settings2/Network/Zap/Map/RadarChart/Experiment/FolderTree/FileText/Terminal`。
|
||
- `web/src/app/globals.css`
|
||
- 侧栏改为“菜单区域滚动 + 底部按钮固定”布局，保证按钮稳定停靠在左下角且不挤占菜单可视区。
|
||
|
||
- AntD CLI 校验（按技能要求）：
|
||
- 变更前 API 查询（JSON）：
|
||
- `info Layout/Menu/Button --format json`
|
||
- 变更后规范检查：
|
||
- `npx @ant-design/cli lint web/src/app/admin/layout.tsx --format json` -> 无问题（`total=0`）。
|
||
|
||
- 验证：
|
||
- `npm --workspace web exec tsc --noEmit --pretty false` -> 通过。
|
||
|
||
- 风险与影响：
|
||
- 仅影响后台壳层导航展示与交互，不改动路由、权限与接口数据结构。
|
||
- 若后端返回了未收录的新 `menu.icon` 字符串，会走路径或通用兜底图标，不会出现“无图标”空位。
|
||
|
||
## Work Log - 打包更新镜像并重启（2026-04-27）
|
||
|
||
- 背景：
|
||
- 用户要求“打包更新镜像并重启”。
|
||
|
||
- 本次执行：
|
||
- `docker compose build`
|
||
- `docker compose up -d`
|
||
|
||
- 验证：
|
||
- `docker compose ps`
|
||
- `api/web/celery-worker/celery-beat/db/redis/minio` 均为 `Up`，其中 `api/db/redis` 为 `healthy`。
|
||
- `curl -fsS http://127.0.0.1:8000/health`
|
||
- 返回 `{"status":"ok","service":"fquiz-api","version":"0.1.0"}`。
|
||
- `curl -I -fsS http://127.0.0.1:3000/`
|
||
- 返回 `HTTP/1.1 200 OK`。
|
||
- `docker compose logs --tail=80 api/web/celery-worker/celery-beat`
|
||
- API 启动完成且 `/health` 返回 200。
|
||
- Web Ready。
|
||
- Celery worker/beat 启动并连接 Redis。
|
||
|
||
- 风险与影响：
|
||
- 发布过程中重建并重启了 `api/web/celery-worker/celery-beat`，存在短时服务切换窗口。
|
||
- Celery worker 存在既有 root 运行告警（非本次新增），当前服务可用。
|