product-spec-mcp 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.2 - MVP readiness fixes
+
+- Added a generic backend order-workflow compile path for QR ordering and kitchen status scenarios.
+- Tightened architecture consistency so compiled registration features are not downgraded to frontend-only local storage.
+- Improved AA calculator local specs with participants, payments, settlements, and algorithm acceptance checks.
+- Marked invalid `product_spec_connect` files in structured output and kept the specific validation warnings visible.
+- Rewrote the README opening around users who need help turning product ideas into executable engineering specs.
+
 ## 0.4.1 - Connect page user context
 
 - Added AI tool and multi-select use-case fields to the `/connect` page.

package/README.md

@@ -1,14 +1,40 @@
 # product-spec-mcp
 
-> 防止 AI 编程一上来就乱写代码的 MCP 工具。
+> 把一句模糊的产品想法，整理成 AI Agent 可以执行的工程规格。
 
-把用户的模糊产品想法变成追问清单、可执行规格、架构建议和验收标准。
+很多人能说清“我想做什么”，但还没法直接写出功能范围、数据字段、架构边界和验收标准。`product-spec-mcp` 先帮你把想法过一遍产品经理式需求闸门，再交给 Codex、Claude、Cursor、OpenCode 等 Agent 开始写代码。
 
-## 适用场景
+## 适合谁
 
-当你或 AI 编程助手拿到一句话需求（"做一个报名系统"、"页面高级一点"、"接口报错了"），不要直接开工。先过一遍需求闸门，减少返工。
+- 你有一个小应用、网站、工具或 SaaS 想法，但不知道怎样拆成开发规格。
+- 你是创始人、运营、设计师、小团队负责人、学生，或刚开始用 AI 写代码的人。
+- 你希望 Agent 少脑补，先确认对象、字段、权限、接口、风险和验收标准。
+- 你要判断一个需求第一版该做纯前端、本地存储、轻后端，还是完整 SaaS。
 
-## 推荐流程
+## 它会产出什么
+
+- 追问清单：先问真正会影响实现的缺口，不套固定模板。
+- 可执行规格：核心功能、数据模型、API 设计、非目标、风险边界。
+- 架构建议：判断是否需要后端、登录、后台、数据库、支付或 AI Key 保护。
+- 验收标准：把“做完了”变成可以检查的列表。
+
+## 最短使用路径
+
+如果不确定从哪个工具开始，直接让 Agent 调用：
+
+```text
+product_spec_assist
+```
+
+输入你的原话，例如：
+
+```text
+我想做一个活动报名系统，用户填姓名电话报名人数，后台能查看、搜索和导出 Excel。
+```
+
+它会自动判断该追问、编译规格、给架构建议，还是生成验收标准。
+
+需要完整开发前规格时，推荐流程是：
 
 ```
 1. spec_interrogate   → 评估需求完整度，生成追问清单
@@ -17,9 +43,7 @@
 4. acceptance_generate → 生成验收标准
 ```
 
-**不确定用哪个工具？** 先用 `product_spec_assist`，它会自动识别场景并调用合适的工具。
-
-**想启用在线 PM Gate？** 先用 `product_spec_connect`，它会引导用户打开连接页、下载连接文件，并让当前 Agent 把 token 写入 MCP 配置。
+**在线 PM Gate 是可选增强。** 默认本地规则已经可用；如果想让低置信或冲突需求走在线 LLM 辅助归门，再调用 `product_spec_connect` 下载连接文件并交给当前 Agent 配置。
 
 ## Features
 

package/dist/index.cjs

@@ -21334,7 +21334,7 @@ function classifyProductDomain(rawIdea, context = {}) {
       scores[domain2] += keyHits * 6;
     }
   }
-  const registration = hasAny(text, ["\u6D3B\u52A8\u62A5\u540D", "\u62A5\u540D\u7CFB\u7EDF", "\u62A5\u540D\u8868", "\u53C2\u4F1A", "\u53C2\u8D5B"]) && !negatedRegistration;
+  const registration = hasAny(text, ["\u6D3B\u52A8\u62A5\u540D", "\u62A5\u540D\u7CFB\u7EDF", "\u62A5\u540D\u8868", "\u62A5\u540D\u7528\u6237", "\u62A5\u540D\u6570\u636E", "\u62A5\u540D\u5217\u8868", "\u7528\u6237\u62A5\u540D\u8868\u5355", "\u53C2\u4F1A", "\u53C2\u8D5B"]) && !negatedRegistration;
   if (registration) scores.registration += 7;
   if (registration && hasAny(text, ["\u5BFC\u51FA", "Excel", "\u624B\u673A\u53F7", "\u62A5\u540D\u5217\u8868"])) scores.registration += 3;
   const commerce = hasAny(text, ["\u6570\u5B57\u8D44\u6599", "\u8D44\u6599\u5305", "\u552E\u5356", "\u8D2D\u4E70", "\u4E0B\u5355", "\u8BA2\u5355", "\u5546\u54C1", "\u4EF7\u683C"]);
