create-fullstack-scaffold 0.1.0

package/template/lint-scripts/ai-context-generator.ts

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync, writeFileSync } from 'fs'
+import { join } from 'path'
+import { execSync } from 'child_process'
+
+const PROJECT_ROOT = process.cwd()
+
+function generateAIContext(): string {
+  const lines: string[] = [
+    '# 项目上下文（用于 AI 会话）',
+    '',
+    '## 项目信息',
+    '',
+    `- **类型**: React + Hono 全栈应用`,
+    `- **技术栈**: React, TypeScript, Hono, Drizzle ORM, Zustand`,
+    `- **架构**: 模块化架构，前后端分离`,
+    '',
+    '## 目录结构',
+    '',
+    '```',
+    'src/',
+    '├── client/          # React 前端',
+    '│   ├── components/  # UI 组件',
+    '│   ├── stores/      # Zustand 状态管理',
+    '│   └── services/    # API 客户端',
+    '├── server/          # Hono 后端',
+    '│   ├── module-*/    # 业务模块',
+    '│   │   ├── routes/  # API 路由',
+    '│   │   ├── services/# 业务逻辑',
+    '│   │   └── __tests__/# 测试',
+    '│   ├── middleware/  # 中间件',
+    '│   └── db/schema/   # 数据库表',
+    '└── shared/          # 共享类型',
+    '    ├── core/        # 框架层（不可修改）',
+    '    └── modules/     # 业务层 Schema',
+    '```',
+    '',
+  ]
+
+  const compactContextPath = join(PROJECT_ROOT, '.dev-context-compact.md')
+  if (existsSync(compactContextPath)) {
+    const compactContext = readFileSync(compactContextPath, 'utf-8')
+    lines.push('## 项目统计')
+    lines.push('')
+    lines.push(compactContext.split('\n').slice(4).join('\n'))
+  }
+
+  const guidePath = join(PROJECT_ROOT, '.dev-guide.md')
+  if (existsSync(guidePath)) {
+    const guide = readFileSync(guidePath, 'utf-8')
+    lines.push('')
+    lines.push('## 开发指引')
+    lines.push('')
+    lines.push(guide)
+  }
+
+  lines.push('')
+  lines.push('## 开发规范')
+  lines.push('')
+  lines.push('### 关键规则')
+  lines.push('')
+  lines.push('1. **中间件位置**: 中间件必须在 `src/server/middleware/` 目录')
+  lines.push('2. **路由位置**: 路由必须在 `src/server/module-*/routes/` 目录')
+  lines.push('3. **中间件应用**: 中间件只能在 `app.ts` 中应用，不能在路由文件中应用')
+  lines.push('4. **类型安全**: 使用 Zod Schema 定义类型，禁止使用 `any`')
+  lines.push('5. **分层架构**: 路由调用服务，服务处理业务逻辑')
+  lines.push('6. **工具函数**: 工具函数放在 `utils/` 目录，不要放在 service 中')
+  lines.push('')
+  lines.push('### API 开发流程')
+  lines.push('')
+  lines.push('```')
+  lines.push('1. 定义 Schema (src/shared/modules/{feature}/schemas.ts)')
+  lines.push('2. 创建数据库表 (src/server/db/schema/{feature}.ts)')
+  lines.push('3. 实现服务层 (src/server/module-{feature}/services/{feature}-service.ts)')
+  lines.push('4. 定义路由 (src/server/module-{feature}/routes/{feature}-routes.ts)')
+  lines.push('5. 注册路由 (src/server/app.ts)')
+  lines.push('6. 编写测试 (src/server/module-{feature}/__tests__/)')
+  lines.push('```')
+  lines.push('')
+  lines.push('### 前端开发流程')
+  lines.push('')
+  lines.push('```')
+  lines.push('1. 创建 API 客户端 (src/client/services/apiClient.ts)')
+  lines.push('2. 创建状态管理 (src/client/stores/{feature}Store.ts)')
+  lines.push('3. 创建组件 (src/client/components/{feature}/)')
+  lines.push('4. 创建页面 (src/client/pages/{feature}Page.tsx)')
+  lines.push('```')
+  lines.push('')
+  lines.push('## 常用命令')
+  lines.push('')
+  lines.push('```bash')
+  lines.push('npm run dev          # 启动开发服务器')
+  lines.push('npm test             # 运行测试')
+  lines.push('npm run typecheck    # 类型检查')
+  lines.push('npm run lint         # 代码检查')
+  lines.push('npm run db:generate  # 生成数据库迁移')
+  lines.push('npm run db:migrate   # 执行数据库迁移')
+  lines.push('```')
+  lines.push('')
+
+  return lines.join('\n')
+}
+
+function copyToClipboard(text: string): void {
+  try {
+    const platform = process.platform
+
+    if (platform === 'darwin') {
+      execSync('pbcopy', { input: text })
+    } else if (platform === 'linux') {
+      execSync('xclip -selection clipboard', { input: text })
+    } else if (platform === 'win32') {
+      execSync('clip', { input: text })
+    } else {
+      console.log('⚠️  不支持的操作系统，无法自动复制到剪贴板')
+      console.log('请手动复制以下内容：\n')
+      console.log(text)
+      return
+    }
+
+    console.log('✅ 上下文已复制到剪贴板！')
+    console.log('💡 现在可以直接粘贴到 AI 会话中\n')
+  } catch (error) {
+    console.log('⚠️  无法复制到剪贴板，请手动复制以下内容：\n')
+    console.log(text)
+  }
+}
+
+function main(): void {
+  const args = process.argv.slice(2)
+  const shouldCopy = !args.includes('--no-copy')
+
+  console.log('🔍 生成 AI 会话上下文...\n')
+
+  const context = generateAIContext()
+
+  const outputPath = join(PROJECT_ROOT, '.ai-context.md')
+  writeFileSync(outputPath, context, 'utf-8')
+  console.log(`✅ 上下文已保存到: ${outputPath}\n`)
+
+  if (shouldCopy) {
+    copyToClipboard(context)
+  } else {
+    console.log(context)
+  }
+
+  console.log('📖 使用方法:')
+  console.log('   1. 在 AI 会话中粘贴上下文')
+  console.log('   2. 描述你的开发需求')
+  console.log('   3. AI 会根据上下文提供精准的帮助\n')
+
+  console.log('💡 示例对话:')
+  console.log('   用户: 我正在开发一个 React + Hono 项目。这是项目上下文：')
+  console.log('   [粘贴上下文]')
+  console.log('   我需要开发一个订单管理接口，请帮我实现。\n')
+}
+
+main()

