birc-generator 0.5.5 → 0.9.0

package/PROJECT.md

@@ -12,7 +12,7 @@ anchor 就不要重寫整份設定；推測以後會用到的模組先不要做
 | 要做的事 | Seam | 誰會吃到 |
 | --- | --- | --- |
 | 新的可選模組 | `FEATURES` + `templates/<key>/` | `create`、`add`（共用 `featureActions`） |
-| `make` / `make:*` 骨架 | `templates/*.hbs` + `makeStackActions` / 單層 actions | `make`（整組）、`make:entity`、`make:model`、`make:mapper`、`make:service`、`make:controller`、`make:exception`、`make:migration` |
+| `make` / `make:*` 骨架 | `templates/*.hbs` + `makeStackActions` / 單層 actions | `make`（整組）、`make:entity`、`make:model`、`make:mapper`、`make:service`、`make:controller`、`make:exception`、`make:migration`、`make:seeder` |
 | 注入給產出專案的 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） |
@@ -48,7 +48,7 @@ anchor 就不要重寫整份設定；推測以後會用到的模組先不要做
 
 ## 慣例
 
-**make 一次整組。** `make` 串 `makeStackActions`：Entity + DAO + Mapper + DTO + Service + Controller。單層指令共用同一組 actions，不另寫一份。`make:entity` 產出 Entity、`XxxDAO extends BaseDAO`。`make:model` 同 Entity + DAO；`--migration` 生 `create_{table}_table`（表名跟 Entity 的 snake_case 對齊，`Flight` → `flight`），`--seed` 生下一版 `seed_{table}` SQL，`--controller` 生 Controller。`--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` 才生完整範例（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` 才執行）。單層指令共用同一組 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 +67,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` / `docs` 從目前目錄往上找 `.bircrc.json`，檔案落在找到的專案根。`birc add email sentry` 可帶 feature 名（也接受 `file-upload` 這種 kebab）；沒帶參數仍互動勾選。打錯功能名會給近似建議。未知旗標會失敗並提示正確名稱。`docs` 用 `.bircrc.json` 的專案名，不再問。`make` 撞到已有檔會提示 `--force`；`--force` 覆寫那組 Java。`--fields` 沒配 `--example` 會提醒，欄位不會寫進 Entity。
+**`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 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` 裝無關。
 
@@ -76,8 +76,8 @@ anchor：`dependencies {}` 的 `// birc-generator:dependency-anchor`、`plugins
 `// birc-generator:plugin-anchor`、`allprojects {}` 的
 `// birc-generator:allprojects-anchor`。`add` 的 gradle append 只有 dest 檔裡有對應那一行才插得進去。
 
-**`make:migration`。** Laravel 風格名稱：`create_users_table`、`add_votes_to_users_table`、`remove_votes_from_users_table`。檔案落在 `src/main/resources/db/migration/V{n}__{name}.sql`。
+**`make:migration`。** Laravel 風格名稱：`create_users_table`、`add_votes_to_users_table`、`remove_votes_from_users_table`。檔案落在 `src/main/resources/db/migration/V{n}__{name}.sql`。`create_{table}_table` 讀既有 Entity（先對 `@Table(name)`，沒對上再用檔名）把欄位寫進 CREATE TABLE；`@SoftDelete` 加 `deleted_at`。String 預設長度 50（Entity `length = 50`、SQL `VARCHAR(50)`）。找不到 Entity 時只有 `id`，或 `--example` 時的 `name` + timestamps 初稿。`make` / `make:model --migration --fields` 以旗標欄位為準。`--seed` / `make:seeder BookSeeder` 生 Java `XxxSeeder`（讀 `--fields` 或既有 Entity，略過 `id` / timestamps）；沒有欄位時 `run()` 是空的。示範資料不進 Flyway。
 
-**`migrate`。** `birc migrate` 在目標專案跑 Gradle wrapper 的 `flywayMigrate`（Unix `./gradlew`，Windows `gradlew.bat`）。`migrate:reset` 是 `flywayClean` + `flywayMigrate`（`--force` 略過確認）。找不到 wrapper 或 spawn 失敗要印錯誤，不要只帶 banner 就結束。Flyway Community **沒有** Laravel 的 rollback；`migrate:rollback` 只說明這件事。undo 要 Flyway Teams 的 `flywayUndo` 加 `U{version}__*.sql`。
+**`migrate` / `seed` / `db:wipe`。** `birc migrate` 在目標專案跑 Gradle wrapper 的 `flywayMigrate`（Unix `./gradlew`，Windows `gradlew.bat`）。`migrate:reset` 是 `flywayClean` + `flywayMigrate`（`--force` 略過確認）。`birc db:wipe` 只跑 `flywayClean`（`--force` 略過確認）。`birc seed` 跑 `bootRun --args=--spring.main.web-application-type=none --birc.seed`，執行 `Seeder` 後結束。找不到 wrapper 或 spawn 失敗要印錯誤，不要只帶 banner 就結束。Flyway Community **沒有** Laravel 的 rollback；`migrate:rollback` 只說明這件事。undo 要 Flyway Teams 的 `flywayUndo` 加 `U{version}__*.sql`。
 
 產出的註解與注入文件用繁中，跟現有 template 一致。目標專案設定欄位以 `.bircrc.example.json` 與 `templates/base/bircrc.hbs` 為準。

package/README.md

@@ -21,17 +21,9 @@ CRUD 用 `birc make`。多模組目錄、`BaseDAO`、`ProjectException` 會先
 
 ## 安裝
 
-需要 Node 18 以上。一般只要裝全域的 `birc`，不必 clone。三種擇一：
-npm、`curl | bash`、PowerShell 的 `irm | iex`。同一台不要混裝，PATH 會搶
-同一個 `birc`。改產生器、或要跑還沒發到 npm 的 commit，才 clone。
-
-`birc update` 會自己判斷來源。npm 裝的等同
-`npm install -g birc-generator@latest`；`curl` / PowerShell 裝的都拉
-GitLab 到 `~/.birc-generator`。
-
-### npm
-
-Win11、WSL、macOS、Linux 都可以。
+需要 Node 18 以上。只走 npm。Win11、WSL、macOS、Linux 都可以。一般只要
+裝全域的 `birc`，不必 clone。改產生器、或要跑還沒發到 npm 的 commit，才
+clone。
 
 ```bash
 npm install -g birc-generator
@@ -44,47 +36,12 @@ npm update -g birc-generator
 npm uninstall -g birc-generator
 ```
 
-使用時若偵測到新版本，會問要不要更新。說不要的話，同一版本 24 小時內
-不會再問。不想檢查就設 `BIRC_SKIP_UPDATE_CHECK=1`。CI 或不是互動終端
-也不會問。
-
-### curl | bash
-
-給 macOS、Linux、WSL、Git Bash。程式放到 `~/.birc-generator`，並把
-`birc` 寫進使用者自己的 bin。不需要 sudo。PowerShell 不要貼這條：內建
-`curl` 是 `Invoke-WebRequest`，會報找不到參數 `-fsSL`。改用下面的
-PowerShell 安裝。
-
-```bash
-curl -fsSL https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/install.sh | bash
-```
-
-關掉終端再開一次，跑 `birc --help`。之後更新用 `birc update`。還沒有
-這個指令的舊安裝，再跑一次上面的 `install.sh`。
+`birc update` 等同 `npm install -g birc-generator@latest`。使用時若偵測到
+新版本，會問要不要更新。說不要的話，同一版本 24 小時內不會再問。不想檢查
+就設 `BIRC_SKIP_UPDATE_CHECK=1`。CI 或不是互動終端也不會問。
 
