@wneng/create-keel 0.1.0

package/src/templates/role-marketing/files/templates-README.md

@@ -0,0 +1,5 @@
+# templates/
+
+对外材料母版。AI 触达：`read-only`。
+
+承载 PPT 框架、白皮书结构、案例模板等。AI 可读作为生成 `../drafts/` 的上下文，但不得修改本目录。

package/src/templates/role-marketing/files/templates-_ai-policy.yaml

@@ -0,0 +1,8 @@
+# docs/11-市场与对外材料/templates/_ai-policy.yaml
+# 局部覆盖：母版人工维护
+
+mode: read-only
+
+notes: |
+  对外材料母版（PPT 框架、白皮书结构、案例模板）。
+  AI 可读作为生成 drafts/ 草稿的上下文，但不得修改本目录。

package/src/templates/role-marketing/fragment.yaml

@@ -0,0 +1,30 @@
+name: role-marketing
+version: 1.0.0
+appliesWhen:
+  role: marketing
+priority: 30
+files:
+  - from: files/README.md
+    to: docs/11-市场与对外材料/README.md
+    render: false
+  - from: files/_ai-policy.yaml
+    to: docs/11-市场与对外材料/_ai-policy.yaml
+    render: false
+  - from: files/templates-README.md
+    to: docs/11-市场与对外材料/templates/README.md
+    render: false
+  - from: files/templates-_ai-policy.yaml
+    to: docs/11-市场与对外材料/templates/_ai-policy.yaml
+    render: false
+  - from: files/drafts-README.md
+    to: docs/11-市场与对外材料/drafts/README.md
+    render: false
+  - from: files/drafts-_ai-policy.yaml
+    to: docs/11-市场与对外材料/drafts/_ai-policy.yaml
+    render: false
+  - from: files/published-README.md
+    to: docs/11-市场与对外材料/published/README.md
+    render: false
+  - from: files/published-_ai-policy.yaml
+    to: docs/11-市场与对外材料/published/_ai-policy.yaml
+    render: false

package/src/templates/role-qa/files/README.md

@@ -0,0 +1,20 @@
+# 07-质量与测试
+
+测试计划、用例集、缺陷库的归属目录。依据 ADR-0002 引入。
+
+## 子目录
+
+| 目录 | 内容 |
+|------|------|
+| `test-plans/` | 项目 / 版本级测试计划 |
+| `test-cases/` | 用例集（手工 / 自动化）。可执行的 Gherkin 仍在 `contracts/tests/acceptance/` |
+| `defects/` | 缺陷库存档（需要长期保留的关键缺陷复盘） |
+
+## AI 触达模式
+
+`mode: suggest`。AI 在契约或代码变更时，应在 PR 描述中提示"可能影响 docs/07/test-plans/xxx"，但**不自动改**测试主线。
+
+## 与既有目录的关系
+
+- 与 `contracts/tests/acceptance/`（Gherkin 业务验收）：本目录是**叙事 + 计划**，acceptance 是**机器可执行**
+- 与 `docs/04-后端详细设计/` / `docs/05-前端客户端详细设计/`：模块设计文档中的"测试要点"指向本目录的具体用例

package/src/templates/role-qa/files/_ai-policy.yaml

@@ -0,0 +1,9 @@
+# docs/07-质量与测试/_ai-policy.yaml
+# 依据 ADR-0002 §3.2.1，ADR-0003（access modes）
+
+mode: suggest
+
+notes: |
+  测试计划、用例集、缺陷库。AI 在契约或代码变更时，
+  应在 PR 描述中提示"可能影响 docs/07/test-plans/xxx"，
+  但不自动改测试主线。

package/src/templates/role-qa/fragment.yaml

@@ -0,0 +1,21 @@
+name: role-qa
+version: 1.0.0
+appliesWhen:
+  role: qa
+priority: 30
+files:
+  - from: files/README.md
+    to: docs/07-质量与测试/README.md
+    render: false
+  - from: files/_ai-policy.yaml
+    to: docs/07-质量与测试/_ai-policy.yaml
+    render: false
+  - from: files/test-plans-gitkeep
+    to: docs/07-质量与测试/test-plans/.gitkeep
+    render: false
+  - from: files/test-cases-gitkeep
+    to: docs/07-质量与测试/test-cases/.gitkeep
+    render: false
+  - from: files/defects-gitkeep
+    to: docs/07-质量与测试/defects/.gitkeep
+    render: false

