create-aiaui-module 0.1.2-TEST → 0.2.0

package/README.md

@@ -7,8 +7,8 @@
 | 步骤 | 命令 | 说明 |
 | --- | --- | --- |
 | 查看可用模块 | `npx create-aiaui-module@latest --list` | 列出模块 ID 与 contractVersion |
-| 生成模块 | `npx create-aiaui-module@latest JobInformation` | 在实例根目录生成 `PyAIAUI/JobInformation` |
-| 机器可读 | `npx create-aiaui-module@latest JobInformation --json` | 生成结果输出 JSON（接 CI） |
+| 生成模块 | `npx create-aiaui-module@latest JobDashboard` | 在实例根目录生成 `PyAIAUI/JobDashboard` |
+| 机器可读 | `npx create-aiaui-module@latest JobDashboard --json` | 生成结果输出 JSON（接 CI） |
 
 ## 环境要求
 
@@ -20,10 +20,10 @@
 在 Instance 根目录（含 `Config/` 的目录）下执行：
 
 ```bash
-npx create-aiaui-module@latest JobInformation
+npx create-aiaui-module@latest JobDashboard
 ```
 
-生成后 `PyAIAUI/JobInformation/` 与 `PyAIAUI/_runtime/` 就位，`Config/AIAUIProtocol.json` 中登记该模块（默认 `enabled: false`、`port: null`）。
+生成后 `PyAIAUI/JobDashboard/` 与 `PyAIAUI/_runtime/` 就位，`Config/AIAUIProtocol.json` 中登记该模块（默认 `enabled: false`、`port: null`）。
 
 启用前需要调整的配置：
 
@@ -32,7 +32,7 @@ npx create-aiaui-module@latest JobInformation
   "schemaVersion": 1,
   "port": 18901,
   "modules": [
-    { "name": "JobInformation", "enabled": true }
+    { "name": "JobDashboard", "enabled": true }
   ]
 }
 ```
@@ -62,10 +62,11 @@ if aiaui is not None:
 ├── Config/AIAUIProtocol.json            # 运行协议：端口 + 模块启停（生成器只登记，不配置）
 └── PyAIAUI/
     ├── __init__.py                      # 入口：AIAUI 类（AIAUI.start / aiaui.stop）
-    ├── JobInformation/                  # 模块目录，目录名 == 模块 ID
-    │   ├── api.py                       # 后端契约：create_api(context) -> APIRouter
-    │   ├── resources/src/               # Vue 前端源码
-    │   ├── resources/dist/              # 预构建产物（开箱即跑，改源码后 npm run build 重出）
+    ├── JobDashboard/                   # 模块目录，目录名 == 模块 ID
+    │   ├── backend/api.py               # 后端契约：create_api(context) -> APIRouter
+    │   ├── backend/config.json          # 外观配置（可无：/config 端点读它）
+    │   ├── client/src/                  # Vue 前端源码
+    │   ├── client/dist/                 # 预构建产物（开箱即跑，改源码后 npm run build 重出）
     │   └── {README.md, CUSTOMIZATION.md}# 模块说明与定制手册
     └── _runtime/                        # 内嵌模块宿主（零外部依赖）
 ```
@@ -76,9 +77,9 @@ if aiaui is not None:
 
 | 模块 ID | 说明 | 组成 |
 | --- | --- | --- |
-| `JobInformation` | 工单 / 载具 / 工序信息面板 | FastAPI 后端 + Vue 前端；内置 `header`、`inputCarriers`、`outputCarriers`、`timeline`、`bottom`（含嵌套的 `recipe`）可替换槽位；三级定制（默认 / 局部替换 / 全量自定义） |
+| `JobDashboard` | 工单 / 载具 / 工序信息面板 | FastAPI 后端（`backend/api.py` + `backend/config.json`）+ Vue 前端（`client/`）；实现 `GET /jobs`（工单数据）+ `GET /config`（显示开关 + 状态色/图标，config.json 读取）即可；分粒度槽位（`board`/`headerRegion`/`middleRegion`/`bottomRegion` + 叶子）可替换任意局部 |
 | `HelloWorld` | 最小前端模块示例 | 自定义元素；验证挂载链路，无后端 |
-自定义通过 `resources/src/customization.ts` 完成，槽位通信通过 `context.bus`（事件 / expose+peer），详见生成目录里的 `CUSTOMIZATION.md`。
+自定义通过 `client/src/customization.ts` 完成，槽位通信通过 `context.bus`（事件 / expose+peer），详见生成目录里的 `CUSTOMIZATION.md`。
 
 ## UIService 集成
 
