HaHafeng
66255368b7
Features - User Management (Phase 4.1): - Database: Add user_modules table for fine-grained module permissions - Database: Add 4 user permissions (view/create/edit/delete) to role_permissions - Backend: UserService (780 lines) - CRUD with tenant isolation - Backend: UserController + UserRoutes (648 lines) - 13 API endpoints - Backend: Batch import users from Excel - Frontend: UserListPage (412 lines) - list/filter/search/pagination - Frontend: UserFormPage (341 lines) - create/edit with module config - Frontend: UserDetailPage (393 lines) - details/tenant/module management - Frontend: 3 modal components (592 lines) - import/assign/configure - API: GET/POST/PUT/DELETE /api/admin/users/* endpoints Architecture Upgrade - Module Permission System: - Backend: Add getUserModules() method in auth.service - Backend: Login API returns modules array in user object - Frontend: AuthContext adds hasModule() method - Frontend: Navigation filters modules based on user.modules - Frontend: RouteGuard checks requiredModule instead of requiredVersion - Frontend: Remove deprecated version-based permission system - UX: Only show accessible modules in navigation (clean UI) - UX: Smart redirect after login (avoid 403 for regular users) Fixes: - Fix UTF-8 encoding corruption in ~100 docs files - Fix pageSize type conversion in userService (String to Number) - Fix authUser undefined error in TopNavigation - Fix login redirect logic with role-based access check - Update Git commit guidelines v1.2 with UTF-8 safety rules Database Changes: - CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled) - ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code) - INSERT 4 permissions + role assignments - UPDATE PUBLIC tenant with 8 module subscriptions Technical: - Backend: 5 new files (~2400 lines) - Frontend: 10 new files (~2500 lines) - Docs: 1 development record + 2 status updates + 1 guideline update - Total: ~4900 lines of code Status: User management 100% complete, module permission system operational
4.4 KiB
4.4 KiB
系统总体设计 - 阅读指南
文档日期： 2025-11-06
文档目的： 快速导航，找到您需要的文档
🎯 如果您想...
快速了解今天的成果
👉 必读： 00-今日架构设计总结
- 7个核心文档总览
- 关键决策总结
- 下一步建议
了解整个系统架构
👉 必读： 08-架构设计全景图
- 一图看懂完整架构
- 四种部署模式
- 代码组织结构
👉 详细了解： 01-系统架构分层设计
- 三层架构详细设计
- 8个业务模块
- 5个通用能力
- 依赖关系分析
做出下一步行动决策
👉 必读： 99-下一步行动决策建议
- 3个方案对比（立即开发 vs 先改造 vs 折中）
- 成本收益分析
- 明确的建议和实施计划
了解数据库架构
👉 先看： 03-数据库架构说明
- PostgreSQL是Docker部署的
- 您有自己独立的数据库
- 与Dify数据库的关系
👉 深入了解： 05-Schema隔离方案与成本分析
- 逻辑隔离 vs 物理隔离
- 改造成本对比（现在1周 vs 未来3-5周）
- 实施方案
了解如何模块独立部署
👉 必读： 06-模块独立部署与单机版方案
- 完整打包方案（独立产品）
- 共享服务方案（平台内模块）
- Electron单机版架构
- 代码复用率分析（85%+）
了解运营管理端
👉 必读： 04-运营管理端架构设计
- 15个功能模块
- 3阶段实施计划
- 对系统的6大影响
了解是否需要Monorepo
👉 必读： 07-Monorepo架构评估
- 当前阶段需要吗？
- 成本对比（现在2-3天 vs 未来7-11天）
- 实施方案
了解文档体系如何重构
👉 必读： 02-文档体系重构方案v2.0
- 新文档结构设计
- 8个模块的标准文档模板
- 迁移计划
了解所有架构问题的答案
👉 必读： 00-核心问题解答
- 部署模式调整（3种，不考虑混合部署）
- 审稿系统独立性分析
- 数据库架构澄清
📊 文档阅读顺序建议
路径1：快速了解（20分钟）
- 00-今日架构设计总结 - 5分钟
- 08-架构设计全景图 - 10分钟
- 99-下一步行动决策建议 - 5分钟
路径2：全面理解（1-2小时）
- 00-今日架构设计总结 - 10分钟
- 01-系统架构分层设计 - 30分钟
- 05-Schema隔离方案与成本分析 - 20分钟
- 07-Monorepo架构评估 - 15分钟
- 99-下一步行动决策建议 - 10分钟
路径3：深入研究（3-4小时）
按顺序阅读所有10个文档
🎯 关键结论速查
Schema隔离
- 建议： 现在做 ⭐⭐⭐⭐⭐
- 成本： 1周 vs 未来3-5周
- ROI： 300-500%
Monorepo
- 建议： 现在转换 ⭐⭐⭐⭐⭐
- 成本： 2-3天 vs 未来7-11天
- ROI： 300-400%
- 触发条件： 近期开发运营管理端，必须转换
下一步行动
- 方案A： 立即开发ASL（累积技术债）
- 方案B： 先改造架构，再开发ASL（强烈推荐）⭐⭐⭐⭐⭐
- 方案C： 只做Monorepo，延后Schema隔离
📝 今日成果
完成的文档：
- ✅ 00-核心问题解答.md
- ✅ 01-系统架构分层设计.md（900+行）
- ✅ 02-文档体系重构方案v2.0.md（790+行）
- ✅ 03-数据库架构说明.md（434+行）
- ✅ 04-运营管理端架构设计.md（859+行）
- ✅ 05-Schema隔离方案与成本分析.md（1042+行）
- ✅ 06-模块独立部署与单机版方案.md（1541+行）
- ✅ 07-Monorepo架构评估.md（555+行）
- ✅ 08-架构设计全景图.md
- ✅ 99-下一步行动决策建议.md
总计： 6000+行详细设计
最后更新： 2025-11-06
维护人： 技术架构师