业务模块地图
本页帮助你从“要改什么”定位到源码。下列业务包都在 art-system，不是独立服务。公共路径为 art-modules/art-system/src/main/java/com/artd/system/。
按业务能力查找
| 业务包 | 用户看到的能力 | 修改时同时核对 |
|---|---|---|
| access | 用户、角色、部门、岗位、个人资料与接口授权 | 账号关系、API 权限、数据范围及删除参与者 |
| auth | 登录、注册、验证码、刷新及会话撤销 | Cookie、账号状态、Redis 与身份拦截器 |
| crypto | 公钥、密码解密与安全配置 | RSA 持久化、前端 keyId、签名开关语义 |
| menu | 菜单、按钮与前端动态路由 | 角色菜单、组件路径、缓存失效 |
| settings | 字典、参数与站点配置 | 公开/管理响应、敏感字段、参数缓存 |
| files | 文件、目录、回收站、下载授权 | 对象定位、引用关系、生命周期及恢复 |
| notifications | 发布通知、收件箱、未读与实时信号 | 收件人范围、短期凭证及跨实例频道 |
| content | 内容、分类、标签、回收站 | 引用、软删除和清理任务 |
| feedback | 用户反馈与处理 | 提交与管理权限的区别 |
| audit | 登录/操作日志、安全事件 | 脱敏、事务内支付审计及采集边界 |
| monitor | 系统资源、在线、访客与缓存 | 监控权限及缓存清理白名单 |
| tasks | 任务定义、计划、执行与日志 | 处理器注册、锁、幂等与执行上限 |
| workflow | 分类、定义版本、实例、任务、表单与附件 | Flowable、快照、审批人及字段权限 |
| mall | 基础资料、商品、库存、订单、支付与售后 | 整数分、库存事务、渠道不确定状态 |
| aiassistant | 流式对话 | 上游配置、并发、取消与 SSE 事件 |
| cache | 受控缓存空间契约 | TTL、隔离与提交后失效 |
一个功能的完整定位路径
以“修改系统参数”为例，先看 Controller 的路径、请求类型与权限，再看 Service 的更新与缓存失效，最后查 Mapper/XML、表结构及对应测试。不要只在页面文本或某个 SQL 中修改一处。
text
用户操作
→ 前端 src/api 中的方法与权限码
→ Java Controller / DTO / VO
→ Service 用例与事务
→ Mapper / XML / 数据表
→ 缓存、任务或外部服务
→ 相关单元与集成测试实际文件对应关系
以下路径相对 art-modules/art-system/：
| 要核对的内容 | 文件 |
|---|---|
| 路径、HTTP 方法、接口权限 | src/main/java/com/artd/system/settings/controller/SystemParamController.java |
| 筛选字段、分页默认值 | src/main/java/com/artd/system/settings/dto/SystemParamQuery.java |
| 用例和 DTO 转换 | src/main/java/com/artd/system/settings/service/SystemParamService.java |
| 数据层筛选模型 | src/main/java/com/artd/system/settings/domain/model/SystemParamFilter.java |
| SQL 和范围过滤 | src/main/resources/mapper/settings/SystemParamMapper.xml |
读完后，应能回答一个问题：“前端多传一个筛选条件，需要改哪些地方？”按完整链路找文件，比只搜索字段名更不容易漏掉转换和权限。
技术配置和业务配置不要混淆
数据库、Redis、存储、AI 和服务器端口在外置 YAML；站点品牌和业务开关由 settings 域维护；菜单与角色授权是业务数据；部署时安装文件与 Compose 生成在 art-admin/admin/deployment。
扩展与裁剪
复用模块前先确认业务范围和数据所有权；新用例优先放所属域。裁剪审批或商城要同步处理代码、依赖、资源、装配、任务、权限和前端入口，不只删除包目录或 SQL。