galaxy-opc-plugin 0.2.1 → 0.2.3

package/src/tools/hr-tool.ts

@@ -5,6 +5,7 @@
 import { Type, type Static } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { OpcDatabase } from "../db/index.js";
+import { BusinessWorkflows } from "../opc/business-workflows.js";
 import { json, toolError } from "../utils/tool-helper.js";
 
 const HrSchema = Type.Union([
@@ -129,7 +130,15 @@ export function registerHrTool(api: OpenClawPluginApi, db: OpcDatabase): void {
                 p.contract_type ?? "full_time",
                 p.notes ?? "", now, now,
               );
-              return json(db.queryOne("SELECT * FROM opc_hr_records WHERE id = ?", id));
+              // 业务闭环：自动记里程碑
+              const workflows = new BusinessWorkflows(db);
+              const autoCreated = workflows.afterEmployeeAdded({
+                id, company_id: p.company_id, employee_name: p.employee_name,
+                position: p.position, contract_type: p.contract_type ?? "full_time",
+                salary: p.salary,
+              });
+              const record = db.queryOne("SELECT * FROM opc_hr_records WHERE id = ?", id);
+              return json({ ...record as object, _auto_created: autoCreated });
             }
 
             case "list_employees": {

package/src/tools/legal-tool.test.ts

@@ -0,0 +1,251 @@
+/**
+ * 星环OPC中心 — legal-tool 集成测试
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { createTestDb, insertTestCompany, factories } from "../__tests__/test-utils.js";
+import { SqliteAdapter } from "../db/sqlite-adapter.js";
+
+describe("legal-tool database integration", () => {
+  let db: SqliteAdapter;
+  let companyId: string;
+
+  beforeEach(() => {
+    db = createTestDb();
+    companyId = insertTestCompany(db);
+  });
+
+  afterEach(() => {
+    db.close();
+  });
+
+  describe("create_contract", () => {
+    it("should create a contract successfully", () => {
+      const contractData = factories.contract(companyId, {
+        title: "技术服务合同",
+        counterparty: "客户A",
+        contract_type: "service",
+        amount: 100000,
+      });
+
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_contracts
+         (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, contractData.company_id, contractData.title, contractData.counterparty,
+        contractData.contract_type, contractData.amount, contractData.start_date,
+        contractData.end_date, contractData.status, contractData.key_terms,
+        contractData.risk_notes, contractData.reminder_date, now, now
+      );
+
+      const contract = db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id) as any;
+      expect(contract).not.toBeNull();
+      expect(contract.title).toBe("技术服务合同");
+      expect(contract.amount).toBe(100000);
+      expect(contract.status).toBe("active");
+    });
+
+    it("should handle contract without amount", () => {
+      const contractData = factories.contract(companyId, {
+        title: "保密协议",
+        contract_type: "NDA",
+        amount: 0,
+      });
+
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_contracts
+         (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, contractData.company_id, contractData.title, contractData.counterparty,
+        contractData.contract_type, contractData.amount, contractData.start_date,
+        contractData.end_date, contractData.status, contractData.key_terms,
+        contractData.risk_notes, contractData.reminder_date, now, now
+      );
+
+      const contract = db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id) as any;
+      expect(contract.amount).toBe(0);
+      expect(contract.contract_type).toBe("NDA");
+    });
+
+    it("should create multiple contracts for same company", () => {
+      const contract1 = factories.contract(companyId, { title: "合同1" });
+      const contract2 = factories.contract(companyId, { title: "合同2" });
+      const now = new Date().toISOString();
+
+      [contract1, contract2].forEach((c) => {
+        const id = db.genId();
+        db.execute(
+          `INSERT INTO opc_contracts
+           (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          id, c.company_id, c.title, c.counterparty, c.contract_type, c.amount,
+          c.start_date, c.end_date, c.status, c.key_terms, c.risk_notes, c.reminder_date, now, now
+        );
+      });
+
+      const contracts = db.query("SELECT * FROM opc_contracts WHERE company_id = ?", companyId) as any[];
+      expect(contracts.length).toBe(2);
+    });
+  });
+
+  describe("list_contracts", () => {
+    it("should list all contracts for a company", () => {
+      // Create 3 contracts
+      for (let i = 0; i < 3; i++) {
+        const contract = factories.contract(companyId, { title: `合同${i + 1}` });
+        const id = db.genId();
+        const now = new Date().toISOString();
+        db.execute(
+          `INSERT INTO opc_contracts
+           (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          id, contract.company_id, contract.title, contract.counterparty,
+          contract.contract_type, contract.amount, contract.start_date,
+          contract.end_date, contract.status, contract.key_terms,
+          contract.risk_notes, contract.reminder_date, now, now
+        );
+      }
+
+      const contracts = db.query("SELECT * FROM opc_contracts WHERE company_id = ?", companyId) as any[];
+      expect(contracts.length).toBe(3);
+    });
+
+    it("should filter contracts by status", () => {
+      const activeContract = factories.contract(companyId, { status: "active" });
+      const expiredContract = factories.contract(companyId, { status: "expired" });
+      const now = new Date().toISOString();
+
+      [activeContract, expiredContract].forEach((c) => {
+        const id = db.genId();
+        db.execute(
+          `INSERT INTO opc_contracts
+           (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          id, c.company_id, c.title, c.counterparty, c.contract_type, c.amount,
+          c.start_date, c.end_date, c.status, c.key_terms, c.risk_notes, c.reminder_date, now, now
+        );
+      });
+
+      const activeContracts = db.query(
+        "SELECT * FROM opc_contracts WHERE company_id = ? AND status = ?",
+        companyId, "active"
+      ) as any[];
+      expect(activeContracts.length).toBe(1);
+      expect(activeContracts[0].status).toBe("active");
+    });
+  });
+
+  describe("update_contract", () => {
+    it("should update contract status", () => {
+      const contract = factories.contract(companyId);
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_contracts
+         (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, contract.company_id, contract.title, contract.counterparty,
+        contract.contract_type, contract.amount, contract.start_date,
+        contract.end_date, contract.status, contract.key_terms,
+        contract.risk_notes, contract.reminder_date, now, now
+      );
+
+      db.execute(
+        "UPDATE opc_contracts SET status = ?, updated_at = ? WHERE id = ?",
+        "terminated", now, id
+      );
+
+      const updated = db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id) as any;
+      expect(updated.status).toBe("terminated");
+    });
+
+    it("should update risk notes", () => {
+      const contract = factories.contract(companyId);
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_contracts
+         (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, contract.company_id, contract.title, contract.counterparty,
+        contract.contract_type, contract.amount, contract.start_date,
+        contract.end_date, contract.status, contract.key_terms,
+        contract.risk_notes, contract.reminder_date, now, now
+      );
+
+      const newRiskNotes = "需注意付款条款";
+      db.execute(
+        "UPDATE opc_contracts SET risk_notes = ?, updated_at = ? WHERE id = ?",
+        newRiskNotes, now, id
+      );
+
+      const updated = db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id) as any;
+      expect(updated.risk_notes).toBe(newRiskNotes);
+    });
+  });
+
+  describe("delete_contract", () => {
+    it("should delete a contract", () => {
+      const contract = factories.contract(companyId);
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_contracts
+         (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, contract.company_id, contract.title, contract.counterparty,
+        contract.contract_type, contract.amount, contract.start_date,
+        contract.end_date, contract.status, contract.key_terms,
+        contract.risk_notes, contract.reminder_date, now, now
+      );
+
+      db.execute("DELETE FROM opc_contracts WHERE id = ?", id);
+
+      const deleted = db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id);
+      expect(deleted).toBeNull();
+    });
+  });
+
+  describe("contract expiration detection", () => {
+    it("should detect expiring contracts", () => {
+      const futureDate = new Date();
+      futureDate.setDate(futureDate.getDate() + 10);
+      const reminderDate = futureDate.toISOString().split("T")[0];
+
+      const contract = factories.contract(companyId, {
+        reminder_date: reminderDate,
+        status: "active",
+      });
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_contracts
+         (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, contract.company_id, contract.title, contract.counterparty,
+        contract.contract_type, contract.amount, contract.start_date,
+        contract.end_date, contract.status, contract.key_terms,
+        contract.risk_notes, contract.reminder_date, now, now
+      );
+
+      const expiringSoon = db.query(
+        `SELECT * FROM opc_contracts
+         WHERE company_id = ? AND status = 'active'
+         AND reminder_date <= date('now', '+30 days')`,
+        companyId
+      ) as any[];
+
+      expect(expiringSoon.length).toBe(1);
+    });
+  });
+});

package/src/tools/legal-tool.ts

@@ -5,6 +5,7 @@
 import { Type, type Static } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { OpcDatabase } from "../db/index.js";
+import { BusinessWorkflows, VALID_DIRECTIONS } from "../opc/business-workflows.js";
 import { json, toolError } from "../utils/tool-helper.js";
 
 const LegalSchema = Type.Union([
@@ -14,6 +15,9 @@ const LegalSchema = Type.Union([
     title: Type.String({ description: "合同标题" }),
     counterparty: Type.String({ description: "签约对方" }),
     contract_type: Type.String({ description: "合同类型: 服务合同/采购合同/劳动合同/租赁合同/合作协议/NDA/其他" }),
+    direction: Type.Optional(Type.String({
+      description: "合同方向: sales(我方提供服务/产品,收钱) | procurement(我方采购,付钱) | outsourcing(外包/劳务) | partnership(合作协议)"
+    })),
     amount: Type.Optional(Type.Number({ description: "合同金额（元）" })),
     start_date: Type.Optional(Type.String({ description: "起始日期 (YYYY-MM-DD)" })),
     end_date: Type.Optional(Type.String({ description: "结束日期 (YYYY-MM-DD)" })),
@@ -102,14 +106,32 @@ export function registerLegalTool(api: OpenClawPluginApi, db: OpcDatabase): void
             case "create_contract": {
               const id = db.genId();
               const now = new Date().toISOString();
+              const direction = p.direction || "sales";
+              // 校验 direction 合法性
+              if (!BusinessWorkflows.validateDirection(direction)) {
+                return toolError(
+                  `无效的合同方向「${direction}」，合法值: ${VALID_DIRECTIONS.join(", ")}`,
+                  "INVALID_DIRECTION",
+                );
+              }
               db.execute(
-                `INSERT INTO opc_contracts (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
-                 VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'draft', ?, ?, ?, ?, ?)`,
-                id, p.company_id, p.title, p.counterparty, p.contract_type,
+                `INSERT INTO opc_contracts (id, company_id, title, counterparty, contract_type, direction, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+                 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'draft', ?, ?, ?, ?, ?)`,
+                id, p.company_id, p.title, p.counterparty, p.contract_type, direction,
                 p.amount ?? 0, p.start_date ?? "", p.end_date ?? "",
                 p.key_terms ?? "", p.risk_notes ?? "", p.reminder_date ?? "", now, now,
               );
-              return json(db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id));
+              // 业务闭环：自动创建关联记录
+              const workflows = new BusinessWorkflows(db);
+              const autoCreated = workflows.afterContractCreated({
+                id, company_id: p.company_id, title: p.title,
+                counterparty: p.counterparty, contract_type: p.contract_type,
+                direction,
+                amount: p.amount ?? 0,
+                start_date: p.start_date ?? "", end_date: p.end_date ?? "",
+              });
+              const contract = db.queryOne("SELECT * FROM opc_contracts WHERE id = ?", id);
+              return json({ ...contract as object, _auto_created: autoCreated });
             }
 
             case "list_contracts": {

package/src/tools/lifecycle-tool.test.ts

@@ -0,0 +1,231 @@
+/**
+ * 星环OPC中心 — lifecycle-tool 集成测试
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { createTestDb, insertTestCompany } from "../__tests__/test-utils.js";
+import { SqliteAdapter } from "../db/sqlite-adapter.js";
+
+describe("lifecycle-tool database integration", () => {
+  let db: SqliteAdapter;
+  let companyId: string;
+
+  beforeEach(() => {
+    db = createTestDb();
+    companyId = insertTestCompany(db);
+  });
+
+  afterEach(() => {
+    db.close();
+  });
+
+  describe("company status transitions", () => {
+    it("should transition from pending to active", () => {
+      const company = db.getCompany(companyId);
+      expect(company).not.toBeNull();
+
+      db.execute(
+        "UPDATE opc_companies SET status = ?, updated_at = ? WHERE id = ?",
+        "active", new Date().toISOString(), companyId
+      );
+
+      const updated = db.getCompany(companyId);
+      expect(updated!.status).toBe("active");
+    });
+
+    it("should transition from active to suspended", () => {
+      db.execute(
+        "UPDATE opc_companies SET status = ?, updated_at = ? WHERE id = ?",
+        "suspended", new Date().toISOString(), companyId
+      );
+
+      const updated = db.getCompany(companyId);
+      expect(updated!.status).toBe("suspended");
+    });
+
+    it("should transition from active to acquired", () => {
+      db.execute(
+        "UPDATE opc_companies SET status = ?, updated_at = ? WHERE id = ?",
+        "acquired", new Date().toISOString(), companyId
+      );
+
+      const updated = db.getCompany(companyId);
+      expect(updated!.status).toBe("acquired");
+    });
+
+    it("should transition from acquired to packaged", () => {
+      db.execute(
+        "UPDATE opc_companies SET status = ?, updated_at = ? WHERE id = ?",
+        "packaged", new Date().toISOString(), companyId
+      );
+
+      const updated = db.getCompany(companyId);
+      expect(updated!.status).toBe("packaged");
+    });
+
+    it("should transition to terminated", () => {
+      db.execute(
+        "UPDATE opc_companies SET status = ?, updated_at = ? WHERE id = ?",
+        "terminated", new Date().toISOString(), companyId
+      );
+
+      const updated = db.getCompany(companyId);
+      expect(updated!.status).toBe("terminated");
+    });
+  });
+
+  describe("milestone tracking", () => {
+    it("should record first transaction milestone", () => {
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      // Schema uses: title, category, target_date, completed_date, status
+      db.execute(
+        `INSERT INTO opc_milestones (id, company_id, title, category, description, completed_date, status, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, companyId, "首笔交易", "business", "首笔交易完成", "2026-01-15", "completed", now
+      );
+
+      const milestones = db.query(
+        "SELECT * FROM opc_milestones WHERE company_id = ?",
+        companyId
+      ) as any[];
+      expect(milestones.length).toBe(1);
+      expect(milestones[0].title).toBe("首笔交易");
+    });
+
+    it("should record profitability milestone", () => {
+      const id = db.genId();
+      const now = new Date().toISOString();
+
+      db.execute(
+        `INSERT INTO opc_milestones (id, company_id, title, category, description, completed_date, status, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, companyId, "首次盈利", "financial", "实现首次盈利", "2026-02-01", "completed", now
+      );
+
+      const milestones = db.query(
+        "SELECT * FROM opc_milestones WHERE company_id = ? AND title = ?",
+        companyId, "首次盈利"
+      ) as any[];
+      expect(milestones.length).toBe(1);
+    });
+
+    it("should track multiple milestones", () => {
+      const milestoneData = [
+        { title: "首笔交易", category: "business" },
+        { title: "首次盈利", category: "financial" },
+        { title: "首位员工", category: "hr" },
+      ];
+      const now = new Date().toISOString();
+
+      milestoneData.forEach((data) => {
+        const id = db.genId();
+        db.execute(
+          `INSERT INTO opc_milestones (id, company_id, title, category, description, completed_date, status, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+          id, companyId, data.title, data.category, `Milestone: ${data.title}`, "2026-01-15", "completed", now
+        );
+      });
+
+      const milestones = db.query(
+        "SELECT * FROM opc_milestones WHERE company_id = ?",
+        companyId
+      ) as any[];
+      expect(milestones.length).toBe(3);
+    });
+  });
+
+  describe("stage detection", () => {
+    it("should identify startup stage (new company)", () => {
+      const company = db.getCompany(companyId);
+      expect(company).not.toBeNull();
+
+      // No transactions yet - startup stage
+      const transactions = db.query(
+        "SELECT * FROM opc_transactions WHERE company_id = ?",
+        companyId
+      ) as any[];
+      expect(transactions.length).toBe(0);
+    });
+
+    it("should identify growth stage (has revenue)", () => {
+      // Add revenue transactions
+      for (let i = 0; i < 3; i++) {
+        const id = db.genId();
+        db.execute(
+          `INSERT INTO opc_transactions (id, company_id, type, category, amount, description, counterparty, transaction_date, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`,
+          id, companyId, "income", "service_income", 50000, "销售收入", "客户A", "2026-01-15"
+        );
+      }
+
+      const transactions = db.query(
+        "SELECT * FROM opc_transactions WHERE company_id = ? AND type = 'income'",
+        companyId
+      ) as any[];
+      expect(transactions.length).toBeGreaterThan(0);
+    });
+
+    it("should identify maturity stage (consistent profit)", () => {
+      // Simulate 6 months of profitable transactions
+      for (let month = 1; month <= 6; month++) {
+        const incomeId = db.genId();
+        const expenseId = db.genId();
+
+        db.execute(
+          `INSERT INTO opc_transactions (id, company_id, type, category, amount, description, counterparty, transaction_date, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`,
+          incomeId, companyId, "income", "service_income", 100000, "月收入", "客户", `2026-0${month}-15`
+        );
+
+        db.execute(
+          `INSERT INTO opc_transactions (id, company_id, type, category, amount, description, counterparty, transaction_date, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`,
+          expenseId, companyId, "expense", "salary", 30000, "月支出", "员工", `2026-0${month}-20`
+        );
+      }
+
+      const summary = db.queryOne(
+        `SELECT
+           COALESCE(SUM(CASE WHEN type = 'income' THEN amount ELSE 0 END), 0) as total_income,
+           COALESCE(SUM(CASE WHEN type = 'expense' THEN amount ELSE 0 END), 0) as total_expense
+         FROM opc_transactions WHERE company_id = ?`,
+        companyId
+      ) as any;
+
+      expect(summary.total_income).toBeGreaterThan(summary.total_expense);
+    });
+  });
+
+  describe("health metrics", () => {
+    it("should calculate company health score", () => {
+      // Add some positive indicators
+      const incomeId = db.genId();
+      db.execute(
+        `INSERT INTO opc_transactions (id, company_id, type, category, amount, description, counterparty, transaction_date, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`,
+        incomeId, companyId, "income", "service_income", 200000, "销售", "客户", "2026-01-15"
+      );
+
+      const contractId = db.genId();
+      const now = new Date().toISOString();
+      db.execute(
+        `INSERT INTO opc_contracts (id, company_id, title, counterparty, contract_type, amount, start_date, end_date, status, key_terms, risk_notes, reminder_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        contractId, companyId, "服务合同", "客户A", "service", 100000, "2026-01-01", "2026-12-31", "active", "", "", "2026-11-30", now, now
+      );
+
+      const metrics = db.queryOne(
+        `SELECT
+           (SELECT COUNT(*) FROM opc_transactions WHERE company_id = ? AND type = 'income') as income_count,
+           (SELECT COUNT(*) FROM opc_contracts WHERE company_id = ? AND status = 'active') as active_contracts
+         FROM opc_companies WHERE id = ?`,
+        companyId, companyId, companyId
+      ) as any;
+
+      expect(metrics.income_count).toBeGreaterThan(0);
+      expect(metrics.active_contracts).toBeGreaterThan(0);
+    });
+  });
+});