-解除安裝：
-
-```bash
-curl -fsSL https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/uninstall.sh | bash
-```
-
-### PowerShell
-
-給 Windows 原生 PowerShell 5.1 或 7。落地目錄跟 `curl | bash` 相同
-（`%USERPROFILE%\.birc-generator`），所以之後的 `birc update` 是同一條路。
-`irm | iex` 在記憶體執行，通常不必改 ExecutionPolicy。
-
-```powershell
-irm https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/install.ps1 | iex
-```
-
-關掉終端再開一次，跑 `birc --help`。之後更新用 `birc update`。
-
-解除安裝：
-
-```powershell
-irm https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/uninstall.ps1 | iex
-```
+以前用 `curl | bash` 或 PowerShell 裝到 `~/.birc-generator` 的，改裝 npm
+全域套件，並自行刪掉那個目錄。
 
 ## 第一次用
 
@@ -146,8 +103,8 @@ birc make
 輸入 `Activity` 或 `activity`，會一次寫出 Entity、DAO、Mapper、DTO、
 Service、Controller。小寫會自動收成 PascalCase。只要其中一層，改跑
 `birc make:entity` 或 `birc make:controller`。預設是初稿，完整範例加
-`--example`。欄位可寫 `--fields title:String,startTime:LocalDateTime`，
-就不會再問一次（要配 `--example`，否則只會提醒、欄位不會寫進 Entity）。
+`--example`，或直接帶 `--fields`。欄位可寫 `--fields title:String,startTime:LocalDateTime`，
+就不會再問一次。
 檔已存在時會停下來；要覆寫加 `--force`。
 
 腳本或課堂示範可 `birc create Practice --yes`，其餘用預設（docker、log4j2、
@@ -162,35 +119,44 @@ ValidGroup、Spotless、注入 agent 文件），不再問。
 | 指令 | 做什麼 |
 | --- | --- |
 | `birc create` | 開一個多模組 Spring Boot 4 專案。`--yes` 其餘用預設、不要問 |
-| `birc update` | 更新本機 `birc`。npm 裝的跑 `npm install -g`；curl / PowerShell / clone 拉 GitLab `main` |
+| `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 |
-| `birc make:entity` | Entity、`XxxDAO`；加 `--dto`、`--mapper`、`--soft-delete`。已有檔要覆寫加 `--force` |
+| `birc make` | 一次生 Entity + DAO + Mapper + DTO + Service + Controller；加 `--migration` / `--seed` |
+| `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 |
 | `birc make:service` | `XxxService extends BaseService`，CRUD 在 `BaseServiceImpl` |
 | `birc make:controller` | Controller |
 | `birc make:exception` | 繼承 `ProjectException` 的例外類 |
-| `birc make:migration` | Flyway SQL（`create_users_table`、`add_votes_to_users_table`） |
+| `birc make:migration` | Flyway SQL（`create_book_table` 會讀 Book 欄位；`add_votes_to_users_table` 仍是檔名） |
+| `birc make:seeder` | Java `XxxSeeder`（讀 Entity 或 `--fields`） |
 | `birc docs` | 補 `AGENTS.md` / `PROJECT.md` / `implement.md` / `test.md`（專案名從 `.bircrc.json` 讀） |
 | `birc migrate` | 在專案裡跑 Gradle wrapper 的 `flywayMigrate`（Unix `./gradlew`，Windows `gradlew.bat`） |
 | `birc migrate:rollback` | Flyway Community 做不到 rollback，指令會說明替代作法 |
 | `birc migrate:reset` | `flywayClean` 後再 `flywayMigrate`（`--force` 略過確認） |
+| `birc seed` | 跑 Java Seeder（`bootRun --birc.seed`，跑完結束） |
+| `birc db:wipe` | 清空資料庫（`flywayClean`）。沒加 `--force` 先問一次 |
 
 ```bash
 birc create Practice --yes
 birc make:entity User --dto
 birc make:entity User --mapper
 birc make:entity User --example
-birc make:entity User --example --fields title:String,startTime:LocalDateTime
+birc make:entity User --fields title:String,startTime:LocalDateTime
+birc make Book --fields title:String,author:String,isbn:String,price:BigDecimal,publishedAt:LocalDate --migration --seed
+birc migrate
+birc seed
+birc db:wipe
 birc make:entity User --force
 birc make:model Flight --migration
 birc make:model Flight --seed
 birc make:model Flight --controller
 birc make:model Flight --soft-delete
 birc make:model Flight --migration --soft-delete
-birc make:migration create_users_table
+birc make:entity Book --fields title:String,author:String,isbn:String,price:BigDecimal,publishedAt:LocalDate
+birc make:migration create_book_table
+birc make:seeder BookSeeder
 birc add
 birc add email
 birc add email sentry
@@ -202,7 +168,7 @@ birc migrate
 
 指令是 `make:entity`，中間一條冒號，跟 Laravel artisan 一樣。
 `birc add` 沒帶名稱時會問你要加哪些模組；也可以寫 `birc add docker` 或 `birc add file-upload`。
-`make:migration add_votes_to_users_table` 裡的 `add_votes_...` 只是 SQL 檔名。
+`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)、
@@ -261,7 +227,7 @@ Mapper 用 MapStruct。Controller 只轉 DTO，業務寫在 Service。
 SSH 部署骨架，帳密仍放 GitLab CI/CD Variables，不要寫進 repo。
 
 Flyway Community 沒有 Laravel 的 rollback。`birc migrate:rollback` 只會
-說明替代作法：再寫一筆往前的遷移。`birc migrate` 會真的跑 Gradle wrapper 的 `flywayMigrate`，不是只印指令。
+說明替代作法：再寫一筆往前的遷移。`birc migrate` 會真的跑 Gradle wrapper 的 `flywayMigrate`，不是只印指令。示範資料用 `birc seed`；清空資料庫用 `birc db:wipe`。
 
 ## 改這個產生器
 
@@ -286,8 +252,7 @@ npm run test:mutation
 
 發版順序：先把改動推進 GitLab `main`，再改 `package.json` 的 `version`，
 最後 `npm publish`。只推 GitLab、不 publish 的話，`npm install -g` 的人
-拿不到新版；只 publish、不合進 `main` 的話，`curl | bash` /
-`irm | iex` / `birc update` 會跟 npm 版本對不上。
+拿不到新版。
 
 ## 接下來
 

package/bin/birc.js