@@ -97,6 +98,6 @@ export AIA_UI_MODULE_TEMPLATE_ROOT="$(npm root -g)/create-aiaui-module"
 
 ## 维护者（发布新模板）
 
-- 新增模块：在 `templates/<ModuleId>/` 下放实现（含 `contractVersion`、`README.md`、`resources/`）
+- 新增模块：在 `templates/<ModuleId>/` 下放实现（含 `contractVersion`、`README.md`、`backend/api.py`、`client/`）
 - 前端模板发布前在 `resources/` 跑 `npm install && npm run build`，把产物一起随包发布；发布自动执行 `verify-dist` 校验每个模板的 `contractVersion`、入口、`dist/` 产物
 - 发版流程：`npm test` → 改 `package.json` 版本号 → `npm publish`

package/bin/create-aiaui-module.js

@@ -35,7 +35,7 @@ function briefDescription(templateId) {
 
 function printTemplateList(entries) {
   console.log();
-  console.log("AIAUI 模块模板");
+  console.log("AIAUI module templates");
   console.log(DIVIDER);
   if (entries.length === 0) console.log("  (none)");
   for (const entry of entries) {
@@ -44,43 +44,35 @@ function printTemplateList(entries) {
       console.log(`     ${briefDescription(entry.id)}`);
   }
   console.log(DIVIDER);
-  console.log("生成: npx create-aiaui-module <模块名> [--list] [--json]");
+  console.log("usage: npx create-aiaui-module <ModuleId> [--list] [--json] [--instance-root <path>]");
 }
 
 function printSuccess(result) {
   console.log();
-  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-  console.log("                  [AIAUI] 生成成功");
-  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.log("                    [AIAUI] module created");
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
   console.log();
-  console.log(`  ✅ 生成路径    ${result.path} (${result.filesCopied} 个文件)`);
-  console.log(`  ✅ 协议配置    ${result.configPath} (enabled: ${result.enabled})`);
+  console.log(`  done  module     ${result.moduleId}`);
+  console.log(`  done  path       ${result.path}`);
+  console.log(`  done  files      ${result.filesCopied}`);
+  console.log(`  done  protocol   ${result.configPath}`);
+  console.log(`                 enabled: ${result.enabled}, port: ${result.port ?? "unset"}`);
   console.log();
-  console.log("⚠️ 配置调整（需要你手动做）");
-  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-  console.log("  📌 修改 port 字段为 18901（或你选择的其他空闲端口）");
-  console.log("  📌 将 enabled 改为 true");
-  console.log("  📌 模块接入 Instance 启动流程后再启用");
-  console.log();
-  console.log("🔧 接下来要做：");
-  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-  console.log("  1. 配置端口");
-  console.log("     修改 AIAUIProtocol.json 中 port 字段为 18901（示例值）");
-  console.log("  2. 配置模块 enable");
-  console.log("     修改 AIAUIProtocol.json 中对应模块的 enabled 为 true");
-  console.log("  3. 接入 Instance 启动流程");
-  console.log("     · 启动时: aiaui = AIAUI.start(services={...})");
-  console.log("     · 关闭时: aiaui.stop()");
-  console.log("  4. 打开 UIClient 对应页面查看效果（JobInformation → /jobs）");
-  console.log();
-  console.log("❌ 没有做的（请确认）");
-  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-  console.log("  · 未启动服务（由 Instance 生命周期调用 AIAUI.start）");
-  console.log("  · 未安装依赖（模块运行需要 pip install fastapi uvicorn）");
-  console.log("  · 未选择/配置端口");
-  console.log("  · 未手动启用任何模块");
-  console.log();
-  console.log("  初始化目录已就绪，按上面的顺序操作即可上线。");
+  console.log("next: edit your Config & wire the module (you must do this)");
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.log('  1. Set a free loopback port in AIAUIProtocol.json ("port", e.g. 18900-18999 range)');
+  console.log('     and flip "enabled" to true for your module');
+  console.log("  2. Wire the module into your Instance lifecycle");
+  console.log("     from PyAIAUI import AIAUI");
+  console.log("     aiaui = AIAUI.start(services={...})   # at Instance startup");
+  console.log("     aiaui.stop()                            # at shutdown");
+  console.log('  3. Mount its data: backend/api.py implements create_api(context) -> APIRouter.');
+  console.log("     (many templates ship backend/config.json for appearance settings — see README)");
+
+  console.log("  4. Rebuild the frontend if you edited it:");
+  console.log("     npm install && npm run build        # from <module>/client");
+  console.log("  no  starting services, auto-required deps, or a running Instance is triggered");
   console.log();
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-aiaui-module",
-  "version": "0.1.2-TEST",
-  "description": "AIAUI Instance module scaffolder: generate editable module (FastAPI + Vue frontend) with one npx command",
+  "version": "0.2.0",
+  "description": "AIAUI Instance module scaffolder: npx generates an editable module",
   "keywords": [
     "aiaui",
     "scaffolding",
@@ -9,7 +9,8 @@
     "vue",
     "fastapi",
     "module",
-    "instance"
+    "instance",
+    "sharetek"
   ],
   "type": "module",
   "bin": {

package/runtime/_runtime/registry.py

@@ -19,7 +19,10 @@ class ModuleDescriptor:
         self.id = module_id
         self.directory = directory
         self.api_file = directory / "api.py"
-        self.frontend_entry = directory / "resources" / "dist"
+        client_dist = directory / "client" / "dist"
+        self.frontend_entry = (
+            client_dist if client_dist.is_dir() else directory / "resources" / "dist"
+        )
 
     @property
     def has_backend(self) -> bool:

package/templates/{JobInformation → JobDashboard}/CUSTOMIZATION.md

@@ -1,4 +1,4 @@
-# JobInformation customization
+# JobDashboard customization
 
 This module ships a built-in job-information panel that reads two local
 endpoints and renders one card per job. Every part of a card can be replaced
@@ -67,7 +67,7 @@ without touching the platform code; the host contract
 
 ## Slots (what you can replace)
 
-Edit `resources/src/customization.ts`. Keys per card:
+Edit `client/src/customization.ts`. Keys per card:
 
 | Slot | Replaces | Renders inside |
 | --- | --- | --- |
@@ -89,7 +89,7 @@ slots ignore the region around them (which stays platform-owned). Replacing
 sub-slots if set.
 
 ```ts
-// resources/src/customization.ts
+// client/src/customization.ts
 import MyJobName from "./custom/MyJobName.vue";
 import type { Customization } from "./contract";
 

package/templates/{JobInformation → JobDashboard}/README.md

@@ -1,4 +1,4 @@
-# JobInformation module
+# JobDashboard module
 
 This template scaffolds an editable "job information" UI module. The
 generator only produces scaffolding plus an inlined runtime
@@ -19,7 +19,7 @@ def create_api(context) -> APIRouter:
 ```
 
 The generated host calls `create_api(context)` once and mounts the returned
-router at `/modules/JobInformation`. You receive:
+router at `/modules/JobDashboard`. You receive:
 
 - `context.instance_root` — the Instance root directory.
 - `context.services` — a dict of the live objects your Instance passes in at
@@ -40,11 +40,11 @@ Everything else about how to fetch or present data is yours to implement.
 
 The frontend is organized around a small customization contract:
 
-- `resources/src/index.ts` — the stable `mount` / `unmount` bridge the host loads.
-- `resources/src/contract.ts` — the shared types for the module context, bus, and customization.
-- `resources/src/customization.ts` — the only file you normally edit to customize.
-- `resources/src/bus.ts` — a per-mount communication bus shared by all slot components.
-- `resources/src/defaults/` — the built-in panel and its replaceable boxes.
+- `client/src/index.ts` — the stable `mount` / `unmount` bridge the host loads.
+- `client/src/contract.ts` — the shared types for the module context, bus, and customization.
+- `client/src/customization.ts` — the only file you normally edit to customize.
+- `client/src/bus.ts` — a per-mount communication bus shared by all slot components.
+- `client/src/defaults/` — the built-in panel and its replaceable boxes.
 
 Slot components also communicate through `context.bus` (events or imperative handles); see CUSTOMIZATION.md for the patterns.
 
@@ -59,7 +59,7 @@ Three levels are supported without changing `index.ts`:
 2. **Partial** — replace one or more named boxes:
 
    ```ts
-   // resources/src/customization.ts
+   // client/src/customization.ts
    import MyHeader from "./custom/MyHeader.vue";
    import type { Customization } from "./contract";
 
@@ -110,7 +110,7 @@ aiaui = AIAUI.start(services={
 aiaui.stop()
 ```
 
-`start()` returns `None` when `JobInformation` is disabled in
+`start()` returns `None` when `JobDashboard` is disabled in
 `Config/AIAUIProtocol.json`; otherwise it returns the running host.
 
 ## Dependencies (reminder, not installed automatically)

package/templates/{JobInformation → JobDashboard/backend}/api.py

@@ -1,9 +1,73 @@
-"""Editable Job Information example, mounted under /modules/JobInformation."""
+"""Editable JobDashboard example, mounted under /modules/JobDashboard."""
 
 import inspect
 
+import json
+from pathlib import Path
+
 from fastapi import APIRouter
 
+CONFIG_PATH = Path(__file__).resolve().parent / "config.json"
+
+DEFAULT_CONFIG = {
+    "display": {
+        "lotId": true,
+        "recipe": true,
+        "inputCarriers": true,
+        "outputCarriers": true,
+        "timeline": true
+    },
+    "states": [
+        {
+            "name": "Setup",
+            "color": "#0369a1",
+            "icon": "clock"
+        },
+        {
+            "name": "Select",
+            "color": "#526176",
+            "icon": "list"
+        },
+        {
+            "name": "WaitingForStart",
+            "color": "#8b95a5",
+            "icon": "stop"
+        },
+        {
+            "name": "Executing",
+            "color": "#1d4ed8",
+            "icon": "activity"
+        },
+        {
+            "name": "Running",
+            "color": "#1d4ed8",
+            "icon": "activity"
+        },
+        {
+            "name": "Complete",
+            "color": "#166534",
+            "icon": "flag"
+        },
+        {
+            "name": "Finished",
+            "color": "#166534",
+            "icon": "flag"
+        }
+    ]
+
+}
+
+
+def default_config() -> dict:
+    """Merge ``config.json`` over the shipped default palette."""
+    try:
+        raw = json.loads(CONFIG_PATH.read_text(encoding="utf-8"))
+    except OSError:
+        return DEFAULT_CONFIG
+    if not isinstance(raw, dict):
+        return DEFAULT_CONFIG
+    return {**DEFAULT_CONFIG, **raw}
+
 
 def create_api(context) -> APIRouter:
     """Entry point invoked by the generated PyAIAUI host.
@@ -71,27 +135,10 @@ def create_api(context) -> APIRouter:
 
     @router.get("/config")
     async def config():
-        """Panel appearance contract: which parts to display + the state
-        colour/icon map. The template already ships a built-in default copy
-        (``config-defaults.ts``), so this endpoint can stay absent.
+        """Panel appearance contract, read from ``config.json`` (sitting next
+        to this file). Any missing key is merged over the built-in default
+        palette; unreadable/malformed content falls back to the default.
         """
-        return {
-            "display": {
-                "lotId": True,
-                "recipe": True,
-                "inputCarriers": True,
-                "outputCarriers": True,
-                "timeline": True,
-            },
-            "states": [
-                {"name": "Setup", "color": "#0369a1", "icon": "clock"},
-                {"name": "Select", "color": "#526176", "icon": "list"},
-                {"name": "WaitingForStart", "color": "#8b95a5", "icon": "stop"},
-                {"name": "Executing", "color": "#1d4ed8", "icon": "activity"},
-                {"name": "Running", "color": "#1d4ed8", "icon": "activity"},
-                {"name": "Complete", "color": "#166534", "icon": "flag"},
-                {"name": "Finished", "color": "#166534", "icon": "flag"},
-            ],
-        }
+        return default_config()
 
     return router

package/templates/JobDashboard/backend/config.json

@@ -0,0 +1,46 @@
+{
+  "display": {
+    "lotId": true,
+    "recipe": true,
+    "inputCarriers": true,
+    "outputCarriers": true,
+    "timeline": true
+  },
+  "states": [
+    {
+      "name": "Setup",
+      "color": "#0369a1",
+      "icon": "clock"
+    },
+    {
+      "name": "Select",
+      "color": "#526176",
+      "icon": "list"
+    },
+    {
+      "name": "WaitingForStart",
+      "color": "#8b95a5",
+      "icon": "stop"
+    },
+    {
+      "name": "Executing",
+      "color": "#1d4ed8",
+      "icon": "activity"
+    },
+    {
+      "name": "Running",
+      "color": "#1d4ed8",
+      "icon": "activity"
+    },
+    {
+      "name": "Complete",
+      "color": "#166534",
+      "icon": "flag"
+    },
+    {
+      "name": "Finished",
+      "color": "#166534",
+      "icon": "flag"
+    }
+  ]
+}

package/templates/{JobInformation/resources → JobDashboard/client}/src/defaults/DefaultPanel.vue

@@ -80,7 +80,7 @@ const visibleJobs = computed(() =>
 </script>
 
 <template>
-  <section class="legacy-jobs" aria-label="Job Information">
+  <section class="legacy-jobs" aria-label="Job Dashboard">
     <header class="legacy-toolbar">
       <div class="legacy-filters">
         <label class="legacy-search">