galaxy-opc-plugin 0.1.1 → 0.2.0

package/src/opc/company-manager.test.ts

@@ -0,0 +1,232 @@
+/**
+ * 星环OPC中心 — CompanyManager 单元测试
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { SqliteAdapter } from "../db/sqlite-adapter.js";
+import { CompanyManager } from "./company-manager.js";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+describe("CompanyManager", () => {
+  let db: SqliteAdapter;
+  let manager: CompanyManager;
+  let dbPath: string;
+
+  beforeEach(() => {
+    dbPath = path.join(os.tmpdir(), `opc-test-${Date.now()}-${Math.random().toString(36).slice(2)}.db`);
+    db = new SqliteAdapter(dbPath);
+    manager = new CompanyManager(db);
+  });
+
+  afterEach(() => {
+    db.close();
+    try { fs.unlinkSync(dbPath); } catch { /* ignore */ }
+    try { fs.unlinkSync(dbPath + "-wal"); } catch { /* ignore */ }
+    try { fs.unlinkSync(dbPath + "-shm"); } catch { /* ignore */ }
+  });
+
+  describe("registerCompany", () => {
+    it("should create a company with pending status", () => {
+      const company = manager.registerCompany({
+        name: "测试科技",
+        industry: "互联网",
+        owner_name: "张三",
+      });
+      expect(company.id).toBeDefined();
+      expect(company.name).toBe("测试科技");
+      expect(company.industry).toBe("互联网");
+      expect(company.owner_name).toBe("张三");
+      expect(company.status).toBe("pending");
+      expect(company.registered_capital).toBe(0);
+    });
+
+    it("should accept optional fields", () => {
+      const company = manager.registerCompany({
+        name: "优质公司",
+        industry: "教育",
+        owner_name: "李四",
+        owner_contact: "13800138000",
+        registered_capital: 500000,
+        description: "在线教育平台",
+      });
+      expect(company.owner_contact).toBe("13800138000");
+      expect(company.registered_capital).toBe(500000);
+      expect(company.description).toBe("在线教育平台");
+    });
+  });
+
+  describe("getCompany", () => {
+    it("should return a company by id", () => {
+      const created = manager.registerCompany({
+        name: "查询测试",
+        industry: "零售",
+        owner_name: "王五",
+      });
+      const found = manager.getCompany(created.id);
+      expect(found).not.toBeNull();
+      expect(found!.name).toBe("查询测试");
+    });
+
+    it("should return null for non-existent id", () => {
+      expect(manager.getCompany("non-existent")).toBeNull();
+    });
+  });
+
+  describe("listCompanies", () => {
+    it("should list all companies", () => {
+      manager.registerCompany({ name: "A公司", industry: "IT", owner_name: "A" });
+      manager.registerCompany({ name: "B公司", industry: "金融", owner_name: "B" });
+      const list = manager.listCompanies();
+      expect(list.length).toBe(2);
+    });
+
+    it("should filter by status", () => {
+      const c = manager.registerCompany({ name: "C公司", industry: "IT", owner_name: "C" });
+      manager.registerCompany({ name: "D公司", industry: "IT", owner_name: "D" });
+      manager.activateCompany(c.id);
+      expect(manager.listCompanies("active").length).toBe(1);
+      expect(manager.listCompanies("pending").length).toBe(1);
+    });
+  });
+
+  describe("activateCompany", () => {
+    it("should transition pending → active", () => {
+      const c = manager.registerCompany({ name: "激活测试", industry: "IT", owner_name: "X" });
+      expect(c.status).toBe("pending");
+      const activated = manager.activateCompany(c.id);
+      expect(activated).not.toBeNull();
+      expect(activated!.status).toBe("active");
+    });
+
+    it("should return null for non-existent company", () => {
+      expect(manager.activateCompany("fake-id")).toBeNull();
+    });
+  });
+
+  describe("transitionStatus — valid transitions", () => {
+    it("pending → active", () => {
+      const c = manager.registerCompany({ name: "T1", industry: "IT", owner_name: "X" });
+      const result = manager.transitionStatus(c.id, "active");
+      expect(result!.status).toBe("active");
+    });
+
+    it("pending → terminated", () => {
+      const c = manager.registerCompany({ name: "T2", industry: "IT", owner_name: "X" });
+      const result = manager.transitionStatus(c.id, "terminated");
+      expect(result!.status).toBe("terminated");
+    });
+
+    it("active → suspended", () => {
+      const c = manager.registerCompany({ name: "T3", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      const result = manager.transitionStatus(c.id, "suspended");
+      expect(result!.status).toBe("suspended");
+    });
+
+    it("active → acquired", () => {
+      const c = manager.registerCompany({ name: "T4", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      const result = manager.transitionStatus(c.id, "acquired");
+      expect(result!.status).toBe("acquired");
+    });
+
+    it("active → packaged", () => {
+      const c = manager.registerCompany({ name: "T5", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      const result = manager.transitionStatus(c.id, "packaged");
+      expect(result!.status).toBe("packaged");
+    });
+
+    it("active → terminated", () => {
+      const c = manager.registerCompany({ name: "T6", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      const result = manager.transitionStatus(c.id, "terminated");
+      expect(result!.status).toBe("terminated");
+    });
+
+    it("suspended → active", () => {
+      const c = manager.registerCompany({ name: "T7", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      manager.transitionStatus(c.id, "suspended");
+      const result = manager.transitionStatus(c.id, "active");
+      expect(result!.status).toBe("active");
+    });
+
+    it("suspended → terminated", () => {
+      const c = manager.registerCompany({ name: "T8", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      manager.transitionStatus(c.id, "suspended");
+      const result = manager.transitionStatus(c.id, "terminated");
+      expect(result!.status).toBe("terminated");
+    });
+
+    it("acquired → terminated", () => {
+      const c = manager.registerCompany({ name: "T9", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      manager.transitionStatus(c.id, "acquired");
+      const result = manager.transitionStatus(c.id, "terminated");
+      expect(result!.status).toBe("terminated");
+    });
+
+    it("packaged → terminated", () => {
+      const c = manager.registerCompany({ name: "T10", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      manager.transitionStatus(c.id, "packaged");
+      const result = manager.transitionStatus(c.id, "terminated");
+      expect(result!.status).toBe("terminated");
+    });
+  });
+
+  describe("transitionStatus — invalid transitions", () => {
+    it("pending → suspended should throw", () => {
+      const c = manager.registerCompany({ name: "E1", industry: "IT", owner_name: "X" });
+      expect(() => manager.transitionStatus(c.id, "suspended")).toThrow();
+    });
+
+    it("pending → acquired should throw", () => {
+      const c = manager.registerCompany({ name: "E2", industry: "IT", owner_name: "X" });
+      expect(() => manager.transitionStatus(c.id, "acquired")).toThrow();
+    });
+
+    it("terminated → active should throw", () => {
+      const c = manager.registerCompany({ name: "E3", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "terminated");
+      expect(() => manager.transitionStatus(c.id, "active")).toThrow(/不允许/);
+    });
+
+    it("acquired → active should throw", () => {
+      const c = manager.registerCompany({ name: "E4", industry: "IT", owner_name: "X" });
+      manager.transitionStatus(c.id, "active");
+      manager.transitionStatus(c.id, "acquired");
+      expect(() => manager.transitionStatus(c.id, "active")).toThrow();
+    });
+  });
+
+  describe("updateCompany", () => {
+    it("should update company fields", () => {
+      const c = manager.registerCompany({ name: "更新测试", industry: "IT", owner_name: "X" });
+      const updated = manager.updateCompany(c.id, { name: "新名称", industry: "金融" });
+      expect(updated).not.toBeNull();
+      expect(updated!.name).toBe("新名称");
+      expect(updated!.industry).toBe("金融");
+    });
+
+    it("should return null for non-existent company", () => {
+      expect(manager.updateCompany("fake-id", { name: "test" })).toBeNull();
+    });
+  });
+
+  describe("deleteCompany", () => {
+    it("should delete an existing company", () => {
+      const c = manager.registerCompany({ name: "删除测试", industry: "IT", owner_name: "X" });
+      expect(manager.deleteCompany(c.id)).toBe(true);
+      expect(manager.getCompany(c.id)).toBeNull();
+    });
+
+    it("should return false for non-existent company", () => {
+      expect(manager.deleteCompany("fake-id")).toBe(false);
+    });
+  });
+});

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

@@ -0,0 +1,139 @@
+/**
+ * 星环OPC中心 — acquisition-tool 核心计算函数单元测试
+ *
+ * 测试收并购模块的亏损抵税计算逻辑。
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { SqliteAdapter } from "../db/sqlite-adapter.js";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+/**
+ * 亏损抵税计算: loss × 25% 企业所得税率
+ * 复制自 acquisition-tool.ts 的核心逻辑
+ */
+function calcTaxDeduction(lossAmount: number): number {
+  return lossAmount * 0.25;
+}
+
+describe("acquisition-tool calculations", () => {
+  describe("calcTaxDeduction — 亏损抵税计算", () => {
+    it("should calculate 25% tax deduction from loss", () => {
+      expect(calcTaxDeduction(100000)).toBe(25000);
+    });
+
+    it("should handle zero loss", () => {
+      expect(calcTaxDeduction(0)).toBe(0);
+    });
+
+    it("should handle large loss amounts", () => {
+      expect(calcTaxDeduction(10000000)).toBe(2500000); // 1000万亏损 → 250万抵税
+    });
+
+    it("should handle decimal amounts", () => {
+      expect(calcTaxDeduction(33333.33)).toBeCloseTo(8333.33, 2);
+    });
+  });
+});
+
+describe("acquisition-tool database integration", () => {
+  let db: SqliteAdapter;
+  let dbPath: string;
+
+  beforeEach(() => {
+    dbPath = path.join(os.tmpdir(), `opc-test-acq-${Date.now()}-${Math.random().toString(36).slice(2)}.db`);
+    db = new SqliteAdapter(dbPath);
+  });
+
+  afterEach(() => {
+    db.close();
+    try { fs.unlinkSync(dbPath); } catch { /* ignore */ }
+    try { fs.unlinkSync(dbPath + "-wal"); } catch { /* ignore */ }
+    try { fs.unlinkSync(dbPath + "-shm"); } catch { /* ignore */ }
+  });
+
+  it("should create an acquisition case with correct tax deduction", () => {
+    // Create target company
+    const company = db.createCompany({
+      name: "亏损公司", industry: "零售", owner_name: "赵六",
+      owner_contact: "", status: "active", registered_capital: 500000, description: "",
+    });
+
+    const id = db.genId();
+    const now = new Date().toISOString();
+    const lossAmount = 200000;
+    const taxDeduction = calcTaxDeduction(lossAmount);
+
+    db.execute(
+      `INSERT INTO opc_acquisition_cases
+         (id, company_id, acquirer_id, case_type, status, trigger_reason,
+          acquisition_price, loss_amount, tax_deduction, initiated_date, notes, created_at, updated_at)
+       VALUES (?, ?, 'starriver', 'acquisition', 'evaluating', ?, ?, ?, ?, date('now'), ?, ?, ?)`,
+      id, company.id, "连续亏损",
+      100000, lossAmount, taxDeduction,
+      "", now, now,
+    );
+
+    const row = db.queryOne("SELECT * FROM opc_acquisition_cases WHERE id = ?", id) as Record<string, unknown>;
+    expect(row).not.toBeNull();
+    expect(row.loss_amount).toBe(200000);
+    expect(row.tax_deduction).toBe(50000); // 200000 × 25%
+    expect(row.acquisition_price).toBe(100000);
+    expect(row.status).toBe("evaluating");
+  });
+
+  it("should update company status to acquired when acquisition is created", () => {
+    const company = db.createCompany({
+      name: "被收购公司", industry: "IT", owner_name: "钱七",
+      owner_contact: "", status: "active", registered_capital: 300000, description: "",
+    });
+
+    const now = new Date().toISOString();
+    db.execute(
+      "UPDATE opc_companies SET status = 'acquired', updated_at = ? WHERE id = ?",
+      now, company.id,
+    );
+
+    const updated = db.getCompany(company.id);
+    expect(updated).not.toBeNull();
+    expect(updated!.status).toBe("acquired");
+  });
+
+  it("should compute acquisition summary correctly", () => {
+    const c1 = db.createCompany({ name: "C1", industry: "IT", owner_name: "X", owner_contact: "", status: "active", registered_capital: 0, description: "" });
+    const c2 = db.createCompany({ name: "C2", industry: "IT", owner_name: "Y", owner_contact: "", status: "active", registered_capital: 0, description: "" });
+    const now = new Date().toISOString();
+
+    // Create two acquisition cases
+    db.execute(
+      `INSERT INTO opc_acquisition_cases (id, company_id, acquirer_id, case_type, status, trigger_reason, acquisition_price, loss_amount, tax_deduction, created_at, updated_at)
+       VALUES (?, ?, 'starriver', 'acquisition', 'completed', '亏损', 50000, 100000, 25000, ?, ?)`,
+      db.genId(), c1.id, now, now,
+    );
+    db.execute(
+      `INSERT INTO opc_acquisition_cases (id, company_id, acquirer_id, case_type, status, trigger_reason, acquisition_price, loss_amount, tax_deduction, created_at, updated_at)
+       VALUES (?, ?, 'starriver', 'acquisition', 'evaluating', '市场萎缩', 80000, 200000, 50000, ?, ?)`,
+      db.genId(), c2.id, now, now,
+    );
+
+    const summary = db.queryOne(
+      `SELECT
+         COUNT(*) as total_cases,
+         COUNT(CASE WHEN status = 'completed' THEN 1 END) as completed,
+         COUNT(CASE WHEN status = 'evaluating' THEN 1 END) as evaluating,
+         COALESCE(SUM(acquisition_price), 0) as total_acquisition_cost,
+         COALESCE(SUM(loss_amount), 0) as total_loss_amount,
+         COALESCE(SUM(tax_deduction), 0) as total_tax_deduction
+       FROM opc_acquisition_cases`,
+    ) as Record<string, number>;
+
+    expect(summary.total_cases).toBe(2);
+    expect(summary.completed).toBe(1);
+    expect(summary.evaluating).toBe(1);
+    expect(summary.total_acquisition_cost).toBe(130000);
+    expect(summary.total_loss_amount).toBe(300000);
+    expect(summary.total_tax_deduction).toBe(75000); // 100000×25% + 200000×25%
+  });
+});

package/src/tools/acquisition-tool.ts

@@ -8,7 +8,7 @@
 import { Type, type Static } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { OpcDatabase } from "../db/index.js";
-import { json } from "../utils/tool-helper.js";
+import { json, toolError } from "../utils/tool-helper.js";
 
 const AcquisitionSchema = Type.Union([
   Type.Object({
@@ -136,10 +136,10 @@ export function registerAcquisitionTool(api: OpenClawPluginApi, db: OpcDatabase)
             }
 
             default:
-              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+              return toolError(`未知操作: ${(p as { action: string }).action}`, "UNKNOWN_ACTION");
           }
         } catch (err) {
-          return json({ error: err instanceof Error ? err.message : String(err) });
+          return toolError(err instanceof Error ? err.message : String(err), "DB_ERROR");
         }
       },
     },

package/src/tools/asset-package-tool.ts

@@ -9,7 +9,7 @@
 import { Type, type Static } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { OpcDatabase } from "../db/index.js";
-import { json } from "../utils/tool-helper.js";
+import { json, toolError } from "../utils/tool-helper.js";
 
 const AssetPackageSchema = Type.Union([
   // ── 资产包管理 ──
@@ -149,7 +149,7 @@ export function registerAssetPackageTool(api: OpenClawPluginApi, db: OpcDatabase
 
             case "get_package_detail": {
               const pkg = db.queryOne("SELECT * FROM opc_asset_packages WHERE id = ?", p.package_id);
-              if (!pkg) return json({ error: "资产包不存在" });
+              if (!pkg) return toolError("资产包不存在", "RECORD_NOT_FOUND");
               const items = db.query(
                 `SELECT i.*, c.name as company_name, c.industry, c.status as company_status
                  FROM opc_asset_package_items i
@@ -269,10 +269,10 @@ export function registerAssetPackageTool(api: OpenClawPluginApi, db: OpcDatabase
             }
 
             default:
-              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+              return toolError(`未知操作: ${(p as { action: string }).action}`, "UNKNOWN_ACTION");
           }
         } catch (err) {
-          return json({ error: err instanceof Error ? err.message : String(err) });
+          return toolError(err instanceof Error ? err.message : String(err), "DB_ERROR");
         }
       },
     },

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

@@ -0,0 +1,106 @@
+/**
+ * 星环OPC中心 — finance-tool 核心计算函数单元测试
+ *
+ * 由于 registerFinanceTool 依赖 OpenClaw Plugin API，这里直接测试纯函数逻辑。
+ * 通过导入模块文件并提取或复制核心计算函数来测试。
+ */
+
+import { describe, it, expect } from "vitest";
+
+// 复制 finance-tool.ts 中的纯计算函数进行测试
+// 因为这些函数是模块内部的，无法直接导入
+
+/** 小规模纳税人增值税简易计算 */
+function calcVatSimple(salesAmount: number, rate = 0.03): { tax: number; rate: number } {
+  return { tax: Math.round(salesAmount * rate * 100) / 100, rate };
+}
+
+/** 企业所得税简算（小型微利企业优惠） */
+function calcIncomeTax(profit: number): { tax: number; rate: number; note: string } {
+  if (profit <= 0) return { tax: 0, rate: 0, note: "无应纳税所得额" };
+  if (profit <= 3_000_000) {
+    const tax = Math.round(profit * 0.05 * 100) / 100;
+    return { tax, rate: 0.05, note: "小型微利企业优惠税率 5%" };
+  }
+  const tax = Math.round(profit * 0.25 * 100) / 100;
+  return { tax, rate: 0.25, note: "一般企业税率 25%" };
+}
+
+describe("finance-tool calculations", () => {
+  describe("calcVatSimple — 增值税计算", () => {
+    it("should calculate VAT at default 3% rate", () => {
+      const result = calcVatSimple(100000);
+      expect(result.tax).toBe(3000);
+      expect(result.rate).toBe(0.03);
+    });
+
+    it("should calculate VAT at custom rate", () => {
+      const result = calcVatSimple(100000, 0.06);
+      expect(result.tax).toBe(6000);
+      expect(result.rate).toBe(0.06);
+    });
+
+    it("should handle zero sales", () => {
+      const result = calcVatSimple(0);
+      expect(result.tax).toBe(0);
+    });
+
+    it("should round to 2 decimal places", () => {
+      const result = calcVatSimple(33333.33);
+      // 33333.33 * 0.03 = 999.9999 → rounded to 1000.00
+      expect(result.tax).toBe(1000);
+    });
+
+    it("should handle small amounts correctly", () => {
+      const result = calcVatSimple(1);
+      expect(result.tax).toBe(0.03);
+    });
+  });
+
+  describe("calcIncomeTax — 企业所得税计算", () => {
+    it("should return 0 tax for zero profit", () => {
+      const result = calcIncomeTax(0);
+      expect(result.tax).toBe(0);
+      expect(result.rate).toBe(0);
+      expect(result.note).toBe("无应纳税所得额");
+    });
+
+    it("should return 0 tax for negative profit (亏损)", () => {
+      const result = calcIncomeTax(-100000);
+      expect(result.tax).toBe(0);
+      expect(result.rate).toBe(0);
+    });
+
+    it("should apply 5% rate for small-profit enterprises (≤300万)", () => {
+      const result = calcIncomeTax(1000000); // 100万利润
+      expect(result.tax).toBe(50000); // 100万 × 5% = 5万
+      expect(result.rate).toBe(0.05);
+      expect(result.note).toContain("5%");
+    });
+
+    it("should apply 5% rate at 300万 boundary", () => {
+      const result = calcIncomeTax(3000000); // 300万 boundary
+      expect(result.tax).toBe(150000); // 300万 × 5% = 15万
+      expect(result.rate).toBe(0.05);
+    });
+
+    it("should apply 25% rate for profits above 300万", () => {
+      const result = calcIncomeTax(5000000); // 500万利润
+      expect(result.tax).toBe(1250000); // 500万 × 25% = 125万
+      expect(result.rate).toBe(0.25);
+      expect(result.note).toContain("25%");
+    });
+
+    it("should handle small profit correctly", () => {
+      const result = calcIncomeTax(10000); // 1万利润
+      expect(result.tax).toBe(500); // 1万 × 5% = 500
+      expect(result.rate).toBe(0.05);
+    });
+
+    it("should round correctly for decimal profits", () => {
+      const result = calcIncomeTax(33333.33);
+      // 33333.33 * 0.05 = 1666.6665 → rounded to 1666.67
+      expect(result.tax).toBe(1666.67);
+    });
+  });
+});

package/src/tools/finance-tool.ts

@@ -5,7 +5,7 @@
 import { Type, type Static } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { OpcDatabase } from "../db/index.js";
-import { json } from "../utils/tool-helper.js";
+import { json, toolError } from "../utils/tool-helper.js";
 
 const FinanceSchema = Type.Union([
   Type.Object({
@@ -133,7 +133,9 @@ export function registerFinanceTool(api: OpenClawPluginApi, db: OpcDatabase): vo
 
             case "update_invoice_status": {
               db.execute("UPDATE opc_invoices SET status = ? WHERE id = ?", p.status, p.invoice_id);
-              return json(db.queryOne("SELECT * FROM opc_invoices WHERE id = ?", p.invoice_id) ?? { error: "发票不存在" });
+              const invoice = db.queryOne("SELECT * FROM opc_invoices WHERE id = ?", p.invoice_id);
+              if (!invoice) return toolError(`发票 ${p.invoice_id} 不存在`, "INVOICE_NOT_FOUND");
+              return json(invoice);
             }
 
             case "calc_vat": {
@@ -230,10 +232,10 @@ export function registerFinanceTool(api: OpenClawPluginApi, db: OpcDatabase): vo
             }
 
             default:
-              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+              return toolError(`未知操作: ${(p as { action: string }).action}`, "UNKNOWN_ACTION");
           }
         } catch (err) {
-          return json({ error: err instanceof Error ? err.message : String(err) });
+          return toolError(err instanceof Error ? err.message : String(err), "DB_ERROR");
         }
       },
     },