create-lumal-admin 0.0.4-beta → 0.0.6-beta

package/dist/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA"}

package/dist/templates.d.ts

@@ -0,0 +1,7 @@
+import type { resolveOptions } from './presets.js';
+import type { TemplateFile } from './types.js';
+export declare function getVersion(): Promise<string>;
+export declare function composeTemplates(options: ReturnType<typeof resolveOptions>): Promise<TemplateFile[]>;
+/** 工程层只读合成，缺失资源在首次写入前失败。 */
+export declare function readTemplateLayers(layers: string[]): Promise<Map<string, string>>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAO9C,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAGlD;AAsBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA6C1G;AAED,4BAA4B;AAC5B,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBvF"}

package/dist/templates.js

@@ -0,0 +1,91 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const templateRoot = fileURLToPath(new URL('../templates/', import.meta.url));
+export async function getVersion() {
+    const manifest = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+    return manifest.version;
+}
+/***********************公共模板组合*********************/
+async function readLayer(name, directory = '', result = []) {
+    const entries = await readdir(join(templateRoot, name, directory), { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            throw new Error(`模板资源不能是符号链接：${entry.name}`);
+        const path = directory ? `${directory}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            await readLayer(name, path, result);
+        }
+        else {
+            result.push({
+                path: path.replace(/\.template$/, '').replace(/^_([^/]+)$/, '.$1'),
+                content: await readFile(join(templateRoot, name, path), 'utf8'),
+            });
+        }
+    }
+    return result;
+}
+export async function composeTemplates(options) {
+    const layers = ['base', 'common', `modes/${options.apiMode}`, ...options.features.map(feature => `features/${feature}`)];
+    if (options.preset !== 'minimal')
+        layers.push('presets/standard');
+    if (options.preset === 'vben-compatible')
+        layers.push('vben-compatible');
+    const files = await readTemplateLayers(layers);
+    const version = await getVersion();
+    const manifest = JSON.parse(files.get('package.json'));
+    manifest.name = options.name;
+    for (const name of ['@lumal/core', '@lumal/icons', '@lumal/icons-vue'])
+        manifest.dependencies[name] = version;
+    if (options.preset === 'vben-compatible')
+        manifest.dependencies['@lumal/vben-compat'] = version;
+    manifest.dependencies = Object.fromEntries(Object.entries(manifest.dependencies).sort(([left], [right]) => left.localeCompare(right)));
+    manifest.devDependencies = Object.fromEntries(Object.entries(manifest.devDependencies).sort(([left], [right]) => left.localeCompare(right)));
+    files.set('package.json', `${JSON.stringify(manifest, null, 2)}\n`);
+    files.set('.env.development', 'VITE_API_BASE_URL=\nVITE_API_ADAPTER=standard\n');
+    files.set('.env.production.example', 'VITE_API_BASE_URL=https://api.example.com\nVITE_API_ADAPTER=standard\n# Local 演示生产构建默认禁止登录；仅演示站点显式启用。\nVITE_ENABLE_LOCAL_DEMO=false\n');
+    files.set('docs/DEVELOPMENT.md', files.get('docs/DEVELOPMENT.md').replace('<!-- PROJECT_CONVENTIONS -->', `## Admin
+
+常规查询、分页、标准新增编辑优先使用 Lumal Schema/CRUD；地图、复杂交互和专用表单使用普通 Vue + Element Plus，不强行塞入 Schema。
+模块通过 module.ts 声明菜单、视图和权限，公共层不依赖业务模块。API 字段转换位于服务 Adapter。
+HTTP 登录失败不得回退 Local。Local 仅供演示，生产默认禁用。修改权限、接口和模块时补充负向测试。
+`.trimEnd()));
+    // 只注入小型配置；完整 SFC、服务和工程文件均保存在模板目录中。
+    files.set('src/app.config.ts', `export const appConfig: {
+  apiMode: 'http' | 'local';
+  features: string[];
+  preset: 'minimal' | 'standard' | 'vben-compatible';
+  routerMode: 'hash' | 'history';
+  title: string;
+} = {
+  apiMode: '${options.apiMode}',
+  features: [${options.features.map(feature => `'${feature}'`).join(', ')}],
+  preset: '${options.preset}',
+  routerMode: '${options.routerMode}',
+  title: '${options.name}',
+};\n`);
+    return [...files].map(([path, content]) => ({ path, content })).sort((a, b) => a.path.localeCompare(b.path));
+}
+/** 工程层只读合成，缺失资源在首次写入前失败。 */
+export async function readTemplateLayers(layers) {
+    const files = new Map();
+    for (const layer of layers) {
+        for (const file of await readLayer(layer)) {
+            if (file.path === 'package.json' && files.has(file.path)) {
+                const previous = JSON.parse(files.get(file.path));
+                const current = JSON.parse(file.content);
+                files.set(file.path, JSON.stringify({
+                    ...previous,
+                    ...current,
+                    dependencies: { ...previous.dependencies, ...current.dependencies },
+                    devDependencies: { ...previous.devDependencies, ...current.devDependencies },
+                }));
+            }
+            else {
+                files.set(file.path, file.content);
+            }
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+export type AdminPreset = 'minimal' | 'standard' | 'vben-compatible';
+export type ApiMode = 'http' | 'local';
+export type RouterMode = 'hash' | 'history';
+export type AdminFeature = 'examples' | 'system';
+export interface CreateLumalAdminProjectOptions {
+    apiMode?: ApiMode;
+    features?: AdminFeature[];
+    name: string;
+    preset?: AdminPreset;
+    routerMode?: RouterMode;
+    targetDir: string;
+    /** 取消创建时仅回滚本次拥有的文件。 */
+    signal?: AbortSignal;
+}
+export interface CreateLumalAdminProjectResult {
+    targetDir: string;
+    createdFiles: string[];
+    preset: AdminPreset;
+    apiMode: ApiMode;
+    routerMode: RouterMode;
+    features: AdminFeature[];
+}
+export interface TemplateFile {
+    path: string;
+    content: string;
+}
+/***********************通用项目生成协议*********************/
+export type ProjectTemplate = 'admin' | 'blank' | 'screen';
+export type ScreenAuth = 'none' | 'local-demo' | 'http';
+export type ScreenData = 'none' | 'local' | 'http';
+export type ScreenVisualization = 'none' | 'charts' | 'datav' | 'cockpit';
+export type ScreenViewport = 'disabled' | 'responsive' | 'width' | 'contain' | 'scale' | 'vw';
+export type ProjectRouterMode = RouterMode | 'none';
+export interface CreateLumalProjectOptions {
+    targetDir: string;
+    name: string;
+    template?: ProjectTemplate;
+    preset?: AdminPreset;
+    apiMode?: ApiMode;
+    features?: AdminFeature[];
+    routerMode?: ProjectRouterMode;
+    auth?: ScreenAuth;
+    data?: ScreenData;
+    visualization?: ScreenVisualization;
+    viewport?: ScreenViewport;
+    signal?: AbortSignal;
+}
+export interface ResolvedScreenOptions {
+    template: 'blank' | 'screen';
+    name: string;
+    targetDir: string;
+    auth: ScreenAuth;
+    data: ScreenData;
+    routerMode: ProjectRouterMode;
+    visualization: ScreenVisualization;
+    viewport: ScreenViewport;
+    signal?: AbortSignal;
+}
+export type CreateLumalProjectResult = (ResolvedScreenOptions | (CreateLumalAdminProjectResult & {
+    template: 'admin';
+})) & {
+    createdFiles: string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,CAAA;AACpE,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AACtC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAA;AAC3C,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEhD,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,sDAAsD;AACtD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAC1D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAA;AACvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAClD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AACzE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAA;AAC7F,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,CAAA;AAEnD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;IACzB,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAChB,UAAU,EAAE,iBAAiB,CAAA;IAC7B,aAAa,EAAE,mBAAmB,CAAA;IAClC,QAAQ,EAAE,cAAc,CAAA;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,qBAAqB,GAAG,CAAC,6BAA6B,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,GAAG;IACzH,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "create-lumal-admin",
   "type": "module",
-  "version": "0.0.4-beta",
-  "description": "Create a minimal Lumal admin application.",
+  "version": "0.0.6-beta",
+  "description": "Create lightweight Vue Blank, Screen or Lumal Admin projects with optional capabilities.",
   "license": "MIT",
   "keywords": [
     "lumal",
     "vue",
     "admin",
+    "screen",
     "scaffold",
     "create"
   ],
@@ -21,16 +22,24 @@
     }
   },
   "bin": {
+    "create-lumal": "./dist/project-cli.js",
     "create-lumal-admin": "./dist/cli.js"
   },
   "files": [
     "CHANGELOG.md",
     "README.md",
-    "dist"
+    "dist",
+    "templates"
   ],
+  "dependencies": {
+    "@clack/prompts": "1.8.1"
+  },
+  "devDependencies": {
+    "@lydell/node-pty": "1.2.0-beta.15"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json && node ../../scripts/clean-package-dist.mjs dist && node ../../scripts/sync-create-lumal-admin-version.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run --config ../../vitest.config.ts tests"
+    "test": "pnpm build && vitest run --config ../../vitest.config.ts tests"
   }
 }

package/templates/base/.env.example

@@ -0,0 +1,4 @@
+VITE_API_BASE_URL=/api
+VITE_API_ADAPTER=standard
+# Local 演示仅开发环境默认启用，生产演示必须显式授权。
+VITE_ENABLE_LOCAL_DEMO=false

package/templates/base/API-CONTRACT.md

@@ -0,0 +1,84 @@
+# 应用 API 契约
+
+基础契约在 `src/app/services/contracts.ts`，业务入参和解析在各模块 `api.ts/types.ts`。
+Local 与 HTTP 使用同一组页面及端点；Core 不包含业务协议。
+系统接口仅在选择 system 时调用，个人中心仅 standard / vben-compatible 启用。
+
+| 方法            | 路径                                                                   | 标准 JSON 响应                                                       |
+| --------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| POST            | `/auth/login`，body `{ username, password }`                           | `{ accessToken, refreshToken?, expiresAt? }`                         |
+| POST            | `/auth/refresh`，body `{ refreshToken }`                               | 同上                                                                 |
+| GET             | `/session/me`                                                          | `{ id, username, name }`，均为字符串                                 |
+| GET             | `/session/access`                                                      | `{ roles: string[], permissions: string[] }`                         |
+| GET             | `/menus`                                                               | `LumalMenuRecord[]`                                                  |
+| POST            | `/auth/logout`                                                         | 204 或 JSON                                                          |
+| GET             | `/system/users`、`/system/roles`                                       | `{ items: User[] \| Role[], total }`                                 |
+| POST/PUT/DELETE | `/system/users[/:id]`、`/system/roles[/:id]`                           | 对应模块输入 / 记录；删除 204 或 JSON                                |
+| PATCH           | `/system/users/:id/status`                                             | `{ status }` / `User`                                                |
+| PUT             | `/system/users/:id/roles`                                              | `{ roles: string[] }` / `User`                                       |
+| PATCH           | `/system/users/batch/status`                                           | `{ ids, status }` / `{ items, updated }`                             |
+| PUT             | `/system/users/batch/roles`                                            | `{ ids, roles, mode: 'append' \| 'replace' }` / `{ items, updated }` |
+| POST            | `/system/users/:id/reset-password`                                     | `{ temporaryPassword }`                                              |
+| GET             | `/system/roles/options`、`/system/organizations/options`               | `{ label, value, disabled?, children? }[]`                           |
+| GET             | `/system/permissions/tree`                                             | `{ id, label, permission?, children? }[]`                            |
+| GET/PUT         | `/system/roles/:code/permissions`                                      | PUT `{ permissions: string[] }`；响应 `string[]`                     |
+| GET             | `/system/menus`、`/system/organizations`                               | 对应树形记录数组，`children`；机构可带 `userCount`                   |
+| POST/PUT/DELETE | `/system/menus[/:id]`、`/system/organizations[/:id]`                   | 对应模块输入 / 记录                                                  |
+| GET             | `/system/dictionaries/types`、`/system/dictionaries/items?typeCode=`   | 对应记录数组                                                         |
+| POST/PUT/DELETE | `/system/dictionaries/types[/:id]`、`/system/dictionaries/items[/:id]` | 对应模块输入 / 记录                                                  |
+| GET             | `/system/dictionaries/options/:code`                                   | `{ label, value, color? }[]`                                         |
+| GET/PUT         | `/system/config`                                                       | `{ appName, colorPrimary, layout, tabbarEnable, transitionEnable }`  |
+| POST            | `/system/config/restore`                                               | 恢复默认，响应同上                                                   |
+| GET/PUT         | `/profile`                                                             | GET `User`；PUT `{ nickname, phone }` / `User`                       |
+| PUT             | `/profile/password`                                                    | `{ currentPassword, newPassword }` / 204 或 JSON                     |
+
+用户查询支持 `page/pageSize/keyword/organizationId/roles/status`，角色支持
+`page/pageSize/keyword/status`。分页默认第一页，页号和每页条数必须为正整数。
+`UserInput` 为 `username/nickname/organizationId/roles/phone/status`；响应另有 `id/createdAt`。
+`RoleInput` 为 `code/name/description/status`；响应另有 `id/builtIn`，不接收 permissions。
+
+## 业务约束与权限
+
+- 用户操作对应 `system:user:list/create/update/delete/status/assign-roles/reset-password`。
+- 角色对应 `system:role:list/create/update/delete/authorize`；资料和授权分别保存，不宣称两个请求是事务。
+- 授权树来自真实接口，非叶访问权限独立回显；授权已写入但会话重读失败时明确提示部分成功，只重试重读。
+- 菜单、机构、字典的权限前缀分别为 `system:menu`、`system:organization`、`system:dict`，操作是 `list/create/update/delete`。
+- 配置读取需 `system:config:view`，写入需 `system:config:update`；无写权限显示只读表单，不是 key/value 记录列表。
+- 服务端须保护内置管理员和角色、角色引用、机构关联用户和父子关系；批量写入应先校验全部目标。
+- 字典同分类值唯一，删除分类级联处理字典项；修改后清理共享 `dictionaryStore`，业务表单应使用同一 Store。
+- 个人中心由后端确认当前身份；密码必须经后端验证并持久化。接口不存在时展示真实错误，不伪造成功。
+
+完整字段以各模块 types.ts 为准。没有指标接口时工作台不请求或编造业务指标。
+
+HTTP 模式必须配置 `VITE_API_BASE_URL`，未配置立即报错，绝不回退本地登录。
+默认直接消费标准 JSON。包装、字段及权限映射集中在应用 `http-adapter.ts`。
+需要 Cookie/CSRF、租户或 SSO 时在应用 transport 接入，不将密钥写到 `VITE_*`。
+默认凭据存于 localStorage，请按安全要求选择内存/HttpOnly Cookie 策略。
+
+## 菜单信任边界
+
+菜单组件使用 `src/app/router/views.ts` 汇集的本地白名单，键必须是自有函数加载器；
+拒绝 constructor、**proto**、prototype 和任意 import URL，递归子菜单同样校验。
+HTTP 菜单替换本地菜单，不静默融合。子路由使用属于父路径的绝对地址；
+目录默认跳到当前身份可访问的首个子页，无子页时隐藏。路由守卫逐层检查父子权限，
+远程 ignoreAccess/requireLogin 不能关闭认证或权限。
+
+外链只接受无用户名密码的 HTTP(S) 绝对地址，禁止 javascript/data/vbscript、
+协议相对地址、反斜线和控制字符。iframe 只能使用 `app/iframe`，且完整来源必须
+注册在 `VITE_IFRAME_ORIGINS`（逗号分隔），使用独立 sandbox。
+
+## 接入仓库 Lumal Mock API
+
+启动独立的 `lumal-mock-api` 后，设置 `VITE_API_BASE_URL=http://127.0.0.1:5320/api`
+和 `VITE_API_ADAPTER=lumal-mock`。这是显式选择的演示后端，不是生产默认值。
+该 adapter 映射 `statusCode/result/resultMsg`、snake_case Token、`records/totalNum`；
+只选择本预设存在的菜单，其余示例页面不生成。
+Mock 的配置字段与上表一致；历史写权限 `system:config:view` 显式映射到应用 update 权限。
+第三方后端应按真实协议调整 Adapter，不假定均兼容此演示协议。
+
+401 GET 自动单飞刷新并最多重放一次；写请求不自动重放，避免重复提交。
+初始化等待用户、权限和菜单全部就绪后注册路由。退出、Token 刷新失败和重新登录清理
+凭据、权限、菜单、动态路由、请求缓存和标签；旧会话请求会被取消。
+主动重读权限失败时清空旧授权及路由，保留凭据供显式重试。
+真实接口的 403、校验或网络错误保持可见，不转换成成功响应。
+Local 存储可被浏览器用户修改，仅供开发，不能替代服务端鉴权。

package/templates/base/README.md

@@ -0,0 +1,59 @@
+# Lumal Admin
+
+## 开发
+
+Node.js 22.12+，pnpm 10.33.0。
+
+```bash
+pnpm install
+pnpm dev
+pnpm test
+pnpm lint
+pnpm typecheck
+pnpm build
+pnpm preview
+```
+
+预设、数据源、路由模式和可选模块见 `src/app.config.ts`。
+业务组件均显式导入，不依赖组件自动导入或 Monorepo 私有 alias。
+`@` 指向 `src`，TS 与 Vite 使用相同映射。SCSS 编译使用 sass-embedded。
+
+## 接口与认证
+
+HTTP 接入前配置 `.env.development`，完整接口见 [API 契约](./API-CONTRACT.md)。
+Local 模式是明确的开发演示，账号 `admin/guest`，密码 `lumal123`；
+生产默认禁用，不应将演示模式当作生产认证。
+系统模块包含有明确关联的开发种子数据；示例数据与系统数据分离。
+
+## 部署
+
+以 `.env.production.example` 为参考创建生产配置，不提交密钥。
+Vite 环境变量在构建时注入，预览前修改变量必须重新构建。
+推荐同域 `/api` 反向代理和 HTTPS。History 路由需要服务器将非文件路径回退到
+`index.html`，Hash 不需要；子目录部署需配置 Vite `base`。
+不要将生产 API 请求回退到 HTML。上传文件限制和后端权限属于服务端职责。
+localStorage Token 示例不是生产安全策略的唯一选择。
+
+## 模块
+
+minimal 没有管理页面与兼容层；standard 的 system/examples 是可选模板层。
+系统页面的 CRUD 和 Schema 不进入 Core 的业务实现。图表、驾驶舱、富文本、
+国际化与 VXE 高级编辑均不默认安装。
+
+```text
+src/app/                     路由、认证、请求、布局接线与异常页
+src/modules/dashboard/       工作台
+src/modules/profile/         个人中心（标准预设）
+src/modules/system/          系统父模块（可选）
+  user/ role/ menu/ organization/ dictionary/ config/
+src/modules/examples/        开发示例（可选）
+src/modules/vben-migration/  迁移示例（仅兼容预设）
+src/modules/business/        自有业务模块
+src/shared/                  共享组件、类型与组合式函数
+```
+
+每个模块通过 `module.ts` 导出 menus/views/permissions，注册表只加载小型元数据，
+页面使用动态 import。在 business 中新增一个子目录及 module.ts 即可注册，不需要修改中心文件；
+完整接入示例见该目录 README。业务类型和强类型 API 放在模块内，不写入全局实体配置。
+系统、开发示例和迁移示例各有真实父路由，权限变化后目录重定向重新计算。
+HTTP 菜单使用已生成页面的 component key，并由后端提供完整菜单；不会静默混入本地菜单。

package/templates/base/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Lumal Admin</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/base/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "template-base",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "packageManager": "pnpm@10.33.0",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "build": "pnpm typecheck && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview --host 127.0.0.1",
+    "test": "vitest run",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@iconify/vue": "^5.0.0",
+    "@lumal/core": "^0.0.0",
+    "@lumal/icons": "^0.0.0",
+    "@lumal/icons-vue": "^0.0.0",
+    "element-plus": "^2.11.0",
+    "vue": "^3.5.0",
+    "vue-router": "^4.5.0"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^8.2.0",
+    "@types/node": "^24.6.1",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "eslint": "^9.37.0",
+    "sass-embedded": "^1.95.1",
+    "typescript": "^6.0.0",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.5",
+    "vue-tsc": "^3.1.1"
+  }
+}