birc-generator 0.9.0 → 1.0.0

package/PROJECT.md

@@ -16,6 +16,7 @@ anchor 就不要重寫整份設定；推測以後會用到的模組先不要做
 | 注入給產出專案的 agent 文件 | `project-docs/` | `create`（`injectDocs`）、`docs` |
 | create 的基礎骨架 | `templates/base/`、`templates/multi-module/`、`templates/gradle-wrapper/` | `create`（含給人看的 `README.md`） |
 | CLI 進入點 | `bin/birc.js`、`bin/home-install.js`、`install.sh` / `install.ps1` | `birc`（banner、版本、`update`、直接呼叫 node-plop） |
+| generator 實作 | `plopfile.js`（登記）+ `lib/features.js` / `lib/make.js` / `lib/create.js` / `lib/project.js` | `create`、`add`、`sync`、`make:*`、`docs` |
 
 完成條件：能說出這次只動哪一個 seam、哪幾個 generator 會吃到。
 
@@ -32,23 +33,41 @@ anchor 就不要重寫整份設定；推測以後會用到的模組先不要做
 
 ## 改 feature
 
-1. 在 `FEATURES` 加一個 key：`label`、`files` / `resourceFiles` / `rootFiles`、`ymlBlock`、`gradleDep`、`gradlePlugin`、`gradleAllprojects`。
+1. 在 `FEATURES` 加一個 key：`label`、`files` / `testFiles` / `entityFiles` / `daoFiles` / `resourceFiles` / `rootFiles`、`ymlBlock`、`gradleDep`、`gradlePlugin`、`gradleAllprojects`。
    完成條件：key 對得上 `templates/<key>/`；用不到的插入欄位是 `null`，`rootFiles` 只在有 repo 根檔時才出現。
 2. 補對應的 `.hbs`。Java 用 `{{basePackage}}`；路徑層級跟既有 feature 一樣（`service/`、`config/`、`client/`）。
-   完成條件：`FEATURES` 列出的每個 `templateFile` 都在，dest 落在對的 root（Java → `root`，resources → `resourcesRoot`，repo 根檔 → `projectRoot`）。
+   完成條件：`FEATURES` 列出的每個 `templateFile` 都在，dest 落在對的 root（Java → `root`，測試 → `testRoot`，
+   Entity → `entityRoot`，DAO → `daoRoot`，resources → `resourcesRoot`，repo 根檔 → `projectRoot`）。
+
+   Entity / DAO 多模組時落在 `databaseconfig` 模組而不是 `root`，所以要用 `entityFiles` / `daoFiles`，
+   套件名用 `{{entityPackage}}` / `{{daoPackage}}`，不要自己拼 `{{basePackage}}.entity`。
+
+   feature 自帶 Entity 時，名字不要用專案很可能自己 `make` 的（`User`、`Order` 這種），
+   否則 `birc make User` 會撞檔。`auth` 用 `AuthUser` / `auth_users` 就是為了讓出 `User`。
+
+   安全相關的判斷（擋什麼、放什麼）用 `testFiles` 讓 feature 帶一份自己的測試進產出專案。
+   generator 這邊的正規表達式斷言只證明程式碼長什麼樣，不會執行到那段邏輯。
+
+   要動 `SecurityFilterChain` 的 feature，寫一個實作 `SecurityCustomizer` 的 `@Component`，
+   不要改寫 `SecurityConfig`——那個檔每個專案都會自己改，覆寫它等於 `add --force` 會吃掉專案的修改。
+   放行路徑走 `publicPaths()`，掛 filter 走 `customize()`。`auth` 的 `AuthSecurityCustomizer` 是範例。
 3. 要寫進 `application.yml` / `build.gradle` 時，做 append fragment，接在 **anchor** 後面：
    - yml：`# birc-generator:config-anchor`
    - gradle 依賴：`// birc-generator:dependency-anchor`（`gradleDep`，在 `dependencies {}`）
    - gradle plugin：`// birc-generator:plugin-anchor`（`gradlePlugin`，在 `plugins {}`）
    - gradle allprojects：`// birc-generator:allprojects-anchor`（`gradleAllprojects`，在 `allprojects {}`）
