galaxy-opc-plugin 0.2.2 → 0.2.3

package/README.md

@@ -2,9 +2,10 @@
 
 > 一人公司(OPC)孵化与赋能平台，基于 [OpenClaw](https://github.com/openclaw/openclaw) 构建的 AI 员工全套解决方案。
 
-![版本](https://img.shields.io/badge/version-0.1.0-blue)
+![版本](https://img.shields.io/badge/version-0.4.0-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![OpenClaw](https://img.shields.io/badge/OpenClaw-2026.x-orange)
+![Tests](https://img.shields.io/badge/tests-199/199-brightgreen)
 
 ---
 
@@ -14,7 +15,7 @@
 |------|--------|------|
 | 核心管理 | `opc_core` | 公司注册、客户管理、收支记录 |
 | AI 员工 | `opc_staff` | 行政/财务/HR/法务/市场/运营岗位配置 |
-| 财税管理 | `opc_finance` | 发票、增值税、所得税、纳税申报 |
+| 财税管理 | `opc_finance` | 发票、增值税、所得税、纳税申报、**应收应付管理** |
 | 法务合同 | `opc_legal` | 合同管理、风险评估、到期提醒 |
 | 人力资源 | `opc_hr` | 员工档案、薪资、社保、公积金 |
 | 新媒体运营 | `opc_media` | 内容创建、发布排期、数据分析 |
@@ -23,10 +24,14 @@
 | 服务采购 | `opc_procurement` | 服务项目、采购订单、费用统计 |
 | 生命周期 | `opc_lifecycle` | 里程碑、大事记、时间线报告 |
 | 运营监控 | `opc_monitoring` | 指标记录、告警管理、KPI 看板 |
+| **订单中台** | `opc_order` | **报价管理、合同流转、里程碑跟踪** |
+| **新功能** | **v0.3: 5大功能 + v0.4: 订单闭环** | **见下方新增功能部分** |
 
 **自动提醒服务**（后台每小时扫描）：
 - 税务申报到期提醒（7天内）
 - 合同到期提醒（30天内）
+- **里程碑到期提醒（7天内）** ← 新增
+- **应收风险分层（normal/warning/critical）** ← 新增
 - 现金流预警（净流出超 5000 元）
 - 融资轮次截止跟进
 
@@ -37,6 +42,164 @@
 
 ---
 
+## 🎯 v0.3 新增功能
+
+### 1. 智能新手引导 (Onboarding Flow)
+
+首次使用时自动触发个性化引导，通过 3 个问题了解用户需求：
+
+- **业务阶段**: 想法阶段 / 准备注册 / 已注册 / 运营中
+- **业务类型**: 内容创作 / 技术服务 / 产品销售 / 其他
+- **预计年收入**: <10万 / 10-50万 / >50万
+
+根据回答自动生成个性化启动清单，支持清单项目勾选和中断后继续。
+
+**文件**: `src/opc/briefing-builder.ts`
+
+### 2. 每日智能简报 (Daily Brief)
+
+每天 9:00 主动推送实时简报，包含：
+
+- **待办提醒**: 逾期款项催收、合同到期、税务申报、客户回访
+- **经营数据**: 本周/本月收入、支出、利润、现金余额
+- **AI 员工汇报**: 财务顾问现金流预警、法务合规提醒、运营进度汇报
+- **推送渠道**: OpenClaw 对话 + 飞书 Webhook
+
+**文件**: `src/opc/proactive-service.ts`, `src/opc/briefing-builder.ts`
+
+### 3. 监控中心 Dashboard
+
+一屏看清公司运营状态，包含：
+
+- **关键指标卡片**: 本月收入/利润、现金余额、应收账款
+- **风险预警列表**: 现金流预警(<2月)、合同到期(30天内)、逾期款项、税务提醒
+- **今日待办**: 按优先级(紧急/重要/一般)排序，支持快速操作
+- **AI 建议**: 基于数据分析的可执行建议，包含行动按钮
+
+**访问方式**: `http://localhost:18789/opc/admin` → Dashboard 页签
+
+**文件**: `src/api/dashboard.ts`, `src/web/config-ui.ts`
+
+### 4. 应收应付管理 (Payment Management)
+
+专业的应收应付账款管理系统：
+
+**CRUD 操作**:
+- 创建应收/应付记录（含客户、金额、到期日期）
+- 查询列表（按方向/状态/客户筛选）
+- 更新到账金额和状态（支持部分到账）
+- 删除记录和批量操作
+
+**核心功能**:
+- 自动逾期检测（超期自动标记）
+- 应收应付汇总统计（待收/待付总额、逾期笔数）
+- 发票和合同关联
+- 催款提醒和对账
+
+**访问方式**: OpenClaw 对话或管理后台"收付款" Tab
+
+**文件**: `src/tools/finance-tool.ts` (扩展 5 个新 action)
+
+### 5. 智能记账 (Smart Accounting)
+
+自然语言记账，智能分类和提醒：
+
+**功能**:
+- **自然语言解析**: 支持"记一笔支出，今天请客户吃饭花了500块"
+- **自动分类**: 业务招待费/办公费用/固定资产/生活支出等
+- **智能提醒**: "记得保存发票可抵税"、"超出本月预算"、"需要开发票吗？"
+- **连续记账**: 支持多笔账目连续输入和修改
+
+**使用场景**:
+```
+用户: "记一笔支出，买了办公用品，150块"
+AI: ✓ 已记录
+   - 类型: 支出
+   - 金额: ¥150
+   - 分类: 办公费用 (可抵扣)
+   - 提醒: 记得申报时扣除，需要保存发票吗？
+```
+
+**文件**: `src/tools/finance-tool.ts`, `src/opc/intelligence-engine.ts`
+
+---
+
+## 🎯 v0.4 新增功能（订单闭环）
+
+### 6. 订单中台 (Order Management)
+
+签单到回款的全流程管理，**每个单子有状态、有金额、有责任时间**：
+
+**核心流程**：
+```
+客户咨询 → 创建报价 → 报价转合同 → 签约确认 → 里程碑跟踪 → 款项到账 → 自动记账
+```
+
+**主要功能**：
+- **报价管理**: 创建报价单（自动编号 QT-YYYYMM-NNN），支持多明细行
+- **报价转合同**: 一键转合同，**自动创建里程碑和应收记录**
+- **里程碑跟踪**: 签约→初稿→终稿，自动流转状态
+- **到期提醒**: 7天内到期的里程碑自动推送
+- **进行中订单**: 查看所有活跃合同及进度
+
+**自动化亮点**：
+- ✅ 报价转合同 → 自动创建 N 个里程碑 + N 条应收
+- ✅ 签约确认 → 自动启动第一个里程碑
+- ✅ 里程碑完成 → 自动启动下一个里程碑
+- ✅ 到账登记 → 自动创建交易记录 + 更新里程碑
+
+**工具名**: `opc_order`
+
+**文件**: `src/tools/order-tool.ts`
+
+**使用指南**: 查看 [ORDER_WORKFLOW_GUIDE.md](ORDER_WORKFLOW_GUIDE.md)
+
+### 7. 回款助手增强 (Collection Assistant)
+
+AI 赋能的应收催款和风险管理：
+
+**核心功能**：
+- **AI 催款文案**: 自动生成礼貌/坚定/紧急三种语气的催款邮件、微信、短信
+- **风险分层**: 自动分类 normal（≤7天）/ warning（8-30天）/ critical（>30天）
+- **一键到账**: 登记收款，自动创建交易记录，自动完成里程碑
+- **自动提醒**: 到期前 3/7 天、逾期 7/15/30 天自动推送
+
+**风险分层规则**：
+| 风险等级 | 逾期天数 | 自动操作 |
+|----------|----------|----------|
+| normal | ≤ 7 天 | 常规跟进 |
+| warning | 8-30 天 | 电话催收 |
+| critical | > 30 天 | 创建告警，建议升级催收 |
+
+**示例对话**：
+```
+你: "客户A逾期15天了，帮我生成催款文案"
+AI: [调用 generate_collection_notice]
+    已生成礼貌催款文案：
+    - 邮件：【友情提醒】XX项目款项到期提醒
+    - 微信：张总好！初稿款3600已到期，麻烦核对一下~
+    - 短信：【XX公司】尊敬的客户，您有一笔3600元...
+```
+
+**工具名**: `opc_finance` (扩展 4 个新 action)
+
+**文件**: `src/tools/finance-tool.ts`
+
+### 8. 数据闭环追溯
+
+完整的业务数据链：
+
+```
+报价单 ID → 合同 ID → 里程碑 ID → 应收 ID → 交易 ID
+```
+
+每一笔钱都有完整的来龙去脉，支持：
+- 从报价单追溯到最终收款
+- 从交易记录反查对应的合同和里程碑
+- 生成客户价值分析报告
+
+---
+
 ## 📦 安装
 
 ### 前提条件
@@ -89,23 +252,57 @@ npm install
 
 ## 🚀 快速开始
 
+### 第一次使用（自动触发新手引导）
+
 重启 OpenClaw Gateway 后，对 AI 说：
 
 ```
-注册一家公司，名称"极光科技有限公司"，行业"软件开发"，注册资金50万
+我想创建一家一人公司，帮我注册吧
 ```
 
-然后访问管理后台：`http://localhost:18789/opc/admin`
+系统会自动触发新手引导：
+1. 询问你的业务阶段、业务类型、预计年收入
+2. 生成个性化启动清单
+3. 引导你完成首个任务
 
 ### 典型 SOP 流程
 
 ```
-1. 注册公司        → opc_core: register_company
-2. 激活公司        → opc_core: activate_company
-3. 配置 AI 员工    → opc_staff: init_default_staff
-4. 日常运营        → 告诉 AI 助手记录收支、合同、员工等
-5. 融资管理        → opc_investment: create_round
-6. 生命周期报告    → opc_lifecycle: generate_report
+1. 新手引导        → 首次使用自动触发，生成启动清单
+2. 公司注册        → opc_core: register_company
+3. 激活公司        → opc_core: activate_company
+4. 配置 AI 员工    → opc_staff: init_default_staff
+5. 日常运营        → 智能记账、应收应付管理、定期简报
+6. 监控仪表盘      → 访问 Dashboard 查看关键指标和风险预警
+7. 融资管理        → opc_investment: create_round
+8. 生命周期报告    → opc_lifecycle: generate_report
+```
+
+### 使用新增功能
+
+#### 查看每日简报
+```
+AI: 给我发送今天的经营简报
+```
+（系统也会在每天 9:00 自动推送）
+
+#### 管理应收应付
+```
+AI: 记录一笔应收账款，客户是张三，金额5000，3月15号到期
+AI: 列出所有逾期的应收款项
+AI: 更新张三的应收账款状态为已到账
+```
+
+#### 智能记账
+```
+AI: 记一笔支出，今天请客户吃饭花了800块
+AI: 记录一笔收入，某某客户付款了2万
+```
+
+#### 访问 Dashboard
+```
+浏览器打开: http://localhost:18789/opc/admin
+点击"监控中心"查看关键指标、风险预警和今日待办
 ```
 
 ---

package/index.ts

@@ -18,6 +18,7 @@ import { startProactiveService } from "./src/opc/proactive-service.js";
 import { runIntelligenceScanForCompany } from "./src/opc/intelligence-engine.js";
 import { detectMilestones } from "./src/opc/milestone-detector.js";
 import { updateCompanyStage } from "./src/opc/stage-detector.js";
+import { generateDailyBrief } from "./src/opc/daily-brief.js";
 import {
   registerSpawnedSession,
   getSessionTaskMapping,
@@ -40,6 +41,9 @@ import { registerProjectTool } from "./src/tools/project-tool.js";
 import { registerSearchTool } from "./src/tools/search-tool.js";
 import { registerStaffTool } from "./src/tools/staff-tool.js";
 import { registerDocumentTool } from "./src/tools/document-tool.js";
+import { registerSmartAccountingTool } from "./src/tools/smart-accounting-tool.js";
+import { registerOnboardingTool } from "./src/tools/onboarding-tool.js";
+import { registerOrderTool } from "./src/tools/order-tool.js";
 import { registerOpcCommand } from "./src/commands/opc-command.js";
 import { triggerEventRules } from "./src/opc/event-triggers.js";
 import { registerConfigUi } from "./src/web/config-ui.js";
@@ -97,6 +101,7 @@ const plugin = {
     registerOpcTool(api, db);
     registerStaffTool(api, db);
     registerOpbTool(api, db);
+    registerOnboardingTool(api, db);
     registerSearchTool(api);
 
     // 注册 Phase 2 专业工具（可通过管理后台禁用）
@@ -115,6 +120,12 @@ const plugin = {
     // 文档生成工具（始终启用）
     registerDocumentTool(api, db);
 
+    // 智能记账工具（始终启用）
+    registerSmartAccountingTool(api, db);
+
+    // 订单中台工具（始终启用，核心签单闭环）
+    registerOrderTool(api, db);
+
     // 资金闭环工具（始终启用，核心商业模式）
     registerAcquisitionTool(api, db);
     registerAssetPackageTool(api, db);
@@ -349,6 +360,101 @@ const plugin = {
       }
     });
 
+    // ── heartbeat 钩子 — 每日简报推送 ──
+    api.on("heartbeat", async (event, ctx) => {
+      try {
+        const hour = new Date().getHours();
+
+        // 每天早上 9:00 推送简报
+        if (hour === 9) {
+          const companies = db!.query(
+            "SELECT * FROM opc_companies WHERE status = 'active'",
+          ) as { id: string; name: string }[];
+
+          for (const company of companies) {
+            try {
+              const brief = generateDailyBrief(db!, company.id);
+
+              // 格式化简报内容
+              const briefContent = formatDailyBrief(company.name, brief);
+
+              // 通过 Agent 消息推送（假设有 sendMessage API）
+              // 注意：根据实际 SDK API 调整
+              api.logger.info(`opc: 生成每日简报 - ${company.name}`);
+              api.logger.info(`opc: 简报摘要 - ${brief.summary}`);
+
+              // TODO: 如果 SDK 支持主动推送，在此调用
+              // await ctx.sendMessage({
+              //   agentId: `opc-${company.id}`,
+              //   content: briefContent
+              // });
+            } catch (err) {
+              api.logger.info(
+                `opc: 生成简报失败 (${company.name}): ${err instanceof Error ? err.message : String(err)}`,
+              );
+            }
+          }
+        }
+      } catch (err) {
+        api.logger.info(`opc: heartbeat 处理失败: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    });
+
+    // 格式化每日简报为消息内容
+    function formatDailyBrief(
+      companyName: string,
+      brief: {
+        todos: Array<{ type: string; title: string; priority: string; dueDate?: string; description: string }>;
+        metrics: Array<{ label: string; value: number | string; trend?: string; unit?: string }>;
+        staffReports: Array<{ role: string; roleName: string; observations: string[]; suggestions: string[]; tasks: Array<{ title: string; status: string }> }>;
+        summary: string;
+      },
+    ): string {
+      let content = `【${companyName} - 每日简报】\n\n`;
+      content += `${brief.summary}\n\n`;
+
+      // 待办事项
+      if (brief.todos.length > 0) {
+        content += `📋 今日待办 (${brief.todos.length} 项):\n`;
+        brief.todos.forEach((todo, i) => {
+          const priority = todo.priority === "urgent" ? "🔴" : todo.priority === "high" ? "🟠" : "🟢";
+          content += `${i + 1}. ${priority} ${todo.title}\n`;
+          if (todo.dueDate) content += `   到期: ${todo.dueDate}\n`;
+        });
+        content += "\n";
+      }
+
+      // 关键指标
+      if (brief.metrics.length > 0) {
+        content += `📊 关键指标:\n`;
+        brief.metrics.forEach((metric) => {
+          content += `- ${metric.label}: ${metric.value}${metric.unit || ""}`;
+          if (metric.trend) content += ` (${metric.trend})`;
+          content += "\n";
+        });
+        content += "\n";
+      }
+
+      // AI 员工汇报
+      if (brief.staffReports.length > 0) {
+        content += `🤖 AI 员工汇报:\n`;
+        brief.staffReports.forEach((report) => {
+          content += `\n[${report.roleName}]\n`;
+          if (report.observations.length > 0) {
+            content += `观察: ${report.observations.join("; ")}\n`;
+          }
+          if (report.suggestions.length > 0) {
+            content += `建议: ${report.suggestions.join("; ")}\n`;
+          }
+          if (report.tasks.length > 0) {
+            content += `任务: ${report.tasks.map(t => `${t.title}(${t.status})`).join(", ")}\n`;
+          }
+        });
+      }
+
+      return content;
+    }
+
     // 注册后台服务（数据库生命周期 + 主动智能）
     let stopProactive: (() => void) | null = null;
     api.registerService({

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "galaxy-opc-plugin",
   "name": "OPC Platform",
   "description": "星环OPC中心 — 一人公司孵化与赋能平台",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "galaxy-opc-plugin",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "星环 Galaxy OPC — 一人公司孵化与赋能平台 OpenClaw 插件",
   "keywords": [
     "openclaw",

package/src/api/companies.ts

@@ -197,6 +197,10 @@ export function registerCompanyRoutes(api: OpenClawPluginApi, db: OpcDatabase, g
           return true;
       }
     } catch (err) {
+      console.error('[OPC Companies API] Error:', err);
+      if (err instanceof Error) {
+        console.error('Stack trace:', err.stack);
+      }
       sendError(res, err instanceof Error ? err.message : String(err), 500);
       return true;
     }