@@ -25,16 +25,17 @@ const HELP_SECTIONS = [
   },
   {
     title: '骨架',
-    note: '寫法是 make:種類 [名稱]。預設只生引入與初稿；加 --example 才有完整範例',
+    note: '寫法是 make:種類 [名稱]。預設只生引入與初稿；加 --example 或 --fields 才有完整範例',
     commands: [
-      ['make', '一次生 Entity + DAO + Mapper + DTO + Service + Controller'],
-      ['make:entity', 'Entity、XxxDAO（--dto / --mapper / --soft-delete）'],
+      ['make', '一次生 Entity + DAO + Mapper + DTO + Service + Controller；--migration / --seed'],
+      ['make:entity', 'Entity、XxxDAO（--migration / --seed / --dto / --mapper / --soft-delete）'],
       ['make:model', '同 make:entity；--migration / --seed / --controller / --soft-delete'],
       ['make:mapper', 'Mapper、CreateRequest、Response'],
       ['make:service', 'XxxService extends BaseService'],
       ['make:controller', 'Controller'],
       ['make:exception', '繼承 ProjectException 的例外'],
-      ['make:migration', 'Flyway SQL（檔名如 create_users_table）'],
+      ['make:migration', 'Flyway SQL（create_book_table 會讀 Entity 欄位）'],
+      ['make:seeder', 'Java Seeder（讀 Entity 欄位；birc seed 才執行）'],
     ]
   },
   {
@@ -42,7 +43,9 @@ const HELP_SECTIONS = [
     commands: [
       ['migrate', '套用待執行的遷移（flywayMigrate）'],
       ['migrate:reset', '清 schema 再重跑（flywayClean + migrate）'],
-      ['migrate:rollback', 'Community 做不到 rollback，會印替代作法']
+      ['migrate:rollback', 'Community 做不到 rollback，會印替代作法'],
+      ['seed', '跑 Java Seeder（bootRun --birc.seed，跑完就結束）'],
+      ['db:wipe', '清空資料庫（flywayClean）。沒加 --force 先問一次']
     ]
   },
   {
@@ -53,7 +56,8 @@ const HELP_SECTIONS = [
   }
 ];
 
-const FLYWAY_COMMANDS = new Set(['migrate', 'migrate:rollback', 'migrate:reset']);
+const FLYWAY_COMMANDS = new Set(['migrate', 'migrate:rollback', 'migrate:reset', 'db:wipe']);
+const SEED_COMMANDS = new Set(['seed']);
 
 function allCommandNames() {
   return HELP_SECTIONS.flatMap((section) => section.commands.map(([name]) => name));
@@ -170,12 +174,12 @@ function printHelp() {
       `  ${'--example'.padEnd(nameWidth + 2)}make:* 產出完整範例`,
       `  ${'--dto'.padEnd(nameWidth + 2)}make:entity 順便生 Mapper 與 DTO`,
       `  ${'--mapper'.padEnd(nameWidth + 2)}同 --dto`,
-      `  ${'--migration'.padEnd(nameWidth + 2)}make:model 順便生 create_{table}_table`,
-      `  ${'--seed'.padEnd(nameWidth + 2)}make:model 順便生 seed_{table}`,
+      `  ${'--migration'.padEnd(nameWidth + 2)}make / make:entity / make:model 順便生 create_{table}_table`,
+      `  ${'--seed'.padEnd(nameWidth + 2)}make / make:entity / make:model 順便生 Java Seeder`,
       `  ${'--controller'.padEnd(nameWidth + 2)}make:model 順便生 Controller`,
       `  ${'--soft-delete'.padEnd(nameWidth + 2)}make:entity / make:model 加 deleted_at 軟刪`,
-      `  ${'--fields'.padEnd(nameWidth + 2)}make --example 的欄位，例如 title:String,startTime:LocalDateTime`,
-      `  ${'--force'.padEnd(nameWidth + 2)}migrate:reset 略過確認；add 覆寫已選的已安裝 feature；make 覆寫已有 Java`,
+      `  ${'--fields'.padEnd(nameWidth + 2)}make 的欄位，例如 title:String,startTime:LocalDateTime（有帶就當完整產出）`,
+      `  ${'--force'.padEnd(nameWidth + 2)}migrate:reset / db:wipe 略過確認；add 覆寫已選的已安裝 feature；make 覆寫已有 Java`,
       `  ${'--yes'.padEnd(nameWidth + 2)}create 其餘用預設、不要問`,
       '',
       '例子',
@@ -193,15 +197,21 @@ function printHelp() {
       '  birc make:entity User --dto',
       '  birc make:entity User --mapper',
       '  birc make:entity User --example',
-      '  birc make:entity User --example --fields title:String,startTime:LocalDateTime',
+      '  birc make:entity User --fields title:String,startTime:LocalDateTime',
+      '  birc make:entity Book --migration',
+      '  birc make:entity Book --seed',
+      '  birc make Book --fields title:String,author:String --migration --seed',
       '  birc make:entity User --force',
       '  birc make:model Flight --migration',
       '  birc make:model Flight --seed',
       '  birc make:model Flight --controller',
       '  birc make:model Flight --soft-delete',
-      '  birc make:migration create_users_table',
+      '  birc make:seeder BookSeeder',
+      '  birc make:migration create_book_table',
       '  birc make:migration add_votes_to_users_table',
       '  birc migrate',
+      '  birc seed',
+      '  birc db:wipe',
       '',
       'create / update 以外的指令會從目前目錄往上找 .bircrc.json。',
       ''
@@ -236,7 +246,8 @@ async function runGenerator(name, bypassArr, flags) {
     process.exit(1);
   }
 
-  if (flags.example) {
+  const hasFields = Boolean(String(flags.fields || '').trim());
+  if (flags.example || hasFields) {
     process.env.BIRC_EXAMPLE = '1';
   }
   if (flags.dto) {
@@ -293,12 +304,8 @@ async function runGenerator(name, bypassArr, flags) {
   }
   if (flags.fields) {
     process.env.BIRC_MAKE_FIELDS = flags.fields;
-    const { applyMakeFieldsFlag, fieldsWithoutExampleMessage } = require('./cli-util');
+    const { applyMakeFieldsFlag } = require('./cli-util');
     applyMakeFieldsFlag(generator.prompts, flags.fields);
-    if (name === 'make' || String(name).startsWith('make:')) {
-      const warn = fieldsWithoutExampleMessage(flags);
-      if (warn) process.stderr.write(`${warn}\n`);
-    }
   }
   const answers = await generator.runPrompts(promptBypass);
   if (createYes) {
@@ -310,7 +317,7 @@ async function runGenerator(name, bypassArr, flags) {
   if (flags.fields) {
     answers.fields = flags.fields;
   }
-  answers.example = Boolean(answers.example) || flags.example;
+  answers.example = Boolean(answers.example) || flags.example || hasFields;
   answers.dto = Boolean(answers.dto) || flags.dto;
   answers.mapper = Boolean(answers.mapper) || flags.mapper;
   answers.migration = Boolean(answers.migration) || flags.migration;
@@ -391,11 +398,16 @@ function printCreateNextSteps(answers) {
     '',
     '生 CRUD 骨架（會從目前目錄往上找 .bircrc.json）：',
     '  birc make                 # Entity + DAO + Mapper + DTO + Service + Controller',
+    '  birc make Book --fields title:String --migration --seed',
     '  birc make:entity          # Entity / DAO',
     '  birc make:entity User --dto',
     '  birc make:model Flight --migration --seed --controller',
+    '  birc make:seeder BookSeeder',
     '  birc make:entity User --example',
-    '  birc make:migration create_users_table',
+    '  birc make:migration create_book_table',
+    '  birc migrate',
+    '  birc seed',
+    '  birc db:wipe',
     '  birc add                  # 之後再補 docker / email 等功能',
     '',
     '打包：',
@@ -503,9 +515,14 @@ async function runFlyway(command, flags) {
     process.exit(1);
   }
 
-  if (command === 'migrate:reset') {
+  if (command === 'migrate:reset' || command === 'db:wipe') {
+    const wiping = command === 'db:wipe';
     if (!flags.force) {
-      const ok = await confirmYes('這會清掉 schema 再重跑全部遷移。確定？ [y/N] ');
+      const ok = await confirmYes(
+        wiping
+          ? '這會清掉 schema 與資料。確定？ [y/N] '
+          : '這會清掉 schema 再重跑全部遷移。確定？ [y/N] '
+      );
       if (!ok) {
         process.stdout.write('已取消。\n');
         return;
@@ -515,6 +532,9 @@ async function runFlyway(command, flags) {
     if (cleanStatus !== 0) {
       process.exit(cleanStatus);
     }
+    if (wiping) {
+      process.exit(0);
+    }
     process.exit(runGradle(['flywayMigrate']));
   }
 
@@ -635,6 +655,12 @@ async function main() {
     await runFlyway(command, flags);
     return;
   }
+  if (SEED_COMMANDS.has(command)) {
+    process.exit(runGradle([
+      'bootRun',
+      '--args=--spring.main.web-application-type=none --birc.seed'
+    ]));
+  }
 
   await runGenerator(command, flags.positionals.slice(1), flags);
 }

package/bin/cli-util.js

@@ -56,10 +56,11 @@ function projectConfigMissingMessage() {
   return '找不到 .bircrc.json，先在專案根目錄建立設定檔（可複製 .bircrc.example.json 改名，或用 birc create 建新專案）';
 }
 
-function findProjectRoot(startDir, exists = fs.existsSync) {
+function findProjectRoot(startDir, exists = fs.existsSync, maxDepth = 10) {
   let current = path.resolve(startDir || '');
   const { root } = path.parse(current);
-  while (true) {
+  let depth = 0;
+  while (depth < maxDepth) {
     if (exists(path.join(current, '.bircrc.json'))) {
       return current;
     }
@@ -71,7 +72,9 @@ function findProjectRoot(startDir, exists = fs.existsSync) {
       return null;
     }
     current = parent;
+    depth += 1;
   }
+  return null;
 }
 
 function toKebabName(value) {
@@ -208,14 +211,6 @@ function alreadyExistsMessage(fail = {}) {
   return `${fileName} 已在，要覆寫用 --force`;
 }
 
-function fieldsWithoutExampleMessage(flags = {}) {
-  const hasFields = Boolean(String(flags.fields || '').trim());
-  if (!hasFields || flags.example) {
-    return null;
-  }
-  return '--fields 要配 --example 才會寫進 Entity';
-}
-
 function levenshtein(left, right) {
   const a = String(left || '');
   const b = String(right || '');
@@ -291,10 +286,18 @@ function formatMakeNextSteps(name, answers = {}) {
   const command = String(name || '');
   const wantsMigrate = command === 'make:migration'
     || command === 'migration'
-    || Boolean(answers.migration)
-    || Boolean(answers.seed);
+    || Boolean(answers.migration);
+  const wantsSeed = command === 'make:seeder' || Boolean(answers.seed);
+  const lines = [''];
   if (wantsMigrate) {
-    return ['', '套用遷移：', '  birc migrate', ''];
+    lines.push('套用遷移：', '  birc migrate');
+  }
+  if (wantsSeed) {
+    lines.push('寫入示範資料：', '  birc seed');
+  }
+  if (wantsMigrate || wantsSeed) {
+    lines.push('');
+    return lines;
   }
   if (command === 'make' || command.startsWith('make:')) {
     return ['', '骨架已寫好。建表可加 --migration，再 birc migrate。', ''];
@@ -416,7 +419,6 @@ module.exports = {
   applyCreatePromptDefaults,
   applyCreateYes,
   alreadyExistsMessage,
-  fieldsWithoutExampleMessage,
   suggestCommand,
   shouldPrintBanner,
   formatAddNextSteps,

package/bin/home-install.js

@@ -1,10 +1,11 @@
 const fs = require('fs');
 const https = require('https');
+const crypto = require('crypto');
 const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
 
-const DEFAULT_BASE_URL = 'https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator';
+const DEFAULT_BASE_URL = 'https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator';
 
 function npmCmd(platform = process.platform) {
   return platform === 'win32' ? 'npm.cmd' : 'npm';
@@ -84,7 +85,8 @@ function installCommand(jsPath, {
   fs.mkdirSync(dir, { recursive: true });
 
   if (platform === 'win32') {
-    fs.writeFileSync(path.join(dir, 'birc.cmd'), `@echo off\r\nnode "${resolved}" %*\r\n`);
+    const cmdPath = resolved.replace(/\//g, '\\');
+    fs.writeFileSync(path.join(dir, 'birc.cmd'), `@echo off\r\nnode "${cmdPath}" %*\r\n`);
     fs.writeFileSync(
       path.join(dir, 'birc.ps1'),
       `& node "${resolved.replace(/\\/g, '/')}" @args\n`
@@ -241,7 +243,7 @@ async function confirmCustomBase(baseUrl) {
 }
 
 function npmInstall(cwd, platform = process.platform) {
-  spawnOrThrow(npmCmd(platform), ['install'], {
+  spawnOrThrow(npmCmd(platform), ['install', '--ignore-scripts'], {
     cwd,
     stdio: 'inherit',
     shell: platform === 'win32',

package/bin/update-check.js

@@ -7,7 +7,7 @@ const pkg = require(path.join(__dirname, '..', 'package.json'));
 
 const NPM_LATEST = `https://registry.npmjs.org/${pkg.name}/latest`;
 const GITLAB_PACKAGE =
-  'https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/package.json';
+  'https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/raw/main/package.json';
 const SNOOZE_FILE = path.join(os.homedir(), '.birc-update-check.json');
 const FETCH_TIMEOUT_MS = 2500;
 const MAX_REDIRECTS = 5;

package/install.ps1

@@ -1,5 +1,5 @@
 # 用法:
-#   irm https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/install.ps1 | iex
+#   irm https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/raw/main/install.ps1 | iex
 # 或下載後執行: powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
 # 需要 Node.js 18+ 與 npm。程式會放到 $HOME\.birc-generator，跟 curl | bash 同一處。
 
@@ -19,7 +19,7 @@ function Write-Err([string]$Message) {
     exit 1
 }
 
-$BaseUrl = if ($env:BIRC_BASE_URL) { $env:BIRC_BASE_URL.TrimEnd('/') } else { 'https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator' }
+$BaseUrl = if ($env:BIRC_BASE_URL) { $env:BIRC_BASE_URL.TrimEnd('/') } else { 'https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator' }
 $InstallDir = Join-Path $HOME '.birc-generator'
 
 function Test-NodeAndNpm {

package/install.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 set -e
 
-# 用法: curl -fsSL https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/install.sh | bash
+# 用法: curl -fsSL https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/raw/main/install.sh | bash
 # 或下載後執行: bash install.sh
 
 RED='\033[0;31m'
@@ -14,7 +14,7 @@ warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
 error() { echo -e "${RED}[ERROR]${NC} $1"; exit 1; }
 
 INSTALL_DIR="$HOME/.birc-generator"
-DEFAULT_BASE_URL="https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator"
+DEFAULT_BASE_URL="https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator"
 BASE_URL="${BIRC_BASE_URL:-$DEFAULT_BASE_URL}"
 BASE_URL="${BASE_URL%/}"
 
@@ -161,7 +161,14 @@ download_project() {
     tmp_tar="$(mktemp)"
     mkdir -p "$INSTALL_DIR"
     curl -fsSL "$TAR_URL" -o "$tmp_tar"
+
+    info "驗證下載檔完整性..."
+    if ! file "$tmp_tar" | grep -qi gzip; then
+        rm -f "$tmp_tar"
+        error "下載的檔案不是有效的 gzip 壓縮檔。可能來源不正確或已被篡改。已取消安裝。"
+    fi
     validate_tar_safety "$tmp_tar"
+
     tar xzf "$tmp_tar" -C "$INSTALL_DIR" --strip-components=1
     rm -f "$tmp_tar"
     cd "$INSTALL_DIR"
@@ -170,7 +177,7 @@ download_project() {
 
 install_dependencies() {
     info "安裝 Node.js 依賴..."
-    npm install
+    npm install --ignore-scripts
 }
 
 create_symlink() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "birc-generator",
-  "version": "0.5.5",
+  "version": "0.9.0",
   "description": "Spring Boot 4 CRUD scaffold generator built on Plop.js",
   "license": "MIT",
   "author": "lucashsu95",

package/plopfile.js

@@ -4,10 +4,10 @@ const { randomInt } = require('node:crypto');
 const VERSIONS = require('./versions');
 const { deriveBasePackage, projectConfigMissingMessage, toPascalCaseName, createDestConflict } = require('./bin/cli-util');
 
-// .env 的 DB 密碼用：6 碼小寫英文，隨機生成，避免 change_me 這種預設值。
+// .env 的 DB 密碼用：16 碼混合大小寫英文 + 數字，隨機生成，避免 change_me 這種預設值。
 function randomDbPassword() {
-  const letters = 'abcdefghijklmnopqrstuvwxyz';
-  return Array.from({ length: 6 }, () => letters[randomInt(letters.length)]).join('');
+  const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+  return Array.from({ length: 16 }, () => chars[randomInt(chars.length)]).join('');
 }
 
 function projectRoot() {
@@ -156,6 +156,8 @@ function validateMigrationName(value) {
     : '遷移名稱只能包含英文字母、數字和底線，例如 create_users_table。';
 }
 
+const DEFAULT_STRING_COLUMN_LENGTH = 50;
+
 function parseFields(fields) {
   if (!fields || !String(fields).trim()) {
     return [];
@@ -165,20 +167,24 @@ function parseFields(fields) {
     .map((f) => {
       const [name, type] = f.split(':');
       const fieldName = (name || '').trim();
+      const fieldType = (type || 'String').trim();
       return {
         name: fieldName,
-        type: (type || 'String').trim(),
+        type: fieldType,
         snakeName: fieldName
           .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
           .replace(/[\s-]+/g, '_')
-          .toLowerCase()
+          .toLowerCase(),
+        columnLength: fieldType === 'String' ? DEFAULT_STRING_COLUMN_LENGTH : null
       };
     })
     .filter((f) => f.name);
 }
 
 function isExample(data) {
-  return Boolean(data && data.example) || process.env.BIRC_EXAMPLE === '1';
+  return Boolean(data && data.example)
+    || process.env.BIRC_EXAMPLE === '1'
+    || parseFields((data && data.fields) || process.env.BIRC_MAKE_FIELDS).length > 0;
 }
 
 function includeMapperWithEntity(data) {
@@ -214,11 +220,266 @@ function tableNameFromEntity(entityName) {
   return toSnakeCase(entityName);
 }
 
+const JAVA_SQL_TYPES = Object.freeze({
+  String: `VARCHAR(${DEFAULT_STRING_COLUMN_LENGTH}) NULL`,
+  Integer: 'INT NULL',
+  int: 'INT NULL',
+  Long: 'BIGINT NULL',
+  long: 'BIGINT NULL',
+  Boolean: 'TINYINT(1) NULL',
+  boolean: 'TINYINT(1) NULL',
+  BigDecimal: 'DECIMAL(19, 2) NULL',
+  LocalDate: 'DATE NULL',
+  LocalDateTime: 'TIMESTAMP NULL',
+  Instant: 'TIMESTAMP NULL',
+  Double: 'DOUBLE NULL',
+  double: 'DOUBLE NULL',
+  Float: 'FLOAT NULL',
+  float: 'FLOAT NULL',
+  Short: 'SMALLINT NULL',
+  short: 'SMALLINT NULL',
+  Byte: 'TINYINT NULL',
+  byte: 'TINYINT NULL'
+});
+
+function sqlTypeForColumn(javaType, columnName) {
+  if (columnName === 'created_at') {
+    return 'TIMESTAMP DEFAULT CURRENT_TIMESTAMP';
+  }
+  if (columnName === 'updated_at') {
+    return 'TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP';
+  }
+  if (columnName === 'deleted_at') {
+    return 'TIMESTAMP NULL';
+  }
+  return JAVA_SQL_TYPES[javaType] || null;
+}
+
+function fieldsToMigrationColumns(fields, options) {
+  const withTimestamps = Boolean(options && options.withTimestamps);
+  const withSoftDelete = Boolean(options && options.withSoftDelete);
+  const columns = [];
+  const seen = new Set();
+
+  function addColumn(name, javaType) {
+    const columnName = sanitizeMigrationToken(name);
+    if (!columnName || columnName === 'id' || seen.has(columnName)) {
+      return;
+    }
+    const sqlType = sqlTypeForColumn(javaType, columnName);
+    if (!sqlType) {
+      return;
+    }
+    seen.add(columnName);
+    columns.push({ name: columnName, sqlType });
+  }
+
+  for (const field of fields || []) {
+    addColumn(field.snakeName || toSnakeCase(field.name), field.type);
+  }
+  if (withTimestamps) {
+    addColumn('created_at', 'LocalDateTime');
+    addColumn('updated_at', 'LocalDateTime');
+  }
+  if (withSoftDelete) {
+    addColumn('deleted_at', 'LocalDateTime');
+  }
+  return columns;
+}
+
+function listJavaFiles(dir, acc = []) {
+  if (!fs.existsSync(dir)) {
+    return acc;
+  }
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      listJavaFiles(full, acc);
+    } else if (entry.isFile() && entry.name.endsWith('.java')) {
+      acc.push(full);
+    }
+  }
+  return acc;
+}
+
+function parseEntityColumns(source) {
+  const fields = [];
+  const fieldRe =
+    /((?:@\w+(?:\s*\([^)]*\))?\s*)*)private\s+([A-Za-z][A-Za-z0-9_]*)\s+([A-Za-z_][A-Za-z0-9_]*)\s*;/g;
+  let match = fieldRe.exec(source);
+  while (match) {
+    const annotations = match[1] || '';
+    const type = match[2];
+    const name = match[3];
+    const columnAttr = annotations.match(/@Column\s*\(([^)]*)\)/);
+    let snakeName = toSnakeCase(name);
+    if (columnAttr) {
+      const named = columnAttr[1].match(/name\s*=\s*"([^"]+)"/);
+      if (named) {
+        snakeName = named[1];
+      }
+    }
+    fields.push({ name, type, snakeName });
+    match = fieldRe.exec(source);
+  }
+  return {
+    fields,
+    withSoftDelete: /@SoftDelete\b/.test(source)
+  };
+}
+
+function findEntitySourceForTable(tableName, config) {
+  if (!tableName) {
+    return null;
+  }
+  const persistence = resolvePersistence(config);
+  const entityDir = path.join(projectRoot(), persistence.entityRoot);
+  const files = listJavaFiles(entityDir);
+  const escaped = String(tableName).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const tableRe = new RegExp(`@Table\\s*\\([^)]*name\\s*=\\s*"${escaped}"`, 'i');
+  for (const file of files) {
+    const source = fs.readFileSync(file, 'utf8');
+    if (tableRe.test(source)) {
+      return source;
+    }
+  }
+  const className = toPascalCaseName(String(tableName).toLowerCase());
+  if (!className) {
+    return null;
+  }
+  const match = files.find((file) => path.basename(file, '.java') === className);
+  if (!match) {
+    return null;
+  }
+  return fs.readFileSync(match, 'utf8');
+}
+
+function javaLiteralForSeed(javaType) {
+  if (javaType === 'String') {
+    return '"example"';
+  }
+  if (javaType === 'LocalDate') {
+    return 'LocalDate.parse("2020-01-01")';
+  }
+  if (javaType === 'LocalDateTime') {
+    return 'LocalDateTime.parse("2020-01-01T00:00:00")';
+  }
+  if (javaType === 'Instant') {
+    return 'Instant.parse("2020-01-01T00:00:00Z")';
+  }
+  if (javaType === 'BigDecimal') {
+    return 'new BigDecimal("0")';
+  }
+  if (javaType === 'Boolean' || javaType === 'boolean') {
+    return 'false';
+  }
+  if (javaType === 'Long' || javaType === 'long') {
+    return '0L';
+  }
+  if (javaType === 'Integer' || javaType === 'int') {
+    return '0';
+  }
+  if (javaType === 'Short' || javaType === 'short') {
+    return '(short) 0';
+  }
+  if (javaType === 'Byte' || javaType === 'byte') {
+    return '(byte) 0';
+  }
+  if (javaType === 'Double' || javaType === 'double') {
+    return '0D';
+  }
+  if (javaType === 'Float' || javaType === 'float') {
+    return '0F';
+  }
+  if (JAVA_SQL_TYPES[javaType]) {
+    return '0';
+  }
+  return null;
+}
+
+const SKIP_SEED_FIELDS = new Set(['id', 'createdAt', 'updatedAt', 'deletedAt', 'created_at', 'updated_at', 'deleted_at']);
+
+function fieldsToSeedFields(fields) {
+  const result = [];
+  const seen = new Set();
+
+  for (const field of fields || []) {
+    const name = String(field.name || '').trim();
+    const snakeName = field.snakeName || toSnakeCase(name);
+    if (!name || SKIP_SEED_FIELDS.has(name) || SKIP_SEED_FIELDS.has(snakeName) || seen.has(name)) {
+      continue;
+    }
+    const literal = javaLiteralForSeed(field.type);
+    if (!literal) {
+      continue;
+    }
+    seen.add(name);
+    result.push({
+      name,
+      type: field.type,
+      setter: `set${name.charAt(0).toUpperCase()}${name.slice(1)}`,
+      literal
+    });
+  }
+  return result;
+}
+
+function resolveSeedFields(data, tableName, config) {
+  const explicitFields = parseFields(data.fields || process.env.BIRC_MAKE_FIELDS);
+  if (explicitFields.length > 0) {
+    return fieldsToSeedFields(explicitFields);
+  }
+  const source = findEntitySourceForTable(tableName, config);
+  if (source) {
+    return fieldsToSeedFields(parseEntityColumns(source).fields);
+  }
+  if (isExample(data)) {
+    return fieldsToSeedFields([{ name: 'name', type: 'String', snakeName: 'name' }]);
+  }
+  return [];
+}
+
+function entityNameForSeeder(data) {
+  const raw = toPascalCaseName((data && data.entityName) || '');
+  return raw.replace(/Seeder$/, '') || raw;
+}
+
+function resolveCreateTableColumns(data, tableName, config) {
+  const example = isExample(data);
+  const flaggedSoftDelete = includeSoftDelete(data);
+  const explicitFields = parseFields(data.fields || process.env.BIRC_MAKE_FIELDS);
+  if (explicitFields.length > 0) {
+    return fieldsToMigrationColumns(explicitFields, {
+      withTimestamps: example,
+      withSoftDelete: flaggedSoftDelete
+    });
+  }
+  const source = findEntitySourceForTable(tableName, config);
+  if (source) {
+    const entity = parseEntityColumns(source);
+    return fieldsToMigrationColumns(entity.fields, {
+      withTimestamps: false,
+      withSoftDelete: flaggedSoftDelete || entity.withSoftDelete
+    });
+  }
+  if (example) {
+    return fieldsToMigrationColumns(
+      [{ name: 'name', type: 'String', snakeName: 'name' }],
+      { withTimestamps: true, withSoftDelete: flaggedSoftDelete }
+    );
+  }
+  return fieldsToMigrationColumns([], {
+    withTimestamps: false,
+    withSoftDelete: flaggedSoftDelete
+  });
+}
+
 function fieldImports(fields) {
   const types = new Set((fields || []).map((field) => field.type));
   const imports = [];
   if (types.has('LocalDateTime')) imports.push('java.time.LocalDateTime');
   if (types.has('LocalDate')) imports.push('java.time.LocalDate');
+  if (types.has('Instant')) imports.push('java.time.Instant');
   if (types.has('BigDecimal')) imports.push('java.math.BigDecimal');
   return imports;
 }
@@ -229,7 +490,12 @@ function resolveMakeFields(data) {
     return fields;
   }
   if (isExample(data)) {
-    return [{ name: 'name', type: 'String', snakeName: 'name' }];
+    return [{
+      name: 'name',
+      type: 'String',
+      snakeName: 'name',
+      columnLength: DEFAULT_STRING_COLUMN_LENGTH
+    }];
   }
   return [];
 }
@@ -351,6 +617,14 @@ function serviceSkeletonActions(root, templateData) {
   ];
 }
 
+function seederSkeletonActions(root, templateData, options) {
+  const skipIfExists = Boolean(options && options.skipIfExists);
+  return [
+    { type: 'add', path: `${root}/seeder/Seeder.java`, templateFile: 'templates/seeder/Seeder.hbs', data: templateData, skipIfExists },
+    { type: 'add', path: `${root}/seeder/SeedRunner.java`, templateFile: 'templates/seeder/SeedRunner.hbs', data: templateData, skipIfExists }
+  ];
+}
+
 function uniqueFeatureKeys(features) {
   return [...new Set((features || []).filter((featureKey) => FEATURES[featureKey]))];
 }
@@ -874,11 +1148,12 @@ module.exports = function (plop) {
       && !String((answers && answers.fields) || process.env.BIRC_MAKE_FIELDS || '').trim()
   };
 
-  function makeEntityActions(data) {
+  function makeEntityActions(data, options) {
     const { persistence, templateData } = makeContext(data);
+    const skipIfExists = Boolean(options && options.skipIfExists);
     return [
-      { type: 'add', path: `${persistence.entityRoot}/{{pascalCase entityName}}.java`, templateFile: 'templates/entity.hbs', data: templateData },
-      { type: 'add', path: `${persistence.daoRoot}/{{pascalCase entityName}}DAO.java`, templateFile: 'templates/dao.hbs', data: templateData }
+      { type: 'add', path: `${persistence.entityRoot}/{{pascalCase entityName}}.java`, templateFile: 'templates/entity.hbs', data: templateData, skipIfExists },
+      { type: 'add', path: `${persistence.daoRoot}/{{pascalCase entityName}}DAO.java`, templateFile: 'templates/dao.hbs', data: templateData, skipIfExists }
     ];
   }
 
@@ -922,28 +1197,30 @@ module.exports = function (plop) {
   }
 
   function makeStackActions(data) {
-    return [
+    return appendMakeSqlActions([
       ...makeEntityActions(data),
       ...makeMapperActions(data),
       ...makeServiceActions(data),
       ...makeControllerActions(data)
-    ];
+    ], data);
   }
 
   plop.setGenerator('make', {
-    description: '一次產生 Entity + DAO + Mapper + DTO + Service + Controller',
+    description: '一次產生 Entity + DAO + Mapper + DTO + Service + Controller；--migration / --seed',
     prompts: [entityNamePrompt, fieldsPrompt],
     actions: makeStackActions
   });
 
   plop.setGenerator('make:entity', {
-    description: '產生 Entity 與 DAO；--dto / --mapper 加 DTO，--soft-delete 加軟刪',
+    description: '產生 Entity 與 DAO；--migration / --seed / --dto / --mapper / --soft-delete',
     prompts: [entityNamePrompt, fieldsPrompt],
     actions(data) {
-      const actions = makeEntityActions(data);
+      const extras = includeModelMigration(data) || includeModelSeed(data);
+      const actions = makeEntityActions(data, { skipIfExists: extras });
       if (includeMapperWithEntity(data)) {
-        return actions.concat(makeMapperActions(data));
+        actions.push(...makeMapperActions(data));
       }
+      appendMakeSqlActions(actions, data);
       return actions;
     }
   });
@@ -1175,6 +1452,7 @@ module.exports = function (plop) {
       ];
       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(
@@ -1263,6 +1541,9 @@ module.exports = function (plop) {
     const parsed = parseMigrationName(data.description);
     const version = data.migrationVersion || nextMigrationVersion(path.join(projectRoot(), migrationPath));
     const example = isExample(data);
+    const migrationColumns = parsed.kind === 'create'
+      ? resolveCreateTableColumns(data, parsed.tableName, config)
+      : [];
     return [
       {
         type: 'add',
@@ -1273,40 +1554,53 @@ module.exports = function (plop) {
           tableName: parsed.tableName,
           columnName: parsed.columnName,
           withExample: example,
-          withSoftDelete: includeSoftDelete(data)
+          withSoftDelete: includeSoftDelete(data),
+          migrationColumns
         }
       }
     ];
   }
 
-  function makeSeedActions(data) {
-    const config = loadProjectConfig();
-    const migrationPath = migrationDir(config);
-    const tableName = tableNameFromEntity(data.entityName);
-    const description = sanitizeMigrationToken(`seed_${tableName}`) || 'seed';
-    const version = data.migrationVersion || nextMigrationVersion(path.join(projectRoot(), migrationPath));
+  function makeSeederActions(data) {
+    data.entityName = entityNameForSeeder(data);
+    const { root, templateData } = makeContext(data);
+    const entityName = data.entityName;
+    const seederClass = `${entityName}Seeder`;
+    const tableName = tableNameFromEntity(entityName);
+    const seedFields = resolveSeedFields(data, tableName, loadProjectConfig());
     return [
+      ...seederSkeletonActions(root, templateData, { skipIfExists: true }),
       {
         type: 'add',
-        path: `${migrationPath}/V${version}__${description}.sql`,
-        templateFile: 'templates/migration/seed.hbs',
+        path: `${root}/seeder/${seederClass}.java`,
+        templateFile: 'templates/seeder.hbs',
         data: {
-          description,
-          tableName,
-          withExample: isExample(data)
+          ...templateData,
+          extraImports: fieldImports(seedFields),
+          seedFields,
+          seederClass,
+          entityName
         }
       }
     ];
   }
 
   function makeModelActions(data) {
-    const actions = makeEntityActions(data);
+    const actions = makeEntityActions(data, { skipIfExists: true });
     if (includeMapperWithEntity(data)) {
       actions.push(...makeMapperActions(data));
     }
+    appendMakeSqlActions(actions, data);
+    if (includeModelController(data)) {
+      actions.push(...makeControllerActions(data));
+    }
+    return actions;
+  }
+
+  function appendMakeSqlActions(actions, data) {
     const config = loadProjectConfig();
     const migrationPath = migrationDir(config);
-    let version = nextMigrationVersion(path.join(projectRoot(), migrationPath));
+    const version = nextMigrationVersion(path.join(projectRoot(), migrationPath));
     if (includeModelMigration(data)) {
       const tableName = tableNameFromEntity(data.entityName);
       actions.push(
@@ -1316,13 +1610,9 @@ module.exports = function (plop) {
           migrationVersion: version
         })
       );
-      version += 1;
     }
     if (includeModelSeed(data)) {
-      actions.push(...makeSeedActions({ ...data, migrationVersion: version }));
-    }
-    if (includeModelController(data)) {
-      actions.push(...makeControllerActions(data));
+      actions.push(...makeSeederActions(data));
     }
     return actions;
   }
@@ -1342,6 +1632,21 @@ module.exports = function (plop) {
     actions: makeMigrationActions
   });
 
+  plop.setGenerator('make:seeder', {
+    description: '產生 Java Seeder；讀既有 Entity 或 --fields',
+    prompts: [
+      {
+        type: 'input',
+        name: 'entityName',
+        message: '名稱（例如 BookSeeder）：',
+        filter: toPascalCaseName,
+        validate: validatePascalCase
+      },
+      fieldsPrompt
+    ],
+    actions: makeSeederActions
+  });
+
   plop.setGenerator('migration', {
     description: 'make:migration 的別名',
     prompts: migrationPrompts,

package/project-docs/PROJECT.md.hbs

@@ -42,6 +42,7 @@ DB → Entity → Mapper → XxxResponse → Result<T>
 - `mapper/`（`EntityMapper`；`XxxMapper extends EntityMapper`）
 - `service/`、`service/impl/`（`BaseService`；`XxxService extends BaseService`）
 - `controller/`
+- `seeder/`（`Seeder`、`SeedRunner`、`XxxSeeder`）
 - `web/Result`
 
 ## 分層（baseline）
@@ -52,14 +53,16 @@ DB → Entity → Mapper → XxxResponse → Result<T>
 - `dao`：`XxxDAO extends BaseDAO<Entity, ID>`。自訂查詢才在介面加方法。資料庫 VIEW 不能寫入時，那個 DAO `extends BaseViewDAO`（沒有 save / delete）。不要為了跟 DAO 對稱再做一個 `BaseViewService`。
 - `service`：Controller 注入 `XxxService` 介面。一對一 `XxxServiceImpl` 是正常的；介面的價值是額外方法的掛點與 Spring 注入，不是預先準備第二套實作。查詢 API 大到該獨立時，另開一個查詢介面（例如只含 search / count），不要把八十個方法塞進同一個 Service。
 - `controller`：參數驗證與呼叫 Service。回傳專案內 `web.Result<T>`。不回 Entity、不注入 DAO、不引用 `birc-spring-boot-starter`。
+- `seeder`：示範資料。`XxxSeeder implements Seeder`，用 DAO `save`。`birc seed` 才跑，不要把 INSERT 寫進 Flyway。
 
 ## 統一規範
 
 - 例外丟 `ProjectException` 子類（例如 `NotFoundException`），由 `ExceptionHandleController` 轉成回應。Controller 不手動 try-catch 包錯誤訊息。
-- 整組骨架用 `birc make`；單層用 `birc make:entity` / `make:model` / `make:mapper` / `make:service` / `make:controller` / `make:exception`。`make:entity` 只生 Entity 與 DAO；`--dto` 與 `--mapper` 一併生 Mapper 與 DTO。`make:model` 可加 `--migration` / `--seed` / `--controller`。`--soft-delete` 用 Hibernate `@SoftDelete` 的 `deleted_at`，查詢自動排除已刪；不要自寫 `@SQLDelete`。預設是初稿，完整範例加 `--example`。不要複製其他 Entity 的程式碼來改名。
+- 整組骨架用 `birc make`；單層用 `birc make:entity` / `make:model` / `make:mapper` / `make:service` / `make:controller` / `make:exception`。`make:entity` 只生 Entity 與 DAO；`--migration` / `--seed` 同 `make:model`（已有 Entity 就跳過，只補 SQL / Seeder）。`--dto` 與 `--mapper` 一併生 Mapper 與 DTO。`make:model` 可加 `--migration` / `--seed` / `--controller`。`make` 也可加 `--migration` / `--seed`。`make:seeder BookSeeder` 生 Java Seeder。`--soft-delete` 用 Hibernate `@SoftDelete` 的 `deleted_at`，查詢自動排除已刪；不要自寫 `@SQLDelete`。預設是初稿，完整範例加 `--example` 或 `--fields`。`make:migration create_{table}_table` 讀對應 Entity 欄位寫進 SQL。`--seed` 生 Java Seeder，用 DAO 塞資料；`birc seed` 才執行。清空資料庫用 `birc db:wipe`。不要複製其他 Entity 的程式碼來改名。
 - 欄位驗證用專案內 `validation/ValidGroup`。CRUD 用 `Create` / `Update`。`Delete` 給「刪除還要帶原因、確認碼、樂觀鎖 version」的 body。`Submit` 給草稿可少填、送審要全填（活動送審就是這組）。Controller 的 `@Validated` 與欄位 `groups` 對同一組。
 - email / sso / oauth / validGroup 用 `birc add`，不要從別的專案抄設定。
 - 格式化走 Spotless（`./gradlew spotlessApply`），不要另裝 Checkstyle。
+- CORS 只改 `CORS_ALLOWED_ORIGIN_PATTERNS`（逗號分隔 Origin，不要尾斜線、不要 `*`）。`SecurityConfig` 已經用 `http.cors()` 接 `CorsConfigurationSource`。不要在 `WebMvcConfigurer` 加 `addCorsMappings`，Spring Security 會擋 preflight。空白 = 不開放跨來源。
 
 ## 已啟用的功能模組
 

package/scripts/install-bin.sh

@@ -53,9 +53,9 @@ EOF
 
     if birc_is_windows; then
         if command -v cygpath >/dev/null 2>&1; then
-            win_path="$(cygpath -w "$script_path")"
+            win_path="$(cygpath -w "$script_path" | sed 's|/|\\\\|g')"
         else
-            win_path="$script_path"
+            win_path="$(echo "$script_path" | sed 's|/|\\\\|g')"
         fi
         printf '@echo off\nnode "%s" %%*\n' "$win_path" > "$bin_dir/birc.cmd"
     fi

package/templates/base/README.md.hbs

@@ -37,13 +37,27 @@ Get-Content .env | ForEach-Object {
 Windows 用 `.\gradlew.bat bootRun`。
 {{/if}}
 
+## 前端跨來源（CORS）
+
+瀏覽器從別的 Origin 打 API 時，設環境變數後重啟：
+
+```bash
+CORS_ALLOWED_ORIGIN_PATTERNS=http://localhost:5173
+```
+
+逗號分隔、不要尾斜線、不要 `*`。只改這變數；不要在 `WebMvcConfigurer` 加 `addCorsMappings`，Spring Security 不會吃。
+
 ## 生骨架
 
 在有 `.bircrc.json` 的目錄跑即可；子目錄也可以，`birc` 會往上找。
 
 ```bash
 birc make
-birc make:entity User --example --fields title:String
+birc make Book --fields title:String --migration --seed
+birc make:seeder BookSeeder
+birc migrate
+birc seed
+birc db:wipe
 birc add email
 ```
 

package/templates/entity.hbs

@@ -33,7 +33,7 @@ public class {{pascalCase entityName}} {
 {{#if withExample}}
 {{#each makeFields}}
 
-    @Column(name = "{{this.snakeName}}")
+    @Column(name = "{{this.snakeName}}"{{#if this.columnLength}}, length = {{this.columnLength}}{{/if}})
     private {{this.type}} {{this.name}};
 {{/each}}
 

package/templates/migration/add-column.hbs

@@ -1,4 +1,4 @@
 -- {{description}}
 
 ALTER TABLE {{tableName}}
-    ADD COLUMN {{columnName}} {{#if withExample}}INT NULL{{else}}VARCHAR(255) NULL{{/if}};
+    ADD COLUMN {{columnName}} {{#if withExample}}INT NULL{{else}}VARCHAR(50) NULL{{/if}};

package/templates/migration/create-table.hbs

@@ -1,9 +1,6 @@
 -- {{description}}
 
 CREATE TABLE {{tableName}} (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY{{#if withExample}},
-    name VARCHAR(255) NULL,
-    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP{{/if}}{{#if withSoftDelete}},
-    deleted_at TIMESTAMP NULL{{/if}}
+    id BIGINT AUTO_INCREMENT PRIMARY KEY{{#each migrationColumns}},
+    {{this.name}} {{this.sqlType}}{{/each}}
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

package/templates/seeder/SeedRunner.hbs

@@ -0,0 +1,31 @@
+package {{basePackage}}.seeder;
+
+import java.util.List;
+import org.springframework.boot.ApplicationArguments;
+import org.springframework.boot.ApplicationRunner;
+import org.springframework.boot.SpringApplication;
+import org.springframework.context.ConfigurableApplicationContext;
+import org.springframework.stereotype.Component;
+
+@Component
+public class SeedRunner implements ApplicationRunner {
+
+    private final List<Seeder> seeders;
+    private final ConfigurableApplicationContext context;
+
+    public SeedRunner(List<Seeder> seeders, ConfigurableApplicationContext context) {
+        this.seeders = seeders;
+        this.context = context;
+    }
+
+    @Override
+    public void run(ApplicationArguments args) {
+        if (!args.containsOption("birc.seed")) {
+            return;
+        }
+        for (Seeder seeder : seeders) {
+            seeder.run();
+        }
+        System.exit(SpringApplication.exit(context, () -> 0));
+    }
+}

package/templates/seeder/Seeder.hbs

@@ -0,0 +1,6 @@
+package {{basePackage}}.seeder;
+
+public interface Seeder {
+
+    void run();
+}

package/templates/seeder.hbs

@@ -0,0 +1,38 @@
+package {{basePackage}}.seeder;
+
+{{#each extraImports}}
+import {{this}};
+{{/each}}
+{{#if seedFields.length}}
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+import {{daoPackage}}.{{pascalCase entityName}}DAO;
+import {{entityPackage}}.{{pascalCase entityName}};
+{{else}}
+import org.springframework.stereotype.Component;
+{{/if}}
+
+@Component
+{{#if seedFields.length}}
+@RequiredArgsConstructor
+{{/if}}
+public class {{seederClass}} implements Seeder {
+{{#if seedFields.length}}
+
+    private final {{pascalCase entityName}}DAO {{camelCase entityName}}DAO;
+
+{{/if}}
+    @Override
+    public void run() {
+{{#if seedFields.length}}
+        if ({{camelCase entityName}}DAO.count() > 0) {
+            return;
+        }
+        {{pascalCase entityName}} {{camelCase entityName}} = new {{pascalCase entityName}}();
+{{#each seedFields}}
+        {{camelCase ../entityName}}.{{this.setter}}({{{this.literal}}});
+{{/each}}
+        {{camelCase entityName}}DAO.save({{camelCase entityName}});
+{{/if}}
+    }
+}

package/test.md

@@ -35,8 +35,11 @@
 - CLI dest：檔落在呼叫者目錄，不是 generator repo。
 - 產出 Java 沒有 `tw.edu.ntub.birc.starter` / `birc-spring-boot-starter`。
 - `make:entity --dto` / `--mapper` 與 `make:mapper` 同一組 Mapper + DTO；預設 `make:entity` 不生它們。
-- `make:model --migration` / `--seed` 的表名跟 Entity `@Table` 一致；migration 與 seed 版本號不重複。
+- `make --fields --migration --seed` 寫 CREATE TABLE 與 Java `XxxSeeder`，不生 seed SQL；`make:model --migration` 的表名跟 Entity `@Table` 一致。已有 Entity 時 `make:entity --migration` / `--seed` 跳過 Java，只補 CREATE TABLE / `XxxSeeder`。
+- `make:seeder` / `--seed` 讀既有 Entity 欄位寫進 `setXxx`；沒有欄位時 `run()` 是空的。`make:seeder BookSeeder` 生 `BookSeeder.java`，不是 `BookSeederSeeder`。
+- `make:migration create_{table}_table` 讀既有 Entity 欄位寫進 SQL；找不到 Entity 時仍只有 `id`。
 - `--soft-delete` 的 Entity 用 `deleted_at` + `SoftDeleteType.TIMESTAMP`；沒加 flag 的 Entity / migration 沒有這欄。
+- `--fields` 有帶就當完整產出，不必再加 `--example`。
 - `--example` 的驗證群組是專案 `ValidGroup.Create` / `Update`，不是 starter `OnCreate`。`Delete` / `Submit` 是空的 marker，給「刪除要帶 body」與送審用，預設 CRUD 不標；不要刪掉。
 - Flyway plugin 版本跟得上 Gradle wrapper；`flywayMigrate` 不能再碰到已刪的 Gradle convention API。
 - 安裝／更新路徑：`detectInstallKind`、自訂 base URL 預設拒絕、tarball 路徑不可逃出目標目錄。

package/uninstall.ps1

@@ -1,5 +1,5 @@
 # 用法:
-#   irm https://gitlab.ntubimdbirc.tw/lucashsu95/birc-generator/-/raw/main/uninstall.ps1 | iex
+#   irm https://gitlab.ntubimdbirc.tw/birc-backend/birc-generator/-/raw/main/uninstall.ps1 | iex
 # 或下載後執行: powershell -NoProfile -ExecutionPolicy Bypass -File uninstall.ps1
 # 只拆 curl / PowerShell 裝到 $HOME\.birc-generator 的那份，不會 npm uninstall -g。
 

package/templates/migration/seed.hbs

@@ -1,7 +0,0 @@
--- {{description}}
-
-{{#if withExample}}
-INSERT INTO {{tableName}} (name) VALUES ('example');
-{{else}}
--- INSERT INTO {{tableName}} (...) VALUES (...);
-{{/if}}