@robsun/create-keystone-app 0.2.15 → 0.4.1

package/dist/create-module.js

@@ -1,114 +1,114 @@
-#!/usr/bin/env node
-const fs = require('fs')
-const path = require('path')
-const readline = require('readline/promises')
-const { stdin: input, stdout: output } = require('process')
-
-const usage = [
-  'Usage: create-module <module-name> [options]',
-  '',
-  'Options:',
-  '  --frontend-only    Only generate the frontend module',
-  '  --backend-only     Only generate the backend module',
-  '  --with-crud        Include CRUD example code',
-  '  --with-approval    Include approval workflow code (implies --with-crud)',
-  '  --skip-register    Skip auto registration steps',
-  '  -h, --help         Show help',
-  '',
-  'Run without options to use guided prompts.',
-].join('\n')
-
-main().catch((err) => {
-  const message = err instanceof Error ? err.message : String(err)
-  console.error(message)
-  process.exit(1)
-})
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2))
-  if (args.help) {
-    console.log(usage)
-    return
-  }
-
-  const canPrompt = isInteractive()
-  const rl = canPrompt ? readline.createInterface({ input, output }) : null
-
-  let includeFrontend = !args.backendOnly
-  let includeBackend = !args.frontendOnly
-  let withCrud = args.withCrud || args.withApproval // --with-approval implies --with-crud
-  let withApproval = args.withApproval
-  let skipRegister = args.skipRegister
-
-  try {
-    if (!args.target) {
-      if (!rl) {
-        console.error(usage)
-        process.exit(1)
-      }
-      args.target = await promptText(rl, 'Module name')
-    }
-
-    if (args.frontendOnly && args.backendOnly) {
-      fail('Use either --frontend-only or --backend-only, not both.')
-    }
-
-    if (!args.frontendOnly && !args.backendOnly && rl) {
-      const selection = await promptSelect(
-        rl,
-        'Generate which module(s)?',
-        ['frontend + backend', 'frontend only', 'backend only'],
-        0
-      )
-      if (selection === 'frontend only') {
-        includeFrontend = true
-        includeBackend = false
-      } else if (selection === 'backend only') {
-        includeFrontend = false
-        includeBackend = true
-      }
-    }
-
-    if (!args.withCrud && !args.withApproval && rl) {
-      withCrud = await promptConfirm(rl, 'Include CRUD example code', false)
-    }
-    if (withCrud && !args.withApproval && rl) {
-      withApproval = await promptConfirm(rl, 'Include approval workflow code', false)
-    }
-    if (!args.skipRegister && rl) {
-      const autoRegister = await promptConfirm(rl, 'Auto-register module', true)
-      skipRegister = !autoRegister
-    }
-  } finally {
-    if (rl) {
-      rl.close()
-    }
-  }
-
-  const names = buildNames(args.target)
-  const rootDir = resolveProjectRoot(process.cwd(), includeFrontend, includeBackend)
-
-  const frontendSourceDir = path.join(rootDir, 'apps', 'web', 'src', 'modules', 'example')
-  const frontendTargetDir = path.join(rootDir, 'apps', 'web', 'src', 'modules', names.kebab)
-  const backendSourceDir = path.join(rootDir, 'apps', 'server', 'internal', 'modules', 'example')
-  const backendTargetDir = path.join(rootDir, 'apps', 'server', 'internal', 'modules', names.kebab)
-
-  if (includeFrontend) {
-    if (!fs.existsSync(frontendSourceDir)) {
-      fail(`Frontend example module not found at ${frontendSourceDir}`)
-    }
-    if (fs.existsSync(frontendTargetDir)) {
-      fail(`Frontend module already exists: ${frontendTargetDir}`)
-    }
-    copyModule(frontendSourceDir, frontendTargetDir, names, 'frontend')
-    if (!withCrud) {
-      pruneFrontendCrud(frontendTargetDir, names)
-    }
-    if (withApproval) {
-      addFrontendApproval(frontendTargetDir, names)
-    }
-  }
-
+#!/usr/bin/env node
+const fs = require('fs')
+const path = require('path')
+const readline = require('readline/promises')
+const { stdin: input, stdout: output } = require('process')
+
+const usage = [
+  'Usage: create-module <module-name> [options]',
+  '',
+  'Options:',
+  '  --frontend-only    Only generate the frontend module',
+  '  --backend-only     Only generate the backend module',
+  '  --with-crud        Include CRUD example code',
+  '  --with-approval    Include approval workflow code (implies --with-crud)',
+  '  --skip-register    Skip auto registration steps',
+  '  -h, --help         Show help',
+  '',
+  'Run without options to use guided prompts.',
+].join('\n')
+
+main().catch((err) => {
+  const message = err instanceof Error ? err.message : String(err)
+  console.error(message)
+  process.exit(1)
+})
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2))
+  if (args.help) {
+    console.log(usage)
+    return
+  }
+
+  const canPrompt = isInteractive()
+  const rl = canPrompt ? readline.createInterface({ input, output }) : null
+
+  let includeFrontend = !args.backendOnly
+  let includeBackend = !args.frontendOnly
+  let withCrud = args.withCrud || args.withApproval // --with-approval implies --with-crud
+  let withApproval = args.withApproval
+  let skipRegister = args.skipRegister
+
+  try {
+    if (!args.target) {
+      if (!rl) {
+        console.error(usage)
+        process.exit(1)
+      }
+      args.target = await promptText(rl, 'Module name')
+    }
+
+    if (args.frontendOnly && args.backendOnly) {
+      fail('Use either --frontend-only or --backend-only, not both.')
+    }
+
+    if (!args.frontendOnly && !args.backendOnly && rl) {
+      const selection = await promptSelect(
+        rl,
+        'Generate which module(s)?',
+        ['frontend + backend', 'frontend only', 'backend only'],
+        0
+      )
+      if (selection === 'frontend only') {
+        includeFrontend = true
+        includeBackend = false
+      } else if (selection === 'backend only') {
+        includeFrontend = false
+        includeBackend = true
+      }
+    }
+
+    if (!args.withCrud && !args.withApproval && rl) {
+      withCrud = await promptConfirm(rl, 'Include CRUD example code', false)
+    }
+    if (withCrud && !args.withApproval && rl) {
+      withApproval = await promptConfirm(rl, 'Include approval workflow code', false)
+    }
+    if (!args.skipRegister && rl) {
+      const autoRegister = await promptConfirm(rl, 'Auto-register module', true)
+      skipRegister = !autoRegister
+    }
+  } finally {
+    if (rl) {
+      rl.close()
+    }
+  }
+
+  const names = buildNames(args.target)
+  const rootDir = resolveProjectRoot(process.cwd(), includeFrontend, includeBackend)
+
+  const frontendSourceDir = path.join(rootDir, 'apps', 'web', 'src', 'modules', 'example')
+  const frontendTargetDir = path.join(rootDir, 'apps', 'web', 'src', 'modules', names.kebab)
+  const backendSourceDir = path.join(rootDir, 'apps', 'server', 'internal', 'modules', 'example')
+  const backendTargetDir = path.join(rootDir, 'apps', 'server', 'internal', 'modules', names.kebab)
+
+  if (includeFrontend) {
+    if (!fs.existsSync(frontendSourceDir)) {
+      fail(`Frontend example module not found at ${frontendSourceDir}`)
+    }
+    if (fs.existsSync(frontendTargetDir)) {
+      fail(`Frontend module already exists: ${frontendTargetDir}`)
+    }
+    copyModule(frontendSourceDir, frontendTargetDir, names, 'frontend')
+    if (!withCrud) {
+      pruneFrontendCrud(frontendTargetDir, names)
+    }
+    if (withApproval) {
+      addFrontendApproval(frontendTargetDir, names)
+    }
+  }
+
   if (includeBackend) {
     if (!fs.existsSync(backendSourceDir)) {
       fail(`Backend example module not found at ${backendSourceDir}`)
@@ -123,1094 +123,1124 @@ async function main() {
     if (withApproval) {
       addBackendApproval(backendTargetDir, names)
     }
+    writeBackendReadme(backendTargetDir, names)
   }
-
-  if (!skipRegister) {
-    if (includeFrontend) {
-      registerFrontendModule(path.join(rootDir, 'apps', 'web', 'src', 'main.tsx'), names)
-    }
-    if (includeBackend) {
-      registerBackendModule(
-        path.join(rootDir, 'apps', 'server', 'internal', 'modules', 'manifest.go'),
-        path.join(rootDir, 'apps', 'server', 'config.yaml'),
-        names
-      )
-    }
-  }
-
-  const targets = []
-  if (includeFrontend) targets.push('frontend')
-  if (includeBackend) targets.push('backend')
-
-  console.log(`Created ${names.kebab} module (${targets.join(' + ')})`)
-  if (skipRegister) {
-    console.log('Registration skipped. Update the app entrypoints manually.')
-  } else {
-    console.log('Registration updated.')
-  }
-  if (!withCrud) {
-    console.log('Generated minimal scaffolding (no CRUD example).')
-  }
-  if (withApproval) {
-    console.log('Approval workflow code added.')
-    console.log('  - Backend: domain/service/approval.go, api/handler/approval.go')
-    console.log('  - Frontend: components/ApprovalActions.tsx')
-    console.log('  Note: Register approval callback in module.go RegisterApprovalCallback()')
-  }
-}
-
-function isInteractive() {
-  return Boolean(input.isTTY && output.isTTY)
-}
-
-async function promptText(rl, label) {
-  while (true) {
-    const answer = await rl.question(`${label}: `)
-    const trimmed = answer.trim()
-    if (trimmed) {
-      return trimmed
-    }
-    console.log('Please enter a value.')
-  }
-}
-
-async function promptSelect(rl, label, choices, defaultIndex) {
-  while (true) {
-    const options = choices.map((choice, index) => `  ${index + 1}) ${choice}`).join('\n')
-    const answer = await rl.question(
-      `${label}\n${options}\nSelect an option [${defaultIndex + 1}]: `
-    )
-    const normalized = answer.trim().toLowerCase()
-    if (!normalized) {
-      return choices[defaultIndex]
-    }
-    const numeric = Number(normalized)
-    if (Number.isInteger(numeric) && numeric >= 1 && numeric <= choices.length) {
-      return choices[numeric - 1]
-    }
-    const match = choices.find((choice) => choice.toLowerCase() === normalized)
-    if (match) {
-      return match
-    }
-    console.log('Invalid selection. Try again.')
-  }
-}
-
-async function promptConfirm(rl, label, defaultValue) {
-  while (true) {
-    const suffix = defaultValue ? 'Y/n' : 'y/N'
-    const answer = await rl.question(`${label} (${suffix}): `)
-    const normalized = answer.trim().toLowerCase()
-    if (!normalized) {
-      return defaultValue
-    }
-    if (['y', 'yes'].includes(normalized)) {
-      return true
-    }
-    if (['n', 'no'].includes(normalized)) {
-      return false
-    }
-    console.log('Please enter y or n.')
-  }
-}
-
-function buildNames(raw) {
-  const words = splitWords(raw)
-  if (words.length === 0) {
-    fail(`Invalid module name: ${raw}`)
-  }
-  const capitalized = words.map(capitalize)
-  const kebab = words.join('-')
-  const camel = words[0] + capitalized.slice(1).join('')
-  const pascal = capitalized.join('')
-  const lower = words.join('')
-  const display = capitalized.join(' ')
-  return {
-    raw,
-    words,
-    kebab,
-    camel,
-    pascal,
-    lower,
-    display,
-  }
-}
-
-function splitWords(value) {
-  const normalized = String(value || '')
-    .trim()
-    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
-    .replace(/[^a-zA-Z0-9]+/g, ' ')
-    .trim()
-  if (!normalized) return []
-  return normalized.split(/\s+/).map((word) => word.toLowerCase())
-}
-
-function capitalize(value) {
-  return value ? value[0].toUpperCase() + value.slice(1) : ''
-}
-
-function resolveProjectRoot(startDir, includeFrontend, includeBackend) {
-  const candidates = [
-    startDir,
-    path.join(startDir, 'packages', 'create-keystone-app', 'template'),
-    path.join(startDir, 'template'),
-  ]
-  for (const candidate of candidates) {
-    const frontendOk =
-      !includeFrontend || fs.existsSync(path.join(candidate, 'apps', 'web', 'src', 'modules', 'example'))
-    const backendOk =
-      !includeBackend || fs.existsSync(path.join(candidate, 'apps', 'server', 'internal', 'modules', 'example'))
-    if (frontendOk && backendOk) {
-      return candidate
-    }
-  }
-  fail('Could not find a project with apps/web and apps/server module templates.')
-}
-
-function copyModule(srcDir, destDir, names, mode) {
-  copyDir(srcDir, destDir, (entryName) => renameSegment(entryName, names), (content, filePath) =>
-    transformContent(content, filePath, names, mode)
-  )
-}
-
-function copyDir(src, dest, renameEntry, transform) {
-  fs.mkdirSync(dest, { recursive: true })
-  const entries = fs.readdirSync(src, { withFileTypes: true })
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name)
-    const nextName = renameEntry(entry.name)
-    const destPath = path.join(dest, nextName)
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, renameEntry, transform)
-    } else {
-      copyFile(srcPath, destPath, transform)
-    }
-  }
-}
-
-function copyFile(src, dest, transform) {
-  const content = fs.readFileSync(src, 'utf8')
-  const next = transform ? transform(content, dest) : content
-  fs.mkdirSync(path.dirname(dest), { recursive: true })
-  fs.writeFileSync(dest, next, 'utf8')
-}
-
-function renameSegment(segment, names) {
-  if (segment === 'example') {
-    return names.kebab
-  }
-  return segment.replace(/Example/g, names.pascal).replace(/example/g, names.camel)
-}
-
-function transformContent(content, filePath, names, mode) {
-  const ext = path.extname(filePath).toLowerCase()
-  if (ext === '.go') {
-    return replaceInCode(
-      content,
-      [
-        ['Example', names.pascal],
-        ['example', names.lower],
-      ],
-      (value) => replaceStringLiteral(value, names, mode === 'backend' ? names.lower : names.camel)
-    )
-  }
-  if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
-    return replaceInCode(
-      content,
-      [
-        ['Example', names.pascal],
-        ['example', names.camel],
-      ],
-      (value) => replaceStringLiteral(value, names, names.camel)
-    )
-  }
-  return replaceText(content, names)
-}
-
-function replaceText(content, names) {
-  return applyReplacements(content, [
-    ['Example', names.display],
-    ['example', names.kebab],
-  ])
-}
-
-function replaceStringLiteral(value, names, pathWord) {
-  if (value.startsWith('./') || value.startsWith('../')) {
-    return applyReplacements(value, [
-      ['Example', names.pascal],
-      ['example', pathWord],
-    ])
-  }
-  return applyReplacements(value, [
-    ['Example', names.display],
-    ['example', names.kebab],
-  ])
-}
-
-function replaceInCode(content, codeReplacements, stringReplacer) {
-  let out = ''
-  let i = 0
-  let start = 0
-  let inString = null
-  let escaped = false
-  while (i < content.length) {
-    const ch = content[i]
-    if (!inString) {
-      if (ch === '"' || ch === "'" || ch === '`') {
-        out += applyReplacements(content.slice(start, i), codeReplacements)
-        inString = ch
-        out += ch
-        i += 1
-        start = i
-        continue
-      }
-      i += 1
-      continue
-    }
-    if (escaped) {
-      escaped = false
-      i += 1
-      continue
-    }
-    if (ch === '\\' && inString !== '`') {
-      escaped = true
-      i += 1
-      continue
-    }
-    if (ch === inString) {
-      out += stringReplacer(content.slice(start, i))
-      out += ch
-      inString = null
-      i += 1
-      start = i
-      continue
-    }
-    i += 1
-  }
-  if (start < content.length) {
-    const tail = content.slice(start)
-    out += inString ? stringReplacer(tail) : applyReplacements(tail, codeReplacements)
-  }
-  return out
-}
-
-function applyReplacements(value, replacements) {
-  let next = value
-  for (const [from, to] of replacements) {
-    next = next.split(from).join(to)
-  }
-  return next
-}
-
-function pruneFrontendCrud(targetDir, names) {
-  const servicesDir = path.join(targetDir, 'services')
-  if (fs.existsSync(servicesDir)) {
-    fs.rmSync(servicesDir, { recursive: true, force: true })
-  }
-  const typesFile = path.join(targetDir, 'types.ts')
-  if (fs.existsSync(typesFile)) {
-    fs.rmSync(typesFile, { force: true })
+
+  if (!skipRegister) {
+    if (includeFrontend) {
+      registerFrontendModule(path.join(rootDir, 'apps', 'web', 'src', 'main.tsx'), names)
+    }
+    if (includeBackend) {
+      registerBackendModule(
+        path.join(rootDir, 'apps', 'server', 'internal', 'modules', 'manifest.go'),
+        path.join(rootDir, 'apps', 'server', 'config.yaml'),
+        names
+      )
+    }
+  }
+
+  const targets = []
+  if (includeFrontend) targets.push('frontend')
+  if (includeBackend) targets.push('backend')
+
+  console.log(`Created ${names.kebab} module (${targets.join(' + ')})`)
+  if (skipRegister) {
+    console.log('Registration skipped. Update the app entrypoints manually.')
+  } else {
+    console.log('Registration updated.')
+  }
+  if (!withCrud) {
+    console.log('Generated minimal scaffolding (no CRUD example).')
+  }
+  if (withApproval) {
+    console.log('Approval workflow code added.')
+    console.log('  - Backend: domain/service/approval.go, api/handler/approval.go')
+    console.log('  - Frontend: components/ApprovalActions.tsx')
+    console.log('  Note: Register approval callback in module.go RegisterApprovalCallback()')
+  }
+}
+
+function isInteractive() {
+  return Boolean(input.isTTY && output.isTTY)
+}
+
+async function promptText(rl, label) {
+  while (true) {
+    const answer = await rl.question(`${label}: `)
+    const trimmed = answer.trim()
+    if (trimmed) {
+      return trimmed
+    }
+    console.log('Please enter a value.')
+  }
+}
+
+async function promptSelect(rl, label, choices, defaultIndex) {
+  while (true) {
+    const options = choices.map((choice, index) => `  ${index + 1}) ${choice}`).join('\n')
+    const answer = await rl.question(
+      `${label}\n${options}\nSelect an option [${defaultIndex + 1}]: `
+    )
+    const normalized = answer.trim().toLowerCase()
+    if (!normalized) {
+      return choices[defaultIndex]
+    }
+    const numeric = Number(normalized)
+    if (Number.isInteger(numeric) && numeric >= 1 && numeric <= choices.length) {
+      return choices[numeric - 1]
+    }
+    const match = choices.find((choice) => choice.toLowerCase() === normalized)
+    if (match) {
+      return match
+    }
+    console.log('Invalid selection. Try again.')
+  }
+}
+
+async function promptConfirm(rl, label, defaultValue) {
+  while (true) {
+    const suffix = defaultValue ? 'Y/n' : 'y/N'
+    const answer = await rl.question(`${label} (${suffix}): `)
+    const normalized = answer.trim().toLowerCase()
+    if (!normalized) {
+      return defaultValue
+    }
+    if (['y', 'yes'].includes(normalized)) {
+      return true
+    }
+    if (['n', 'no'].includes(normalized)) {
+      return false
+    }
+    console.log('Please enter y or n.')
+  }
+}
+
+function buildNames(raw) {
+  const words = splitWords(raw)
+  if (words.length === 0) {
+    fail(`Invalid module name: ${raw}`)
+  }
+  const capitalized = words.map(capitalize)
+  const kebab = words.join('-')
+  const camel = words[0] + capitalized.slice(1).join('')
+  const pascal = capitalized.join('')
+  const lower = words.join('')
+  const display = capitalized.join(' ')
+  return {
+    raw,
+    words,
+    kebab,
+    camel,
+    pascal,
+    lower,
+    display,
+  }
+}
+
+function splitWords(value) {
+  const normalized = String(value || '')
+    .trim()
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/[^a-zA-Z0-9]+/g, ' ')
+    .trim()
+  if (!normalized) return []
+  return normalized.split(/\s+/).map((word) => word.toLowerCase())
+}
+
+function capitalize(value) {
+  return value ? value[0].toUpperCase() + value.slice(1) : ''
+}
+
+function resolveProjectRoot(startDir, includeFrontend, includeBackend) {
+  const candidates = [
+    startDir,
+    path.join(startDir, 'packages', 'create-keystone-app', 'template'),
+    path.join(startDir, 'template'),
+  ]
+  for (const candidate of candidates) {
+    const frontendOk =
+      !includeFrontend || fs.existsSync(path.join(candidate, 'apps', 'web', 'src', 'modules', 'example'))
+    const backendOk =
+      !includeBackend || fs.existsSync(path.join(candidate, 'apps', 'server', 'internal', 'modules', 'example'))
+    if (frontendOk && backendOk) {
+      return candidate
+    }
+  }
+  fail('Could not find a project with apps/web and apps/server module templates.')
+}
+
+function copyModule(srcDir, destDir, names, mode) {
+  copyDir(srcDir, destDir, (entryName) => renameSegment(entryName, names), (content, filePath) =>
+    transformContent(content, filePath, names, mode)
+  )
+}
+
+function copyDir(src, dest, renameEntry, transform) {
+  fs.mkdirSync(dest, { recursive: true })
+  const entries = fs.readdirSync(src, { withFileTypes: true })
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name)
+    const nextName = renameEntry(entry.name)
+    const destPath = path.join(dest, nextName)
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, renameEntry, transform)
+    } else {
+      copyFile(srcPath, destPath, transform)
+    }
+  }
+}
+
+function copyFile(src, dest, transform) {
+  const content = fs.readFileSync(src, 'utf8')
+  const next = transform ? transform(content, dest) : content
+  fs.mkdirSync(path.dirname(dest), { recursive: true })
+  fs.writeFileSync(dest, next, 'utf8')
+}
+
+function renameSegment(segment, names) {
+  if (segment === 'example') {
+    return names.kebab
+  }
+  return segment.replace(/Example/g, names.pascal).replace(/example/g, names.camel)
+}
+
+function transformContent(content, filePath, names, mode) {
+  const ext = path.extname(filePath).toLowerCase()
+  if (ext === '.go') {
+    return replaceInCode(
+      content,
+      [
+        ['Example', names.pascal],
+        ['example', names.lower],
+      ],
+      (value) => replaceStringLiteral(value, names, mode === 'backend' ? names.lower : names.camel)
+    )
+  }
+  if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
+    return replaceInCode(
+      content,
+      [
+        ['Example', names.pascal],
+        ['example', names.camel],
+      ],
+      (value) => replaceStringLiteral(value, names, names.camel)
+    )
+  }
+  return replaceText(content, names)
+}
+
+function replaceText(content, names) {
+  return applyReplacements(content, [
+    ['Example', names.display],
+    ['example', names.kebab],
+  ])
+}
+
+function replaceStringLiteral(value, names, pathWord) {
+  if (value.startsWith('./') || value.startsWith('../')) {
+    return applyReplacements(value, [
+      ['Example', names.pascal],
+      ['example', pathWord],
+    ])
+  }
+  return applyReplacements(value, [
+    ['Example', names.display],
+    ['example', names.kebab],
+  ])
+}
+
+function replaceInCode(content, codeReplacements, stringReplacer) {
+  let out = ''
+  let i = 0
+  let start = 0
+  let inString = null
+  let escaped = false
+  while (i < content.length) {
+    const ch = content[i]
+    if (!inString) {
+      if (ch === '"' || ch === "'" || ch === '`') {
+        out += applyReplacements(content.slice(start, i), codeReplacements)
+        inString = ch
+        out += ch
+        i += 1
+        start = i
+        continue
+      }
+      i += 1
+      continue
+    }
+    if (escaped) {
+      escaped = false
+      i += 1
+      continue
+    }
+    if (ch === '\\' && inString !== '`') {
+      escaped = true
+      i += 1
+      continue
+    }
+    if (ch === inString) {
+      out += stringReplacer(content.slice(start, i))
+      out += ch
+      inString = null
+      i += 1
+      start = i
+      continue
+    }
+    i += 1
+  }
+  if (start < content.length) {
+    const tail = content.slice(start)
+    out += inString ? stringReplacer(tail) : applyReplacements(tail, codeReplacements)
+  }
+  return out
+}
+
+function applyReplacements(value, replacements) {
+  let next = value
+  for (const [from, to] of replacements) {
+    next = next.split(from).join(to)
+  }
+  return next
+}
+
+function pruneFrontendCrud(targetDir, names) {
+  const servicesDir = path.join(targetDir, 'services')
+  if (fs.existsSync(servicesDir)) {
+    fs.rmSync(servicesDir, { recursive: true, force: true })
+  }
+  const typesFile = path.join(targetDir, 'types.ts')
+  if (fs.existsSync(typesFile)) {
+    fs.rmSync(typesFile, { force: true })
+  }
+  const pageFile = path.join(targetDir, 'pages', `${names.pascal}ItemsPage.tsx`)
+  const content = [
+    "import { Card, Typography } from 'antd'",
+    '',
+    `export function ${names.pascal}ItemsPage() {`,
+    '  return (',
+    `    <Card title="${names.display}">`,
+    '      <Typography.Paragraph type="secondary">',
+    `        ${names.display} module is ready. Start building your pages here.`,
+    '      </Typography.Paragraph>',
+    '    </Card>',
+    '  )',
+    '}',
+    '',
+  ].join('\n')
+  fs.writeFileSync(pageFile, content, 'utf8')
+}
+
+function pruneBackendCrud(targetDir, names) {
+  const dirs = ['api', 'bootstrap', 'domain', 'infra', 'tests']
+  for (const dir of dirs) {
+    const fullPath = path.join(targetDir, dir)
+    if (fs.existsSync(fullPath)) {
+      fs.rmSync(fullPath, { recursive: true, force: true })
+    }
+  }
+  const moduleFile = path.join(targetDir, 'module.go')
+  const content = [
+    `package ${names.lower}`,
+    '',
+    'import (',
+    '\t"github.com/gin-gonic/gin"',
+    '\t"gorm.io/gorm"',
+    '',
+    '\t"github.com/robsuncn/keystone/domain/permissions"',
+    '\t"github.com/robsuncn/keystone/infra/jobs"',
+    ')',
+    '',
+    'type Module struct{}',
+    '',
+    'func NewModule() *Module {',
+    '\treturn &Module{}',
+    '}',
+    '',
+    'func (m *Module) Name() string {',
+    `\treturn "${names.kebab}"`,
+    '}',
+    '',
+    'func (m *Module) RegisterRoutes(_ *gin.RouterGroup) {}',
+    '',
+    'func (m *Module) RegisterModels() []interface{} {',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) RegisterPermissions(reg *permissions.Registry) error {',
+    '\tif reg == nil {',
+    '\t\treturn nil',
+    '\t}',
+    `\tif err := reg.CreateMenu("${names.kebab}:overview", "${names.display}", "${names.kebab}", 10); err != nil {`,
+    '\t\treturn err',
+    '\t}',
+    `\tif err := reg.CreateAction("${names.kebab}:overview:view", "View ${names.display}", "${names.kebab}", "${names.kebab}:overview"); err != nil {`,
+    '\t\treturn err',
+    '\t}',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) RegisterJobs(_ *jobs.Registry) error {',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) Migrate(_ *gorm.DB) error {',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) Seed(_ *gorm.DB) error {',
+    '\treturn nil',
+    '}',
+    '',
+  ].join('\n')
+  fs.writeFileSync(moduleFile, content, 'utf8')
+}
+
+function registerFrontendModule(mainPath, names) {
+  if (!fs.existsSync(mainPath)) {
+    return
+  }
+  const content = fs.readFileSync(mainPath, 'utf8')
+  const importLine = `import './modules/${names.kebab}'`
+  if (content.includes(importLine)) {
+    return
+  }
+  const lines = content.split(/\r?\n/)
+  let lastImport = -1
+  for (let i = 0; i < lines.length; i += 1) {
+    if (/^\s*import\s/.test(lines[i])) {
+      lastImport = i
+    }
+  }
+  if (lastImport === -1) {
+    lines.unshift(importLine)
+  } else {
+    lines.splice(lastImport + 1, 0, importLine)
+  }
+  fs.writeFileSync(mainPath, lines.join('\n'), 'utf8')
+}
+
+function registerBackendModule(manifestPath, configPath, names) {
+  updateManifest(manifestPath, names)
+  updateConfig(configPath, names)
+}
+
+function updateManifest(manifestPath, names) {
+  if (!fs.existsSync(manifestPath)) {
+    return
+  }
+  const content = fs.readFileSync(manifestPath, 'utf8')
+  const lines = content.split(/\r?\n/)
+  const importStart = lines.findIndex((line) => line.trim() === 'import (')
+  if (importStart === -1) {
+    return
+  }
+  const importEnd = lines.findIndex((line, index) => index > importStart && line.trim() === ')')
+  if (importEnd === -1) {
+    return
+  }
+  const importBlock = lines.slice(importStart + 1, importEnd)
+  const exampleImport = importBlock.find((line) => line.includes('/internal/modules/example'))
+  if (!exampleImport) {
+    return
+  }
+  const pathMatch = exampleImport.match(/\"([^\"]+)\"/)
+  if (!pathMatch) {
+    return
+  }
+  const modulePath = pathMatch[1].replace(/\/example$/, `/${names.kebab}`)
+  const alias = names.lower
+  const importLine = `${alias} "${modulePath}"`
+  if (!importBlock.some((line) => line.includes(`/${names.kebab}"`))) {
+    lines.splice(importEnd, 0, importLine)
+  }
+  const registerLine = `\tRegister(${alias}.NewModule())`
+  if (!lines.some((line) => line.trim() === registerLine.trim())) {
+    const registerIndices = lines
+      .map((line, index) => ({ line, index }))
+      .filter(({ line }) => line.includes('Register('))
+    if (registerIndices.length > 0) {
+      lines.splice(registerIndices[registerIndices.length - 1].index + 1, 0, registerLine)
+    } else {
+      const clearIndex = lines.findIndex((line) => line.includes('Clear()'))
+      if (clearIndex !== -1) {
+        lines.splice(clearIndex + 1, 0, registerLine)
+      }
+    }
+  }
+  fs.writeFileSync(manifestPath, lines.join('\n'), 'utf8')
+}
+
+function updateConfig(configPath, names) {
+  if (!fs.existsSync(configPath)) {
+    return
+  }
+  const content = fs.readFileSync(configPath, 'utf8')
+  if (content.includes(`- "${names.kebab}"`) || content.includes(`- '${names.kebab}'`)) {
+    return
+  }
+  const lines = content.split(/\r?\n/)
+  const modulesIndex = lines.findIndex((line) => line.trim() === 'modules:')
+  if (modulesIndex === -1) {
+    return
+  }
+  const enabledIndex = lines.findIndex((line, index) => index > modulesIndex && line.trim() === 'enabled:')
+  if (enabledIndex === -1) {
+    return
+  }
+  let insertIndex = enabledIndex + 1
+  let indent = null
+  for (let i = enabledIndex + 1; i < lines.length; i += 1) {
+    const line = lines[i]
+    if (!line.trim()) continue
+    if (!line.trim().startsWith('-')) {
+      insertIndex = i
+      break
+    }
+    if (indent === null) {
+      indent = line.match(/^\s*/)?.[0] ?? ''
+    }
+    insertIndex = i + 1
+  }
+  const prefix = indent ?? '    '
+  lines.splice(insertIndex, 0, `${prefix}- "${names.kebab}"`)
+  fs.writeFileSync(configPath, lines.join('\n'), 'utf8')
+}
+
+function parseArgs(argv) {
+  const out = {
+    target: null,
+    frontendOnly: false,
+    backendOnly: false,
+    withCrud: false,
+    withApproval: false,
+    skipRegister: false,
+    help: false,
+  }
+  for (const arg of argv) {
+    if (arg === '--help' || arg === '-h') {
+      out.help = true
+      continue
+    }
+    if (arg === '--frontend-only') {
+      out.frontendOnly = true
+      continue
+    }
+    if (arg === '--backend-only') {
+      out.backendOnly = true
+      continue
+    }
+    if (arg === '--with-crud') {
+      out.withCrud = true
+      continue
+    }
+    if (arg === '--with-approval') {
+      out.withApproval = true
+      continue
+    }
+    if (arg === '--skip-register') {
+      out.skipRegister = true
+      continue
+    }
+    if (arg.startsWith('-')) {
+      fail(`Unknown option: ${arg}`)
+    }
+    if (!out.target) {
+      out.target = arg
+      continue
+    }
+    fail('Too many arguments.')
+  }
+  return out
+}
+
+// ============================================================================
+// Approval Workflow Code Generation
+// ============================================================================
+
+function addBackendApproval(targetDir, names) {
+  // 1. Add approval status constants to model
+  addApprovalStatusToModel(targetDir, names)
+
+  // 2. Create approval service file
+  createApprovalService(targetDir, names)
+
+  // 3. Create approval callback file
+  createApprovalCallback(targetDir, names)
+
+  // 4. Create approval handler file
+  createApprovalHandler(targetDir, names)
+
+  // 5. Add approval routes to module.go
+  addApprovalRoutes(targetDir, names)
+
+  // 6. Add approval i18n keys
+  addApprovalI18nKeys(targetDir, names)
+}
+
+function addApprovalStatusToModel(targetDir, names) {
+  // Find the model file - could be item.go or {names.lower}.go
+  const modelDir = path.join(targetDir, 'domain', 'models')
+  if (!fs.existsSync(modelDir)) return
+
+  const modelFiles = fs.readdirSync(modelDir).filter((f) => f.endsWith('.go'))
+  if (modelFiles.length === 0) return
+
+  const modelFile = path.join(modelDir, modelFiles[0])
+  let content = fs.readFileSync(modelFile, 'utf8')
+
+  // Add approval status constants if not exists
+  if (!content.includes('StatusPending') && !content.includes('StatusDraft')) {
+    // Pattern: StatusActive ItemStatus = "active"
+    content = content.replace(
+      /(StatusActive\s+\w+\s*=\s*"active")/,
+      `StatusDraft    ItemStatus = "draft"\n\tStatusPending  ItemStatus = "pending"\n\tStatusApproved ItemStatus = "approved"\n\tStatusRejected ItemStatus = "rejected"\n\t$1`
+    )
+
+    // Update IsValid to include new statuses
+    content = content.replace(
+      /case StatusActive, StatusInactive:/,
+      `case StatusDraft, StatusPending, StatusApproved, StatusRejected, StatusActive, StatusInactive:`
+    )
+  }
+
+  // Add approval fields to struct if not exists
+  if (!content.includes('ApprovalInstanceID')) {
+    // Pattern: Status ItemStatus `gorm:...` json:"status"`
+    // Need to match the full line including the backticks and add before closing brace
+    content = content.replace(
+      /(Status\s+ItemStatus\s+`[^`]+`)/,
+      `$1\n\tApprovalInstanceID *uint      \`gorm:"index" json:"approval_instance_id,omitempty"\`\n\tRejectReason       string     \`gorm:"size:500" json:"reject_reason,omitempty"\``
+    )
+  }
+
+  fs.writeFileSync(modelFile, content, 'utf8')
+}
+
+function createApprovalService(targetDir, names) {
+  const serviceDir = path.join(targetDir, 'domain', 'service')
+  fs.mkdirSync(serviceDir, { recursive: true })
+
+  const content = `package service
+
+import (
+\t"context"
+\t"fmt"
+
+\tapproval "github.com/robsuncn/keystone/domain/approval/service"
+\t"__APP_NAME__/apps/server/internal/modules/${names.kebab}/domain/models"
+)
+
+// ApprovalBusinessType is the approval business type for this module
+const ApprovalBusinessType = "${names.lower}_item_approval"
+
+// Submit submits the entity for approval
+func (s *${names.pascal}Service) Submit(ctx context.Context, tenantID, id, userID uint) error {
+\tentity, err := s.repo.FindByID(tenantID, id)
+\tif err != nil {
+\t\treturn err
+\t}
+
+\tif entity.Status != models.StatusDraft {
+\t\treturn ErrInvalidStatusForSubmit
+\t}
+
+\tinstance, err := s.approval.CreateInstance(ctx, approval.CreateInstanceInput{
+\t\tTenantID:     tenantID,
+\t\tBusinessType: ApprovalBusinessType,
+\t\tBusinessID:   id,
+\t\tApplicantID:  userID,
+\t\tContext: map[string]interface{}{
+\t\t\t"name":        entity.Name,
+\t\t\t"description": entity.Description,
+\t\t},
+\t})
+\tif err != nil {
+\t\treturn fmt.Errorf("create approval instance failed: %w", err)
+\t}
+
+\tentity.Status = models.StatusPending
+\tentity.ApprovalInstanceID = &instance.ID
+\treturn s.repo.Update(ctx, entity)
+}
+
+// Cancel cancels the approval request
+func (s *${names.pascal}Service) Cancel(ctx context.Context, tenantID, id, userID uint) error {
+\tentity, err := s.repo.FindByID(tenantID, id)
+\tif err != nil {
+\t\treturn err
+\t}
+
+\tif entity.Status != models.StatusPending {
+\t\treturn ErrInvalidStatusForCancel
+\t}
+
+\tif entity.ApprovalInstanceID == nil {
+\t\treturn ErrNoApprovalInstance
+\t}
+
+\tif err := s.approval.Cancel(ctx, *entity.ApprovalInstanceID, userID); err != nil {
+\t\treturn err
+\t}
+
+\tentity.Status = models.StatusDraft
+\tentity.ApprovalInstanceID = nil
+\treturn s.repo.Update(ctx, entity)
+}
+`
+  fs.writeFileSync(path.join(serviceDir, 'approval.go'), content, 'utf8')
+
+  // Add approval errors to errors.go
+  const errorsFile = path.join(serviceDir, 'errors.go')
+  if (fs.existsSync(errorsFile)) {
+    let errContent = fs.readFileSync(errorsFile, 'utf8')
+    if (!errContent.includes('ErrInvalidStatusForSubmit')) {
+      errContent = errContent.replace(
+        /\)(\s*)$/,
+        `\tErrInvalidStatusForSubmit = &i18n.I18nError{Key: modulei18n.MsgInvalidStatusForSubmit}\n\tErrInvalidStatusForCancel = &i18n.I18nError{Key: modulei18n.MsgInvalidStatusForCancel}\n\tErrNoApprovalInstance     = &i18n.I18nError{Key: modulei18n.MsgNoApprovalInstance}\n)$1`
+      )
+      fs.writeFileSync(errorsFile, errContent, 'utf8')
+    }
+  }
+}
+
+function createApprovalCallback(targetDir, names) {
+  const serviceDir = path.join(targetDir, 'domain', 'service')
+  fs.mkdirSync(serviceDir, { recursive: true })
+
+  const content = `package service
+
+import (
+\t"context"
+\t"log/slog"
+
+\t"__APP_NAME__/apps/server/internal/modules/${names.kebab}/domain/models"
+\t"__APP_NAME__/apps/server/internal/modules/${names.kebab}/infra/repository"
+)
+
+// ${names.pascal}ApprovalCallback implements the approval callback interface
+type ${names.pascal}ApprovalCallback struct {
+\trepo *repository.${names.pascal}Repository
+}
+
+// New${names.pascal}ApprovalCallback creates a new approval callback
+func New${names.pascal}ApprovalCallback(repo *repository.${names.pascal}Repository) *${names.pascal}ApprovalCallback {
+\treturn &${names.pascal}ApprovalCallback{repo: repo}
+}
+
+// OnApproved is called when the approval is approved
+func (c *${names.pascal}ApprovalCallback) OnApproved(
+\tctx context.Context,
+\ttenantID, businessID, approverID uint,
+) error {
+\tentity, err := c.repo.FindByID(tenantID, businessID)
+\tif err != nil {
+\t\treturn err
+\t}
+
+\tif entity.Status != models.StatusPending {
+\t\tslog.Warn("approval callback: status mismatch",
+\t\t\t"expected", models.StatusPending,
+\t\t\t"actual", entity.Status,
+\t\t)
+\t\treturn nil // idempotent
+\t}
+
+\tentity.Status = models.StatusApproved
+\treturn c.repo.Update(ctx, entity)
+}
+
+// OnRejected is called when the approval is rejected
+func (c *${names.pascal}ApprovalCallback) OnRejected(
+\tctx context.Context,
+\ttenantID, businessID, approverID uint,
+\treason string,
+) error {
+\tentity, err := c.repo.FindByID(tenantID, businessID)
+\tif err != nil {
+\t\treturn err
+\t}
+
+\tif entity.Status != models.StatusPending {
+\t\treturn nil // idempotent
+\t}
+
+\tentity.Status = models.StatusRejected
+\tentity.RejectReason = reason
+\treturn c.repo.Update(ctx, entity)
+}
+`
+  fs.writeFileSync(path.join(serviceDir, 'callback.go'), content, 'utf8')
+}
+
+function createApprovalHandler(targetDir, names) {
+  const handlerDir = path.join(targetDir, 'api', 'handler')
+  fs.mkdirSync(handlerDir, { recursive: true })
+
+  const content = `package handler
+
+import (
+\t"github.com/gin-gonic/gin"
+\thcommon "github.com/robsuncn/keystone/api/handler/common"
+\t"github.com/robsuncn/keystone/api/response"
+
+\tmodulei18n "__APP_NAME__/apps/server/internal/modules/${names.kebab}/i18n"
+)
+
+// Submit submits the entity for approval
+func (h *${names.pascal}Handler) Submit(c *gin.Context) {
+\tif h == nil || h.svc == nil {
+\t\tresponse.ServiceUnavailableI18n(c, modulei18n.MsgServiceUnavailable)
+\t\treturn
+\t}
+\ttenantID := resolveTenantID(c)
+\tuserID, _ := hcommon.GetUserID(c)
+
+\tid, err := hcommon.ParseUintParam(c, "id")
+\tif err != nil || id == 0 {
+\t\tresponse.BadRequestI18n(c, modulei18n.MsgInvalidID)
+\t\treturn
+\t}
+
+\tif err := h.svc.Submit(c.Request.Context(), tenantID, id, userID); err != nil {
+\t\thandleServiceError(c, err)
+\t\treturn
+\t}
+
+\tresponse.SuccessI18n(c, modulei18n.MsgSubmitted, nil)
+}
+
+// Cancel cancels the approval request
+func (h *${names.pascal}Handler) Cancel(c *gin.Context) {
+\tif h == nil || h.svc == nil {
+\t\tresponse.ServiceUnavailableI18n(c, modulei18n.MsgServiceUnavailable)
+\t\treturn
+\t}
+\ttenantID := resolveTenantID(c)
+\tuserID, _ := hcommon.GetUserID(c)
+
+\tid, err := hcommon.ParseUintParam(c, "id")
+\tif err != nil || id == 0 {
+\t\tresponse.BadRequestI18n(c, modulei18n.MsgInvalidID)
+\t\treturn
+\t}
+
+\tif err := h.svc.Cancel(c.Request.Context(), tenantID, id, userID); err != nil {
+\t\thandleServiceError(c, err)
+\t\treturn
+\t}
+
+\tresponse.SuccessI18n(c, modulei18n.MsgCancelled, nil)
+}
+`
+  fs.writeFileSync(path.join(handlerDir, 'approval.go'), content, 'utf8')
+}
+
+function addApprovalRoutes(targetDir, names) {
+  const moduleFile = path.join(targetDir, 'module.go')
+  if (!fs.existsSync(moduleFile)) return
+
+  let content = fs.readFileSync(moduleFile, 'utf8')
+
+  // Add approval routes if not exists
+  if (!content.includes('Submit') && content.includes('RegisterRoutes')) {
+    // Pattern: group.DELETE("/items/:id", handler.Delete) or similar
+    content = content.replace(
+      /(group\.DELETE\("[^"]+",\s*\w+\.Delete\))/,
+      `$1
+
+\t// Approval routes
+\tgroup.POST("/items/:id/submit", handler.Submit)
+\tgroup.POST("/items/:id/cancel", handler.Cancel)`
+    )
+    fs.writeFileSync(moduleFile, content, 'utf8')
+  }
+}
+
+function addApprovalI18nKeys(targetDir, names) {
+  const keysFile = path.join(targetDir, 'i18n', 'keys.go')
+  if (!fs.existsSync(keysFile)) return
+
+  let content = fs.readFileSync(keysFile, 'utf8')
+
+  if (!content.includes('MsgSubmitted')) {
+    content = content.replace(
+      /MsgServiceUnavailable\s*=\s*"[^"]+"/,
+      `MsgServiceUnavailable = "${names.kebab}.service.unavailable"
+
+\t// Approval messages
+\tMsgSubmitted               = "${names.kebab}.${names.lower}.submitted"
+\tMsgCancelled               = "${names.kebab}.${names.lower}.cancelled"
+\tMsgInvalidStatusForSubmit  = "${names.kebab}.validation.invalidStatusForSubmit"
+\tMsgInvalidStatusForCancel  = "${names.kebab}.validation.invalidStatusForCancel"
+\tMsgNoApprovalInstance      = "${names.kebab}.validation.noApprovalInstance"`
+    )
+    fs.writeFileSync(keysFile, content, 'utf8')
+  }
+
+  // Update locale files
+  const localeFiles = [
+    { file: path.join(targetDir, 'i18n', 'locales', 'zh-CN.json'), lang: 'zh' },
+    { file: path.join(targetDir, 'i18n', 'locales', 'en-US.json'), lang: 'en' },
+  ]
+
+  for (const { file, lang } of localeFiles) {
+    if (!fs.existsSync(file)) continue
+    try {
+      const locale = JSON.parse(fs.readFileSync(file, 'utf8'))
+      const moduleKey = names.kebab
+      if (!locale[moduleKey]) locale[moduleKey] = {}
+      if (!locale[moduleKey][names.lower]) locale[moduleKey][names.lower] = {}
+      if (!locale[moduleKey].validation) locale[moduleKey].validation = {}
+
+      if (lang === 'zh') {
+        locale[moduleKey][names.lower].submitted = '\u5df2\u63d0\u4ea4\u5ba1\u6279'
+        locale[moduleKey][names.lower].cancelled = '\u5df2\u64a4\u56de\u5ba1\u6279'
+        locale[moduleKey].validation.invalidStatusForSubmit = '\u5f53\u524d\u72b6\u6001\u4e0d\u5141\u8bb8\u63d0\u4ea4'
+        locale[moduleKey].validation.invalidStatusForCancel = '\u5f53\u524d\u72b6\u6001\u4e0d\u5141\u8bb8\u64a4\u56de'
+        locale[moduleKey].validation.noApprovalInstance = '\u65e0\u5ba1\u6279\u5b9e\u4f8b'
+      } else {
+        locale[moduleKey][names.lower].submitted = 'Submitted for approval'
+        locale[moduleKey][names.lower].cancelled = 'Approval cancelled'
+        locale[moduleKey].validation.invalidStatusForSubmit = 'Cannot submit in current status'
+        locale[moduleKey].validation.invalidStatusForCancel = 'Cannot cancel in current status'
+        locale[moduleKey].validation.noApprovalInstance = 'No approval instance'
+      }
+
+      fs.writeFileSync(file, JSON.stringify(locale, null, 2), 'utf8')
+    } catch {
+      // ignore parse errors
+    }
+  }
+}
+
+function addFrontendApproval(targetDir, names) {
+  // 1. Create ApprovalActions component
+  createApprovalActionsComponent(targetDir, names)
+
+  // 2. Update types.ts to include approval status
+  updateFrontendTypes(targetDir, names)
+
+  // 3. Add approval API functions
+  addApprovalApiServices(targetDir, names)
+
+  // 4. Add approval i18n translations
+  addFrontendApprovalI18n(targetDir, names)
+}
+
+function createApprovalActionsComponent(targetDir, names) {
+  const componentsDir = path.join(targetDir, 'components')
+  fs.mkdirSync(componentsDir, { recursive: true })
+
+  const content = `import { useCallback, useState } from 'react'
+import { App, Button, Popconfirm, Space, Tag } from 'antd'
+import { CheckCircleOutlined, CloseCircleOutlined, SendOutlined, UndoOutlined } from '@ant-design/icons'
+import { useTranslation } from 'react-i18next'
+import type { ${names.pascal}ItemStatus } from '../types'
+
+interface Props {
+  id: number
+  status: ${names.pascal}ItemStatus
+  onSubmit: (id: number) => Promise<void>
+  onCancel: (id: number) => Promise<void>
+  onRefresh: () => void
+}
+
+const statusConfig: Record<${names.pascal}ItemStatus, { color: string; icon: React.ReactNode }> = {
+  draft: { color: 'default', icon: null },
+  pending: { color: 'processing', icon: <CloseCircleOutlined spin /> },
+  approved: { color: 'success', icon: <CheckCircleOutlined /> },
+  rejected: { color: 'error', icon: <CloseCircleOutlined /> },
+  active: { color: 'success', icon: null },
+  inactive: { color: 'default', icon: null },
+}
+
+export function ApprovalActions({ id, status, onSubmit, onCancel, onRefresh }: Props) {
+  const { t } = useTranslation('${names.camel}')
+  const { t: tc } = useTranslation('common')
+  const { message } = App.useApp()
+  const [loading, setLoading] = useState(false)
+
+  const handleSubmit = useCallback(async () => {
+    setLoading(true)
+    try {
+      await onSubmit(id)
+      message.success(t('messages.submitSuccess'))
+      onRefresh()
+    } catch (err) {
+      message.error(err instanceof Error ? err.message : tc('messages.operationFailed'))
+    } finally {
+      setLoading(false)
+    }
+  }, [id, message, onRefresh, onSubmit, t, tc])
+
+  const handleCancel = useCallback(async () => {
+    setLoading(true)
+    try {
+      await onCancel(id)
+      message.success(t('messages.cancelSuccess'))
+      onRefresh()
+    } catch (err) {
+      message.error(err instanceof Error ? err.message : tc('messages.operationFailed'))
+    } finally {
+      setLoading(false)
+    }
+  }, [id, message, onRefresh, onCancel, t, tc])
+
+  const config = statusConfig[status] || { color: 'default', icon: null }
+
+  return (
+    <Space>
+      <Tag color={config.color} icon={config.icon}>
+        {t(\`status.\${status}\`)}
+      </Tag>
+
+      {status === 'draft' && (
+        <Popconfirm title={t('confirm.submit')} onConfirm={handleSubmit}>
+          <Button type="primary" icon={<SendOutlined />} loading={loading} size="small">
+            {t('actions.submit')}
+          </Button>
+        </Popconfirm>
+      )}
+
+      {status === 'pending' && (
+        <Popconfirm title={t('confirm.cancel')} onConfirm={handleCancel}>
+          <Button icon={<UndoOutlined />} loading={loading} size="small">
+            {t('actions.cancelApproval')}
+          </Button>
+        </Popconfirm>
+      )}
+    </Space>
+  )
+}
+`
+  fs.writeFileSync(path.join(componentsDir, 'ApprovalActions.tsx'), content, 'utf8')
+}
+
+function updateFrontendTypes(targetDir, names) {
+  const typesFile = path.join(targetDir, 'types.ts')
+  if (!fs.existsSync(typesFile)) return
+
+  let content = fs.readFileSync(typesFile, 'utf8')
+
+  // Update status type to include approval statuses
+  // Pattern: export type XxxItemStatus = 'active' | 'inactive'
+  if (!content.includes("'pending'")) {
+    content = content.replace(
+      /export type (\w+)Status = ['"]active['"] \| ['"]inactive['"]/,
+      `export type $1Status = 'draft' | 'pending' | 'approved' | 'rejected' | 'active' | 'inactive'`
+    )
+  }
+
+  // Add approval fields to interface
+  // Pattern: status: XxxItemStatus
+  if (!content.includes('approval_instance_id')) {
+    content = content.replace(
+      /(status:\s*\w+Status\s*\n)/,
+      `$1  approval_instance_id?: number\n  reject_reason?: string\n`
+    )
+  }
+
+  fs.writeFileSync(typesFile, content, 'utf8')
+}
+
+function addApprovalApiServices(targetDir, names) {
+  const apiFile = path.join(targetDir, 'services', 'api.ts')
+  if (!fs.existsSync(apiFile)) return
+
+  let content = fs.readFileSync(apiFile, 'utf8')
+
+  if (!content.includes('submit')) {
+    content += `
+
+// Approval API
+export const submit${names.pascal}Item = async (id: number) => {
+  await api.post(\`/${names.kebab}/items/\${id}/submit\`)
+}
+
+export const cancel${names.pascal}ItemApproval = async (id: number) => {
+  await api.post(\`/${names.kebab}/items/\${id}/cancel\`)
+}
+`
+    fs.writeFileSync(apiFile, content, 'utf8')
+  }
+}
+
+function addFrontendApprovalI18n(targetDir, names) {
+  const localeFiles = [
+    { file: path.join(targetDir, 'locales', 'zh-CN', `${names.camel}.json`), lang: 'zh' },
+    { file: path.join(targetDir, 'locales', 'en-US', `${names.camel}.json`), lang: 'en' },
+  ]
+
+  for (const { file, lang } of localeFiles) {
+    if (!fs.existsSync(file)) continue
+    try {
+      const locale = JSON.parse(fs.readFileSync(file, 'utf8'))
+
+      // Add approval status translations
+      if (!locale.status) locale.status = {}
+      if (!locale.messages) locale.messages = {}
+      if (!locale.actions) locale.actions = {}
+      if (!locale.confirm) locale.confirm = {}
+
+      if (lang === 'zh') {
+        locale.status.draft = '\u8349\u7a3f'
+        locale.status.pending = '\u5ba1\u6279\u4e2d'
+        locale.status.approved = '\u5df2\u901a\u8fc7'
+        locale.status.rejected = '\u5df2\u62d2\u7edd'
+        locale.messages.submitSuccess = '\u63d0\u4ea4\u6210\u529f'
+        locale.messages.cancelSuccess = '\u64a4\u56de\u6210\u529f'
+        locale.actions.submit = '\u63d0\u4ea4\u5ba1\u6279'
+        locale.actions.cancelApproval = '\u64a4\u56de'
+        locale.confirm.submit = '\u786e\u5b9a\u8981\u63d0\u4ea4\u5ba1\u6279\u5417\uff1f'
+        locale.confirm.cancel = '\u786e\u5b9a\u8981\u64a4\u56de\u5ba1\u6279\u5417\uff1f'
+      } else {
+        locale.status.draft = 'Draft'
+        locale.status.pending = 'Pending'
+        locale.status.approved = 'Approved'
+        locale.status.rejected = 'Rejected'
+        locale.messages.submitSuccess = 'Submitted successfully'
+        locale.messages.cancelSuccess = 'Cancelled successfully'
+        locale.actions.submit = 'Submit'
+        locale.actions.cancelApproval = 'Cancel'
+        locale.confirm.submit = 'Are you sure to submit for approval?'
+        locale.confirm.cancel = 'Are you sure to cancel the approval?'
+      }
+
+      fs.writeFileSync(file, JSON.stringify(locale, null, 2), 'utf8')
+    } catch {
+      // ignore parse errors
+    }
   }
-  const pageFile = path.join(targetDir, 'pages', `${names.pascal}ItemsPage.tsx`)
-  const content = [
-    "import { Card, Typography } from 'antd'",
-    '',
-    `export function ${names.pascal}ItemsPage() {`,
-    '  return (',
-    `    <Card title="${names.display}">`,
-    '      <Typography.Paragraph type="secondary">',
-    `        ${names.display} module is ready. Start building your pages here.`,
-    '      </Typography.Paragraph>',
-    '    </Card>',
-    '  )',
-    '}',
-    '',
-  ].join('\n')
-  fs.writeFileSync(pageFile, content, 'utf8')
 }
 
-function pruneBackendCrud(targetDir, names) {
-  const dirs = ['api', 'bootstrap', 'domain', 'infra']
-  for (const dir of dirs) {
-    const fullPath = path.join(targetDir, dir)
-    if (fs.existsSync(fullPath)) {
-      fs.rmSync(fullPath, { recursive: true, force: true })
-    }
+function writeBackendReadme(targetDir, names) {
+  const readmePath = path.join(targetDir, 'README.md')
+  if (fs.existsSync(readmePath)) {
+    return
   }
-  const moduleFile = path.join(targetDir, 'module.go')
   const content = [
-    `package ${names.lower}`,
-    '',
-    'import (',
-    '\t"github.com/gin-gonic/gin"',
-    '\t"gorm.io/gorm"',
-    '',
-    '\t"github.com/robsuncn/keystone/domain/permissions"',
-    '\t"github.com/robsuncn/keystone/infra/jobs"',
-    ')',
+    `# ${names.display} Module`,
     '',
-    'type Module struct{}',
+    '## Overview',
+    `- Module key: \`${names.kebab}\``,
+    '- Description: TODO',
     '',
-    'func NewModule() *Module {',
-    '\treturn &Module{}',
-    '}',
+    '## API Endpoints',
+    '- TODO: list REST endpoints and handlers',
     '',
-    'func (m *Module) Name() string {',
-    `\treturn "${names.kebab}"`,
-    '}',
+    '## Permissions',
+    '- TODO: list permission codes',
     '',
-    'func (m *Module) RegisterRoutes(_ *gin.RouterGroup) {}',
-    '',
-    'func (m *Module) RegisterModels() []interface{} {',
-    '\treturn nil',
-    '}',
-    '',
-    'func (m *Module) RegisterPermissions(reg *permissions.Registry) error {',
-    '\tif reg == nil {',
-    '\t\treturn nil',
-    '\t}',
-    `\tif err := reg.CreateMenu("${names.kebab}:overview", "${names.display}", "${names.kebab}", 10); err != nil {`,
-    '\t\treturn err',
-    '\t}',
-    `\tif err := reg.CreateAction("${names.kebab}:overview:view", "View ${names.display}", "${names.kebab}", "${names.kebab}:overview"); err != nil {`,
-    '\t\treturn err',
-    '\t}',
-    '\treturn nil',
-    '}',
-    '',
-    'func (m *Module) RegisterJobs(_ *jobs.Registry) error {',
-    '\treturn nil',
-    '}',
-    '',
-    'func (m *Module) Migrate(_ *gorm.DB) error {',
-    '\treturn nil',
-    '}',
-    '',
-    'func (m *Module) Seed(_ *gorm.DB) error {',
-    '\treturn nil',
-    '}',
+    '## Configuration',
+    '```yaml',
+    'modules:',
+    `  ${names.kebab}:`,
+    '    # key: value',
+    '```',
     '',
   ].join('\n')
-  fs.writeFileSync(moduleFile, content, 'utf8')
-}
-
-function registerFrontendModule(mainPath, names) {
-  if (!fs.existsSync(mainPath)) {
-    return
-  }
-  const content = fs.readFileSync(mainPath, 'utf8')
-  const importLine = `import './modules/${names.kebab}'`
-  if (content.includes(importLine)) {
-    return
-  }
-  const lines = content.split(/\r?\n/)
-  let lastImport = -1
-  for (let i = 0; i < lines.length; i += 1) {
-    if (/^\s*import\s/.test(lines[i])) {
-      lastImport = i
-    }
-  }
-  if (lastImport === -1) {
-    lines.unshift(importLine)
-  } else {
-    lines.splice(lastImport + 1, 0, importLine)
-  }
-  fs.writeFileSync(mainPath, lines.join('\n'), 'utf8')
-}
-
-function registerBackendModule(manifestPath, configPath, names) {
-  updateManifest(manifestPath, names)
-  updateConfig(configPath, names)
-}
-
-function updateManifest(manifestPath, names) {
-  if (!fs.existsSync(manifestPath)) {
-    return
-  }
-  const content = fs.readFileSync(manifestPath, 'utf8')
-  const lines = content.split(/\r?\n/)
-  const importStart = lines.findIndex((line) => line.trim() === 'import (')
-  if (importStart === -1) {
-    return
-  }
-  const importEnd = lines.findIndex((line, index) => index > importStart && line.trim() === ')')
-  if (importEnd === -1) {
-    return
-  }
-  const importBlock = lines.slice(importStart + 1, importEnd)
-  const exampleImport = importBlock.find((line) => line.includes('/internal/modules/example'))
-  if (!exampleImport) {
-    return
-  }
-  const pathMatch = exampleImport.match(/\"([^\"]+)\"/)
-  if (!pathMatch) {
-    return
-  }
-  const modulePath = pathMatch[1].replace(/\/example$/, `/${names.kebab}`)
-  const alias = names.lower
-  const importLine = `${alias} "${modulePath}"`
-  if (!importBlock.some((line) => line.includes(`/${names.kebab}"`))) {
-    lines.splice(importEnd, 0, importLine)
-  }
-  const registerLine = `\tRegister(${alias}.NewModule())`
-  if (!lines.some((line) => line.trim() === registerLine.trim())) {
-    const registerIndices = lines
-      .map((line, index) => ({ line, index }))
-      .filter(({ line }) => line.includes('Register('))
-    if (registerIndices.length > 0) {
-      lines.splice(registerIndices[registerIndices.length - 1].index + 1, 0, registerLine)
-    } else {
-      const clearIndex = lines.findIndex((line) => line.includes('Clear()'))
-      if (clearIndex !== -1) {
-        lines.splice(clearIndex + 1, 0, registerLine)
-      }
-    }
-  }
-  fs.writeFileSync(manifestPath, lines.join('\n'), 'utf8')
-}
-
-function updateConfig(configPath, names) {
-  if (!fs.existsSync(configPath)) {
-    return
-  }
-  const content = fs.readFileSync(configPath, 'utf8')
-  if (content.includes(`- "${names.kebab}"`) || content.includes(`- '${names.kebab}'`)) {
-    return
-  }
-  const lines = content.split(/\r?\n/)
-  const modulesIndex = lines.findIndex((line) => line.trim() === 'modules:')
-  if (modulesIndex === -1) {
-    return
-  }
-  const enabledIndex = lines.findIndex((line, index) => index > modulesIndex && line.trim() === 'enabled:')
-  if (enabledIndex === -1) {
-    return
-  }
-  let insertIndex = enabledIndex + 1
-  let indent = null
-  for (let i = enabledIndex + 1; i < lines.length; i += 1) {
-    const line = lines[i]
-    if (!line.trim()) continue
-    if (!line.trim().startsWith('-')) {
-      insertIndex = i
-      break
-    }
-    if (indent === null) {
-      indent = line.match(/^\s*/)?.[0] ?? ''
-    }
-    insertIndex = i + 1
-  }
-  const prefix = indent ?? '    '
-  lines.splice(insertIndex, 0, `${prefix}- "${names.kebab}"`)
-  fs.writeFileSync(configPath, lines.join('\n'), 'utf8')
-}
-
-function parseArgs(argv) {
-  const out = {
-    target: null,
-    frontendOnly: false,
-    backendOnly: false,
-    withCrud: false,
-    withApproval: false,
-    skipRegister: false,
-    help: false,
-  }
-  for (const arg of argv) {
-    if (arg === '--help' || arg === '-h') {
-      out.help = true
-      continue
-    }
-    if (arg === '--frontend-only') {
-      out.frontendOnly = true
-      continue
-    }
-    if (arg === '--backend-only') {
-      out.backendOnly = true
-      continue
-    }
-    if (arg === '--with-crud') {
-      out.withCrud = true
-      continue
-    }
-    if (arg === '--with-approval') {
-      out.withApproval = true
-      continue
-    }
-    if (arg === '--skip-register') {
-      out.skipRegister = true
-      continue
-    }
-    if (arg.startsWith('-')) {
-      fail(`Unknown option: ${arg}`)
-    }
-    if (!out.target) {
-      out.target = arg
-      continue
-    }
-    fail('Too many arguments.')
-  }
-  return out
-}
-
-// ============================================================================
-// Approval Workflow Code Generation
-// ============================================================================
-
-function addBackendApproval(targetDir, names) {
-  // 1. Add approval status constants to model
-  addApprovalStatusToModel(targetDir, names)
-
-  // 2. Create approval service file
-  createApprovalService(targetDir, names)
-
-  // 3. Create approval callback file
-  createApprovalCallback(targetDir, names)
-
-  // 4. Create approval handler file
-  createApprovalHandler(targetDir, names)
-
-  // 5. Add approval routes to module.go
-  addApprovalRoutes(targetDir, names)
-
-  // 6. Add approval i18n keys
-  addApprovalI18nKeys(targetDir, names)
-}
-
-function addApprovalStatusToModel(targetDir, names) {
-  // Find the model file - could be item.go or {names.lower}.go
-  const modelDir = path.join(targetDir, 'domain', 'models')
-  if (!fs.existsSync(modelDir)) return
-
-  const modelFiles = fs.readdirSync(modelDir).filter((f) => f.endsWith('.go'))
-  if (modelFiles.length === 0) return
-
-  const modelFile = path.join(modelDir, modelFiles[0])
-  let content = fs.readFileSync(modelFile, 'utf8')
-
-  // Add approval status constants if not exists
-  if (!content.includes('StatusPending') && !content.includes('StatusDraft')) {
-    // Pattern: StatusActive ItemStatus = "active"
-    content = content.replace(
-      /(StatusActive\s+\w+\s*=\s*"active")/,
-      `StatusDraft    ItemStatus = "draft"\n\tStatusPending  ItemStatus = "pending"\n\tStatusApproved ItemStatus = "approved"\n\tStatusRejected ItemStatus = "rejected"\n\t$1`
-    )
-
-    // Update IsValid to include new statuses
-    content = content.replace(
-      /case StatusActive, StatusInactive:/,
-      `case StatusDraft, StatusPending, StatusApproved, StatusRejected, StatusActive, StatusInactive:`
-    )
-  }
-
-  // Add approval fields to struct if not exists
-  if (!content.includes('ApprovalInstanceID')) {
-    // Pattern: Status ItemStatus `gorm:...` json:"status"`
-    // Need to match the full line including the backticks and add before closing brace
-    content = content.replace(
-      /(Status\s+ItemStatus\s+`[^`]+`)/,
-      `$1\n\tApprovalInstanceID *uint      \`gorm:"index" json:"approval_instance_id,omitempty"\`\n\tRejectReason       string     \`gorm:"size:500" json:"reject_reason,omitempty"\``
-    )
-  }
-
-  fs.writeFileSync(modelFile, content, 'utf8')
-}
-
-function createApprovalService(targetDir, names) {
-  const serviceDir = path.join(targetDir, 'domain', 'service')
-  fs.mkdirSync(serviceDir, { recursive: true })
-
-  const content = `package service
-
-import (
-\t"context"
-\t"fmt"
-
-\tapproval "github.com/robsuncn/keystone/domain/approval/service"
-\t"__APP_NAME__/apps/server/internal/modules/${names.kebab}/domain/models"
-)
-
-// ApprovalBusinessType is the approval business type for this module
-const ApprovalBusinessType = "${names.kebab}_approval"
-
-// Submit submits the entity for approval
-func (s *${names.pascal}Service) Submit(ctx context.Context, tenantID, id, userID uint) error {
-\tentity, err := s.repo.FindByID(tenantID, id)
-\tif err != nil {
-\t\treturn err
-\t}
-
-\tif entity.Status != models.StatusDraft {
-\t\treturn ErrInvalidStatusForSubmit
-\t}
-
-\tinstance, err := s.approval.CreateInstance(ctx, approval.CreateInstanceInput{
-\t\tTenantID:     tenantID,
-\t\tBusinessType: ApprovalBusinessType,
-\t\tBusinessID:   id,
-\t\tApplicantID:  userID,
-\t\tContext: map[string]interface{}{
-\t\t\t"name":        entity.Name,
-\t\t\t"description": entity.Description,
-\t\t},
-\t})
-\tif err != nil {
-\t\treturn fmt.Errorf("create approval instance failed: %w", err)
-\t}
-
-\tentity.Status = models.StatusPending
-\tentity.ApprovalInstanceID = &instance.ID
-\treturn s.repo.Update(ctx, entity)
-}
-
-// Cancel cancels the approval request
-func (s *${names.pascal}Service) Cancel(ctx context.Context, tenantID, id, userID uint) error {
-\tentity, err := s.repo.FindByID(tenantID, id)
-\tif err != nil {
-\t\treturn err
-\t}
-
-\tif entity.Status != models.StatusPending {
-\t\treturn ErrInvalidStatusForCancel
-\t}
-
-\tif entity.ApprovalInstanceID == nil {
-\t\treturn ErrNoApprovalInstance
-\t}
-
-\tif err := s.approval.Cancel(ctx, *entity.ApprovalInstanceID, userID); err != nil {
-\t\treturn err
-\t}
-
-\tentity.Status = models.StatusDraft
-\tentity.ApprovalInstanceID = nil
-\treturn s.repo.Update(ctx, entity)
-}
-`
-  fs.writeFileSync(path.join(serviceDir, 'approval.go'), content, 'utf8')
-
-  // Add approval errors to errors.go
-  const errorsFile = path.join(serviceDir, 'errors.go')
-  if (fs.existsSync(errorsFile)) {
-    let errContent = fs.readFileSync(errorsFile, 'utf8')
-    if (!errContent.includes('ErrInvalidStatusForSubmit')) {
-      errContent = errContent.replace(
-        /\)(\s*)$/,
-        `\tErrInvalidStatusForSubmit = &i18n.I18nError{Key: modulei18n.MsgInvalidStatusForSubmit}\n\tErrInvalidStatusForCancel = &i18n.I18nError{Key: modulei18n.MsgInvalidStatusForCancel}\n\tErrNoApprovalInstance     = &i18n.I18nError{Key: modulei18n.MsgNoApprovalInstance}\n)$1`
-      )
-      fs.writeFileSync(errorsFile, errContent, 'utf8')
-    }
-  }
-}
-
-function createApprovalCallback(targetDir, names) {
-  const serviceDir = path.join(targetDir, 'domain', 'service')
-  fs.mkdirSync(serviceDir, { recursive: true })
-
-  const content = `package service
-
-import (
-\t"context"
-\t"log/slog"
-
-\t"__APP_NAME__/apps/server/internal/modules/${names.kebab}/domain/models"
-\t"__APP_NAME__/apps/server/internal/modules/${names.kebab}/infra/repository"
-)
-
-// ${names.pascal}ApprovalCallback implements the approval callback interface
-type ${names.pascal}ApprovalCallback struct {
-\trepo *repository.${names.pascal}Repository
-}
-
-// New${names.pascal}ApprovalCallback creates a new approval callback
-func New${names.pascal}ApprovalCallback(repo *repository.${names.pascal}Repository) *${names.pascal}ApprovalCallback {
-\treturn &${names.pascal}ApprovalCallback{repo: repo}
-}
-
-// OnApproved is called when the approval is approved
-func (c *${names.pascal}ApprovalCallback) OnApproved(
-\tctx context.Context,
-\ttenantID, businessID, approverID uint,
-) error {
-\tentity, err := c.repo.FindByID(tenantID, businessID)
-\tif err != nil {
-\t\treturn err
-\t}
-
-\tif entity.Status != models.StatusPending {
-\t\tslog.Warn("approval callback: status mismatch",
-\t\t\t"expected", models.StatusPending,
-\t\t\t"actual", entity.Status,
-\t\t)
-\t\treturn nil // idempotent
-\t}
-
-\tentity.Status = models.StatusApproved
-\treturn c.repo.Update(ctx, entity)
-}
-
-// OnRejected is called when the approval is rejected
-func (c *${names.pascal}ApprovalCallback) OnRejected(
-\tctx context.Context,
-\ttenantID, businessID, approverID uint,
-\treason string,
-) error {
-\tentity, err := c.repo.FindByID(tenantID, businessID)
-\tif err != nil {
-\t\treturn err
-\t}
-
-\tif entity.Status != models.StatusPending {
-\t\treturn nil // idempotent
-\t}
-
-\tentity.Status = models.StatusRejected
-\tentity.RejectReason = reason
-\treturn c.repo.Update(ctx, entity)
-}
-`
-  fs.writeFileSync(path.join(serviceDir, 'callback.go'), content, 'utf8')
-}
-
-function createApprovalHandler(targetDir, names) {
-  const handlerDir = path.join(targetDir, 'api', 'handler')
-  fs.mkdirSync(handlerDir, { recursive: true })
-
-  const content = `package handler
-
-import (
-\t"github.com/gin-gonic/gin"
-\thcommon "github.com/robsuncn/keystone/api/handler/common"
-\t"github.com/robsuncn/keystone/api/response"
-
-\tmodulei18n "__APP_NAME__/apps/server/internal/modules/${names.kebab}/i18n"
-)
-
-// Submit submits the entity for approval
-func (h *${names.pascal}Handler) Submit(c *gin.Context) {
-\tif h == nil || h.svc == nil {
-\t\tresponse.ServiceUnavailableI18n(c, modulei18n.MsgServiceUnavailable)
-\t\treturn
-\t}
-\ttenantID := resolveTenantID(c)
-\tuserID, _ := hcommon.GetUserID(c)
-
-\tid, err := hcommon.ParseUintParam(c, "id")
-\tif err != nil || id == 0 {
-\t\tresponse.BadRequestI18n(c, modulei18n.MsgInvalidID)
-\t\treturn
-\t}
-
-\tif err := h.svc.Submit(c.Request.Context(), tenantID, id, userID); err != nil {
-\t\thandleServiceError(c, err)
-\t\treturn
-\t}
-
-\tresponse.SuccessI18n(c, modulei18n.MsgSubmitted, nil)
-}
-
-// Cancel cancels the approval request
-func (h *${names.pascal}Handler) Cancel(c *gin.Context) {
-\tif h == nil || h.svc == nil {
-\t\tresponse.ServiceUnavailableI18n(c, modulei18n.MsgServiceUnavailable)
-\t\treturn
-\t}
-\ttenantID := resolveTenantID(c)
-\tuserID, _ := hcommon.GetUserID(c)
-
-\tid, err := hcommon.ParseUintParam(c, "id")
-\tif err != nil || id == 0 {
-\t\tresponse.BadRequestI18n(c, modulei18n.MsgInvalidID)
-\t\treturn
-\t}
-
-\tif err := h.svc.Cancel(c.Request.Context(), tenantID, id, userID); err != nil {
-\t\thandleServiceError(c, err)
-\t\treturn
-\t}
-
-\tresponse.SuccessI18n(c, modulei18n.MsgCancelled, nil)
-}
-`
-  fs.writeFileSync(path.join(handlerDir, 'approval.go'), content, 'utf8')
-}
-
-function addApprovalRoutes(targetDir, names) {
-  const moduleFile = path.join(targetDir, 'module.go')
-  if (!fs.existsSync(moduleFile)) return
-
-  let content = fs.readFileSync(moduleFile, 'utf8')
-
-  // Add approval routes if not exists
-  if (!content.includes('Submit') && content.includes('RegisterRoutes')) {
-    // Pattern: group.DELETE("/items/:id", handler.Delete) or similar
-    content = content.replace(
-      /(group\.DELETE\("[^"]+",\s*\w+\.Delete\))/,
-      `$1
-
-\t// Approval routes
-\tgroup.POST("/items/:id/submit", handler.Submit)
-\tgroup.POST("/items/:id/cancel", handler.Cancel)`
-    )
-    fs.writeFileSync(moduleFile, content, 'utf8')
-  }
-}
-
-function addApprovalI18nKeys(targetDir, names) {
-  const keysFile = path.join(targetDir, 'i18n', 'keys.go')
-  if (!fs.existsSync(keysFile)) return
-
-  let content = fs.readFileSync(keysFile, 'utf8')
-
-  if (!content.includes('MsgSubmitted')) {
-    content = content.replace(
-      /MsgServiceUnavailable\s*=\s*"[^"]+"/,
-      `MsgServiceUnavailable = "${names.kebab}.service.unavailable"
-
-\t// Approval messages
-\tMsgSubmitted               = "${names.kebab}.${names.lower}.submitted"
-\tMsgCancelled               = "${names.kebab}.${names.lower}.cancelled"
-\tMsgInvalidStatusForSubmit  = "${names.kebab}.validation.invalidStatusForSubmit"
-\tMsgInvalidStatusForCancel  = "${names.kebab}.validation.invalidStatusForCancel"
-\tMsgNoApprovalInstance      = "${names.kebab}.validation.noApprovalInstance"`
-    )
-    fs.writeFileSync(keysFile, content, 'utf8')
-  }
-
-  // Update locale files
-  const localeFiles = [
-    { file: path.join(targetDir, 'i18n', 'locales', 'zh-CN.json'), lang: 'zh' },
-    { file: path.join(targetDir, 'i18n', 'locales', 'en-US.json'), lang: 'en' },
-  ]
-
-  for (const { file, lang } of localeFiles) {
-    if (!fs.existsSync(file)) continue
-    try {
-      const locale = JSON.parse(fs.readFileSync(file, 'utf8'))
-      const moduleKey = names.kebab
-      if (!locale[moduleKey]) locale[moduleKey] = {}
-      if (!locale[moduleKey][names.lower]) locale[moduleKey][names.lower] = {}
-      if (!locale[moduleKey].validation) locale[moduleKey].validation = {}
-
-      if (lang === 'zh') {
-        locale[moduleKey][names.lower].submitted = '已提交审批'
-        locale[moduleKey][names.lower].cancelled = '已撤回审批'
-        locale[moduleKey].validation.invalidStatusForSubmit = '当前状态不允许提交'
-        locale[moduleKey].validation.invalidStatusForCancel = '当前状态不允许撤回'
-        locale[moduleKey].validation.noApprovalInstance = '无审批实例'
-      } else {
-        locale[moduleKey][names.lower].submitted = 'Submitted for approval'
-        locale[moduleKey][names.lower].cancelled = 'Approval cancelled'
-        locale[moduleKey].validation.invalidStatusForSubmit = 'Cannot submit in current status'
-        locale[moduleKey].validation.invalidStatusForCancel = 'Cannot cancel in current status'
-        locale[moduleKey].validation.noApprovalInstance = 'No approval instance'
-      }
-
-      fs.writeFileSync(file, JSON.stringify(locale, null, 2), 'utf8')
-    } catch {
-      // ignore parse errors
-    }
-  }
-}
-
-function addFrontendApproval(targetDir, names) {
-  // 1. Create ApprovalActions component
-  createApprovalActionsComponent(targetDir, names)
-
-  // 2. Update types.ts to include approval status
-  updateFrontendTypes(targetDir, names)
-
-  // 3. Add approval API functions
-  addApprovalApiServices(targetDir, names)
-
-  // 4. Add approval i18n translations
-  addFrontendApprovalI18n(targetDir, names)
-}
-
-function createApprovalActionsComponent(targetDir, names) {
-  const componentsDir = path.join(targetDir, 'components')
-  fs.mkdirSync(componentsDir, { recursive: true })
-
-  const content = `import { useCallback, useState } from 'react'
-import { App, Button, Popconfirm, Space, Tag } from 'antd'
-import { CheckCircleOutlined, CloseCircleOutlined, SendOutlined, UndoOutlined } from '@ant-design/icons'
-import { useTranslation } from 'react-i18next'
-import type { ${names.pascal}ItemStatus } from '../types'
-
-interface Props {
-  id: number
-  status: ${names.pascal}ItemStatus
-  onSubmit: (id: number) => Promise<void>
-  onCancel: (id: number) => Promise<void>
-  onRefresh: () => void
-}
-
-const statusConfig: Record<${names.pascal}ItemStatus, { color: string; icon: React.ReactNode }> = {
-  draft: { color: 'default', icon: null },
-  pending: { color: 'processing', icon: <CloseCircleOutlined spin /> },
-  approved: { color: 'success', icon: <CheckCircleOutlined /> },
-  rejected: { color: 'error', icon: <CloseCircleOutlined /> },
-  active: { color: 'success', icon: null },
-  inactive: { color: 'default', icon: null },
-}
-
-export function ApprovalActions({ id, status, onSubmit, onCancel, onRefresh }: Props) {
-  const { t } = useTranslation('${names.camel}')
-  const { t: tc } = useTranslation('common')
-  const { message } = App.useApp()
-  const [loading, setLoading] = useState(false)
-
-  const handleSubmit = useCallback(async () => {
-    setLoading(true)
-    try {
-      await onSubmit(id)
-      message.success(t('messages.submitSuccess'))
-      onRefresh()
-    } catch (err) {
-      message.error(err instanceof Error ? err.message : tc('messages.operationFailed'))
-    } finally {
-      setLoading(false)
-    }
-  }, [id, message, onRefresh, onSubmit, t, tc])
-
-  const handleCancel = useCallback(async () => {
-    setLoading(true)
-    try {
-      await onCancel(id)
-      message.success(t('messages.cancelSuccess'))
-      onRefresh()
-    } catch (err) {
-      message.error(err instanceof Error ? err.message : tc('messages.operationFailed'))
-    } finally {
-      setLoading(false)
-    }
-  }, [id, message, onRefresh, onCancel, t, tc])
-
-  const config = statusConfig[status] || { color: 'default', icon: null }
-
-  return (
-    <Space>
-      <Tag color={config.color} icon={config.icon}>
-        {t(\`status.\${status}\`)}
-      </Tag>
-
-      {status === 'draft' && (
-        <Popconfirm title={t('confirm.submit')} onConfirm={handleSubmit}>
-          <Button type="primary" icon={<SendOutlined />} loading={loading} size="small">
-            {t('actions.submit')}
-          </Button>
-        </Popconfirm>
-      )}
-
-      {status === 'pending' && (
-        <Popconfirm title={t('confirm.cancel')} onConfirm={handleCancel}>
-          <Button icon={<UndoOutlined />} loading={loading} size="small">
-            {t('actions.cancelApproval')}
-          </Button>
-        </Popconfirm>
-      )}
-    </Space>
-  )
-}
-`
-  fs.writeFileSync(path.join(componentsDir, 'ApprovalActions.tsx'), content, 'utf8')
-}
-
-function updateFrontendTypes(targetDir, names) {
-  const typesFile = path.join(targetDir, 'types.ts')
-  if (!fs.existsSync(typesFile)) return
-
-  let content = fs.readFileSync(typesFile, 'utf8')
-
-  // Update status type to include approval statuses
-  // Pattern: export type XxxItemStatus = 'active' | 'inactive'
-  if (!content.includes("'pending'")) {
-    content = content.replace(
-      /export type (\w+)Status = ['"]active['"] \| ['"]inactive['"]/,
-      `export type $1Status = 'draft' | 'pending' | 'approved' | 'rejected' | 'active' | 'inactive'`
-    )
-  }
-
-  // Add approval fields to interface
-  // Pattern: status: XxxItemStatus
-  if (!content.includes('approval_instance_id')) {
-    content = content.replace(
-      /(status:\s*\w+Status\s*\n)/,
-      `$1  approval_instance_id?: number\n  reject_reason?: string\n`
-    )
-  }
-
-  fs.writeFileSync(typesFile, content, 'utf8')
-}
-
-function addApprovalApiServices(targetDir, names) {
-  const apiFile = path.join(targetDir, 'services', 'api.ts')
-  if (!fs.existsSync(apiFile)) return
-
-  let content = fs.readFileSync(apiFile, 'utf8')
-
-  if (!content.includes('submit')) {
-    content += `
-
-// Approval API
-export const submit${names.pascal} = async (id: number) => {
-  await api.post(\`/${names.kebab}/${names.lower}s/\${id}/submit\`)
-}
-
-export const cancel${names.pascal}Approval = async (id: number) => {
-  await api.post(\`/${names.kebab}/${names.lower}s/\${id}/cancel\`)
-}
-`
-    fs.writeFileSync(apiFile, content, 'utf8')
-  }
-}
-
-function addFrontendApprovalI18n(targetDir, names) {
-  const localeFiles = [
-    { file: path.join(targetDir, 'locales', 'zh-CN', `${names.camel}.json`), lang: 'zh' },
-    { file: path.join(targetDir, 'locales', 'en-US', `${names.camel}.json`), lang: 'en' },
-  ]
-
-  for (const { file, lang } of localeFiles) {
-    if (!fs.existsSync(file)) continue
-    try {
-      const locale = JSON.parse(fs.readFileSync(file, 'utf8'))
-
-      // Add approval status translations
-      if (!locale.status) locale.status = {}
-      if (!locale.messages) locale.messages = {}
-      if (!locale.actions) locale.actions = {}
-      if (!locale.confirm) locale.confirm = {}
-
-      if (lang === 'zh') {
-        locale.status.draft = '草稿'
-        locale.status.pending = '审批中'
-        locale.status.approved = '已通过'
-        locale.status.rejected = '已拒绝'
-        locale.messages.submitSuccess = '提交成功'
-        locale.messages.cancelSuccess = '撤回成功'
-        locale.actions.submit = '提交审批'
-        locale.actions.cancelApproval = '撤回'
-        locale.confirm.submit = '确定要提交审批吗？'
-        locale.confirm.cancel = '确定要撤回审批吗？'
-      } else {
-        locale.status.draft = 'Draft'
-        locale.status.pending = 'Pending'
-        locale.status.approved = 'Approved'
-        locale.status.rejected = 'Rejected'
-        locale.messages.submitSuccess = 'Submitted successfully'
-        locale.messages.cancelSuccess = 'Cancelled successfully'
-        locale.actions.submit = 'Submit'
-        locale.actions.cancelApproval = 'Cancel'
-        locale.confirm.submit = 'Are you sure to submit for approval?'
-        locale.confirm.cancel = 'Are you sure to cancel the approval?'
-      }
-
-      fs.writeFileSync(file, JSON.stringify(locale, null, 2), 'utf8')
-    } catch {
-      // ignore parse errors
-    }
-  }
+  fs.writeFileSync(readmePath, content, 'utf8')
 }
 
 function fail(message) {