package/src/templates/root-files/files/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

package/src/templates/root-files/files/.gitattributes

@@ -0,0 +1,13 @@
+* text=auto eol=lf
+*.sh text eol=lf
+*.ps1 text eol=crlf
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.pdf binary
+<% if (it.options.gitLfs) { %>
+# Git LFS
+docs/assets/**/*.png filter=lfs diff=lfs merge=lfs -text
+docs/assets/**/*.psd filter=lfs diff=lfs merge=lfs -text
+docs/assets/**/*.sketch filter=lfs diff=lfs merge=lfs -text
+<% } %>

package/src/templates/root-files/files/AGENTS.md

@@ -0,0 +1,194 @@
+# AGENTS — <%= it.options.projectName %>
+
+> 本文件是仓库协作总纲。它不承载所有细则——细则按任务类型从 `docs/`、`contracts/`、`.kiro/steering/` 加载（见 §6 按需加载索引、§7 权威文件索引）。
+>
+> 任何与本文件冲突的局部约定一律作废，除非通过 PR 修改本文件本身。
+
+*Created by AI on <%= it.generatedAt.slice(0, 10) %>.*
+
+## 0. 默认必读
+
+1. 本文件 `AGENTS.md`（总纲）
+2. `docs/README.md`（文档门户）
+3. `contracts/README.md`（涉及契约时）
+<% if (it.options.ai === 'kiro') { %>4. `.kiro/steering/*.md`（若存在）
+<% } else if (it.options.ai === 'codex') { %>4. `.codex/project.md`（项目专属备注）
+<% } else if (it.options.ai === 'cursor') { %>4. `.cursor/rules/*.md`（项目规则）
+<% } else if (it.options.ai === 'claude-code') { %>4. `CLAUDE.md`（Claude Code 自动加载）
+<% } %>
+
+> 入门 / 角色场景对照：[`docs/03-工程规范与研发基础设施/usage-quickstart.md`](docs/03-工程规范与研发基础设施/usage-quickstart.md)
+
+## 1. 项目定位
+
+本仓库采用 **Contract First + Vibe Coding**。契约定义优先于实现，文档与契约分层维护。
+
+顶层目录职责：
+
+| 目录         | 面向      | 内容                                                 |
+| ------------ | --------- | ---------------------------------------------------- |
+| `contracts/` | 机器 / AI | 结构化、版本可控、工具可消费的规约                   |
+| `docs/`      | 人类      | 过程性资料、正式设计文档、外部引用资料、资产文件     |
+<% if (it.options.backend !== 'none') { %>| `server/`    | 机器      | 后端服务实现源码（<%= it.options.backend %>）                      |
+<% } %><% if (it.options.frontend !== 'none') { %>| `web/`       | 机器      | 前端应用实现源码（<%= it.options.frontend %>）                     |
+<% } %><% if (it.options.mobile !== 'none') { %>| `mobile/`    | 机器      | 移动端原生应用源码（<%= it.options.mobile %>）                     |
+<% } %><% if (it.options.miniapp !== 'none') { %>| `miniapp/`   | 机器      | 小程序源码（<%= it.options.miniapp %>）                            |
+<% } %><% if (it.options.agent !== 'none') { %>| `agent/`     | 机器      | 终端 / 桌面客户端源码（<%= it.options.agent %>）                   |
+<% } %>| `ops/`       | 机器      | 基础设施即代码（集群、网络、监控）                   |
+| `deploy/`    | 机器      | 应用发布物（Dockerfile、Helm、K8s manifest、流水线） |
+| `tools/`     | 机器      | 结构化、可复用的开发工具与脚手架                     |
+| `scripts/`   | 机器      | 薄、零散、日常维护脚本                               |
+<% if (it.options.ai === 'kiro') { %>| `.kiro/`     | AI        | Kiro IDE 的 steering、prompts、specs                 |
+<% } else if (it.options.ai === 'codex') { %>| `.codex/`    | AI        | Codex 项目备注与 prompts                             |
+<% } else if (it.options.ai === 'cursor') { %>| `.cursor/`   | AI        | Cursor 项目规则                                      |
+<% } else if (it.options.ai === 'claude-code') { %>| `CLAUDE.md`  | AI        | Claude Code 项目上下文（根文件）                     |
+| `.claude/`   | AI        | Claude Code slash-commands                           |
+<% } %>
+
+### 1.1 单应用 vs 多应用模式
+
+每个执行环境目录（`server/` `web/` `mobile/` `miniapp/` `agent/`）默认处于**单应用模式**。需要容纳第二个应用时切换到**多应用模式**：
+
+1. 在该目录下创建 `apps/<app-name>/`（`<app-name>` 匹配 `^[a-z0-9][a-z0-9-]{0,62}$`）
+2. 将原有工程文件整体迁入 `apps/<原应用名>/`
+3. 之后所有应用都必须位于 `<env>/apps/*/` 之下；**禁止**裸工程文件与 `apps/` 子目录并存
+
+跨应用共享只走 `contracts/` 或可选的根 `packages/`；**禁止** `<env>/apps/A/` 直接 import `<env>/apps/B/`。
+
+## 2. 不可协商原则
+
+- **Contract First**：契约定义优先于代码实现。
+- 接口、事件、错误码、字典、状态机统一进入 `contracts/`，**禁止**在模块内部重复定义。
+- 由契约生成的 `generated/` 代码**禁止手改**；CI 校验"重新生成后 diff 为空"。
+- **禁止**提交 secret、私钥、真实 PII、真实用户数据。
+- 文件统一使用 **UTF-8 + LF**（`.gitattributes` 强制）。
+- 模块边界稳定优先于业务细节。
+- AI 生成代码必须**打标**：commit 使用 `feat(ai): ...` / `chore(ai): ...` 前缀，PR 打 `ai-generated` 标签。
+- 临时 / 讨论 / 未定稿**只能**进 `docs/过程文档/`。
+
+## 3. 项目配置（本仓库选定值）
+
+- Backend language: **<%= it.options.backend %>**
+- Frontend framework: **<%= it.options.frontend %>**
+- Mobile app: **<%= it.options.mobile %>**
+- Mini program: **<%= it.options.miniapp %>**
+- Agent client: **<%= it.options.agent %>**
+- Deploy target: **<%= it.options.deploy %>**
+- Contract kind: **<%= it.options.contract %>**
+- AI tool integration: **<%= it.options.ai %>**
+- License: **<%= it.options.license %>**
+- Git LFS enabled: **<%= it.options.gitLfs %>**
+- Integrations docs: **<%= it.options.integrations %>**
+- CI platform: **<%= it.options.ci %>**
+
+## 4. 文档归属
+
+每类文档只有一个合法位置；放错位置的 PR 应被退回。完整归档规则与索引同步要求 → [`docs/README.md`](docs/README.md)。
+
+| 文档类型                                  | 归属目录                                       |
+| ----------------------------------------- | ---------------------------------------------- |
+| PRD、需求调研、竞品分析                   | `docs/01-背景与需求/`                          |
+| 架构决策（ADR）、方案对比                 | `docs/02-系统方案与架构/`                      |
+| 编码规范、CI/CD 说明、环境管理            | `docs/03-工程规范与研发基础设施/`              |
+| 后端模块详细设计                          | `docs/04-后端详细设计/`                        |
+| 前端 / 客户端模块详细设计                 | `docs/05-前端客户端详细设计/`                  |
+<% if (it.options.integrations) { %>| 跨执行环境对接（已启用 `integrations`）   | `docs/06-集成对接/<consumer>-to-<producer>/`   |
+<% } %>| 治理细则（CI / 安全 / Git / 资产 / 等）   | `docs/governance/`（详见 §8）                  |
+| 架构图源、UI 稿、截图、设计稿             | `docs/assets/{diagrams,images,design}/`        |
+| 行业标准、厂商手册、法规、合规参考        | `docs/references/{standards,vendors,legal}/`   |
+| 会议记录、调研草稿、未定稿、技术探针      | `docs/过程文档/`（结论固化后回迁）             |
+| 过期 / 被否决 / 90 天未采纳的过程文档     | `docs/archive/`                                |
+
+索引同步要求：新增 / 修改可能影响**启动 / 实现 / 管理**视角的文档时，**必须**在同一 PR 同步 `docs/README.md`（目录地图、新增分类入口、子目录约定）。手维护的"阅读顺序 / 必读清单 / 详细设计导航"索引已废弃，改用 `grep` / `fileSearch` 检索。
+
+## 5. 快速判定卡
+
+### 5.1 ops/ vs deploy/
+
+- **"即便没有业务应用也要存在"** → `ops/`
+- **"业务应用的打包与投递"** → `deploy/`
+- 一个 Helm chart：chart 本身属 `deploy/`，依赖的 Namespace / CRD 属 `ops/`
+- 完整规则 → [`docs/governance/deploy-ops.md`](docs/governance/deploy-ops.md)
+
+### 5.2 tools/ vs scripts/
+
+- **有结构、可复用、近似小产品** → `tools/`
+- **薄、零散、日常维护** → `scripts/`
+- `scripts/` 出现以下任一信号 → 升级 `tools/`：第二个配置项 / 子命令；需独立依赖；多模块复用；超 200 行
+- 脚本顶部必须含：用途 / 参数 / 幂等性 / 危险级别
+- 完整规则 → [`docs/governance/tools-scripts.md`](docs/governance/tools-scripts.md)
+
+<% if (it.options.integrations) { %>### 5.3 contracts/ vs docs/06-集成对接/
+
+- **机器可验证的权威契约** → `contracts/`
+- **契约不说但双方必须知道** → `docs/06-集成对接/`
+- 完整规则 → [`docs/governance/integrations.md`](docs/governance/integrations.md)
+<% } %>
+
+## 6. 核心协作规则
+
+- 先补契约和文档，再补实现。
+- AI 生成代码必须在 PR / commit 中显式引用契约锚点和设计文档。
+- `spike/*` 分支允许暂时跳过契约；合入 `main` 前必须补齐。
+- 完整 PR 模板与 CODEOWNERS → [`docs/governance/git-workflow.md`](docs/governance/git-workflow.md)
+- 契约 SemVer / CHANGELOG / 废弃流程 → [`contracts/README.md`](contracts/README.md)
+
+## 7. 按需加载索引
+
+### 7.1 路径触发表
+
+| 修改路径 | 必读 |
+| --- | --- |
+| `contracts/**` | `contracts/README.md`、`docs/governance/integrations.md`、`docs/governance/checklists.md` |
+| `docs/**`（除 `docs/governance/` 与 `docs/06-集成对接/`） | `docs/README.md`、`docs/governance/docs-references.md`、`docs/governance/checklists.md` |
+<% if (it.options.integrations) { %>| `docs/06-集成对接/**` | `docs/governance/integrations.md` |
+<% } %>| `docs/governance/**` | `docs/governance/README.md`；同一 PR 必须同步本文件中对应摘要 |
+| `docs/assets/**` 或根 `.gitattributes` | `docs/governance/assets.md` |
+| `ops/**` 或 `deploy/**` | `docs/governance/deploy-ops.md`、`docs/governance/security.md` |
+| `tools/**` 或 `scripts/**` | `docs/governance/tools-scripts.md` |
+<% if (it.options.ci === 'gitee') { %>| `.gitee/**` | `docs/governance/ci.md`、`docs/governance/security.md` |
+<% } else { %>| `.github/**` | `docs/governance/ci.md`、`docs/governance/security.md` |
+<% } %>
+
+### 7.2 任务触发表
+
+| 任务 | 必读 |
+| --- | --- |
+| 新增依赖 | `docs/governance/security.md` |
+| 修改 PR 模板 / CODEOWNERS / 分支策略 | `docs/governance/git-workflow.md` |
+| 新增脚本或工具 | `docs/governance/tools-scripts.md`、`docs/governance/checklists.md` |
+| 多应用模式切换 | 本文件 §1.1、`docs/governance/git-workflow.md`、`docs/governance/checklists.md` |
+| 发布前核对 | `docs/governance/checklists.md` §3、`docs/governance/security.md` |
+| 应急响应（高危漏洞） | `docs/governance/security.md` §4 |
+
+## 8. 权威文件索引
+
+| 主题 | 唯一权威 |
+| --- | --- |
+| 契约 | [`contracts/README.md`](contracts/README.md) |
+| 文档 | [`docs/README.md`](docs/README.md) |
+| CI | [`docs/governance/ci.md`](docs/governance/ci.md) |
+| 安全 | [`docs/governance/security.md`](docs/governance/security.md) |
+| Git / PR / CODEOWNERS | [`docs/governance/git-workflow.md`](docs/governance/git-workflow.md) |
+| 资产与 LFS | [`docs/governance/assets.md`](docs/governance/assets.md) |
+| 集成对接 | [`docs/governance/integrations.md`](docs/governance/integrations.md) |
+| ops / deploy 完整规则 | [`docs/governance/deploy-ops.md`](docs/governance/deploy-ops.md) |
+| tools / scripts 完整规则 | [`docs/governance/tools-scripts.md`](docs/governance/tools-scripts.md) |
+| 完整 checklist | [`docs/governance/checklists.md`](docs/governance/checklists.md) |
+| 治理细则索引 | [`docs/governance/README.md`](docs/governance/README.md) |
+
+## 9. 检查清单（入口）
+
+完整可勾选清单 → [`docs/governance/checklists.md`](docs/governance/checklists.md)
+
+每个 PR 高频核对项：
+
+- **开发前**：契约 / 字典 / 错误码 / 状态机 / 事件 / 设计文档已就位；环境变量已同步
+- **提交前**：CHANGELOG / docs/README.md（如需）/ PII / AI 标签 / 测试 / governance 摘要同步
+- **发布前**：deploy values / pipeline CHANGELOG / 回滚 / 监控 / 密钥 / SBOM
+- **多应用模式**：apps/ 不与裸文件并存 / pair 命名 / 跨应用引用走契约
+- **新增脚本 / 工具**：归属判定 / 顶部注释 / 跨平台 / 索引
+
+---
+
+*Created by AI on <%= it.generatedAt.slice(0, 10) %>.*

