docs(codegen): 加 ssw-{appCode} 多模块结构 + POM 依赖层级文档

references/commands.md §1.11:
- 表格加 --flat / --multi-module-pom 行
- 加 '多模块结构' 段 (完整目录树 + 归类规则表 + POM 依赖层级)
- 加 '完整推荐流程' 段 (一个命令搞定多模块 Java 项目)
This commit is contained in:
ssw committed 2026-06-23 10:55:24 +08:00
1 parent 7c6321707a
commit 2084bd4ef8
1 file changed
+54
@@ -247,6 +247,8 @@ dacli form codegen <formId> [options]
| `--dbLinkId <id>` | - | token.dbLinkId | 数据源 ID(BS-48 `default` → token.dbLinkId) |
| `--enableFlow <0\|1>` | - | `0` | 是否启用流程 |
| `--out <path>` | - | `./generated/${company}-${module}/` | 输出目录 |
| `--flat` | - | `false` | **关闭多模块归类**(旧版兼容:文件直接写到 outDir 根)。默认开启多模块归类 |
| `--multi-module-pom` | - | `false` | 生成 4 个 pom.xml 占位(parent + entity/biz/controller,严格按 aibridge §POM 依赖规则;与 `--flat` 互斥) |
| **`--auto-alias`** ⭐ | - | `false` | **推荐**:从 `form.tables` 自动推导主表别名,写 `base_visual_alias` 表。CodePreview 直接用别名生成代码,无 post-fix |
| `--alias-file <path>` | - | - | 从 JSON 文件读 alias 表(格式:`[{table, aliasName, fields?}]`) |
| `--alias <json>` | - | - | 直接传 alias JSON 字符串 |
@@ -302,6 +304,58 @@ dacli form codegen 808986025610185477 --module=tds --auto-fix-names --mainClassN
dacli form codegen 808986025610185477 --module=tds --enable-flow=1 --auto-alias --mainClassName=tdsBilling
```
**多模块结构**(v0.10+ 默认开启,按 aibridge docs/code-rule.md §POM 依赖规则组织):
```
ssw-tds/ # parent (--multi-module-pom 时生成 pom.xml)
├── ssw-tds-entity/ # Entity + Model/Form/VO
│ ├── pom.xml # (--multi-module-pom 时生成)
│ └── src/main/java/ssw/tds/
│ ├── entity/{Model}Entity.java
│ └── model/{Model}Form.java
├── ssw-tds-biz/ # Service + ServiceImpl + Mapper
│ ├── pom.xml
│ └── src/main/java/
│ ├── ssw/tds/service/{Model}Service.java
│ ├── ssw/tds/service/impl/{Model}ServiceImpl.java
│ └── jnpf/mapper/{Model}Mapper.java # 固定包名 jnpf.mapper
└── ssw-tds-controller/ # Controller
├── pom.xml
└── src/main/java/ssw/tds/controller/{Model}Controller.java
```
**归类规则**(`pathToModule()` 函数):
| 文件路径特征 | 归到 Maven 模块 |
|--------------|-----------------|
| `/controller/` 目录 或 `*Controller.java` | `ssw-tds-controller` |
| `/service/` 目录 或 `*Service*.java` | `ssw-tds-biz` |
| `/mapper/` 目录 或 `*Mapper.{java,xml}` | `ssw-tds-biz` |
| `/entity/` 目录 或 `*Entity.java` | `ssw-tds-entity` |
| `/model/` 目录 或 `*Form.java` | `ssw-tds-entity` |
| 其他 `.xml` 资源 | `ssw-tds-biz`(与 mapper.xml 同目录) |
| `.vue`/`.ts`/`.js` 前端文件 | 不归 Maven 模块,写到 outDir 根 |
**POM 依赖层级**(严格按 aibridge §依赖层级图):
```
controller (ssw-tds-controller) → biz + jnpf-common-all
biz (ssw-tds-biz) → entity + fastjson + commons-lang3 + jnpf-common-all
entity (ssw-tds-entity) → jnpf-common-all + jnpf-generater-base
```
**完整推荐流程**(一个命令搞定):
```bash
dacli form codegen <formId> \
--company=ssw --module=tds \
--auto-alias --mainClassName=tdsBilling \
--multi-module-pom \
--enable-flow=0
# 输出到 ./generated/ssw-tds/, 含 4 个 pom.xml + 完整多模块 Java 结构
# 直接 mvn package 即可编译
```
**JNPF alias 系统与 aibridge 命名约定的差异**:
| 维度 | aibridge docs/code-rule.md | JNPF `base_visual_alias` |