@wneng/create-keel 0.3.4 → 0.4.0

package/src/templates/db-java-flyway-mysql/files/application.yaml

@@ -0,0 +1,39 @@
+spring:
+  application:
+    name: <%= it.options.projectName %>-server
+  datasource:
+    url: ${SPRING_DATASOURCE_URL:jdbc:mysql://localhost:3306/<%= it.options.projectName %>?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=UTF-8&useUnicode=true}
+    username: ${SPRING_DATASOURCE_USERNAME:root}
+    password: ${SPRING_DATASOURCE_PASSWORD:}
+    driver-class-name: com.mysql.cj.jdbc.Driver
+  jpa:
+    # Flyway 接管 schema 演化，关掉 Hibernate 的 ddl-auto 避免双向漂移
+    hibernate:
+      ddl-auto: validate
+    properties:
+      hibernate:
+        dialect: org.hibernate.dialect.MySQLDialect
+        format_sql: true
+    show-sql: false
+    open-in-view: false
+  flyway:
+    enabled: true
+    locations: classpath:db/migration
+    baseline-on-migrate: false
+    validate-on-migrate: true
+    # 修改既有迁移文件 = 破坏性变更；CI 里 out-of-order=false 会拦截
+    out-of-order: false
+
+server:
+  port: 8080
+
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info,flyway
+
+app:
+  jwt:
+    secret: ${JWT_SECRET:change-me-please-this-is-a-development-secret-only-min-32-chars}
+    expiration-minutes: 120

package/src/templates/db-java-flyway-mysql/files/db-README.md

@@ -0,0 +1,102 @@
+# server/db/
+
+Spring Boot + Flyway 项目的数据库入口。
+
+> 跨项目的数据库归属规则（哪类 SQL 放哪个目录、与 `contracts/` 如何对齐）见 [`docs/governance/database.md`](../../docs/governance/database.md)。本文件只解释**本项目的工具与命令**。
+
+## 工具与版本
+
+| 项 | 值 |
+|---|---|
+| 数据库 | MySQL 8 / MariaDB 10.6+ |
+| 迁移工具 | [Flyway](https://flywaydb.org) `10.20.0` |
+| 驱动 | `mysql-connector-j` `9.1.0` |
+
+工具版本在 `pom.xml` 钉死，并镜像到 `docs/03-工程规范与研发基础设施/tech-stack-server.md`。governance-lint 检测两边漂移并阻断 PR；升级时同 PR 改两个文件。
+
+## 路径分歧（重要）
+
+Spring Boot + Flyway 的迁移文件**不在** `server/db/migrations/`，而在 Spring Boot 的默认扫描路径：
+
+```
+server/
+├── src/main/resources/
+│   └── db/migration/             # ← Flyway 扫描这里
+│       ├── V1__init.sql
+│       └── V2__add_orders.sql
+└── db/
+    ├── README.md                 # 本文件（保留作为 keel 框架的入口）
+    └── seeds/
+        └── dev/                  # 仅本地 / 测试用，与 Flyway 无关
+            └── 0001_dev_users.sql
+```
+
+之所以接受这个分歧而不强行统一到 `server/db/migrations/`：Spring Boot 在启动时自动扫描 `classpath:db/migration`，逆这个默认会让用户每次都改 `application.yaml`。`server/db/` 仍是 keel 约定的入口（README + seeds），与其他后端语言保持视觉一致。
+
+## 目录布局
+
+```
+server/src/main/resources/
+├── application.yaml              # spring.flyway.* 配置
+└── db/migration/                 # Flyway 迁移文件
+    └── V<N>__<description>.sql
+```
+
+## 文件命名规则
+
+- 版本化迁移：`V<N>__<description>.sql`
+  - `N` 单调递增整数，不允许跳号
+  - 已合入 `main` 的文件**绝对不能修改** —— 改 schema 写 `V<N+1>__*.sql`
+- 可重复迁移：`R__<description>.sql`（每次 schema hash 变化时重跑）
+  - 用于视图、存储过程、字典数据 upsert
+- 撤销迁移：Flyway Community 不支持 `down`；回滚靠新写一条 `V<N+1>__revert_*.sql`
+
+## 常用命令
+
+```bash
+# Spring Boot 启动时自动应用所有 pending 迁移（默认行为）
+mvn spring-boot:run
+
+# 不启动应用，单独跑迁移
+mvn flyway:migrate
+
+# 查看当前迁移状态
+mvn flyway:info
+
+# 检查迁移文件 vs DB 历史是否一致（CI 用）
+mvn flyway:validate
+```
+
+环境变量：`SPRING_DATASOURCE_URL` / `SPRING_DATASOURCE_USERNAME` / `SPRING_DATASOURCE_PASSWORD`。
+
+## prod vs dev seeds
+
+Flyway 把"种子数据"分成两类：
+
+| 类型 | 位置 | 命名 |
+|---|---|---|
+| 生产字典（必装） | `src/main/resources/db/migration/` | `V<N>__seed_<topic>.sql`（首次）或 `R__<topic>.sql`（每次重跑） |
+| 开发样例 | `server/db/seeds/dev/`（不在 Flyway 路径下） | 任意；用 `mysql -e 'source ...'` 手动加载 |
+
+字典类生产种子的真值在 `contracts/dictionaries/enums.yaml`。改字典的 PR 必须**同步**更新对应 SQL；当前是手动同步（自动派生留给 `contract-derived-seeds` 特性）。
+
+## 改动分级（参见 `docs/governance/change-tiers.md`）
+
+| 改动 | Tier |
+|---|---|
+| 新增 `V<N>__*.sql` 加表 / 加字段 | 3（contract 一致性 + CHANGELOG） |
+| 修改既有 `V<N>__*.sql` | **绝不允许**；写新文件 |
+| 删字段 / 改类型（破坏性） | 4（ADR + 迁移预案） |
+| 改 dev seed | 1/2 |
+| 改字典 `R__*.sql` 或 prod 种子 | 3（同步 contracts/dictionaries/） |
+| 升级 Flyway / mysql-connector-j | 2，但同步改 tech-stack-server.md |
+
+## CI 行为
+
+每个 PR 的 backend job 跑：
+
+```bash
+mvn -B verify       # 含 mvn flyway:migrate（启动应用时）+ mvn flyway:validate
+```
+
+`spring.flyway.validate-on-migrate=true` 强制每次启动时校验"代码里的迁移文件历史"与"DB 中已应用的版本"完全一致；任何已合入 `main` 的迁移被改动都会让 CI 红。

package/src/templates/db-java-flyway-mysql/files/pom.xml

@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+                             https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.3.4</version>
+        <relativePath/>
+    </parent>
+
+    <groupId>com.example</groupId>
+    <artifactId><%= it.options.projectName %>-server</artifactId>
+    <version>0.1.0</version>
+    <packaging>jar</packaging>
+    <name><%= it.options.projectName %>-server</name>
+
+    <properties>
+        <java.version>21</java.version>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <jjwt.version>0.12.6</jjwt.version>
+        <flyway.version>10.20.0</flyway.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-actuator</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-security</artifactId>
+        </dependency>
+
+        <!--
+            Flyway: 数据库迁移工具。
+            Spring Boot 启动时自动扫描 src/main/resources/db/migration/V*__*.sql
+            并按版本号顺序应用（一次性）；也可通过 `mvn flyway:migrate` 手动执行。
+            版本号一旦合入 main 不允许修改；改 schema 写新文件 V<N+1>__*.sql。
+        -->
+        <dependency>
+            <groupId>org.flywaydb</groupId>
+            <artifactId>flyway-core</artifactId>
+            <version>${flyway.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.flywaydb</groupId>
+            <artifactId>flyway-mysql</artifactId>
+            <version>${flyway.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>com.mysql</groupId>
+            <artifactId>mysql-connector-j</artifactId>
+            <version>9.1.0</version>
+            <scope>runtime</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>io.jsonwebtoken</groupId>
+            <artifactId>jjwt-api</artifactId>
+            <version>${jjwt.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.jsonwebtoken</groupId>
+            <artifactId>jjwt-impl</artifactId>
+            <version>${jjwt.version}</version>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.jsonwebtoken</groupId>
+            <artifactId>jjwt-jackson</artifactId>
+            <version>${jjwt.version}</version>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+
+            <plugin>
+                <groupId>org.flywaydb</groupId>
+                <artifactId>flyway-maven-plugin</artifactId>
+                <version>${flyway.version}</version>
+                <configuration>
+                    <url>${env.SPRING_DATASOURCE_URL}</url>
+                    <user>${env.SPRING_DATASOURCE_USERNAME}</user>
+                    <password>${env.SPRING_DATASOURCE_PASSWORD}</password>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+                <version>3.5.0</version>
+                <configuration>
+                    <configLocation>checkstyle.xml</configLocation>
+                    <consoleOutput>true</consoleOutput>
+                    <failsOnError>true</failsOnError>
+                    <linkXRef>false</linkXRef>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>verify-checkstyle</id>
+                        <phase>verify</phase>
+                        <goals><goal>check</goal></goals>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <plugin>
+                <groupId>com.diffplug.spotless</groupId>
+                <artifactId>spotless-maven-plugin</artifactId>
+                <version>2.43.0</version>
+                <configuration>
+                    <java>
+                        <googleJavaFormat>
+                            <version>1.22.0</version>
+                            <style>AOSP</style>
+                        </googleJavaFormat>
+                        <removeUnusedImports/>
+                        <trimTrailingWhitespace/>
+                        <endWithNewline/>
+                    </java>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>verify-spotless</id>
+                        <phase>verify</phase>
+                        <goals><goal>check</goal></goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

package/src/templates/db-java-flyway-mysql/fragment.yaml

@@ -0,0 +1,19 @@
+name: db-java-flyway-mysql
+version: 1.0.0
+appliesWhen:
+  backend: java
+  database: mysql
+priority: 40
+files:
+  - from: files/pom.xml
+    to: server/pom.xml
+    render: true
+  - from: files/application.yaml
+    to: server/src/main/resources/application.yaml
+    render: true
+  - from: files/V1__init.sql
+    to: server/src/main/resources/db/migration/V1__init.sql
+    render: false
+  - from: files/db-README.md
+    to: server/db/README.md
+    render: true

package/src/templates/db-java-flyway-postgres/files/V1__init.sql

@@ -0,0 +1,40 @@
+-- V1__init.sql — 初始化迁移
+--
+-- 命名规则：V<N>__<description>.sql。N 单调递增；不允许跳号。
+-- 已合入 main 的迁移文件**不可修改**——改 schema 写 V<N+1>__*.sql。
+-- 修改既有迁移属于破坏性变更，应升 Tier 4（参见 docs/governance/change-tiers.md）。
+--
+-- PostgreSQL 注意：
+--   - 主键统一用 BIGINT GENERATED ALWAYS AS IDENTITY
+--   - 文本默认用 TEXT，仅在确需限长时用 VARCHAR(n)
+--   - 时间列用 TIMESTAMPTZ，统一存 UTC
+
+CREATE TABLE IF NOT EXISTS roles (
+    id          BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+    code        VARCHAR(64)  NOT NULL UNIQUE,
+    name        VARCHAR(128) NOT NULL,
+    description TEXT         NULL,
+    created_at  TIMESTAMPTZ  NOT NULL DEFAULT NOW(),
+    updated_at  TIMESTAMPTZ  NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS users (
+    id            BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+    email         VARCHAR(255) NOT NULL UNIQUE,
+    password_hash VARCHAR(255) NOT NULL,
+    display_name  VARCHAR(128) NULL,
+    role_id       BIGINT       NOT NULL REFERENCES roles (id),
+    created_at    TIMESTAMPTZ  NOT NULL DEFAULT NOW(),
+    updated_at    TIMESTAMPTZ  NOT NULL DEFAULT NOW(),
+    deleted_at    TIMESTAMPTZ  NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_users_role_id    ON users (role_id);
+CREATE INDEX IF NOT EXISTS idx_users_deleted_at ON users (deleted_at);
+
+-- 字典数据：与 contracts/dictionaries/enums.yaml 对齐。
+-- ON CONFLICT DO NOTHING 保证多次跑幂等；改字典的 PR 必须同步改这里 + contracts/CHANGELOG.md。
+INSERT INTO roles (code, name, description) VALUES
+    ('admin', '系统管理员', '可执行所有管理操作'),
+    ('user',  '普通用户',   '默认注册角色')
+ON CONFLICT (code) DO NOTHING;

package/src/templates/db-java-flyway-postgres/files/application.yaml

@@ -0,0 +1,37 @@
+spring:
+  application:
+    name: <%= it.options.projectName %>-server
+  datasource:
+    url: ${SPRING_DATASOURCE_URL:jdbc:postgresql://localhost:5432/<%= it.options.projectName %>}
+    username: ${SPRING_DATASOURCE_USERNAME:postgres}
+    password: ${SPRING_DATASOURCE_PASSWORD:}
+    driver-class-name: org.postgresql.Driver
+  jpa:
+    hibernate:
+      ddl-auto: validate
+    properties:
+      hibernate:
+        dialect: org.hibernate.dialect.PostgreSQLDialect
+        format_sql: true
+    show-sql: false
+    open-in-view: false
+  flyway:
+    enabled: true
+    locations: classpath:db/migration
+    baseline-on-migrate: false
+    validate-on-migrate: true
+    out-of-order: false
+
+server:
+  port: 8080
+
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info,flyway
+
+app:
+  jwt:
+    secret: ${JWT_SECRET:change-me-please-this-is-a-development-secret-only-min-32-chars}
+    expiration-minutes: 120

package/src/templates/db-java-flyway-postgres/files/db-README.md

@@ -0,0 +1,75 @@
+# server/db/
+
+Spring Boot + Flyway 项目的数据库入口。
+
+> 跨项目的数据库归属规则（哪类 SQL 放哪个目录、与 `contracts/` 如何对齐）见 [`docs/governance/database.md`](../../docs/governance/database.md)。本文件只解释**本项目的工具与命令**。
+
+## 工具与版本
+
+| 项 | 值 |
+|---|---|
+| 数据库 | PostgreSQL 14+ |
+| 迁移工具 | [Flyway](https://flywaydb.org) `10.20.0` |
+| 驱动 | `postgresql` (JDBC) `42.7.4` |
+
+工具版本在 `pom.xml` 钉死，并镜像到 `docs/03-工程规范与研发基础设施/tech-stack-server.md`。governance-lint 检测两边漂移并阻断 PR；升级时同 PR 改两个文件。
+
+## 路径分歧（重要）
+
+Spring Boot + Flyway 的迁移文件**不在** `server/db/migrations/`，而在 Spring Boot 的默认扫描路径：
+
+```
+server/
+├── src/main/resources/
+│   └── db/migration/             # ← Flyway 扫描这里
+│       ├── V1__init.sql
+│       └── V2__add_orders.sql
+└── db/
+    ├── README.md                 # 本文件（保留作为 keel 框架的入口）
+    └── seeds/
+        └── dev/                  # 仅本地 / 测试用
+            └── 0001_dev_users.sql
+```
+
+之所以接受这个分歧而不强行统一到 `server/db/migrations/`：Spring Boot 在启动时自动扫描 `classpath:db/migration`，逆这个默认会让用户每次都改 `application.yaml`。
+
+## 文件命名规则
+
+- 版本化迁移：`V<N>__<description>.sql`（N 单调递增，不跳号；已合入 `main` 不可修改）
+- 可重复迁移：`R__<description>.sql`（每次 schema hash 变化时重跑，用于视图、字典 upsert）
+- 撤销迁移：Flyway Community 不支持 `down`；回滚靠新写一条 `V<N+1>__revert_*.sql`
+
+## 常用命令
+
+```bash
+mvn spring-boot:run           # 启动应用，自动跑 pending 迁移
+mvn flyway:migrate            # 仅跑迁移
+mvn flyway:info               # 查看当前状态
+mvn flyway:validate           # 校验代码 vs DB 历史一致（CI 用）
+```
+
+环境变量：`SPRING_DATASOURCE_URL` / `SPRING_DATASOURCE_USERNAME` / `SPRING_DATASOURCE_PASSWORD`。
+
+## prod vs dev seeds
+
+| 类型 | 位置 | 命名 |
+|---|---|---|
+| 生产字典（必装） | `src/main/resources/db/migration/` | `V<N>__seed_<topic>.sql` 或 `R__<topic>.sql` |
+| 开发样例 | `server/db/seeds/dev/` | 任意；用 `psql -f <file>` 手动加载 |
+
+字典类生产种子的真值在 `contracts/dictionaries/enums.yaml`。改字典的 PR 必须**同步**更新对应 SQL；当前是手动同步。
+
+## 改动分级（参见 `docs/governance/change-tiers.md`）
+
+| 改动 | Tier |
+|---|---|
+| 新增 `V<N>__*.sql` 加表 / 加字段 | 3（contract 一致性 + CHANGELOG） |
+| 修改既有 `V<N>__*.sql` | **绝不允许**；写新文件 |
+| 删字段 / 改类型（破坏性） | 4（ADR + 迁移预案） |
+| 改 dev seed | 1/2 |
+| 改字典 `R__*.sql` 或 prod 种子 | 3（同步 contracts/dictionaries/） |
+| 升级 Flyway / postgresql 驱动 | 2，但同步改 tech-stack-server.md |
+
+## CI 行为
+
+每个 PR 的 backend job 跑 `mvn -B verify`，含 `flyway:migrate` + `flyway:validate`；任何已合入 `main` 的迁移被改动都会让 CI 红。

package/src/templates/db-java-flyway-postgres/files/pom.xml

@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+                             https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.3.4</version>
+        <relativePath/>
+    </parent>
+
+    <groupId>com.example</groupId>
+    <artifactId><%= it.options.projectName %>-server</artifactId>
+    <version>0.1.0</version>
+    <packaging>jar</packaging>
+    <name><%= it.options.projectName %>-server</name>
+
+    <properties>
+        <java.version>21</java.version>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <jjwt.version>0.12.6</jjwt.version>
+        <flyway.version>10.20.0</flyway.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-actuator</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-security</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>org.flywaydb</groupId>
+            <artifactId>flyway-core</artifactId>
+            <version>${flyway.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.flywaydb</groupId>
+            <artifactId>flyway-database-postgresql</artifactId>
+            <version>${flyway.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>postgresql</artifactId>
+            <version>42.7.4</version>
+            <scope>runtime</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>io.jsonwebtoken</groupId>
+            <artifactId>jjwt-api</artifactId>
+            <version>${jjwt.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>io.jsonwebtoken</groupId>
+            <artifactId>jjwt-impl</artifactId>
+            <version>${jjwt.version}</version>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.jsonwebtoken</groupId>
+            <artifactId>jjwt-jackson</artifactId>
+            <version>${jjwt.version}</version>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+
+            <plugin>
+                <groupId>org.flywaydb</groupId>
+                <artifactId>flyway-maven-plugin</artifactId>
+                <version>${flyway.version}</version>
+                <configuration>
+                    <url>${env.SPRING_DATASOURCE_URL}</url>
+                    <user>${env.SPRING_DATASOURCE_USERNAME}</user>
+                    <password>${env.SPRING_DATASOURCE_PASSWORD}</password>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+                <version>3.5.0</version>
+                <configuration>
+                    <configLocation>checkstyle.xml</configLocation>
+                    <consoleOutput>true</consoleOutput>
+                    <failsOnError>true</failsOnError>
+                    <linkXRef>false</linkXRef>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>verify-checkstyle</id>
+                        <phase>verify</phase>
+                        <goals><goal>check</goal></goals>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <plugin>
+                <groupId>com.diffplug.spotless</groupId>
+                <artifactId>spotless-maven-plugin</artifactId>
+                <version>2.43.0</version>
+                <configuration>
+                    <java>
+                        <googleJavaFormat>
+                            <version>1.22.0</version>
+                            <style>AOSP</style>
+                        </googleJavaFormat>
+                        <removeUnusedImports/>
+                        <trimTrailingWhitespace/>
+                        <endWithNewline/>
+                    </java>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>verify-spotless</id>
+                        <phase>verify</phase>
+                        <goals><goal>check</goal></goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

package/src/templates/db-java-flyway-postgres/fragment.yaml

@@ -0,0 +1,19 @@
+name: db-java-flyway-postgres
+version: 1.0.0
+appliesWhen:
+  backend: java
+  database: postgres
+priority: 40
+files:
+  - from: files/pom.xml
+    to: server/pom.xml
+    render: true
+  - from: files/application.yaml
+    to: server/src/main/resources/application.yaml
+    render: true
+  - from: files/V1__init.sql
+    to: server/src/main/resources/db/migration/V1__init.sql
+    render: false
+  - from: files/db-README.md
+    to: server/db/README.md
+    render: true