# Hide Auto-Increment IDs in Create Forms Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Hide generated auto-increment fields in create dialogs while showing them read-only in edit and view dialogs.

**Architecture:** Keep field metadata unchanged and implement visibility in the Qing Vue template with a runtime `v-if` keyed to the generated primary-key value. Add a template-rendering regression test so both frontend and admin-frontend generation inherit the behavior.

**Tech Stack:** Java 8, JUnit 4, Apache Velocity, Vue 2, Element UI, Maven

---

### Task 1: Template rendering behavior

**Files:**
- Modify: `ruoyi-generator/src/test/java/com/ruoyi/generator/util/QingTemplateSupportTest.java`
- Modify: `ruoyi-generator/src/main/resources/qing/index.vue.vm`

- [ ] **Step 1: Write the failing rendering test**

Add a test that renders `qing/index.vue.vm` for a table with:

```java
GenTableColumn id = column("id", "ID", "Long", "id", "1", "1", "1", "1", "EQ", "input");
GenTableColumn name = column("name", "Name", "String", "name", "0", "1", "1", "1", "LIKE", "input");
```

Assert the rendered template contains:

```java
assertTrue(rendered.contains("<el-form-item v-if=\"form.id\" label=\"ID\" prop=\"id\">"));
assertTrue(rendered.contains("<el-input v-model=\"form.id\" disabled"));
assertFalse(rendered.contains("prop=\"id\" :rules="));
assertTrue(rendered.contains("<el-form-item label=\"Name\" prop=\"name\""));
```

- [ ] **Step 2: Run the focused test and verify RED**

Run:

```powershell
mvn -pl ruoyi-generator -am "-Dtest=QingTemplateSupportTest#qingCrudFormHidesAutoIncrementIdOnCreateAndShowsItReadOnlyOnEdit" "-Dsurefire.failIfNoSpecifiedTests=false" test
```

Expected: the new assertions fail because the generated ID field is unconditional, editable, and required.

- [ ] **Step 3: Implement the minimal template condition**

In the form-field loop:

```velocity
#set($autoIncrementField = $column.isIncrement == "1")
        <el-form-item#if($autoIncrementField) v-if="form.${pkColumn.javaField}"#end label="${columnComment}" prop="${javaField}"#if($column.isRequired == "1" && !$autoIncrementField) :rules="..."#end>
```

For input fields:

```velocity
          <el-input v-model="form.${javaField}"#if($autoIncrementField) disabled#end placeholder="请输入${columnComment}" />
```

- [ ] **Step 4: Run focused and related tests**

Run:

```powershell
mvn -pl ruoyi-generator -am "-Dtest=QingTemplateSupportTest" "-Dsurefire.failIfNoSpecifiedTests=false" test
```

Expected: all `QingTemplateSupportTest` tests pass.

- [ ] **Step 5: Verify generated output**

Render or regenerate project 106 and confirm the generated book form contains:

```vue
<el-form-item v-if="form.id" label="图书ID" prop="id">
  <el-input v-model="form.id" disabled ... />
</el-form-item>
```

Open `http://127.0.0.1:20178/#/admin/books` and verify:

- clicking “新增” does not show ID;
- editing an existing record shows ID read-only;
- saving a new record still succeeds.

### Task 2: Final verification

**Files:**
- Verify: `ruoyi-generator/src/main/resources/qing/index.vue.vm`
- Verify: `ruoyi-generator/src/test/java/com/ruoyi/generator/util/QingTemplateSupportTest.java`

- [ ] **Step 1: Run regression tests**

```powershell
mvn -pl ruoyi-generator -am "-Dtest=QingTemplateSupportTest,FrontProjectServiceImplTest,MysqlDdlBuilderTest" "-Dsurefire.failIfNoSpecifiedTests=false" test
```

Expected: zero failures and zero errors.

- [ ] **Step 2: Check the patch**

```powershell
git diff --check -- ruoyi-generator/src/main/resources/qing/index.vue.vm ruoyi-generator/src/test/java/com/ruoyi/generator/util/QingTemplateSupportTest.java
```

Expected: exit code 0.