# ZJPB v3.0 版本更新日志 **发布日期：** 2025-02-06 **版本代号：** User System **重要程度：** 🔴 重大更新 --- ## 🎯 核心功能 ### 1. 用户系统 (User System) #### ✨ 用户注册与登录 - 用户注册功能（用户名 + 密码） - 用户登录/登出 - 多用户类型支持（Admin 和 User 分离） - 会话管理和状态持久化 #### ⭐ 工具收藏功能 - 一键收藏/取消收藏工具 - 收藏状态实时同步 - 收藏按钮视觉反馈（未收藏/已收藏状态） - 未登录用户引导登录 #### 📁 收藏分组管理 - 创建自定义文件夹 - 文件夹增删改查 - 收藏移动到不同文件夹 - 文件夹图标自定义 #### 👤 用户中心 - 个人资料展示 - 收藏统计（收藏数、文件夹数） - 最近收藏列表 - 收藏列表页面（网格展示 + 分页） --- ## 🗄️ 数据库变更 ### 新增表 **users（用户表）** ```sql - id: 主键 - username: 用户名（唯一，索引） - password_hash: 密码哈希 - email: 邮箱（可选，唯一，索引） - avatar: 头像URL - bio: 个人简介 - is_active: 是否启用 - is_public_profile: 是否公开资料 - created_at: 创建时间 - last_login: 最后登录时间 ``` **folders（收藏分组表）** ```sql - id: 主键 - user_id: 用户ID（外键，索引） - name: 文件夹名称 - description: 描述 - icon: 图标emoji - sort_order: 排序权重 - is_public: 是否公开 - public_slug: 公开链接标识（唯一，索引） - created_at: 创建时间 - 唯一约束: (user_id, name) ``` **collections（收藏记录表）** ```sql - id: 主键 - user_id: 用户ID（外键，索引） - site_id: 网站ID（外键，索引） - folder_id: 文件夹ID（外键，索引，可选） - note: 备注 - created_at: 创建时间 - updated_at: 更新时间 - 唯一约束: (user_id, site_id, folder_id) - 复合索引: (user_id, folder_id) ``` --- ## 🔌 API 端点 ### 认证 API ``` POST /register - 用户注册 POST /login - 用户登录 GET /logout - 用户登出 GET /api/auth/status - 获取登录状态 ``` ### 收藏 API（需登录） ``` POST /api/collections/toggle - 收藏/取消收藏 GET /api/collections/status/:code - 查询收藏状态 GET /api/collections/list - 获取收藏列表 PUT /api/collections/:id/note - 更新收藏备注 PUT /api/collections/:id/move - 移动收藏 ``` ### 文件夹 API（需登录） ``` GET /api/folders - 获取文件夹列表 POST /api/folders - 创建文件夹 PUT /api/folders/:id - 更新文件夹 DELETE /api/folders/:id - 删除文件夹 ``` ### 用户中心 ``` GET /user/profile - 用户中心主页 GET /user/collections - 收藏列表页面 PUT /api/user/profile - 更新用户资料 ``` --- ## 🎨 前端更新 ### 新增页面 1. **用户注册页面** (`/register`) - Tailwind CSS 设计 - 表单验证 - 密码可见性切换 2. **用户登录页面** (`/login`) - 与管理员登录页面风格一致 - 支持 next 参数跳转 3. **用户中心** (`/user/profile`) - 侧边栏导航 - 统计卡片 - 最近收藏展示 4. **收藏列表** (`/user/collections`) - 文件夹标签切换 - 工具网格展示 - 分页支持 - 空状态提示 ### 界面优化 - **导航栏**：登录后显示用户头像和下拉菜单 - **工具详情页**：添加收藏按钮（带动画效果） - **响应式设计**：所有新页面支持移动端 --- ## 🔒 安全增强 ### 权限隔离 - ✅ Admin 和 User 完全分离 - ✅ 普通用户无法访问管理后台 - ✅ 管理员无法使用收藏功能 - ✅ 所有管理员 API 添加权限检查 ### 受保护的路由（共14个） **Flask-Admin 后台：** - SecureModelView（网站、标签、新闻等管理） - SecureAdminIndexView（控制台首页） **管理员页面：** - /admin/change-password - /admin/seo-tools - /admin/batch-import **管理员 API：** - /api/fetch-website-info - /api/upload-logo - /api/generate-features - /api/generate-description - /api/generate-tags - /api/fetch-site-news - /api/fetch-all-news - /api/generate-static-sitemap - /api/notify-search-engines ### 密码安全 - Werkzeug 密码哈希 - 最短密码长度：6位 - 最短用户名长度：3位 --- ## 📁 文件变更 ### 新增文件（7个） ``` templates/auth/register.html - 注册页面 templates/auth/login.html - 登录页面 templates/user/profile.html - 用户中心 templates/user/collections.html - 收藏列表 create_user_tables.py - 数据库迁移脚本 USER_SYSTEM_README.md - 用户系统文档 CHANGELOG_v3.0.md - 本更新日志 ``` ### 修改文件（4个） ``` models.py - 新增 User、Folder、Collection 模型 app.py - 新增路由和 API，权限检查 templates/base_new.html - 导航栏用户菜单 templates/detail_new.html - 收藏按钮 ``` --- ## 🚀 部署指南 ### 1. 数据库迁移 ```bash python create_user_tables.py ``` ### 2. 启动应用 ```bash python app.py ``` ### 3. 测试流程 1. 访问 `/register` 注册新用户 2. 登录后访问工具详情页 3. 点击"收藏"按钮测试 4. 访问 `/user/collections` 查看收藏 --- ## ⚠️ 破坏性变更 ### Admin 模型变更 - `Admin.get_id()` 现在返回 `"admin:{id}"` 格式 - 旧的管理员账号需要重新登录一次 ### 权限系统 - 所有管理员路由现在强制检查用户类型 - 普通用户无法访问任何管理功能 --- ## 🔄 兼容性 - ✅ 向后兼容 v2.x 的所有功能 - ✅ 现有管理员账号无需迁移 - ✅ 现有网站数据完全兼容 - ⚠️ 管理员需要重新登录一次 --- ## 📊 性能优化 - 收藏列表查询使用 JOIN 避免 N+1 问题 - 添加必要的数据库索引 - 分页支持大量收藏数据 --- ## 🎯 后续计划（v3.1+） ### 待实现功能 - [ ] 收藏备注编辑 UI - [ ] 文件夹拖拽排序 - [ ] 批量收藏操作 - [ ] 收藏导出（CSV/JSON） - [ ] 公开收藏列表（分享功能） - [ ] 收藏统计图表 - [ ] 邮箱验证 - [ ] 忘记密码 - [ ] 头像上传 - [ ] 第三方登录（微信、GitHub） --- ## 👥 贡献者 - **开发：** Claude Sonnet 4.5 - **需求：** 项目团队 - **测试：** 待进行 --- ## 📝 注意事项 1. **首次部署必须运行数据库迁移脚本** 2. **管理员和普通用户使用不同的登录入口** - 管理员：`/admin/login` - 普通用户：`/login` 3. **删除用户会级联删除其所有收藏和文件夹** 4. **建议在生产环境部署前进行完整测试** --- ## 🐛 已知问题 - 无 --- ## 📞 技术支持 如有问题，请查看： - 用户系统文档：`USER_SYSTEM_README.md` - Flask-Login 文档：https://flask-login.readthedocs.io/ - SQLAlchemy 文档：https://docs.sqlalchemy.org/ --- **版本：** v3.0.0 **发布状态：** ✅ 稳定版 **推荐升级：** 是