package/src/templates/root-files/files/README.md

@@ -0,0 +1,16 @@
+# <%= it.options.projectName %>
+
+Created by AI on <%= it.generatedAt.slice(0, 10) %>.
+
+## Quick start
+
+See `AGENTS.md` for the full working agreement.
+
+<% if (it.options.backend !== 'none') { %>- Backend lives in `server/` (<%= it.options.backend %>).
+<% } %><% if (it.options.frontend !== 'none') { %>- Frontend lives in `web/` (<%= it.options.frontend %>).
+<% } %>- Contracts live in `contracts/`.
+- Documentation lives in `docs/`.
+
+## License
+
+<%= it.options.license === 'proprietary' ? 'Proprietary — all rights reserved.' : 'See the LICENSE file.' %>

package/src/templates/root-files/fragment.yaml

@@ -0,0 +1,20 @@
+name: root-files
+version: 1.0.0
+appliesWhen: {}
+priority: 90
+files:
+  - from: files/AGENTS.md
+    to: AGENTS.md
+    render: true
+  - from: files/README.md
+    to: README.md
+    render: true
+  - from: files/.gitignore
+    to: .gitignore
+    render: false
+  - from: files/.gitattributes
+    to: .gitattributes
+    render: true
+  - from: files/.editorconfig
+    to: .editorconfig
+    render: false

