create-pangza 1.0.1 → 2.0.0

package/README.md

@@ -13,6 +13,10 @@ npm create pangza@latest -- init my-app
 交互勾选模块：`orm` / `auth` / `redis` / `log` / `schedule` / `encrypt` / `validate`。  
 勾选 `orm` / `redis` 时会写入 `EnableOrm()` / `EnableRedis()`；未勾选则启动不连库、不因缺配置报错。不生成 `.gitkeep`。
 
+初始化还会生成：
+- `application.yaml`：默认 `server.port: 5270`；按所选模块追加 `redis` / `datasource`+`orm` 等
+- `tsconfig.json`：`@/*` → `src/*`（dev：`tsconfig-paths`；build：`tsc-alias`）
+
 ```bash
 npx create-pangza init my-app --modules=orm,auth,redis --db=mysql
 ```

package/lib/generate.js

@@ -31,7 +31,9 @@ function findProjectRoot(cwd = process.cwd()) {
           ...(json.dependencies || {}),
           ...(json.devDependencies || {}),
         };
-        if (deps["@pangza/express"]) return dir;
+        if (deps["@pangza/express"]) {
+          return dir;
+        }
       } catch {
         /* ignore */
       }
@@ -59,7 +61,7 @@ function writeFile(filePath, content, { force }) {
 }
 
 function tplEntity({ Pascal, snake }) {
-  return `import { TableField, TableId, TableName } from "@pangza/express";
+  return `import { TableField, TableId, TableName } from "@pangza/orm";
 
 @TableName("${snake}")
 export default class ${Pascal}Entity {
@@ -89,7 +91,7 @@ export default class ${Pascal}Entity {
 }
 
 function tplMapper({ Pascal, fileBase }) {
-  return `import { Mapper, MapperType } from "@pangza/express";
+  return `import { Mapper, MapperType } from "@pangza/orm";
 import ${Pascal}Entity from "../entity/${fileBase}";
 
 @Mapper(${Pascal}Entity)

package/lib/modules.js

@@ -1,41 +1,41 @@
 "use strict";
 
-/** 可选能力模块（当前均由单包 @pangza/express 提供，差异在依赖与脚手架文件） */
+/** ??????????????????????? */
 const MODULES = [
   {
     id: "orm",
     label: "ORM",
-    hint: "Db / Mapper / QueryWrapper / 多数据源",
+    hint: "Db / Mapper / QueryWrapper / ????",
   },
   {
     id: "auth",
     label: "Auth",
-    hint: "登录态、角色权限装饰器（建议同时选 Redis）",
+    hint: "????????????????? Redis?",
   },
   {
     id: "redis",
     label: "Redis",
-    hint: "缓存、限流、Auth token 存储",
+    hint: "??????Auth token ??",
   },
   {
     id: "log",
     label: "Log",
-    hint: "操作审计日志装饰器",
+    hint: "?????????",
   },
   {
     id: "schedule",
     label: "Schedule",
-    hint: "定时任务 (cron)",
+    hint: "???? (cron)",
   },
   {
     id: "encrypt",
     label: "Encrypt",
-    hint: "AES 等传输加密工具",
+    hint: "AES ???????",
   },
   {
     id: "validate",
     label: "Validate",
-    hint: "参数校验装饰器",
+    hint: "?????????? @pangza/express?",
   },
 ];
 
@@ -81,7 +81,7 @@ const DB_ENV = {
 /** @param {string[]} moduleIds @param {string} [dbType] */
 function resolveDependencies(moduleIds, dbType = "mysql") {
   const deps = {
-    "@pangza/express": "^1.0.1",
+    "@pangza/express": "^2.0.0",
     cors: "^2.8.5",
     express: "^5.2.1",
     inversify: "^8.2.3",
@@ -90,18 +90,28 @@ function resolveDependencies(moduleIds, dbType = "mysql") {
   const set = new Set(moduleIds);
 
   if (set.has("orm")) {
+    deps["@pangza/orm"] = "^2.0.0";
     Object.assign(deps, DB_DEPS[dbType] || DB_DEPS.mysql);
   }
   if (set.has("redis") || set.has("auth")) {
+    deps["@pangza/redis"] = "^2.0.0";
     deps.redis = "^6.2.1";
   }
   if (set.has("auth")) {
+    deps["@pangza/auth"] = "^2.0.0";
     deps.jsonwebtoken = "^9.0.3";
     deps.bcryptjs = "^3.0.3";
   }
+  if (set.has("log")) {
+    deps["@pangza/log"] = "^2.0.0";
+  }
   if (set.has("schedule")) {
+    deps["@pangza/schedule"] = "^2.0.0";
     deps["node-cron"] = "^4.6.0";
   }
+  if (set.has("encrypt")) {
+    deps["@pangza/encrypt"] = "^2.0.0";
+  }
 
   return deps;
 }
@@ -142,34 +152,146 @@ function resolveDirs(moduleIds) {
   return dirs;
 }
 
+const DB_YAML = {
+  mysql: {
+    type: "mysql",
+    port: 3306,
+    user: "root",
+    database: "pangza",
+  },
+  postgresql: {
+    type: "postgresql",
+    port: 5432,
+    user: "postgres",
+    database: "pangza",
+  },
+  mssql: {
+    type: "sqlserver",
+    port: 1433,
+    user: "sa",
+    database: "pangza",
+  },
+};
+
 /**
- * 生成空项目入口：只起 HTTP；选了 redis/orm 才 Enable*，否则启动不连库。
+ * ?? application.yaml??? server.port=5270?
+ * @param {string[]} moduleIds
+ * @param {string} [dbType]
+ */
+function generateApplicationYaml(moduleIds, dbType = "mysql") {
+  const set = new Set(moduleIds);
+  const lines = [
+    "# Generated by create-pangza init",
+    "# profile: PANGZA_PROFILE / APP_ENV / NODE_ENV??? development",
+    "",
+    "server:",
+    "  port: 5270",
+    "  trustProxy: false",
+  ];
+
+  if (set.has("redis") || set.has("auth")) {
+    lines.push(
+      "",
+      "redis:",
+      "  host: 127.0.0.1",
+      "  port: 6379",
+      '  password: ""',
+      "  db: 0",
+      '  keyPrefix: "pangza:"',
+      "  mode: standalone",
+    );
+  }
+
+  if (set.has("orm")) {
+    const db = DB_YAML[dbType] || DB_YAML.mysql;
+    lines.push(
+      "",
+      "datasource:",
+      "  default:",
+      `    type: ${db.type}`,
+      "    host: 127.0.0.1",
+      `    port: ${db.port}`,
+      `    user: ${db.user}`,
+      '    password: ""',
+      `    database: ${db.database}`,
+      "    connectionLimit: 10",
+      "",
+      "orm:",
+      "  logicDelete: true",
+      "  logicDeleteField: delete_flag",
+      "  logicDeleteValue: 1",
+      "  logicNotDeleteValue: 0",
+      "  idType: ASSIGN_ID",
+      "  mapUnderscoreToCamelCase: true",
+      "  mapperLocations: []",
+      "  sqlLog:",
+      "    enabled: false",
+    );
+  }
+
+  if (set.has("encrypt")) {
+    lines.push("", "# encrypt: ????????????????????");
+  }
+
+  if (set.has("schedule")) {
+    lines.push("", "# schedule: ???? src/schedule?? Application.scan ??");
+  }
+
+  if (set.has("log")) {
+    lines.push("", "# log: ?? registry(Log({ writer })) ??????");
+  }
+
+  if (set.has("auth")) {
+    lines.push(
+      "",
+      "# auth: jwtSecret ???? Auth({ ... }) ?????? yaml ????????",
+    );
+  }
+
+  lines.push("");
+  return lines.join("\n");
+}
+
+/**
+ * ?????????? HTTP??? redis/orm ? Enable*????????
  * @param {string[]} moduleIds
  */
 function generateMainTs(moduleIds) {
   const set = new Set(moduleIds);
-  const named = ["Application", "Logger"];
-  if (set.has("orm")) named.push("EnableOrm");
-  if (set.has("redis") || set.has("auth")) named.push("EnableRedis");
-  if (set.has("auth")) named.push("Auth", "Redis");
-  if (set.has("log")) named.push("Log");
 
   const imports = [
     'import "reflect-metadata";',
     'import cors from "cors";',
     'import { json } from "express";',
-    `import { ${named.join(", ")} } from "@pangza/express";`,
+    'import { Application, Logger } from "@pangza/express";',
   ];
 
+  if (set.has("orm")) {
+    imports.push('import { EnableOrm } from "@pangza/orm";');
+  }
+  if (set.has("redis") || set.has("auth")) {
+    imports.push('import Redis, { EnableRedis } from "@pangza/redis";');
+  }
+  if (set.has("auth")) {
+    imports.push('import Auth from "@pangza/auth";');
+  }
+  if (set.has("log")) {
+    imports.push('import Log from "@pangza/log";');
+  }
+
   const notes = [];
   if (set.has("schedule")) {
-    notes.push("// Schedule: 在 src/schedule 编写任务并由扫描加载");
+    notes.push(
+      "// Schedule: ? src/schedule ???????????@pangza/schedule?",
+    );
   }
   if (set.has("encrypt")) {
-    notes.push("// Encrypt: 从 @pangza/express 导入 AESUtil 等");
+    notes.push('// Encrypt: import { AESUtil } from "@pangza/encrypt"');
   }
   if (set.has("validate")) {
-    notes.push("// Validate: 在 Controller 参数上使用校验装饰器");
+    notes.push(
+      "// Validate: ? Controller ????? @pangza/express ?????",
+    );
   }
 
   const chain = [
@@ -209,5 +331,6 @@ module.exports = {
   resolveDependencies,
   resolveEnvLines,
   resolveDirs,
+  generateApplicationYaml,
   generateMainTs,
 };

package/lib/scaffold.js

@@ -6,6 +6,7 @@ const {
   resolveDependencies,
   resolveEnvLines,
   resolveDirs,
+  generateApplicationYaml,
   generateMainTs,
 } = require("./modules");
 
@@ -64,7 +65,7 @@ function scaffold(opts) {
     description: "Pangza Express app",
     scripts: {
       dev: "ts-node -r tsconfig-paths/register src/main.ts",
-      build: "tsc -p tsconfig.json",
+      build: "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
       start: "node dist/main.js",
     },
     dependencies: resolveDependencies(modules, dbType),
@@ -73,6 +74,7 @@ function scaffold(opts) {
       "@types/express": "^5.0.6",
       "@types/node": "^22.0.0",
       "ts-node": "^10.9.2",
+      "tsc-alias": "^1.8.16",
       "tsconfig-paths": "^4.2.0",
       typescript: "^5.9.3",
     },
@@ -86,6 +88,10 @@ function scaffold(opts) {
     path.join(targetDir, ".env.example"),
     resolveEnvLines(modules, dbType).join("\n") + "\n",
   );
+  writeFile(
+    path.join(targetDir, "application.yaml"),
+    generateApplicationYaml(modules, dbType),
+  );
   writeFile(path.join(targetDir, "src", "main.ts"), generateMainTs(modules));
 
   writeFile(
@@ -102,12 +108,14 @@ ${modules.includes("orm") ? `Database: **${dbType}**\n` : ""}
 ## Run
 
 \`\`\`bash
-cp .env.example .env
+cp .env.example .env   # 可选；端口与库配置以 application.yaml 为准
 npm install
 npm run dev
 \`\`\`
 
-需要 Redis / 数据库时，请在入口 \`registry(EnableRedis())\` / \`registry(EnableOrm())\`（脚手架勾选对应模块时已自动写入）。
+- 默认端口：\`application.yaml\` → \`server.port: 5270\`
+- 路径别名：\`@/*\` → \`src/*\`（dev 用 tsconfig-paths，build 用 tsc-alias）
+- 需要 Redis / 数据库时，入口已按模块写入 \`EnableRedis()\` / \`EnableOrm()\`
 `,
   );
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-pangza",
-  "version": "1.0.1",
-  "description": "Scaffold & generate for @pangza/express (init / g controller|service|mapper|entity|all)",
+  "version": "2.0.0",
+  "description": "Scaffold & generate for @pangza/* (init / g controller|service|mapper|entity|all)",
   "bin": {
     "create-pangza": "./bin/create-pangza.js"
   },

package/template/base/tsconfig.json

@@ -4,6 +4,10 @@
     "module": "CommonJS",
     "outDir": "dist",
     "rootDir": "src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    },
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,