create-pardx-scaffold 0.1.0

package/template/scripts/generate-prisma-enums.ts

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+/**
+ * Prisma Enum Generator
+ *
+ * 从 Prisma schema 中提取所有 enum 定义，生成 Zod schema 文件
+ * 供 @repo/contracts 使用，实现前后端 enum 类型共享
+ *
+ * 使用方法:
+ *   pnpm generate:enums
+ *
+ * 输出文件:
+ *   packages/contracts/src/schemas/prisma-enums.generated.ts
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 配置
+const PRISMA_SCHEMA_PATH = path.resolve(__dirname, '../apps/api/prisma/schema.prisma');
+const OUTPUT_PATH = path.resolve(__dirname, '../packages/contracts/src/schemas/prisma-enums.generated.ts');
+
+interface EnumDefinition {
+  name: string;
+  values: string[];
+  comment?: string;
+}
+
+/**
+ * 解析 Prisma schema 文件，提取所有 enum 定义
+ */
+function parsePrismaEnums(schemaContent: string): EnumDefinition[] {
+  const enums: EnumDefinition[] = [];
+  const lines = schemaContent.split('\n');
+
+  let currentEnum: EnumDefinition | null = null;
+  let previousComment = '';
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+
+    // 收集注释
+    if (line.startsWith('//')) {
+      previousComment = line.substring(2).trim();
+      continue;
+    }
+
+    // 检测 enum 开始
+    const enumMatch = line.match(/^enum\s+(\w+)\s*\{/);
+    if (enumMatch) {
+      currentEnum = {
+        name: enumMatch[1],
+        values: [],
+        comment: previousComment || undefined,
+      };
+      previousComment = '';
+      continue;
+    }
+
+    // 检测 enum 结束
+    if (currentEnum && line === '}') {
+      enums.push(currentEnum);
+      currentEnum = null;
+      continue;
+    }
+
+    // 收集 enum 值
+    if (currentEnum && line && !line.startsWith('//')) {
+      // 移除可能的注释
+      const value = line.split('//')[0].trim();
+      if (value) {
+        currentEnum.values.push(value);
+      }
+    }
+
+    // 重置注释（如果不是紧跟着 enum）
+    if (!line.startsWith('//') && !enumMatch) {
+      previousComment = '';
+    }
+  }
+
+  return enums;
+}
+
+/**
+ * 生成 Zod enum schema 代码
+ */
+function generateZodEnums(enums: EnumDefinition[]): string {
+  const imports = `/**
+ * Prisma Enums - Auto-generated from Prisma schema
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * This file is auto-generated by scripts/generate-prisma-enums.ts
+ * Run \`pnpm generate:enums\` to regenerate.
+ *
+ * @generated
+ */
+
+import { z } from 'zod';
+
+`;
+
+  const enumCode = enums.map(enumDef => {
+    const { name, values, comment } = enumDef;
+    const schemaName = `${name}Schema`;
+
+    // 生成值数组
+    const valuesStr = values.map(v => `'${v}'`).join(', ');
+
+    // 生成注释
+    const commentStr = comment ? `/** ${comment} */\n` : '';
+
+    return `${commentStr}export const ${schemaName} = z.enum([${valuesStr}]);
+export type ${name} = z.infer<typeof ${schemaName}>;
+`;
+  }).join('\n');
+
+  // 生成导出汇总
+  const exportSummary = `
+// ============================================================================
+// Enum value arrays (for iteration/validation)
+// ============================================================================
+
+${enums.map(e => `export const ${e.name}Values = ${e.name}Schema.options;`).join('\n')}
+
+// ============================================================================
+// Type guards
+// ============================================================================
+
+${enums.map(e => `export const is${e.name} = (value: unknown): value is ${e.name} => ${e.name}Schema.safeParse(value).success;`).join('\n')}
+`;
+
+  return imports + enumCode + exportSummary;
+}
+
+/**
+ * 主函数
+ */
+function main() {
+  console.log('📦 Generating Prisma enums...');
+  console.log(`   Source: ${PRISMA_SCHEMA_PATH}`);
+  console.log(`   Output: ${OUTPUT_PATH}`);
+
+  // 读取 Prisma schema
+  if (!fs.existsSync(PRISMA_SCHEMA_PATH)) {
+    console.error(`❌ Prisma schema not found: ${PRISMA_SCHEMA_PATH}`);
+    process.exit(1);
+  }
+
+  const schemaContent = fs.readFileSync(PRISMA_SCHEMA_PATH, 'utf-8');
+
+  // 解析 enums
+  const enums = parsePrismaEnums(schemaContent);
+  console.log(`   Found ${enums.length} enums`);
+
+  // 生成代码
+  const code = generateZodEnums(enums);
+
+  // 确保输出目录存在
+  const outputDir = path.dirname(OUTPUT_PATH);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  // 写入文件
+  fs.writeFileSync(OUTPUT_PATH, code, 'utf-8');
+
+  console.log(`✅ Generated ${enums.length} enum schemas`);
+  console.log('   Enums:', enums.map((e: EnumDefinition) => e.name).join(', '));
+}
+
+main();

