后端模块概览
下面按 Forge Project 聚合 POM 的模块顺序 列，不是按文档目录随便排。
Starter 在 forge-server/forge-framework/forge-starter-parent，共 23 个（forge-starter-parent 自己是聚合 POM，不算模块）。
Starter（forge-starter-parent）
源码顺序与 forge-starter-parent/pom.xml 的 <modules> 一致。
| artifactId | 自动装配 / 入口 | 配置前缀 | 常用注解 | 文档 |
|---|---|---|---|---|
forge-starter-core | ExceptionAutoConfiguration、JacksonConfig | forge.auth、forge.crypto、forge.log、forge.demo | @ApiEncrypt @ApiDecrypt @ApiPermissionIgnore @IgnoreTenant @OperationLog @RefreshScope | core |
forge-starter-orm | MybatisPlusConfig | — | — | orm |
forge-starter-web | 包 com.mdframe.forge.starter（Undertow，无独立 AutoConfiguration 类） | — | — | web |
forge-starter-cache | ManagedCacheAutoConfiguration、RedissonConfig | forge.cache | @ForgeCacheable @ForgeCachePut @ForgeCacheEvict @ForgeCacheConfig | cache |
forge-starter-auth | SaTokenConfig、SaTokenConfigLoader | forge.captcha | — | auth |
forge-starter-log | 操作日志组件（无独立 AutoConfiguration 类名） | 复用 forge.log | 与 @OperationLog 配合 | log |
forge-starter-trans | TransAutoConfiguration | — | @DictTrans @DictTranslate @TransField | trans |
forge-starter-file | FileAutoConfiguration | forge.file | — | file |
forge-starter-excel | ExcelAutoConfiguration | — | @ExcelColumn @ExcelExport | excel |
forge-starter-config | ConfigAutoConfiguration、PropertyRefreshAutoConfiguration | config.datasource | — | config |
forge-starter-job | @ScheduledJob / @JobHandler | — | @ScheduledJob @JobHandler | job |
forge-starter-id | IdAutoConfiguration | uid.cache、uid.default | — | id |
forge-starter-datascope | DataScopeAutoConfiguration | forge.datascope | @DataScopeIgnore | datascope |
forge-starter-message | MessageAutoConfiguration | forge.message | — | message |
forge-starter-tenant | TenantAutoConfiguration | forge.tenant、forge.business.datasource | @TenantBusinessDataSource | tenant |
forge-starter-crypto | CryptoAutoConfiguration、JacksonCryptoConfiguration | forge.crypto.internal-call | @CryptoField @Desensitize | crypto |
forge-starter-websocket | WebSocketConfig | forge.websocket | — | websocket |
forge-starter-api-config | ApiConfigAutoConfiguration | forge.api-config | — | api-config |
forge-starter-social | SocialAutoConfiguration | forge.social | — | social |
forge-starter-idempotent | IdempotentAutoConfiguration | forge.idempotent 及 .token .cache .lock | @Idempotent | idempotent |
forge-starter-openapi-security | OpenApiSecurityAutoConfiguration | forge.openapi.security | — | openapi-security |
forge-starter-outbound | OutboundAutoConfiguration | forge.outbound | — | outbound |
forge-starter-collaboration | CollaborationProviderRegistry 等 SPI（无独立 *AutoConfiguration） | — | — | collaboration |
forge-starter-web 源码目前只有 package-info.java，实际 Web 容器依赖在模块 POM 里（Undertow，排除 Tomcat）。不要把它写成还有一整包 Controller。
Plugin（forge-plugin-parent）
| artifactId | 文档 |
|---|---|
forge-plugin-system | system + 使用指南 |
forge-plugin-job | job-plugin + 定时任务手册 |
forge-plugin-message | message-plugin + 消息中心 |
forge-plugin-collaboration | collaboration + 企业协同手册 |
forge-plugin-generator | generator + 代码生成 |
forge-plugin-flow | flow-design |
forge-plugin-ai | ai |
forge-plugin-mcp | mcp |
forge-plugin-external | external |
forge-plugin-data | data |
forge-plugin-capability-core | capability |
forge-plugin-capability-platform | capability |
forge-plugin-capability-actions | capability |
forge-plugin-capability-high-risk-approval | capability |
能力开放四个子模块必须同时出现在 capability，不能只写 parent。
独立服务与客户端
| artifactId | 官方端口 | 文档 |
|---|---|---|
forge-admin-server | 8580 | Admin 配置 |
forge-report-server | 8581 | Report 配置 |
forge-flow-server | 8081 | Flow 配置 |
forge-app-server | 8583 | App 配置 |
forge-flow-client | — | flow-client |
FlowClientProperties 类内默认是 http://localhost:8080，Admin 官方 YAML 覆盖为 8081。