-   完成條件：產出檔仍留著同一行 anchor，新內容在它後面。yml fragment 若再寫一個 top-level `spring:`，用 `---` 開新 YAML document（SnakeYAML 同一 document 重複 key 是後蓋前，不會 merge）。gradle 依賴 fragment 維持 `dependencies {}` 內的縮排；plugin / allprojects 不要塞進 `dependencies {}`。
+   插進去的每段 fragment 都會被 `birc:begin:<marker>` / `birc:end:<marker>` 包住（yml 用 `#`，gradle 用 `//`），
+   marker 就是 feature key，同一個 feature 插到 plugins / allprojects 的另外兩段是 `<key>-plugin` / `<key>-allprojects`。
+   冪等看 marker 在不在；marker 出現前產出的舊專案沒有 marker，改用整段文字比對，兩條都要留著。
+
+   完成條件：產出檔仍留著同一行 anchor，新內容在它後面，而且被成對 marker 包住。yml fragment 若再寫一個 top-level `spring:`，用 `---` 開新 YAML document（SnakeYAML 同一 document 重複 key 是後蓋前，不會 merge）。gradle 依賴 fragment 維持 `dependencies {}` 內的縮排；plugin / allprojects 不要塞進 `dependencies {}`。
 4. 用 `npx plop create` 與 `npx plop add` 各走一次，再重跑一次 `add`。
  完成條件：兩邊產出同一組檔與同一段 yml/gradle，anchor 行還在；第二次 `add`
  不改檔，`.bircrc.json.features` 只有一個同名 key。
 
 ## 慣例
 
