diff --git a/.claude/skills/dacli-ts/references/commands.md b/.claude/skills/dacli-ts/references/commands.md index 1e6be5b..6fab9e5 100644 --- a/.claude/skills/dacli-ts/references/commands.md +++ b/.claude/skills/dacli-ts/references/commands.md @@ -247,6 +247,8 @@ dacli form codegen [options] | `--dbLinkId ` | - | token.dbLinkId | 数据源 ID(BS-48 `default` → token.dbLinkId) | | `--enableFlow <0\|1>` | - | `0` | 是否启用流程 | | `--out ` | - | `./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 ` | - | - | 从 JSON 文件读 alias 表(格式:`[{table, aliasName, fields?}]`) | | `--alias ` | - | - | 直接传 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 \ + --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` |