业务模块地图

本文面向需要评估、复用或扩展商业版后端模块的研发人员。它用于判断当前后端已经提供哪些能力，哪些更适合作为业务项目的基础底座。

模块总体分布

当前业务模块可以按 4 组来理解：

模块组	代表模块	主要作用
平台基础	auth、user、roles、menus、dicts	账号、角色、组织、菜单、基础管理
安全与治理	api-permissions、data-permissions、security-audit、crypto	权限控制、接口安全、审计治理
业务协同	content、notifications、feedback、files	内容、通知、反馈、文件等平台能力
运营扩展	mall、workflow、scheduled-tasks、monitor、ai-assistant	商城、流程、调度、监控、AI 等扩展能力

最值得优先理解的模块

基础平台模块

这组决定项目是不是一个可使用的后台底座，优先级通常最高：

• auth
• user
• roles
• departments
• menus
• site-settings
• system-params

文件、通知、监控模块

这组通常在业务项目里非常高频，建议重点保留：

• files
• notifications
• monitor
• scheduled-tasks

工作流、商城、AI 等扩展模块

这组模块用于承接更完整的业务平台场景，可根据项目需求选择直接复用、裁剪或借鉴结构。

业务项目适配评估

建议按下面顺序判断：

1. 基础平台模块是否满足组织与权限要求
2. 文件、参数、通知、日志这些底座能力是否够用
3. 工作流、商城等业务模块是直接复用还是只借鉴结构

模块阅读建议

想快速了解模块能力

先看：

• *.module.ts
• *.controller.ts

想了解业务规则

再看：

• *.service.ts
• services/

想了解数据结构

最后看：

• schema.prisma
• 对应 DTO 和 repository

最适合拿来做平台底座的模块

• 认证与会话
• 用户角色组织
• 菜单与权限
• 系统参数与站点配置
• 文件中心
• 通知中心
• 监控与定时任务

这些模块的价值通常高于单个演示业务模块。

检查清单

评估模块复用范围时，建议确认：

• 业务项目依赖的基础平台模块已完成初始化和权限配置。
• 文件、通知、监控、定时任务等平台能力是否纳入功能范围已明确。
• 工作流、商城、AI 等扩展模块是直接复用、裁剪还是作为扩展开发参考已形成结论。