-**make 一次整組。** `make` 串 `makeStackActions`：Entity + DAO + Mapper + DTO + Service + Controller。`--migration` 生 `create_{table}_table`（Flyway SQL）。`--seed` 生 `XxxSeeder`（Java，走 DAO；`birc seed` 才執行）。單層指令共用同一組 actions，不另寫一份。`make:entity` 產出 Entity、`XxxDAO extends BaseDAO`。`--migration` / `--seed` 同 `make:model`；已有 Entity 就跳過，只補 SQL / Seeder。`make:model` 同 Entity + DAO；`--migration` / `--seed` 同上，`--controller` 生 Controller。`make:seeder BookSeeder` 只生 Seeder（寫 `Book` 也可以，結尾 `Seeder` 會剝掉再對 Entity）。`--soft-delete` 在 Entity 加 Hibernate `@SoftDelete(columnName = "deleted_at", strategy = TIMESTAMP)`，migration 加 `deleted_at TIMESTAMP NULL`；`deleteById` 不用改。不做 restore / withTrashed。`make:entity --dto` 與 `make:entity --mapper` 一併生 Mapper 與 Request / Response DTO（同一組檔）。`make:mapper` 連 Request / Response DTO，並把 MapStruct 依賴接到 `build.gradle` 的 dependency-anchor 後面（已有則跳過）。`make:service` 的 `XxxService extends BaseService`，CRUD 在 `BaseServiceImpl`；多出來的業務方法寫在 `XxxService` / `XxxServiceImpl`。指令是 `make:entity`，不是 `make::entity`。預設只生引入與初稿；加 `--example` 或 `--fields` 才生完整範例（CRUD、欄位、`@Column`）。`--example` 的 Entity 與 `make:migration` 一樣帶 `created_at` / `updated_at`（DB 填，JPA `insertable = false`），不進 CreateRequest。多模組時 Entity / DAO 落在 `databaseconfig`。路徑以 `.bircrc.json` 的 `entityPath` / `daoPath` 為準。
+**make 一次整組。** `make` 串 `makeStackActions`：Entity + DAO + Mapper + DTO + Service + Controller。`--migration` 生 `create_{table}_table`（Flyway SQL）。`--seed` 生 `XxxSeeder`（Java，走 DAO；`birc seed` 才執行）。加 `--migration` / `--seed` 時已有 Java 就跳過，只補缺的檔與 SQL / Seeder。單層指令共用同一組 actions，不另寫一份。`make:entity` 產出 Entity、`XxxDAO extends BaseDAO`。`--migration` / `--seed` 同 `make:model`；已有 Entity 就跳過，只補 SQL / Seeder。`make:model` 同 Entity + DAO；`--migration` / `--seed` 同上，`--controller` 生 Controller。`make:seeder BookSeeder` 只生 Seeder（寫 `Book` 也可以，結尾 `Seeder` 會剝掉再對 Entity）。`--soft-delete` 在 Entity 加 Hibernate `@SoftDelete(columnName = "deleted_at", strategy = TIMESTAMP)`，migration 加 `deleted_at TIMESTAMP NULL`；`deleteById` 不用改。不做 restore / withTrashed。`make:entity --dto` 與 `make:entity --mapper` 一併生 Mapper 與 Request / Response DTO（同一組檔）。`make:mapper` 連 Request / Response DTO，並把 MapStruct 依賴接到 `build.gradle` 的 dependency-anchor 後面（已有則跳過）。`make:service` 的 `XxxService extends BaseService`，CRUD 在 `BaseServiceImpl`；多出來的業務方法寫在 `XxxService` / `XxxServiceImpl`。指令是 `make:entity`，不是 `make::entity`。預設只生引入與初稿；加 `--example` 或 `--fields` 才生完整範例（CRUD、欄位、`@Column`）。`--example` 的 Entity 與 `make:migration` 一樣帶 `created_at` / `updated_at`（DB 填，JPA `insertable = false`），不進 CreateRequest。多模組時 Entity / DAO 落在 `databaseconfig`。路徑以 `.bircrc.json` 的 `entityPath` / `daoPath` 為準。
 
 **例外走 ProjectException。** 基底是專案內的 `ProjectException`（`getErrorCode` / `getHttpStatus`），不是 starter 的 `BusinessException`。`create` 會生 `ProjectException`、`NotFoundException`、`ExceptionHandleController`、`web/Result`。`make:exception` 生的類別一律 `extends ProjectException`。Controller 回傳專案內 `Result<T>`，不引用 `tw.edu.ntub.birc.starter`。
 
@@ -67,7 +86,7 @@ anchor 就不要重寫整份設定；推測以後會用到的模組先不要做
 **版本只改一處。** Spring Boot、Flyway、Sentry、MapStruct、Spotless、dependency-management
 plugin 與 starter 版本都在 `versions.js`；`create` / `add` / `make:mapper` 將它們注入 template。
 