package/src/templates/server-go/files/README.md

@@ -0,0 +1,3 @@
+# server/
+
+Go backend for **<%= it.options.projectName %>**. Contract-first.

package/src/templates/server-go/files/go.mod

@@ -0,0 +1,3 @@
+module <%= it.options.projectName %>/server
+
+go 1.22

package/src/templates/server-go/files/main.go

@@ -0,0 +1,7 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("server placeholder")
+}

package/src/templates/server-go/fragment.yaml

@@ -0,0 +1,18 @@
+name: server-go
+version: 1.0.0
+appliesWhen:
+  backend: go
+priority: 30
+files:
+  - from: files/README.md
+    to: server/README.md
+    render: true
+  - from: files/go.mod
+    to: server/go.mod
+    render: true
+  - from: files/main.go
+    to: server/cmd/server/main.go
+    render: false
+  - from: files/generated-gitkeep
+    to: server/generated/.gitkeep
+    render: false

package/src/templates/server-java/files/Application.java

@@ -0,0 +1,12 @@
+package com.example.app;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class Application {
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+}

package/src/templates/server-java/files/README.md

@@ -0,0 +1,48 @@
+# <%= it.options.projectName %>-server
+
+Backend scaffold (Spring Boot 3.3 + JDK 21 + JPA + Spring Security + JWT + MySQL).
+
+## Stack
+
+- Spring Boot 3.3.4
+- JDK 21
+- Spring Data JPA + Hibernate
+- Spring Security + JJWT 0.12（无状态认证）
+- MySQL 8 (default; tests use H2 with MySQL mode)
+- Jackson, Validation, Actuator
+
+## Configuration
+
+| 属性 | 默认 | 环境变量 |
+|------|------|---------|
+| 数据库 URL | `jdbc:mysql://localhost:3306/<%= it.options.projectName %>?createDatabaseIfNotExist=true...` | `SPRING_DATASOURCE_URL` |
+| DB 用户 | `root` | `SPRING_DATASOURCE_USERNAME` |
+| DB 密码 | （空） | `SPRING_DATASOURCE_PASSWORD` |
+| JWT secret | development-only placeholder | `JWT_SECRET`（生产必改）|
+| JWT 有效期 | 120 分钟 | `app.jwt.expiration-minutes` |
+
+> 默认 `spring.jpa.hibernate.ddl-auto=update`。生产环境改为 `validate` 并用 Flyway/Liquibase 管理 schema。
+
+## Profiles
+
+- 默认（无 profile）：MySQL，详见 `application.yaml`
+- `test`：H2 内存数据库 + MySQL 兼容模式，见 `application-test.yaml`
+
+## Development
+
+```bash
+# 假设 JDK 21 在 D:\work\wn\soft\java21
+$env:JAVA_HOME = 'D:\work\wn\soft\java21'
+$env:PATH = "$env:JAVA_HOME\bin;$env:PATH"
+
+mvn spring-boot:run
+mvn test
+mvn package
+```
+
+## Conventions
+
+- 包结构：`com.example.app.<feature>` 一个包一个模块
+- JPA 实体：`<feature>/entity/`；Repo：`<feature>/repository/`；Service：`<feature>/service/`；Controller：`<feature>/web/`
+- 契约消费：所有 DTO 字段名与 `contracts/openapi/api.yaml` 对齐；类型由 `contracts/dictionaries/` 派生
+- 错误处理：抛 `BusinessException`，`@ControllerAdvice` 翻译为 `contracts/errors/error-codes.yaml` 中的标准错误结构