package/template/lint-scripts/check-framework-modify.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+cd "$PROJECT_ROOT"
+
+npx tsx lint-scripts/framework/check-modify.ts

package/template/lint-scripts/check-menu-permissions.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+
+/**
+ * 菜单权限检查脚本
+ *
+ * 这个脚本检查菜单配置，确保：
+ * 1. 每个菜单项都有权限配置
+ * 2. 权限配置不为空数组（除非是公开菜单）
+ * 3. 权限配置的权限都存在
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const PUBLIC_MENUS = ['/dashboard']
+
+const REQUIRED_PERMISSIONS = {
+  '/users': ['user:view'],
+  '/orders': ['order:view'],
+  '/tickets': ['ticket:view'],
+  '/disputes': ['ticket:view'],
+  '/content': ['content:view'],
+  '/system/settings': ['system:settings'],
+  '/system/logs': ['system:logs'],
+  '/system/monitor': ['system:monitor'],
+  '/system/permissions': ['role:view'],
+  '/system/roles': ['role:view'],
+}
+
+function extractMenuConfig(content) {
+  const menuConfigMatch = content.match(/const MENU_CONFIG:\s*MenuItem\[\]\s*=\s*\[/)
+  if (!menuConfigMatch) {
+    return null
+  }
+
+  let braceCount = 0
+  let inString = false
+  let stringChar = null
+  let config = ''
+  let i = menuConfigMatch.index + menuConfigMatch[0].length - 1
+
+  while (i < content.length) {
+    const char = content[i]
+
+    if (!inString && (char === '"' || char === "'" || char === '`')) {
+      inString = true
+      stringChar = char
+    } else if (inString && char === stringChar && content[i - 1] !== '\\') {
+      inString = false
+      stringChar = null
+    }
+
+    if (!inString) {
+      if (char === '[') {
+        braceCount++
+      } else if (char === ']') {
+        braceCount--
+        if (braceCount === 0) {
+          config += char
+          break
+        }
+      }
+    }
+
+    config += char
+    i++
+  }
+
+  return config
+}
+
+function parseMenuItems(configStr) {
+  const items = []
+  const itemRegex = /{\s*path:\s*['"`]([^'"`]+)['"`]/g
+  let match
+
+  while ((match = itemRegex.exec(configStr)) !== null) {
+    const path = match[1]
+    const itemStart = match.index
+    const itemEnd = findItemEnd(configStr, itemStart)
+    const itemStr = configStr.substring(itemStart, itemEnd)
+
+    const permissionsMatch = itemStr.match(/permissions:\s*\[([^\]]*)\]/)
+    const permissions = permissionsMatch
+      ? permissionsMatch[1]
+          .split(',')
+          .map(p => p.trim().replace(/['"`]/g, ''))
+          .filter(p => p && p !== 'Permission.')
+      : []
+
+    const labelMatch = itemStr.match(/label:\s*['"`]([^'"`]+)['"`]/)
+    const label = labelMatch ? labelMatch[1] : ''
+
+    items.push({ path, label, permissions, itemStr })
+  }
+
+  return items
+}
+
+function findItemEnd(str, start) {
+  let braceCount = 0
+  let inString = false
+  let stringChar = null
+
+  for (let i = start; i < str.length; i++) {
+    const char = str[i]
+
+    if (!inString && (char === '"' || char === "'" || char === '`')) {
+      inString = true
+      stringChar = char
+    } else if (inString && char === stringChar && str[i - 1] !== '\\') {
+      inString = false
+      stringChar = null
+    }
+
+    if (!inString) {
+      if (char === '{') {
+        braceCount++
+      } else if (char === '}') {
+        braceCount--
+        if (braceCount === 0) {
+          return i + 1
+        }
+      }
+    }
+  }
+
+  return str.length
+}
+
+function checkMenuPermissions(filePath) {
+  const content = fs.readFileSync(filePath, 'utf-8')
+  const errors = []
+  const warnings = []
+
+  const menuConfig = extractMenuConfig(content)
+  if (!menuConfig) {
+    warnings.push({
+      file: filePath,
+      message: '未找到 MENU_CONFIG 配置',
+    })
+    return { errors, warnings }
+  }
+
+  const items = parseMenuItems(menuConfig)
+
+  for (const item of items) {
+    const isPublic = PUBLIC_MENUS.includes(item.path)
+
+    if (isPublic) {
+      if (item.permissions.length > 0) {
+        warnings.push({
+          file: filePath,
+          path: item.path,
+          label: item.label,
+          message: `公开菜单 "${item.label}" (${item.path}) 不应该有权限配置`,
+        })
+      }
+    } else {
+      if (item.permissions.length === 0) {
+        const requiredPerms = REQUIRED_PERMISSIONS[item.path] || []
+        errors.push({
+          file: filePath,
+          path: item.path,
+          label: item.label,
+          message: `菜单 "${item.label}" (${item.path}) 缺少权限配置。建议添加: [${requiredPerms.map(p => `Permission.${p.toUpperCase().replace(/:/g, '_')}`).join(', ')}]`,
+        })
+      } else {
+        const requiredPerms = REQUIRED_PERMISSIONS[item.path] || []
+        const missingPerms = requiredPerms.filter(p => {
+          const permCode = `Permission.${p.toUpperCase().replace(/:/g, '_')}`
+          return !item.permissions.some(perm => perm.includes(p.toUpperCase().replace(/:/g, '_')))
+        })
+
+        if (missingPerms.length > 0) {
+          warnings.push({
+            file: filePath,
+            path: item.path,
+            label: item.label,
+            message: `菜单 "${item.label}" (${item.path}) 缺少推荐权限: [${missingPerms.map(p => `Permission.${p.toUpperCase().replace(/:/g, '_')}`).join(', ')}]`,
+          })
+        }
+      }
+    }
+  }
+
+  return { errors, warnings }
+}
+
+function main() {
+  const srcDir = path.join(__dirname, '..', 'src')
+  const menuConfigFile = path.join(
+    srcDir,
+    'server',
+    'module-permission',
+    'services',
+    'permission-service.ts'
+  )
+
+  console.log('🔍 检查菜单权限配置...\n')
+
+  if (!fs.existsSync(menuConfigFile)) {
+    console.log('❌ 未找到菜单配置文件:', menuConfigFile)
+    process.exit(1)
+  }
+
+  const { errors, warnings } = checkMenuPermissions(menuConfigFile)
+
+  if (errors.length > 0 || warnings.length > 0) {
+    console.log(`📄 ${path.relative(path.join(__dirname, '..'), menuConfigFile)}\n`)
+
+    for (const error of errors) {
+      console.log(`  ❌ ${error.message}`)
+    }
+
+    for (const warning of warnings) {
+      console.log(`  ⚠️  ${warning.message}`)
+    }
+
+    console.log()
+  }
+
+  console.log('==================================================')
+  console.log(`📊 检查结果:`)
+  console.log(`  ❌ 错误: ${errors.length}`)
+  console.log(`  ⚠️  警告: ${warnings.length}`)
+  console.log('==================================================\n')
+
+  if (errors.length > 0) {
+    console.log('❌ 发现菜单权限配置错误！请修复后再提交代码。')
+    process.exit(1)
+  } else {
+    console.log('✅ 所有菜单权限配置正确！')
+    process.exit(0)
+  }
+}
+
+main()

package/template/lint-scripts/check-refs.ts

@@ -0,0 +1,165 @@
+/**
+ * 检查项目中所有 md 文件的引用路径是否正确
+ *
+ * 运行: npm run check:refs
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { glob } from 'glob'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const templateDir = path.resolve(__dirname, '..')
+
+const MD_FILE_PATTERN = /\.md$/
+const MD_LINK_PATTERN = /\[([^\]]+)\]\(([^)]+)\)/g
+
+const GLOB_CHARS = ['*', '?', '[', '{']
+const PLACEHOLDER_PATTERN = /\{[a-zA-Z_]+\}/
+const EXCLUDED_PROTOCOLS = ['http://', 'https://', 'mailto:']
+
+interface CheckResult {
+  file: string
+  line: number
+  ref: string
+  resolvedPath: string
+  exists: boolean
+  isGlob: boolean
+}
+
+function isGlobPattern(p: string): boolean {
+  return GLOB_CHARS.some(char => p.includes(char))
+}
+
+function isPlaceholder(p: string): boolean {
+  return PLACEHOLDER_PATTERN.test(p)
+}
+
+function shouldExclude(refPath: string): boolean {
+  if (refPath.startsWith('#')) return true
+  if (EXCLUDED_PROTOCOLS.some(proto => refPath.startsWith(proto))) return true
+  return false
+}
+
+function findAllMdFiles(dir: string): string[] {
+  const results: string[] = []
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      if (!['node_modules', 'dist', '.git', '.pi'].includes(entry.name)) {
+        results.push(...findAllMdFiles(fullPath))
+      }
+    } else if (entry.isFile() && MD_FILE_PATTERN.test(entry.name)) {
+      results.push(fullPath)
+    }
+  }
+
+  return results
+}
+
+function checkGlobPattern(baseDir: string, pattern: string): boolean {
+  try {
+    const fullPattern = path.isAbsolute(pattern) ? pattern : path.join(baseDir, pattern)
+    const matchedFiles = glob.sync(fullPattern, {
+      cwd: templateDir,
+      nodir: true,
+    })
+    return matchedFiles.length > 0
+  } catch {
+    return false
+  }
+}
+
+function checkFileExists(baseDir: string, refPath: string): boolean {
+  const fullPath = path.isAbsolute(refPath) ? refPath : path.join(baseDir, refPath)
+  return fs.existsSync(fullPath)
+}
+
+function checkReferences(): CheckResult[] {
+  const results: CheckResult[] = []
+  const mdFiles = findAllMdFiles(templateDir)
+
+  for (const filePath of mdFiles) {
+    const content = fs.readFileSync(filePath, 'utf-8')
+    const lines = content.split('\n')
+    const fileDir = path.dirname(filePath)
+    const relativePath = path.relative(templateDir, filePath)
+
+    lines.forEach((line, index) => {
+      const lineNum = index + 1
+
+      MD_LINK_PATTERN.lastIndex = 0
+      let match
+      while ((match = MD_LINK_PATTERN.exec(line)) !== null) {
+        const linkText = match[1]
+        const refPath = match[2]
+
+        if (shouldExclude(refPath)) continue
+        if (isPlaceholder(refPath)) continue
+
+        const resolvedPath = refPath.startsWith('/')
+          ? path.join(templateDir, refPath.slice(1))
+          : path.resolve(fileDir, refPath)
+
+        const resolvedRelative = path.relative(templateDir, resolvedPath)
+
+        if (isGlobPattern(refPath)) {
+          const exists = checkGlobPattern(refPath.startsWith('/') ? templateDir : fileDir, refPath)
+          results.push({
+            file: relativePath,
+            line: lineNum,
+            ref: refPath,
+            resolvedPath: resolvedRelative,
+            exists,
+            isGlob: true,
+          })
+        } else {
+          const exists = checkFileExists(fileDir, refPath)
+          results.push({
+            file: relativePath,
+            line: lineNum,
+            ref: refPath,
+            resolvedPath: resolvedRelative,
+            exists,
+            isGlob: false,
+          })
+        }
+      }
+    })
+  }
+
+  return results
+}
+
+function main(): void {
+  const results = checkReferences()
+  const broken = results.filter(r => !r.exists)
+
+  if (broken.length > 0) {
+    console.log(`\n❌ Broken references (${broken.length}):\n`)
+    const grouped = new Map<string, CheckResult[]>()
+    for (const r of broken) {
+      const key = `${r.file}`
+      if (!grouped.has(key)) grouped.set(key, [])
+      grouped.get(key)!.push(r)
+    }
+    for (const [file, refs] of Array.from(grouped.entries())) {
+      console.log(`  📄 ${file}`)
+      for (const r of refs) {
+        if (r.isGlob) {
+          console.log(`     L${r.line}: ${r.ref} (NO MATCHES)`)
+        } else {
+          console.log(`     L${r.line}: ${r.ref} -> ${r.resolvedPath} (NOT FOUND)`)
+        }
+      }
+    }
+    console.log()
+    process.exit(1)
+  }
+}
+
+main()