-**`birc` 的 dest。** `bin/birc.js` 把 plop 的 cwd 釘在這個 repo（找 `plopfile.js` 與 `templates/`），dest 與 `.bircrc.json` 走呼叫者目錄（`BIRC_PROJECT_ROOT` + `--dest`）。`create` / `update` 用目前目錄；目前目錄已有 `.bircrc.json`、或目標資料夾已在，`create` 會先失敗。`birc create --yes` 其餘用預設、不要問。`add` / `make:*` / `migrate` / `seed` / `db:wipe` / `docs` 從目前目錄往上找 `.bircrc.json`，檔案落在找到的專案根。`birc add email sentry` 可帶 feature 名（也接受 `file-upload` 這種 kebab）；沒帶參數仍互動勾選。打錯功能名會給近似建議。未知旗標會失敗並提示正確名稱。`docs` 用 `.bircrc.json` 的專案名，不再問。`make` 撞到已有檔會提示 `--force`；`--force` 覆寫那組 Java。`--fields` 有帶就當完整產出，不必再加 `--example`。
+**`birc` 的 dest。** `bin/birc.js` 把 plop 的 cwd 釘在這個 repo（找 `plopfile.js` 與 `templates/`），dest 與 `.bircrc.json` 走呼叫者目錄（`BIRC_PROJECT_ROOT` + `--dest`）。`create` / `update` 用目前目錄；目前目錄已有 `.bircrc.json`、或目標資料夾已在，`create` 會先失敗。`birc create --yes` 其餘用預設、不要問。`add` / `make:*` / `migrate` / `seed` / `db:wipe` / `docs` 從目前目錄往上找 `.bircrc.json`，檔案落在找到的專案根。`birc add email sentry` 可帶 feature 名（也接受 `file-upload` 這種 kebab）；沒帶參數仍互動勾選。打錯功能名會給近似建議。未知旗標會失敗並提示正確名稱。`docs` 用 `.bircrc.json` 的專案名，不再問。`make` 撞到已有檔只印 `Error:` 與那一個檔，並提示只要表用 `make:migration`、只要 Seeder 用 `make:seeder`；不印後續 aborted。`--force` 覆寫那組 Java。`--fields` 有帶就當完整產出，不必再加 `--example`。
 
 **`birc update`。** 先 `detectInstallKind`：`npm` 跑 `npm install -g birc-generator@latest`。curl / PowerShell / clone 走 `bin/home-install.js`（不要再把 Windows 暫存路徑丟給 bash）。`~/.birc-generator` 的 kind 是 `home`，跟用 bash 還是 `irm | iex` 裝無關。
 

package/README.md

@@ -16,7 +16,7 @@ DAO 繼承寫錯、例外類從 starter 抓來用，之後還要再修。
 CRUD 用 `birc make`。多模組目錄、`BaseDAO`、`ProjectException` 會先寫好。
 
 完整文件在
-[GitLab wiki](https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/wikis/home)
+[GitLab wiki](https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/wikis/home)
 （開始使用、add / make / migrate）。這份 README 只留安裝與第一次用。
 
 ## 安裝
@@ -122,7 +122,7 @@ ValidGroup、Spotless、注入 agent 文件），不再問。
 | `birc update` | 更新本機 `birc`（`npm install -g birc-generator@latest`） |
 | `birc add` | 往既有專案加模組。沒帶名稱會互動勾選；`birc add email sentry` 直接加。`--force` 覆寫已選的已安裝 feature 檔 |
 | `birc sync` | 用目前 template 覆寫全部已安裝 feature 的檔（不動 yml / gradle） |
-| `birc make` | 一次生 Entity + DAO + Mapper + DTO + Service + Controller；加 `--migration` / `--seed` |
+| `birc make` | 一次生 Entity + DAO + Mapper + DTO + Service + Controller；加 `--migration` / `--seed`。已有 Java 時加這兩個旗標會跳過，只補缺的檔與 SQL / Seeder |
 | `birc make:entity` | Entity、`XxxDAO`；加 `--migration` / `--seed` / `--dto`、`--mapper`、`--soft-delete`。已有檔要覆寫加 `--force`；只要表或 Seeder 可 `--migration` / `--seed`，不會覆寫 Entity |
 | `birc make:model` | 同 `make:entity`；加 `--migration` / `--seed` / `--controller` / `--soft-delete` |
 | `birc make:mapper` | Mapper 和 CreateRequest / Response |
@@ -170,31 +170,33 @@ birc migrate
 `birc add` 沒帶名稱時會問你要加哪些模組；也可以寫 `birc add docker` 或 `birc add file-upload`。
 `make:migration create_book_table` 會讀已有的 Book Entity 把欄位寫進 SQL。`birc make Book --fields title:String --migration --seed` 同一指令生骨架、CREATE TABLE 與 `BookSeeder`，再 `birc migrate`、`birc seed`。只補 Seeder 用 `birc make:seeder BookSeeder`。清空資料庫用 `birc db:wipe`。`add_votes_to_users_table` 裡的 `add_votes_...` 仍只是檔名。
 