package/src/templates/server-java/files/application-test.yaml

@@ -0,0 +1,17 @@
+spring:
+  datasource:
+    url: jdbc:h2:mem:test;MODE=MySQL;DB_CLOSE_DELAY=-1
+    driver-class-name: org.h2.Driver
+    username: sa
+    password: ''
+  jpa:
+    hibernate:
+      ddl-auto: create-drop
+    properties:
+      hibernate:
+        dialect: org.hibernate.dialect.H2Dialect
+
+app:
+  jwt:
+    secret: test-secret-for-unit-tests-only-min-32-characters-please
+    expiration-minutes: 60

package/src/templates/server-java/files/application.yaml

@@ -0,0 +1,33 @@
+spring:
+  application:
+    name: <%= it.options.projectName %>-server
+  datasource:
+    # 默认指向本地 MySQL；生产环境通过 SPRING_DATASOURCE_URL 等环境变量覆盖
+    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:
+    hibernate:
+      ddl-auto: update
+    properties:
+      hibernate:
+        dialect: org.hibernate.dialect.MySQLDialect
+        format_sql: true
+    show-sql: false
+    open-in-view: false
+
+server:
+  port: 8080
+
+management:
+  endpoints:
+    web:
+      exposure:
+        include: health,info
+
+# JWT 配置：生产环境通过环境变量覆盖 secret
+app:
+  jwt:
+    secret: ${JWT_SECRET:change-me-please-this-is-a-development-secret-only-min-32-chars}
+    expiration-minutes: 120

package/src/templates/server-java/files/pom.xml

@@ -0,0 +1,97 @@
+<?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>
+    </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>com.mysql</groupId>
+            <artifactId>mysql-connector-j</artifactId>
+            <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>
+        </plugins>
+    </build>
+</project>

package/src/templates/server-java/fragment.yaml

@@ -0,0 +1,24 @@
+name: server-java
+version: 1.1.0
+appliesWhen:
+  backend: java
+priority: 30
+files:
+  - from: files/README.md
+    to: server/README.md
+    render: true
+  - from: files/pom.xml
+    to: server/pom.xml
+    render: true
+  - from: files/Application.java
+    to: server/src/main/java/com/example/app/Application.java
+    render: false
+  - from: files/application.yaml
+    to: server/src/main/resources/application.yaml
+    render: true
+  - from: files/application-test.yaml
+    to: server/src/test/resources/application-test.yaml
+    render: false
+  - from: files/generated-gitkeep
+    to: server/generated/.gitkeep
+    render: false