package/template/scripts/init-project.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+
+/**
+ * Interactive Project Initialization Script
+ * Customizes the scaffold with project-specific settings
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+// Colors for console output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+};
+
+const log = {
+  info: (msg) => console.log(`${colors.blue}ℹ${colors.reset} ${msg}`),
+  success: (msg) => console.log(`${colors.green}✓${colors.reset} ${msg}`),
+  warning: (msg) => console.log(`${colors.yellow}⚠${colors.reset} ${msg}`),
+  error: (msg) => console.log(`${colors.red}✗${colors.reset} ${msg}`),
+  header: (msg) => console.log(`\n${colors.bright}${colors.cyan}${msg}${colors.reset}\n`),
+};
+
+// Create readline interface
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+// Promisify question
+const question = (query) => new Promise((resolve) => rl.question(query, resolve));
+
+// Project configuration
+const config = {
+  projectName: '',
+  projectDescription: '',
+  authorName: '',
+  authorEmail: '',
+  databaseUrl: '',
+  redisUrl: '',
+  apiPort: '',
+  webPort: '',
+};
+
+async function main() {
+  console.clear();
+  log.header('╔════════════════════════════════════════════════════════════╗');
+  log.header('║         PardxAI Monorepo Project Initialization            ║');
+  log.header('╚════════════════════════════════════════════════════════════╝');
+
+  log.info('This wizard will help you customize your project.\n');
+
+  try {
+    // Collect project information
+    config.projectName = await question(
+      `${colors.cyan}Project name${colors.reset} (e.g., my-awesome-app): `
+    );
+    config.projectName = config.projectName.trim() || 'my-project';
+
+    config.projectDescription = await question(
+      `${colors.cyan}Project description${colors.reset}: `
+    );
+    config.projectDescription = config.projectDescription.trim() || 'A PardxAI monorepo project';
+
+    config.authorName = await question(
+      `${colors.cyan}Author name${colors.reset}: `
+    );
+    config.authorName = config.authorName.trim() || 'Your Name';
+
+    config.authorEmail = await question(
+      `${colors.cyan}Author email${colors.reset}: `
+    );
+    config.authorEmail = config.authorEmail.trim() || 'your.email@example.com';
+
+    log.header('\n📦 Configuration');
+
+    config.apiPort = await question(
+      `${colors.cyan}API port${colors.reset} [3100]: `
+    );
+    config.apiPort = config.apiPort.trim() || '3100';
+
+    config.webPort = await question(
+      `${colors.cyan}Web port${colors.reset} [3000]: `
+    );
+    config.webPort = config.webPort.trim() || '3000';
+
+    config.databaseUrl = await question(
+      `${colors.cyan}Database URL${colors.reset} [postgresql://user:password@localhost:5432/dbname]: `
+    );
+    config.databaseUrl = config.databaseUrl.trim() || 'postgresql://user:password@localhost:5432/dbname';
+
+    config.redisUrl = await question(
+      `${colors.cyan}Redis URL${colors.reset} [redis://localhost:6379]: `
+    );
+    config.redisUrl = config.redisUrl.trim() || 'redis://localhost:6379';
+
+    rl.close();
+
+    // Display configuration summary
+    log.header('\n📋 Configuration Summary');
+    console.log(`  Project Name:    ${colors.green}${config.projectName}${colors.reset}`);
+    console.log(`  Description:     ${config.projectDescription}`);
+    console.log(`  Author:          ${config.authorName} <${config.authorEmail}>`);
+    console.log(`  API Port:        ${config.apiPort}`);
+    console.log(`  Web Port:        ${config.webPort}`);
+    console.log(`  Database:        ${config.databaseUrl}`);
+    console.log(`  Redis:           ${config.redisUrl}`);
+
+    // Apply configuration
+    log.header('\n🔧 Applying Configuration');
+    await applyConfiguration();
+
+    // Success message
+    log.header('\n✨ Project Initialized Successfully!');
+    log.info('Next steps:');
+    console.log(`  1. ${colors.cyan}pnpm install${colors.reset}          - Install dependencies`);
+    console.log(`  2. ${colors.cyan}pnpm db:generate${colors.reset}      - Generate Prisma client`);
+    console.log(`  3. ${colors.cyan}pnpm db:migrate:dev${colors.reset}   - Run database migrations`);
+    console.log(`  4. ${colors.cyan}pnpm dev${colors.reset}              - Start development servers`);
+    console.log('');
+
+  } catch (error) {
+    log.error(`Initialization failed: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function applyConfiguration() {
+  const rootDir = process.cwd();
+
+  // Update root package.json
+  log.info('Updating root package.json...');
+  updatePackageJson(path.join(rootDir, 'package.json'), {
+    name: config.projectName,
+    description: config.projectDescription,
+    author: `${config.authorName} <${config.authorEmail}>`,
+  });
+  log.success('Root package.json updated');
+
+  // Update apps/web/package.json
+  log.info('Updating web package.json...');
+  updatePackageJson(path.join(rootDir, 'apps/web/package.json'), {
+    name: `@repo/web`,
+  });
+  log.success('Web package.json updated');
+
+  // Update apps/api/package.json
+  log.info('Updating API package.json...');
+  updatePackageJson(path.join(rootDir, 'apps/api/package.json'), {
+    name: `@repo/api`,
+  });
+  log.success('API package.json updated');
+
+  // Create .env files
+  log.info('Creating environment files...');
+  createEnvFile(
+    path.join(rootDir, 'apps/web/.env.local'),
+    {
+      NEXT_PUBLIC_API_BASE_URL: `http://localhost:${config.apiPort}/api`,
+    }
+  );
+  createEnvFile(
+    path.join(rootDir, 'apps/api/.env'),
+    {
+      NODE_ENV: 'development',
+      PORT: config.apiPort,
+      HOST: '0.0.0.0',
+      DATABASE_URL: config.databaseUrl,
+      REDIS_URL: config.redisUrl,
+      JWT_SECRET: generateRandomSecret(),
+      JWT_EXPIRES_IN: '7d',
+      CORS_ORIGIN: `http://localhost:${config.webPort}`,
+    }
+  );
+  log.success('Environment files created');
+
+  // Update README
+  log.info('Updating README...');
+  updateReadme(path.join(rootDir, 'README.md'));
+  log.success('README updated');
+}
+
+function updatePackageJson(filePath, updates) {
+  if (!fs.existsSync(filePath)) {
+    log.warning(`File not found: ${filePath}`);
+    return;
+  }
+
+  const packageJson = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  Object.assign(packageJson, updates);
+  fs.writeFileSync(filePath, JSON.stringify(packageJson, null, 2) + '\n');
+}
+
+function createEnvFile(filePath, variables) {
+  const content = Object.entries(variables)
+    .map(([key, value]) => `${key}=${value}`)
+    .join('\n') + '\n';
+
+  fs.writeFileSync(filePath, content);
+}
+
+function updateReadme(filePath) {
+  if (!fs.existsSync(filePath)) {
+    log.warning(`File not found: ${filePath}`);
+    return;
+  }
+
+  let content = fs.readFileSync(filePath, 'utf8');
+  content = content.replace(/# PardxAI Monorepo Scaffold/, `# ${config.projectName}`);
+  content = content.replace(
+    /A production-ready monorepo scaffold based on PardxAI architecture\./,
+    config.projectDescription
+  );
+  fs.writeFileSync(filePath, content);
+}
+
+function generateRandomSecret() {
+  return require('crypto').randomBytes(32).toString('hex');
+}
+
+// Run the script
+main().catch((error) => {
+  log.error(`Fatal error: ${error.message}`);
+  process.exit(1);
+});

package/template/turbo.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalDependencies": ["**/.env.*local", "**/.env"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
+    },
+    "lint": {
+      "dependsOn": ["^lint"]
+    },
+    "dev": {
+      "dependsOn": ["^build"],
+      "cache": false,
+      "persistent": true
+    },
+    "type-check": {
+      "dependsOn": ["^type-check"]
+    },
+    "test": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "test:unit": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "test:e2e": {
+      "dependsOn": ["build"],
+      "outputs": ["playwright-report/**", "test-results/**"]
+    },
+    "test:cov": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "db:format": {
+      "cache": false
+    },
+    "db:generate": {
+      "cache": false
+    },
+    "db:migrate:dev": {
+      "cache": false
+    },
+    "db:migrate:deploy": {
+      "cache": false
+    },
+    "db:push": {
+      "cache": false
+    },
+    "clean": {
+      "cache": false
+    }
+  }
+}