-各指令的細節見 wiki：[make](https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/wikis/基礎/make)、
-[add](https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/wikis/基礎/add)、
-[migrate](https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/wikis/基礎/migrate)。
+各指令的細節見 wiki：[make](https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/wikis/基礎/make)、
+[add](https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/wikis/基礎/add)、
+[migrate](https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/wikis/基礎/migrate)。
 
 ## 建立專案時可以勾的功能
 
 勾了就會寫進專案裡。之後也能用 `birc add` 再補。完整對照見
-[功能模組](https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/wikis/開發人員/功能模組)。
+[功能模組](https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/wikis/開發人員/功能模組)。
 
 | 畫面上的名稱 | 會多出什麼 |
 | --- | --- |
 | Docker | `Dockerfile`、`docker-compose.yml`、`docker-compose.prod.yml`、`.env.example`（建立時預設勾選，並複製成 `.env`） |
 | Email | JavaMailSender、Thymeleaf 範本、`EmailService` |
-| SSO | 校內單一登入（`SsoProperties` + `SsoAutoConfiguration` 原始碼，無外部依賴） |
-| OAuth2 登入 | OAuth2 登入（範例接 Google） |
+| 帳號登入 | `auth_users` 表、`POST /api/auth/login`（回應標頭 `X-Auth-Token` 帶 JWT）、`GET /api/auth/me`、驗章 filter。`JWT_SECRET` 寫在 `.env`，沒有就啟動時產生 |
+| SSO | 校內單一登入的設定骨架（`SsoProperties` + `SsoAutoConfiguration`）。只有設定檔，驗票與發證要自己接 |
+| OAuth2 登入 | OAuth2 登入（範例接 Google）。`OAuth2LoginSuccessHandler` 要自己掛上 `SecurityCustomizer` 才會生效 |
 | 排程 | `@EnableScheduling` 和一個範例 Job |
 | AOP 事件記錄 | `@OperationLog` 和對應的 Aspect |
 | Client | 呼叫外部 API 的 RestClient 封裝 |
+| 簽到 | 接中心簽到系統的 `ClockInClient`（登入拿 JWT、簽到、簽退、改工作內容、查紀錄、查權限、值班表）與 `ClockInController`；帳密放 `BIRC_CLOCKIN_ACCOUNT` / `BIRC_CLOCKIN_PASSWORD` |
 | Sentry | 錯誤追蹤設定與客戶端例外過濾 |
 | Log4j2 | 取代預設 Logback，加入主控台、rolling file 與 MDC 格式（建立時預設勾選） |
 | OpenAPI | springdoc、Swagger UI 與 Bearer JWT security scheme |
 | 檔案上傳 | 本機磁碟上傳、`util/file` 檢查、上傳例外、`FileUploadController` |
 | 分頁查詢 | `PageRequest` / `PageResponse`、`Pager`、`GenericSpecification` |
 | 驗證群組 | `ValidGroup`（Create / Update / Delete / Submit），給 `@Validated` 與欄位 `groups`（建立時預設勾選） |
-| 權限控管 | Spring Security 和 `@RequirePermission` |
+| 權限控管 | Spring Security 和 `@RequirePermission`。比對的是 `Authentication` 裡的權限代碼，所以要搭配「帳號登入」或自己的登入機制才有作用 |
 | .gitlab-ci.yml | Harbor build/push 與 SSH deploy（對齊 teaching-platform；帳密放 GitLab CI/CD Variables） |
 | Spotless | 根目錄 `spotless_formatter.xml`、Eclipse 4.31、`./gradlew spotlessApply`（建立時預設勾選） |
 
@@ -236,7 +238,7 @@ Flyway Community 沒有 Laravel 的 rollback。`birc migrate:rollback` 只會
 clone 下來之後，在 repo 裡跑才會吃到你改的 template：
 
 ```bash
-git clone https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator.git
+git clone https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator.git
 cd birc-generator
 npm install
 node bin/birc.js --help
@@ -245,9 +247,9 @@ npm run test:coverage
 npm run test:mutation
 ```
 