@@ -21451,7 +21451,7 @@ function isPlantCareTool(text) {
   return hasAny(text, ["\u690D\u7269", "\u6D47\u6C34", "\u65BD\u80A5", "\u517B\u62A4"]) && hasAny(text, ["\u63D0\u9192", "\u5468\u671F", "\u4ECA\u5929", "\u5F85\u529E"]);
 }
 function hasNegatedRegistration(text) {
-  return /(不接|不做|不用|无需|不需要|暂不|先不|不是|不要).{0,8}(报名|报名系统|报名表|手机号|导出 Excel|导出Excel)/.test(text);
+  return /(不接|不做|不用|无需|不需要|暂不|先不|不是|不要).{0,4}(报名|报名系统|报名表|手机号|导出 Excel|导出Excel)/.test(text);
 }
 function hasNegatedTicket(text) {
   return /(不接|不做|不用|无需|不需要|暂不|先不|不是|不要).{0,8}(工单|ticket|任务协作|分派|处理人)/i.test(text);
@@ -22117,6 +22117,7 @@ function buildTechnicalProfile(rawText, context = {}) {
   if (localTool) evidence.push("\u9700\u6C42\u50CF\u4E2A\u4EBA\u6E05\u5355\u3001\u8BB0\u5F55\u3001\u53F0\u8D26\u3001\u63D0\u9192\u6216\u6536\u85CF\u5DE5\u5177");
   if (aiRisk) blockers.push("\u6D89\u53CA AI \u6216\u7B2C\u4E09\u65B9\u6A21\u578B\u5BC6\u94A5\uFF0C\u9700\u8981\u540E\u7AEF\u4FDD\u62A4\u5BC6\u94A5");
   if (paymentRisk) blockers.push("\u6D89\u53CA\u652F\u4ED8\u3001\u8BA2\u5355\u6216\u6536\u6B3E\uFF0C\u9700\u8981\u540E\u7AEF\u786E\u8BA4\u91D1\u989D\u548C\u72B6\u6001");
+  if (hasOperationalOrderWorkflowSignal(text)) evidence.push("\u9700\u6C42\u5305\u542B\u4E0B\u5355\u3001\u8BA2\u5355\u72B6\u6001\u6216\u540E\u53F0\u64CD\u4F5C\u6D41\uFF0C\u9700\u8981\u7EDF\u4E00\u540E\u7AEF\u72B6\u6001\u6E90");
   if (fullBackend && !isNegatedBackend(text)) {
     return profile("full_backend_saas", "high", false, true, true, true, "postgresql", evidence, blockers);
   }
@@ -22241,7 +22242,11 @@ function hasStaticDisplaySignal(text) {
 }
 function hasLightBackendSignal(text, context) {
   if (context.has_auth === true || context.need_backend === true || context.backend_need === true) return true;
-  return /(后台|管理员|登录|注册|多人|团队|审核|权限|服务端|服务器|数据库|报名|预约|容量|满员|提交到服务器|公开给用户)/.test(text) && !isNegatedBackend(text);
+  return /(后台|管理员|登录|注册|多人|团队|审核|权限|服务端|服务器|数据库|报名|预约|容量|满员|提交到服务器|公开给用户)/.test(text) && !isNegatedBackend(text) || hasOperationalOrderWorkflowSignal(text);
+}
+function hasOperationalOrderWorkflowSignal(text) {
+  if (/(不接|不做|不用|无需|不需要|暂不|先不).{0,8}(订单|下单|后厨|扫码点餐|菜品)/.test(text)) return false;
+  return /(扫码点餐|扫码下单|后厨|菜品|菜单|桌号|订单状态|维护菜品|顾客.{0,6}下单|下单.{0,12}(后厨|订单状态)|后厨.{0,12}(订单|状态))/.test(text);
 }
 function hasSaasSignal(text, context) {
   return context.commercial_intent === true || /(SaaS|商业化|套餐|订阅收费|按次数|扣次|余额|多租户)/i.test(text);
@@ -22253,9 +22258,13 @@ function hasAiRisk(text, context) {
 }
 function hasPaymentRisk(text, context) {
   if (context.has_payment === true) return true;
+  if (isSplitBillAccountingText(text)) return false;
   if (/(不接|不做|不用|无需|不需要|暂不|先不).{0,8}(支付|付款|收费|订单|收款|购买)/.test(text)) return false;
   return /(支付|付款|收款|退款|微信支付|支付宝|在线支付|订单支付|付费套餐|套餐购买)/.test(text);
 }
+function isSplitBillAccountingText(text) {
+  return /(AA|aa|分账|均摊|人均|谁该转给谁|转给谁|转账建议)/.test(text) && /(记账|付款记录|付了多少钱|参与人|本地保存|localStorage|浏览器)/.test(text);
+}
 function hasStrongBackendSignal(text, context) {
   return hasAiRisk(text, context) || hasPaymentRisk(text, context) || hasLightBackendSignal(text, context);
 }
@@ -24141,6 +24150,7 @@ function buildLocalToolSignalProfile(text) {
   };
 }
 function extractRecordObject(text) {
+  if (isSplitBillTool(text)) return "AA \u8BB0\u8D26";
   if (/药品|药箱|药/.test(text)) return "\u836F\u54C1";
   const patterns = [
     /(?:做一个|做个|开发一个|创建一个|想做一个|想做个)([^，。,.；;]{1,16}?)(?:管理工具|提醒工具|记录工具|清单|小工具|页面|网页|HTML)/i,
@@ -24158,6 +24168,7 @@ function cleanObjectLabel(value) {
   return value.replace(/^(家庭|个人|家里|我的|一个|一款)/, "").replace(/(管理|提醒|记录|清单|工具|页面|网页|HTML)$/i, "").trim();
 }
 function buildFieldLabels(text, recordObject) {
+  if (isSplitBillTool(text)) return ["\u53C2\u4E0E\u4EBA", "\u4ED8\u6B3E\u8BB0\u5F55", "\u5E94\u4ED8\u91D1\u989D", "\u8F6C\u8D26\u5EFA\u8BAE", "\u5907\u6CE8"];
   const labels = [`${recordObject}\u540D`];
   const physicalInventory = /家里有哪些|有哪些|库存|余量|剩余|补货|存放|放在/.test(text);
   addIf(labels, "\u6570\u91CF/\u5E93\u5B58", physicalInventory || /数量|库存|余量|剩余|补货/.test(text));
@@ -24171,6 +24182,9 @@ function buildFieldLabels(text, recordObject) {
   return Array.from(new Set(labels));
 }
 function buildFeatureHints(text, recordObject) {
+  if (isSplitBillTool(text)) {
+    return ["\u53C2\u4E0E\u4EBA\u7BA1\u7406", "\u4ED8\u6B3E\u8BB0\u5F55", "\u8F6C\u8D26\u5EFA\u8BAE\u8BA1\u7B97", "\u65B0\u589E/\u7F16\u8F91/\u5220\u9664"];
+  }
   const hints = [];
   if (/记录|管理|保存|清单|列表/.test(text)) hints.push(`${recordObject}\u8BB0\u5F55\u7BA1\u7406`);
   if (/记录|管理|保存|清单|列表/.test(text)) hints.push("\u65B0\u589E/\u7F16\u8F91/\u5220\u9664");
@@ -24182,6 +24196,13 @@ function buildFeatureHints(text, recordObject) {
   return Array.from(new Set(hints));
 }
 function buildAcceptanceItems(text, recordObject, fieldLabels) {
+  if (isSplitBillTool(text)) {
+    return [
+      "\u6BCF\u4E2A\u53C2\u4E0E\u4EBA\u53EF\u4EE5\u8BB0\u5F55\u59D3\u540D\u3001\u662F\u5426\u53C2\u4E0E\u672C\u6B21 AA \u548C\u4E2A\u4EBA\u5B9E\u9645\u4ED8\u6B3E\u91D1\u989D",
+      "\u603B\u4ED8\u6B3E\u91D1\u989D\u3001\u6BCF\u4EBA\u5E94\u4ED8\u91D1\u989D\u548C\u5DEE\u989D\u8BA1\u7B97\u4E00\u81F4",
+      "\u8F6C\u8D26\u5EFA\u8BAE\u80FD\u8BF4\u660E\u8C01\u8BE5\u8F6C\u7ED9\u8C01\u3001\u8F6C\u591A\u5C11\u94B1\uFF0C\u6240\u6709\u8F6C\u8D26\u91D1\u989D\u5408\u8BA1\u540E\u80FD\u6E05\u96F6\u5DEE\u989D"
+    ];
+  }
   const items = [];
   if (/记录|管理|保存|清单|列表/.test(text)) {
     items.push(`${recordObject}\u8BB0\u5F55\u80FD\u4FDD\u5B58${fieldLabels.join("\u3001")}`);
@@ -24201,6 +24222,9 @@ function buildAcceptanceItems(text, recordObject, fieldLabels) {
 function addIf(items, label, condition) {
   if (condition) items.push(label);
 }
+function isSplitBillTool(text) {
+  return /(AA|aa|分账|均摊|人均|谁该转给谁|转给谁|付了多少钱|付款金额)/.test(text) && /(记账|计算|小工具|本地保存|浏览器|参与人|每个人)/.test(text);
+}
 
 // src/core/promptBuilder.ts
 function buildSpec(rawIdea, context, readiness) {
@@ -24234,6 +24258,9 @@ function buildSpec(rawIdea, context, readiness) {
   if (shouldUseDomainPack && classification.domain === "registration") {
     return withTechnicalProfile(buildRegistrationSpec(rawIdea, normalizedContext, readiness), technicalProfile);
   }
+  if (classification.domain === "generic" && isOperationalOrderWorkflowContext(rawIdea, normalizedContext)) {
+    return withTechnicalProfile(buildOperationalOrderWorkflowSpec(rawIdea, normalizedContext, readiness), technicalProfile);
+  }
   if (classification.domain === "generic" && shouldUsePmGateSpec(pmIntentDecision)) {
     return withTechnicalProfile(buildPmGateSpec(rawIdea, normalizedContext, readiness, pmIntentDecision), technicalProfile);
   }
@@ -24702,6 +24729,68 @@ function buildDigitalCommerceSpec(rawIdea, context, readiness) {
     inputConsumption: buildInputConsumption(context, domainKeys, "digital_commerce", "high")
   };
 }
+function buildOperationalOrderWorkflowSpec(rawIdea, context, readiness) {
+  const platform = context.platform || context.target_platform || extractPlatform(rawIdea) || "web";
+  const database = context.database || "SQLite";
+  const domainKeys = ["order_flow", "admin_features", "data_persistence", "target_platform"];
+  return {
+    readinessScore: Math.max(readiness.score, 60),
+    readinessStatus: "Draft Ready",
+    isActionable: false,
+    productGoal: context.product_goal || "\u626B\u7801\u70B9\u9910\u8BA2\u5355\u7CFB\u7EDF",
+    targetUser: context.target_user || "\u987E\u5BA2\u3001\u540E\u53A8\u4EBA\u5458\u548C\u5E97\u94FA\u7BA1\u7406\u5458",
+    platform,
+    coreFeatures: [
+      "\u987E\u5BA2\u626B\u7801\u8FDB\u5165\u684C\u53F0\u70B9\u9910\u9875",
+      "\u83DC\u5355\u548C\u83DC\u54C1\u5C55\u793A\uFF1A\u5206\u7C7B\u3001\u540D\u79F0\u3001\u4EF7\u683C\u3001\u4E0A\u4E0B\u67B6\u72B6\u6001",
+      "\u8D2D\u7269\u8F66\u548C\u4E0B\u5355\uFF1A\u9009\u62E9\u83DC\u54C1\u3001\u6570\u91CF\u3001\u5907\u6CE8\u5E76\u521B\u5EFA\u8BA2\u5355",
+      "\u8BA2\u5355\u72B6\u6001\u6D41\uFF1Apending -> accepted -> cooking -> ready -> completed/cancelled",
+      "\u540E\u53A8\u8BA2\u5355\u770B\u677F\uFF1A\u67E5\u770B\u65B0\u8BA2\u5355\u5E76\u66F4\u65B0\u5236\u4F5C\u72B6\u6001",
+      "\u8001\u677F\u540E\u53F0\uFF1A\u7EF4\u62A4\u83DC\u54C1\u3001\u5206\u7C7B\u3001\u4EF7\u683C\u548C\u4E0A\u4E0B\u67B6\u72B6\u6001"
+    ],
+    dataModel: buildOperationalOrderDataModel(database),
+    architecture: [
+      `MVP \u63A8\u8350\u5355\u4F53 Web \u540E\u7AEF\u67B6\u6784\uFF1ANode.js/Express + ${database} + \u670D\u52A1\u7AEF Session\u3002`,
+      "\u987E\u5BA2\u4E0B\u5355\u3001\u540E\u53A8\u72B6\u6001\u548C\u8001\u677F\u7EF4\u62A4\u83DC\u54C1\u90FD\u9700\u8981\u7EDF\u4E00\u540E\u7AEF\u72B6\u6001\u6E90\uFF0C\u4E0D\u80FD\u53EA\u653E\u5728\u6D4F\u89C8\u5668 localStorage\u3002",
+      "\u4EF7\u683C\u5FC5\u987B\u4EE5\u540E\u7AEF\u83DC\u54C1\u8868\u4E3A\u51C6\uFF0C\u524D\u7AEF\u4F20\u5165\u91D1\u989D\u53EA\u80FD\u4F5C\u4E3A\u5C55\u793A\u53C2\u8003\u3002"
+    ].join("\n"),
+    apiDesign: [
+      "GET /api/menus - \u67E5\u8BE2\u53EF\u5C55\u793A\u83DC\u5355\u5206\u7C7B\u548C\u5DF2\u4E0A\u67B6\u83DC\u54C1",
+      "POST /api/orders - \u987E\u5BA2\u521B\u5EFA\u8BA2\u5355\uFF1Bbody: { tableCode, items, note }\uFF1B\u540E\u7AEF\u6309\u83DC\u54C1\u8868\u8BA1\u7B97\u91D1\u989D\u5E76\u5199\u5165 pending \u72B6\u6001",
+      "GET /api/orders/:id - \u67E5\u8BE2\u8BA2\u5355\u8BE6\u60C5\u548C\u5F53\u524D\u72B6\u6001",
+      "GET /api/kitchen/orders?status= - \u540E\u53A8\u67E5\u8BE2\u5F85\u5904\u7406\u548C\u5236\u4F5C\u4E2D\u8BA2\u5355\uFF1B\u9700\u8981\u540E\u53A8\u6216\u7BA1\u7406\u5458\u767B\u5F55",
+      "PATCH /api/kitchen/orders/:id/status - \u540E\u53A8\u66F4\u65B0\u8BA2\u5355\u72B6\u6001\uFF1B\u53EA\u5141\u8BB8\u6309\u72B6\u6001\u673A\u6D41\u8F6C",
+      "POST /api/admin/login - \u8001\u677F\u6216\u7BA1\u7406\u5458\u767B\u5F55",
+      "GET /api/admin/dishes - \u67E5\u8BE2\u83DC\u54C1\u5217\u8868",
+      "POST /api/admin/dishes - \u65B0\u589E\u83DC\u54C1",
+      "PATCH /api/admin/dishes/:id - \u7F16\u8F91\u83DC\u54C1\u540D\u79F0\u3001\u4EF7\u683C\u3001\u5206\u7C7B\u6216\u4E0A\u4E0B\u67B6\u72B6\u6001",
+      "GET /api/admin/orders - \u8001\u677F\u67E5\u8BE2\u8BA2\u5355\u5217\u8868\u548C\u72B6\u6001"
+    ].join("\n"),
+    riskBoundaries: [
+      "\u8BA2\u5355\u91D1\u989D\u5FC5\u987B\u7531\u540E\u7AEF\u6839\u636E\u83DC\u54C1\u4EF7\u683C\u8BA1\u7B97\uFF0C\u4E0D\u80FD\u4FE1\u4EFB\u524D\u7AEF\u4F20\u5165\u91D1\u989D",
+      "\u540E\u53A8\u72B6\u6001\u6D41\u8F6C\u5FC5\u987B\u5728\u540E\u7AEF\u6821\u9A8C\uFF0C\u907F\u514D\u8BA2\u5355\u88AB\u8DF3\u8FC7\u6216\u91CD\u590D\u5B8C\u6210",
+      "\u8001\u677F\u540E\u53F0\u548C\u540E\u53A8\u770B\u677F\u5FC5\u987B\u670D\u52A1\u7AEF\u9274\u6743",
+      "\u540C\u4E00\u684C\u53F0\u77ED\u65F6\u95F4\u91CD\u590D\u63D0\u4EA4\u9700\u8981\u5E42\u7B49\u6216\u660E\u786E\u9632\u91CD\u590D\u63D0\u793A"
+    ],
+    nonGoals: [
+      "MVP \u6682\u4E0D\u63A5\u771F\u5B9E\u652F\u4ED8",
+      "MVP \u6682\u4E0D\u505A\u590D\u6742\u5E93\u5B58\u3001\u4F1A\u5458\u548C\u4F18\u60E0\u5238",
+      "MVP \u6682\u4E0D\u505A\u591A\u95E8\u5E97\u548C\u590D\u6742\u6743\u9650"
+    ],
+    successCriteria: [
+      "\u987E\u5BA2\u626B\u7801\u540E\u53EF\u4EE5\u770B\u5230\u5DF2\u4E0A\u67B6\u83DC\u54C1\u5E76\u521B\u5EFA\u8BA2\u5355",
+      "\u8BA2\u5355\u521B\u5EFA\u540E\uFF0C\u540E\u53A8\u770B\u677F\u80FD\u770B\u5230\u65B0\u8BA2\u5355\u548C\u83DC\u54C1\u660E\u7EC6",
+      "\u540E\u53A8\u66F4\u65B0\u72B6\u6001\u540E\uFF0C\u987E\u5BA2\u8BA2\u5355\u8BE6\u60C5\u80FD\u770B\u5230\u6700\u65B0\u72B6\u6001",
+      "\u8001\u677F\u53EF\u4EE5\u65B0\u589E\u3001\u7F16\u8F91\u3001\u4E0B\u67B6\u83DC\u54C1\uFF0C\u4E14\u4E0B\u67B6\u83DC\u54C1\u4E0D\u80FD\u518D\u88AB\u4E0B\u5355",
+      "\u8BA2\u5355\u91D1\u989D\u4EE5\u540E\u7AEF\u83DC\u54C1\u4EF7\u683C\u8BA1\u7B97\uFF0C\u4FEE\u6539\u524D\u7AEF\u91D1\u989D\u4E0D\u4F1A\u5F71\u54CD\u5B9E\u9645\u8BA2\u5355\u91D1\u989D"
+    ],
+    assumptions: [
+      "MVP \u9ED8\u8BA4\u6BCF\u5F20\u684C\u5B50\u4F7F\u7528\u4E00\u4E2A tableCode \u6216\u4E8C\u7EF4\u7801\u53C2\u6570\u8BC6\u522B\u6765\u6E90\u3002",
+      "MVP \u9ED8\u8BA4\u540E\u53A8\u548C\u8001\u677F\u4F7F\u7528\u7B80\u5355\u8D26\u53F7\u767B\u5F55\uFF0C\u4E0D\u505A\u590D\u6742 RBAC\u3002"
+    ],
+    inputConsumption: buildInputConsumption(context, domainKeys, "generic", "medium")
+  };
+}
 function buildAppointmentSpec(rawIdea, context, readiness) {
   const serviceCatalog = context.service_catalog || "\u670D\u52A1\u9879\u76EE\u5305\u542B\u540D\u79F0\u3001\u7B80\u4ECB\u3001\u65F6\u957F\u3001\u53EF\u9884\u7EA6\u72B6\u6001";
   const timeSlotRule = context.time_slot_rule || "\u7BA1\u7406\u5458\u53EF\u4EE5\u8BBE\u7F6E\u65E5\u671F\u3001\u5F00\u59CB\u65F6\u95F4\u3001\u7ED3\u675F\u65F6\u95F4\u3001\u6700\u5927\u9884\u7EA6\u4EBA\u6570";
@@ -25357,6 +25446,12 @@ function impliesTrueForField(field, text) {
   }
   return false;
 }
+function isOperationalOrderWorkflowContext(rawIdea, context) {
+  const text = `${rawIdea} ${JSON.stringify(context)}`;
+  if (classifyProductDomain(rawIdea, context).domain !== "generic") return false;
+  if (/(不接|不做|不用|无需|不需要|暂不|先不).{0,8}(订单|下单|后厨|扫码点餐|菜品)/.test(text)) return false;
+  return /(扫码点餐|扫码下单|后厨|菜品|菜单|桌号|订单状态|维护菜品|顾客.{0,6}下单|下单.{0,12}(后厨|订单状态)|后厨.{0,12}(订单|状态))/.test(text);
+}
 function parseListLike(value, fallback) {
   if (!value) return fallback;
   if (Array.isArray(value)) return value.map(String).filter(Boolean);
@@ -25396,6 +25491,17 @@ function buildDigitalCommerceDataModel(database) {
     "\u5EFA\u8BAE\u7D22\u5F15\uFF1Aidx_orders_user(user_id)\uFF0Cidx_orders_product(product_id)\uFF0Cidx_downloads_user(user_id)\uFF0Cidx_downloads_order(order_id)"
   ].join("\n");
 }
+function buildOperationalOrderDataModel(database) {
+  return [
+    `\u6570\u636E\u5E93\uFF1A${database}`,
+    "menus(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, sort_order INTEGER NOT NULL DEFAULT 0, status TEXT NOT NULL DEFAULT 'active')",
+    "dishes(id INTEGER PRIMARY KEY AUTOINCREMENT, menu_id INTEGER NOT NULL, name TEXT NOT NULL, description TEXT, price_cents INTEGER NOT NULL CHECK(price_cents >= 0), status TEXT NOT NULL DEFAULT 'active', created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP)",
+    "orders(id INTEGER PRIMARY KEY AUTOINCREMENT, table_code TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'pending', total_cents INTEGER NOT NULL DEFAULT 0, note TEXT DEFAULT '', created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP)",
+    "order_items(id INTEGER PRIMARY KEY AUTOINCREMENT, order_id INTEGER NOT NULL, dish_id INTEGER NOT NULL, dish_name TEXT NOT NULL, unit_price_cents INTEGER NOT NULL, quantity INTEGER NOT NULL CHECK(quantity >= 1), note TEXT DEFAULT '')",
+    "staff_users(id INTEGER PRIMARY KEY AUTOINCREMENT, username TEXT NOT NULL UNIQUE, password_hash TEXT NOT NULL, role TEXT NOT NULL DEFAULT 'kitchen', created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP)",
+    "\u5EFA\u8BAE\u7D22\u5F15\uFF1Aidx_orders_status(status)\uFF0Cidx_orders_table(table_code)\uFF0Cidx_order_items_order(order_id)\uFF0C\u7528\u4E8E\u540E\u53A8\u770B\u677F\u548C\u8BA2\u5355\u8BE6\u60C5\u67E5\u8BE2"
+  ].join("\n");
+}
 function buildAppointmentDataModel(database) {
   return [
     `\u6570\u636E\u5E93\uFF1A${database}`,
@@ -25658,6 +25764,10 @@ function buildLocalRecordJsonExample(recordObject, fieldExample) {
   };
   for (const label of labels) {
     if (label.includes("\u540D")) record2.name = `\u793A\u4F8B${recordObject}`;
+    else if (label.includes("\u53C2\u4E0E\u4EBA")) record2.participants = [{ id: "p1", name: "\u5F20\u4E09" }, { id: "p2", name: "\u674E\u56DB" }];
+    else if (label.includes("\u4ED8\u6B3E\u8BB0\u5F55")) record2.payments = [{ payerId: "p1", amount: 120, note: "\u665A\u9910" }];
+    else if (label.includes("\u5E94\u4ED8\u91D1\u989D")) record2.shareAmount = 60;
+    else if (label.includes("\u8F6C\u8D26\u5EFA\u8BAE")) record2.settlements = [{ from: "p2", to: "p1", amount: 60 }];
     else if (label.includes("\u6570\u91CF") || label.includes("\u5E93\u5B58")) record2.quantity = 1;
     else if (label.includes("\u6709\u6548\u671F") || label.includes("\u5230\u671F")) record2.expireDate = "2026-12-31";
     else if (label.includes("\u5206\u7C7B")) record2.category = "\u9ED8\u8BA4\u5206\u7C7B";
@@ -26172,12 +26282,12 @@ function decideArchitecture(productType, platform, features, commercialIntent, e
     "crm"
   ].includes(domain);
   const isLightweightCoveredDomain = coveredOperationalDomain && expectedUsers !== "enterprise" && expectedUsers !== "massive" && !commercialIntent && !paymentRisk && !aiKeyRisk;
-  const needsBackend = isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || result.need_backend || matchedRules.some((r) => r.result.need_backend);
-  const needsAuth = !singleUserCrm && (isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || result.need_auth || matchedRules.some((r) => r.result.need_auth) || /登录|鉴权|权限|下载|后台|管理员|处理人|成员|销售/.test(allText));
-  const needsAdmin = !singleUserCrm && (isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || result.need_admin || matchedRules.some((r) => r.result.need_admin) || /后台|管理员|审核|举报|隐藏|下架|分配|处理人|发布|撤回|目录权限|成员权限|负责人/.test(allText));
+  const needsBackend = technicalProfile.needsBackend || isLightweightCoveredDomain || isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || result.need_backend || matchedRules.some((r) => r.result.need_backend);
+  const needsAuth = !singleUserCrm && (technicalProfile.needsAuth || isLightweightCoveredDomain || isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || result.need_auth || matchedRules.some((r) => r.result.need_auth) || /登录|鉴权|权限|下载|后台|管理员|处理人|成员|销售/.test(allText));
+  const needsAdmin = !singleUserCrm && (technicalProfile.needsAdmin || isLightweightCoveredDomain || isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || result.need_admin || matchedRules.some((r) => r.result.need_admin) || /后台|管理员|审核|举报|隐藏|下架|分配|处理人|发布|撤回|目录权限|成员权限|负责人/.test(allText));
   const needsLogging = paymentRisk || aiKeyRisk || !isLightweightIndividualMvp && (result.need_logging || matchedRules.some((r) => r.result.need_logging));
   return {
-    canBeFrontendOnly: result.can_be_frontend_only,
+    canBeFrontendOnly: needsBackend ? false : result.can_be_frontend_only,
     needBackend: needsBackend,
     needSeparation: isLightweightIndividualMvp || isLightweightCoveredDomain ? false : result.need_separation,
     recommendedDatabase: isIndividualRegistrationMvp || isLightweightCoveredDomain && domain === "registration" ? "SQLite" : isIndividualDigitalCommerceMvp || isIndividualAppointmentMvp || isIndividualContentCommunityMvp || isIndividualTicketWorkflowMvp || isIndividualKnowledgeBaseMvp || isIndividualCrmMvp || isLightweightCoveredDomain ? "SQLite \u6216 JSON \u6587\u4EF6\u5B58\u50A8" : dbRec,
@@ -26202,6 +26312,7 @@ function hasNegatedPayment2(text) {
 }
 function hasDirectPaymentRisk(text) {
   if (hasNegatedPayment2(text)) return false;
+  if (/(AA|aa|分账|均摊|人均|谁该转给谁|转给谁|转账建议)/.test(text) && /(记账|付款记录|付了多少钱|参与人|本地保存|localStorage|浏览器)/.test(text)) return false;
   return /支付|付款|收费|收款|退款|微信支付|支付宝|在线支付|付费套餐|套餐购买/.test(text);
 }
 
@@ -28286,13 +28397,14 @@ function buildConnectGuide(connectFile, client = "unknown") {
   return {
     configured: false,
     connectUrl,
+    isError: Boolean(connectFile && parsed.warnings.length > 0),
     steps: [
       `\u6253\u5F00 ${connectUrl}`,
       "\u70B9\u51FB\u201C\u751F\u6210\u5E76\u4E0B\u8F7D\u8FDE\u63A5\u6587\u4EF6\u201D\u3002",
       "\u628A\u4E0B\u8F7D\u7684 product-spec-mcp-connect.json \u53D1\u56DE\u5F53\u524D Agent \u5BF9\u8BDD\u3002",
       "\u8BA9 Agent \u8BFB\u53D6\u8FDE\u63A5\u6587\u4EF6\uFF0C\u5E76\u628A instructions.env \u5199\u5165\u5F53\u524D MCP \u914D\u7F6E\u3002"
     ],
-    warnings: [
+    warnings: parsed.warnings.length > 0 ? parsed.warnings : [
       "\u4E0D\u8981\u624B\u52A8\u586B\u5199 token\uFF1B\u8FDE\u63A5\u6587\u4EF6\u4E2D\u5DF2\u7ECF\u5305\u542B\u6240\u9700\u914D\u7F6E\u3002",
       "\u6D4F\u89C8\u5668\u9875\u9762\u4E0D\u80FD\u76F4\u63A5\u4FEE\u6539\u672C\u673A Agent \u914D\u7F6E\uFF0C\u9700\u8981\u628A\u8FDE\u63A5\u6587\u4EF6\u4EA4\u7ED9 Agent \u5B8C\u6210\u3002"
     ]
@@ -30107,16 +30219,19 @@ var ProductSpecConnectOutputSchema = external_exports.object({
   connectUrl: external_exports.string(),
   env: external_exports.record(external_exports.string()).optional(),
   steps: external_exports.array(external_exports.string()),
-  warnings: external_exports.array(external_exports.string())
+  warnings: external_exports.array(external_exports.string()),
+  isError: external_exports.boolean().optional()
 });
 
 // src/tools/productSpecConnect.ts
 function registerProductSpecConnect(server) {
   const handler = async (input) => {
     const result = buildConnectGuide(input.connect_file, input.client || "unknown");
+    const isError = Boolean(input.connect_file && !result.env && result.warnings.length > 0);
     return {
       content: [{ type: "text", text: formatConnectGuide(result) }],
-      structuredContent: result
+      structuredContent: result,
+      isError
     };
   };
   server.registerTool(
@@ -30154,7 +30269,7 @@ function formatConnectGuide(result) {
 function createServer() {
   const server = new McpServer({
     name: "product-spec-mcp",
-    version: "0.4.1"
+    version: "0.4.2"
   });
   registerSpecInterrogate(server);
   registerSpecCompile(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "product-spec-mcp",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "MCP Server for product specification - requirement interrogation, architecture decision, UI translation, debug guidance, and acceptance generation",
   "type": "commonjs",
   "main": "dist/index.cjs",