docs: project docs, scripts, deployment configs, and evidence

.workbuddy/memory/2026-03-20.md

@@ -0,0 +1,120 @@
+# 前端开发工作日志
+
+## 2026-03-20
+
+### 项目检查
+
+今天检查了用户管理系统（UMS）Admin 前端的开发状态：
+
+**技术栈**：
+- React 19 + TypeScript + Vite
+- Ant Design 6 组件库
+- React Router DOM 7
+- Day.js 日期处理
+
+**已完成功能**：
+1. 认证模块
+   - 登录页面（密码登录、邮箱验证码、短信验证码）
+   - 忘记密码页面
+   - 密码重置页面
+   
+2. 布局系统
+   - AdminLayout（侧边栏导航、顶栏、面包屑）
+   - AuthLayout（登录页布局）
+   - 响应式设计支持
+
+3. 用户管理模块
+   - 用户列表、筛选、分页
+   - 用户详情抽屉
+   - 用户编辑抽屉
+   - 角色分配弹窗
+   - 用户状态管理（激活/禁用/删除）
+
+4. 权限管理模块
+   - 角色管理页面
+   - 权限管理页面
+
+5. 日志模块
+   - 登录日志页面
+   - 操作日志页面
+
+6. 集成功能
+   - Webhooks 页面
+   - 导入导出页面
+
+7. 个人中心
+   - 个人资料页面
+   - 安全设置页面（TOTP 2FA）
+
+8. 基础设施
+   - HTTP 客户端（Token 刷新、并发锁、错误处理）
+   - 认证状态管理（AuthProvider）
+   - 主题系统（Design Tokens + Ant Design 主题）
+   - 路由守卫（RequireAuth、RequireAdmin）
+   - 全局样式和响应式布局
+
+### 项目状态
+
+项目前端已经相当完整，开发服务器可以正常启动（端口 3000）。
+
+### 优化修复
+
+- 修复 index.html 的标题为"用户管理系统"
+- 修复 HTML lang 属性为"zh-CN"
+- 构建检查通过，无 TypeScript 错误
+
+### M10-M11 功能开发
+
+根据前端计划文档，完成以下剩余功能：
+
+1. **types/device.ts** - 创建设备类型定义
+2. **services/profile.ts** - 创建个人资料服务（密码、TOTP、头像等）
+3. **services/devices.ts** - 创建设备管理服务
+4. **ProfilePage.tsx** - 实现个人资料页面（查看/编辑资料、头像上传）
+5. **ProfileSecurityPage.tsx** - 实现安全设置页面（修改密码、TOTP双因素、设备管理）
+6. **ImportExportPage.tsx** - 实现导入导出页面（Excel导入、导出、模板下载）
+
+所有页面已实现完整功能，构建测试通过。
+
+### 前端质量改进
+
+根据质量测试报告，完成以下改进：
+
+1. **单元测试配置** - 配置 Vitest + React Testing Library
+   - 安装测试依赖：vitest、@testing-library/react、jsdom 等
+   - 创建 vitest.config.ts 配置文件
+   - 创建测试设置文件和工具函数测试
+
+2. **可访问性增强** - 添加 Skip to main content 链接
+   - 在 AdminLayout 添加键盘可访问的跳过链接
+   - 添加 main-content id 到主要内容区域
+   - 添加相应的 CSS 样式
+
+3. **响应式优化** - 移动端侧边栏改为抽屉式导航
+   - 添加移动端检测（< 768px）
+   - 移动端使用 Drawer 抽屉替代固定侧边栏
+   - 保留桌面端的折叠功能
+
+4. **E2E 测试配置** - 添加 Playwright
+   - 创建 playwright.config.ts 配置文件
+   - 创建登录页面 E2E 测试（login.spec.ts）
+   - 创建响应式设计 E2E 测试（navigation.spec.ts）
+   - 安装 Chromium 浏览器
+
+### 前后端集成
+
+**后端**：
+- Go 后端服务运行在端口 8080
+- 数据库：SQLite（./data/user_management.db）
+- 健康检查：/health
+
+**前端**：
+- Vite 开发服务器运行在端口 3000
+- API 代理配置：/api -> http://localhost:8080
+
+**API 端点验证**：
+- ✅ GET /health - 健康检查正常
+- ✅ POST /api/v1/auth/login - 代理正常（返回后端响应）
+- ✅ GET /api/v1/users - 代理正常（返回 401 未授权）
+
+**注意**：由于配置文件中 admin 密码为空，需要通过注册或数据库初始化创建用户。