-改 template 或 `plopfile.js` 之前，先讀 [AGENTS.md](./AGENTS.md) 的目錄，
+改 template、`plopfile.js` 或 `lib/` 之前，先讀 [AGENTS.md](./AGENTS.md) 的目錄，
 規範在 [PROJECT.md](./PROJECT.md)。wiki 的
-[改產生器](https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/wikis/開發人員/改產生器)
+[改產生器](https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/wikis/開發人員/改產生器)
 是給人看的精簡版。
 
 發版順序：先把改動推進 GitLab `main`，再改 `package.json` 的 `version`，

package/bin/birc.js

@@ -336,15 +336,21 @@ async function runGenerator(name, bypassArr, flags) {
     },
     onFailure(fail) {
       failed = true;
-      const { alreadyExistsMessage } = require('./cli-util');
-      const rewritten = alreadyExistsMessage(fail);
+      const { isAbortedFollowOn, formatAlreadyExistsHelp } = require('./cli-util');
+      if (isAbortedFollowOn(fail)) {
+        return;
+      }
+      const rewritten = formatAlreadyExistsHelp(fail, {
+        command: name,
+        entityName: answers.entityName
+      });
       if (rewritten) {
-        process.stderr.write(`  ${rewritten}\n`);
+        process.stderr.write(`${rewritten.map((line) => `  ${line}`).join('\n')}\n`);
         return;
       }
       const errMsg = fail.error || fail.message || '';
       const bits = [fail.type, fail.path, errMsg].filter(Boolean);
-      process.stderr.write(`  ${bits.join('  ')}\n`);
+      process.stderr.write(`  Error: ${bits.join('  ')}\n`);
     }
   });
   if (failed) process.exit(1);

package/bin/cli-util.js

@@ -206,9 +206,35 @@ function alreadyExistsMessage(fail = {}) {
   const rawPath = fail.path || (fromError && fromError[1].trim()) || '';
   const fileName = path.basename(String(rawPath).trim());
   if (!fileName) {
-    return '檔案已在，要覆寫用 --force';
+    return 'Error: 檔案已在，要覆寫用 --force';
   }
-  return `${fileName} 已在，要覆寫用 --force`;
+  return `Error: ${fileName} 已在，要覆寫用 --force`;
+}
+
+function isAbortedFollowOn(fail = {}) {
+  return /aborted due to previous action failure/i.test(
+    String(fail.error || fail.message || '')
+  );
+}
+
+function formatAlreadyExistsHelp(fail = {}, context = {}) {
+  const headline = alreadyExistsMessage(fail);
+  if (!headline) return null;
+  const command = String(context.command || '');
+  const entityName = toPascalCaseName(context.entityName || '');
+  const showExtras = entityName
+    && (command === 'make' || command === 'make:entity' || command === 'make:model');
+  if (!showExtras) {
+    return [headline];
+  }
+  const table = entityName.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
+  return [
+    headline,
+    '只要建表，不要動 Java：',
+    `  birc make:migration create_${table}_table`,
+    '只要示範資料：',
+    `  birc make:seeder ${entityName}Seeder`
+  ];
 }
 
 function levenshtein(left, right) {
@@ -419,6 +445,8 @@ module.exports = {
   applyCreatePromptDefaults,
   applyCreateYes,
   alreadyExistsMessage,
+  isAbortedFollowOn,
+  formatAlreadyExistsHelp,
   suggestCommand,
   shouldPrintBanner,
   formatAddNextSteps,

package/lib/create.js

@@ -0,0 +1,150 @@
+const VERSIONS = require('../versions');
+const {
+  toKebab,
+  persistenceLayout,
+  randomDbPassword
+} = require('./project');
+const { featureActions } = require('./features');
+const {
+  exceptionSkeletonActions,
+  serviceSkeletonActions,
+  seederSkeletonActions
+} = require('./make');
+
+function buildCreateActions(data) {
+  const projectDir = toKebab(data.projectName);
+  const basePackagePath = data.basePackage.replace(/\./g, '/');
+
+  const layout = persistenceLayout(data.basePackage, {
+    multiModule: true,
+    projectNameKebab: projectDir
+  });
+
+  const templateData = {
+    ...VERSIONS,
+    basePackage: data.basePackage,
+    projectName: data.projectName,
+    projectNameKebab: projectDir,
+    multiModule: true,
+    entityPackage: layout.entityPackage,
+    daoPackage: layout.daoPackage,
+    entityPath: layout.entityRoot,
+    daoPath: layout.daoRoot,
+    gitlabProjectPath: data.gitlabProjectPath || '',
+    dbRootPassword: randomDbPassword(),
+    dbPassword: randomDbPassword(),
+    hasDocker: (data.features || []).includes('docker')
+  };
+
+  const srcPath = 'src/main/java';
+  const testSrcPath = 'src/test/java';
+  const resourcesPath = 'src/main/resources';
+  const root = `${projectDir}/${srcPath}/${basePackagePath}`;
+  const testRoot = `${projectDir}/${testSrcPath}/${basePackagePath}`;
+  const resourcesRoot = `${projectDir}/${resourcesPath}`;
+  const ymlPath = `${resourcesRoot}/application.yml`;
+  const gradlePath = `${projectDir}/build.gradle`;
+
+  let actions = [
+    { type: 'assertCreateDestFree', abortOnFail: true },
+    { type: 'add', path: `${root}/Application.java`, templateFile: 'templates/base/Application.hbs', data: templateData },
+    { type: 'add', path: `${testRoot}/ApplicationTests.java`, templateFile: 'templates/base/ApplicationTests.java.hbs', data: templateData },
+    { type: 'add', path: `${testRoot}/CorsTest.java`, templateFile: 'templates/base/CorsTest.java.hbs', data: templateData },
+    { type: 'add', path: `${projectDir}/src/test/resources/application.yml`, templateFile: 'templates/base/application-test.yml.hbs', data: templateData },
+    { type: 'add', path: gradlePath, templateFile: 'templates/multi-module/build.gradle.hbs', data: templateData },
+    { type: 'add', path: `${projectDir}/settings.gradle`, templateFile: 'templates/multi-module/settings.gradle.hbs', data: templateData },
+    { type: 'add', path: `${resourcesRoot}/application.yml`, templateFile: 'templates/base/application.yml.hbs', data: templateData },
+    { type: 'add', path: `${projectDir}/.gitignore`, templateFile: 'templates/base/gitignore.hbs', data: templateData },
+    { type: 'copyFile', from: 'templates/gradle-wrapper/gradlew', path: `${projectDir}/gradlew`, executable: true },
+    { type: 'copyFile', from: 'templates/gradle-wrapper/gradlew.bat', path: `${projectDir}/gradlew.bat` },
+    {
+      type: 'copyFile',
+      from: 'templates/gradle-wrapper/gradle/wrapper/gradle-wrapper.jar',
+      path: `${projectDir}/gradle/wrapper/gradle-wrapper.jar`
+    },
+    {
+      type: 'copyFile',
+      from: 'templates/gradle-wrapper/gradle/wrapper/gradle-wrapper.properties',
+      path: `${projectDir}/gradle/wrapper/gradle-wrapper.properties`
+    },
+    {
+      type: 'add',
+      path: `${projectDir}/.bircrc.json`,
+      templateFile: 'templates/base/bircrc.hbs',
+      data: { ...templateData, featuresJson: JSON.stringify(data.features) }
+    }
+  ];
+  actions = actions.concat(exceptionSkeletonActions(root, templateData));
+  actions = actions.concat(serviceSkeletonActions(root, templateData));
+  actions = actions.concat(seederSkeletonActions(root, templateData));
+
+  const configRoot = `${projectDir}/modules/${projectDir}-config/src/main/java/${basePackagePath}/config`;
+  actions.push(
+    { type: 'add', path: `${projectDir}/modules/${projectDir}-config/build.gradle`, templateFile: 'templates/multi-module/config/build.gradle.hbs', data: templateData },
+    { type: 'add', path: `${configRoot}/Config.java`, templateFile: 'templates/multi-module/config/Config.java.hbs', data: templateData },
+    { type: 'add', path: `${configRoot}/ApplicationConfig.java`, templateFile: 'templates/multi-module/config/ApplicationConfig.java.hbs', data: templateData },
+    { type: 'add', path: `${configRoot}/SecurityConfig.java`, templateFile: 'templates/multi-module/config/SecurityConfig.java.hbs', data: templateData },
+    { type: 'add', path: `${configRoot}/SecurityCustomizer.java`, templateFile: 'templates/multi-module/config/SecurityCustomizer.java.hbs', data: templateData }
+  );
+
+  const dbConfigRoot = `${projectDir}/modules/${projectDir}-database-config/src/main/java/${basePackagePath}/databaseconfig`;
+  actions.push(
+    { type: 'add', path: `${projectDir}/modules/${projectDir}-database-config/build.gradle`, templateFile: 'templates/multi-module/database-config/build.gradle.hbs', data: templateData },
+    { type: 'add', path: `${dbConfigRoot}/Config.java`, templateFile: 'templates/multi-module/database-config/Config.java.hbs', data: templateData },
+    { type: 'add', path: `${dbConfigRoot}/JpaConfig.java`, templateFile: 'templates/multi-module/database-config/JpaConfig.java.hbs', data: templateData },
+    { type: 'add', path: `${projectDir}/${layout.daoRoot}/BaseViewDAO.java`, templateFile: 'templates/multi-module/database-config/BaseViewDAO.java.hbs', data: templateData },
+    { type: 'add', path: `${projectDir}/${layout.daoRoot}/BaseDAO.java`, templateFile: 'templates/multi-module/database-config/BaseDAO.java.hbs', data: templateData }
+  );
+
+  for (const featureKey of data.features) {
+    actions = actions.concat(
+      featureActions(featureKey, {
+        root,
+        testRoot,
+        entityRoot: `${projectDir}/${layout.entityRoot}`,
+        daoRoot: `${projectDir}/${layout.daoRoot}`,
+        resourcesRoot,
+        projectRoot: projectDir,
+        ymlPath,
+        gradlePath,
+        templateData
+      })
+    );
+  }
+
+  actions.push({
+    type: 'add',
+    path: `${projectDir}/README.md`,
+    templateFile: 'templates/base/README.md.hbs',
+    data: templateData,
+    skipIfExists: true
+  });
+
+  if (data.injectDocs) {
+    actions.push(
+      { type: 'add', path: `${projectDir}/AGENTS.md`, templateFile: 'project-docs/AGENTS.md.hbs', data: templateData },
+      { type: 'add', path: `${projectDir}/PROJECT.md`, templateFile: 'project-docs/PROJECT.md.hbs', data: templateData },
+      { type: 'add', path: `${projectDir}/implement.md`, templateFile: 'project-docs/implement.hbs', data: templateData },
+      { type: 'add', path: `${projectDir}/test.md`, templateFile: 'project-docs/test.hbs', data: templateData }
+    );
+  }
+
+  if ((data.features || []).includes('docker')) {
+    actions.push({
+      type: 'copyIfExists',
+      from: `${projectDir}/.env.example`,
+      path: `${projectDir}/.env`
+    });
+  }
+
+  if ((data.features || []).includes('auth')) {
+    actions.push({
+      type: 'ensureJwtSecret',
+      path: `${projectDir}/.env`
+    });
+  }
+
+  return actions;
+}
+
+module.exports = { buildCreateActions };