galaxy-opc-plugin 0.2.3 → 0.2.5

package/openclaw.plugin.json

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

package/package.json

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

package/src/db/sqlite-adapter.ts

@@ -32,10 +32,17 @@ export class SqliteAdapter implements OpcDatabase {
     for (const sql of Object.values(OPC_TABLES)) {
       this.db.exec(sql);
     }
+    // IMPORTANT: run migrations before creating indexes.
+    // Existing DBs may miss columns introduced by migrations (e.g. quotation_id),
+    // and creating dependent indexes first would fail plugin startup.
+    runMigrations(this.db);
     for (const idx of OPC_INDEXES) {
-      this.db.exec(idx);
+      try {
+        this.db.exec(idx);
+      } catch {
+        // Keep startup resilient for partially migrated historical databases.
+      }
     }
-    runMigrations(this.db);
   }
 
   /** 通用查询方法，供 Phase 2 工具使用 */

package/src/web/config-ui.ts

@@ -3127,15 +3127,28 @@ export function registerConfigUi(api: OpenClawPluginApi, db: OpcDatabase, gatewa
   // 注册 Dashboard API 路由
   registerDashboardApiRoutes(api, db);
 
-  api.registerHttpHandler(async (req, res) => {
+  api.registerHttpHandler(async (req, res) => {
     const rawUrl = req.url ?? "";
     const urlObj = new URL(rawUrl, "http://localhost");
     const pathname = urlObj.pathname;
     const method = req.method?.toUpperCase() ?? "GET";
 
-    if (!pathname.startsWith("/opc/admin")) {
-      return false;
-    }
+    if (!pathname.startsWith("/opc/admin")) {
+      return false;
+    }
+
+    // Normalize accidental SPA deep-links (e.g. /opc/admin/chat) back to OPC admin root.
+    // Without this, users may land on OpenClaw's default chat UI and think OPC admin failed to load.
+    if (
+      !pathname.startsWith("/opc/admin/api/")
+      && pathname !== "/opc/admin"
+      && pathname !== "/opc/admin/"
+    ) {
+      const tokenParam = gatewayToken ? `?token=${encodeURIComponent(gatewayToken)}` : "";
+      res.writeHead(302, { Location: `/opc/admin${tokenParam}` });
+      res.end();
+      return true;
+    }
 
     // API 端点需要认证
     if (pathname.startsWith("/opc/admin/api/") && gatewayToken) {

package/src/web/DASHBOARD_INTEGRATION_GUIDE.md

@@ -1,478 +0,0 @@
-# Dashboard 和收付款管理 UI 集成指南
-
-本文档详细说明如何将 Dashboard 监控中心和收付款管理 UI 集成到 `config-ui.ts` 中。
-
-## 1. Dashboard 监控中心集成
-
-### 1.1 导入 Dashboard UI 模块
-
-在 `config-ui.ts` 文件顶部添加导入:
-
-```typescript
-import { generateDashboardHtml, getDashboardCss, getDashboardJs, type DashboardData } from './dashboard-ui.js';
-import { registerDashboardApiRoutes } from '../api/dashboard.js';
-```
-
-### 1.2 在 CSS 部分添加 Dashboard 样式
-
-在 `getCss()` 函数的返回值中添加 Dashboard CSS:
-
-```typescript
-function getCss(): string {
-  return ":root{...}"
-  + "\n*{margin:0;padding:0;box-sizing:border-box}"
-  // ... 现有样式 ...
-  + getDashboardCss()  // 添加这一行
-  // ... 继续现有样式 ...
-}
-```
-
-### 1.3 修改侧边栏菜单
-
-当前已经有 "监控中心" 菜单项 (data-view="monitoring")，我们将其更新为 Dashboard:
-
-在 `getBodyHtml()` 函数中,找到侧边栏部分并修改:
-
-```typescript
-// 将原来的:
-+ '<a data-view="monitoring"><span class="icon">...</span> 监控中心</a>'
-
-// 改为:
-+ '<a data-view="dashboard-monitor"><span class="icon"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><rect x="2" y="2" width="5" height="5" stroke="currentColor" stroke-width="1.5" rx="1"/><rect x="9" y="2" width="5" height="5" stroke="currentColor" stroke-width="1.5" rx="1"/><rect x="2" y="9" width="5" height="5" stroke="currentColor" stroke-width="1.5" rx="1"/><rect x="9" y="9" width="5" height="5" stroke="currentColor" stroke-width="1.5" rx="1"/></svg></span> 监控中心</a>'
-```
-
-### 1.4 添加 Dashboard 视图容器
-
-在 main 内容区域添加 dashboard 视图:
-
-```typescript
-// 在 <div class="main"> 内部添加:
-+ '<div id="view-dashboard-monitor" class="view"><div class="page-header"><h1>监控中心</h1><p>一屏看清公司运营状态、风险预警、今日待办</p></div><div id="dashboard-monitor-content"><div class="skeleton" style="height:400px"></div></div></div>'
-```
-
-### 1.5 更新 showView 函数
-
-在 JavaScript 部分的 `showView` 函数中添加:
-
-```typescript
-+ "\nfunction showView(name){currentView=name;document.querySelectorAll('.view').forEach(function(v){v.classList.remove('active')});document.querySelectorAll('.sidebar-nav a').forEach(function(a){a.classList.remove('active')});var el=document.getElementById('view-'+name);if(el)el.classList.add('active');var nav=document.querySelector('.sidebar-nav a[data-view=\"'+name+'\"]');if(nav)nav.classList.add('active');if(name==='dashboard')loadDashboard();if(name==='companies')loadCompanies();if(name==='finance')loadFinance();if(name==='monitoring')loadMonitoring();if(name==='dashboard-monitor')loadDashboardMonitor();if(name==='tools')loadConfig();if(name==='guide')loadGuide();if(name==='canvas')initCanvasView();if(name==='feishu')loadFeishu();}"
-```
-
-### 1.6 添加 loadDashboardMonitor 函数
-
-在 JavaScript 部分添加新的加载函数:
-
-```typescript
-+ "\nfunction loadDashboardMonitor(){"
-+ "var el=document.getElementById('dashboard-monitor-content');"
-+ "el.innerHTML='<div class=\"skeleton\" style=\"height:400px\"></div>';"
-+ "fetch('/opc/admin/api/dashboard').then(function(r){return r.json()}).then(function(data){"
-+ "renderDashboardMonitor(data);"
-+ "}).catch(function(e){el.innerHTML='<div class=\"card\"><div class=\"empty-state\"><p>加载失败: '+e.message+'</p></div></div>';});}"
-
-+ "\nfunction renderDashboardMonitor(data){"
-+ "var el=document.getElementById('dashboard-monitor-content');"
-+ "var html=generateDashboardHtmlClient(data);"  // 需要在客户端重新实现或传输 HTML
-+ "el.innerHTML=html;"
-+ "}"
-```
-
-**注意**: 由于 `generateDashboardHtml` 在服务端生成,我们需要:
-
-方案 A: 在服务端生成 HTML 并通过 API 返回
-方案 B: 在客户端 JavaScript 中重新实现 `generateDashboardHtml` 逻辑
-
-推荐**方案 A**,修改 `/opc/admin/api/dashboard` 端点:
-
-```typescript
-// 在 src/api/dashboard.ts 中修改
-api.registerHttpRoute({
-  path: "/opc/admin/api/dashboard",
-  handler: (req, res) => {
-    try {
-      const data = getDashboardData(db);
-      const html = generateDashboardHtml(data); // 生成 HTML
-      res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
-      res.end(JSON.stringify({ ...data, html })); // 同时返回数据和 HTML
-    } catch (err) {
-      res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
-      res.end(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
-    }
-  },
-});
-```
-
-然后在客户端:
-
-```typescript
-+ "\nfunction renderDashboardMonitor(data){"
-+ "var el=document.getElementById('dashboard-monitor-content');"
-+ "el.innerHTML=data.html || '<div class=\"card\"><p>暂无数据</p></div>';"
-+ "}"
-```
-
-### 1.7 添加 Dashboard JavaScript 函数
-
-在 JavaScript 部分添加 Dashboard 专用函数:
-
-```typescript
-+ getDashboardJs()  // 添加 dismissAlert 等函数
-```
-
-### 1.8 注册 Dashboard API 路由
-
-在 `registerConfigUiRoutes` 函数中调用:
-
-```typescript
-export function registerConfigUiRoutes(api: OpenClawPluginApi, db: OpcDatabase, gatewayToken?: string): void {
-  // 注册 Dashboard API
-  registerDashboardApiRoutes(api, db);
-
-  // 现有路由注册代码...
-  api.registerHttpRoute({
-    path: /^\/opc\/admin/,
-    handler: async (req, res) => {
-      // ...
-    }
-  });
-}
-```
-
----
-
-## 2. 收付款管理 UI 集成
-
-### 2.1 修改公司详情页 Tab 标签
-
-在 `renderCompanyDetail` 函数中,找到 tabNames 数组并添加 "收付款" Tab:
-
-```typescript
-// 原来的:
-+ "var tabNames=[{k:'overview',l:'概览'},{k:'finance',l:'财务'},{k:'team',l:'团队'},{k:'projects',l:'项目'},{k:'contracts',l:'合同'},{k:'investment',l:'投融资'},{k:'timeline',l:'时间线'},{k:'staff',l:'AI员工'},{k:'media',l:'新媒体'},{k:'procurement',l:'采购'}];"
-
-// 改为:
-+ "var tabNames=[{k:'overview',l:'概览'},{k:'finance',l:'财务'},{k:'payments',l:'收付款'},{k:'team',l:'团队'},{k:'projects',l:'项目'},{k:'contracts',l:'合同'},{k:'investment',l:'投融资'},{k:'timeline',l:'时间线'},{k:'staff',l:'AI员工'},{k:'media',l:'新媒体'},{k:'procurement',l:'采购'}];"
-```
-
-### 2.2 添加收付款 Tab 内容渲染逻辑
-
-在 `renderCompanyDetail` 函数中,添加收付款 Tab 的渲染:
-
-```typescript
-// 在 finance tab 后添加:
-
-// ── Tab: 收付款 ──
-+ "if(activeTab==='payments'){"
-+ "h+='<div class=\"tab-content\">';"
-
-// 汇总卡片
-+ "h+='<div class=\"stats-grid\" style=\"grid-template-columns:repeat(3,1fr);margin-bottom:24px\">';"
-+ "var receivableTotal=0,payableTotal=0,overdueCount=0;"
-+ "if(d.payments){"
-+ "d.payments.forEach(function(p){"
-+ "var unpaid=p.amount-p.paid_amount;"
-+ "if(p.direction==='receivable'&&p.status!=='paid'&&p.status!=='cancelled')receivableTotal+=unpaid;"
-+ "if(p.direction==='payable'&&p.status!=='paid'&&p.status!=='cancelled')payableTotal+=unpaid;"
-+ "if(p.status==='overdue')overdueCount++;"
-+ "});}"
-+ "h+='<div class=\"stat-card\" style=\"border-left:4px solid #10b981\"><div class=\"label\">待收总额</div><div class=\"value\">'+fmt(receivableTotal)+' <span class=\"unit\">元</span></div></div>';"
-+ "h+='<div class=\"stat-card\" style=\"border-left:4px solid #ef4444\"><div class=\"label\">待付总额</div><div class=\"value\">'+fmt(payableTotal)+' <span class=\"unit\">元</span></div></div>';"
-+ "h+='<div class=\"stat-card\" style=\"border-left:4px solid #f59e0b\"><div class=\"label\">逾期笔数</div><div class=\"value\">'+overdueCount+' <span class=\"unit\">笔</span></div></div>';"
-+ "h+='</div>';"
-
-// 新增按钮
-+ "h+='<div style=\"display:flex;justify-content:space-between;align-items:center;margin-bottom:16px\">';"
-+ "h+='<h2 style=\"margin:0\">收付款列表</h2>';"
-+ "h+='<button class=\"btn-primary\" onclick=\"openPaymentModal(\\''+esc(companyId)+'\\',null)\">+ 新增收付款</button>';"
-+ "h+='</div>';"
-
-// 收付款表格
-+ "if(d.payments&&d.payments.length){"
-+ "h+='<table><thead><tr><th>方向</th><th>对方</th><th>金额</th><th>已付</th><th>状态</th><th>到期日</th><th>类别</th><th>操作</th></tr></thead><tbody>';"
-+ "d.payments.forEach(function(p){"
-+ "var directionBadge=p.direction==='receivable'?'<span class=\"badge badge-income\">应收</span>':'<span class=\"badge badge-expense\">应付</span>';"
-+ "var statusBadge=p.status==='paid'?'<span class=\"badge badge-paid\">已付</span>':p.status==='partial'?'<span class=\"badge badge-warning\">部分</span>':p.status==='overdue'?'<span class=\"badge badge-critical\">逾期</span>':'<span class=\"badge badge-pending\">待付</span>';"
-+ "h+='<tr>';"
-+ "h+='<td>'+directionBadge+'</td>';"
-+ "h+='<td>'+esc(p.counterparty)+'</td>';"
-+ "h+='<td>'+fmt(p.amount)+' 元</td>';"
-+ "h+='<td>'+fmt(p.paid_amount)+' 元</td>';"
-+ "h+='<td>'+statusBadge+'</td>';"
-+ "h+='<td>'+fmtDate(p.due_date)+'</td>';"
-+ "h+='<td>'+esc(p.category||'--')+'</td>';"
-+ "h+='<td><button class=\"btn-link\" onclick=\"openPaymentModal(\\''+esc(companyId)+'\\',\\''+esc(p.id)+'\\')\" style=\"margin-right:8px\">编辑</button><button class=\"btn-link\" onclick=\"recordPayment(\\''+esc(p.id)+'\\')\" style=\"color:var(--ok)\">记账</button></td>';"
-+ "h+='</tr>';"
-+ "});"
-+ "h+='</tbody></table>';"
-+ "}else{h+='<div class=\"empty-state\"><p>暂无收付款记录</p></div>';}"
-
-+ "h+='</div>';"  // 结束 tab-content
-+ "}"
-```
-
-### 2.3 添加收付款数据获取
-
-在 `handleCompanyDetail` 函数中,添加收付款数据查询:
-
-```typescript
-// 在返回对象中添加:
-const payments = db.query(
-  "SELECT * FROM opc_payments WHERE company_id = ? ORDER BY due_date DESC, created_at DESC",
-  companyId,
-) as PaymentRow[];
-
-return {
-  company,
-  finance: financeSummary,
-  transactions,
-  invoices,
-  taxFilings,
-  hrRecords,
-  projects,
-  tasks,
-  contracts,
-  rounds,
-  investors,
-  milestones,
-  lifecycleEvents,
-  alerts,
-  contacts,
-  employees,
-  salarySum,
-  staffConfig,
-  mediaContent,
-  procurementOrders,
-  services,
-  // ... 其他字段
-  payments,  // 添加这一行
-};
-```
-
-并添加 PaymentRow 接口定义:
-
-```typescript
-interface PaymentRow {
-  id: string;
-  company_id: string;
-  direction: string;
-  counterparty: string;
-  amount: number;
-  paid_amount: number;
-  status: string;
-  due_date: string;
-  paid_date: string;
-  invoice_id: string;
-  contract_id: string;
-  category: string;
-  payment_method: string;
-  notes: string;
-  created_at: string;
-  updated_at: string;
-}
-```
-
-### 2.4 添加收付款弹窗 HTML
-
-在 `getBodyHtml()` 函数的 `<body>` 内添加弹窗:
-
-```typescript
-+ '<div id="payment-modal" class="modal" style="display:none">'
-+ '<div class="modal-content" style="max-width:600px">'
-+ '<div class="modal-header">'
-+ '<h3 id="payment-modal-title">新增收付款</h3>'
-+ '<span class="modal-close" onclick="closePaymentModal()">&times;</span>'
-+ '</div>'
-+ '<div class="modal-body">'
-+ '<form id="payment-form" onsubmit="savePayment(event)">'
-+ '<input type="hidden" id="payment-id" name="payment_id">'
-+ '<input type="hidden" id="payment-company-id" name="company_id">'
-+ '<div class="form-group">'
-+ '<label>方向 *</label>'
-+ '<select name="direction" required><option value="receivable">应收</option><option value="payable">应付</option></select>'
-+ '</div>'
-+ '<div class="form-group">'
-+ '<label>对方单位 *</label>'
-+ '<input type="text" name="counterparty" required placeholder="客户/供应商名称">'
-+ '</div>'
-+ '<div class="form-group">'
-+ '<label>金额（元）*</label>'
-+ '<input type="number" name="amount" required step="0.01" min="0" placeholder="0.00">'
-+ '</div>'
-+ '<div class="form-group">'
-+ '<label>到期日期 *</label>'
-+ '<input type="date" name="due_date" required>'
-+ '</div>'
-+ '<div class="form-group">'
-+ '<label>类别</label>'
-+ '<select name="category"><option value="">请选择</option><option value="service">服务</option><option value="product">产品</option><option value="rent">租金</option><option value="salary">工资</option><option value="tax">税费</option></select>'
-+ '</div>'
-+ '<div class="form-group">'
-+ '<label>支付方式</label>'
-+ '<select name="payment_method"><option value="">请选择</option><option value="bank_transfer">银行转账</option><option value="alipay">支付宝</option><option value="wechat">微信</option><option value="cash">现金</option></select>'
-+ '</div>'
-+ '<div class="form-group">'
-+ '<label>备注</label>'
-+ '<textarea name="notes" rows="3" placeholder="可选"></textarea>'
-+ '</div>'
-+ '<div class="modal-actions">'
-+ '<button type="button" class="btn-secondary" onclick="closePaymentModal()">取消</button>'
-+ '<button type="submit" class="btn-primary">保存</button>'
-+ '</div>'
-+ '</form>'
-+ '</div>'
-+ '</div>'
-+ '</div>'
-```
-
-### 2.5 添加收付款弹窗 CSS
-
-在 `getCss()` 函数中添加:
-
-```typescript
-// Modal styles
-+ "\n.modal{position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0,0,0,0.5);z-index:1000;display:flex;align-items:center;justify-content:center;padding:20px}"
-+ "\n.modal-content{background:var(--card);border-radius:var(--r);max-width:800px;width:100%;max-height:90vh;overflow:hidden;display:flex;flex-direction:column;box-shadow:0 20px 25px -5px rgba(0,0,0,0.1),0 10px 10px -5px rgba(0,0,0,0.04)}"
-+ "\n.modal-header{padding:20px 24px;border-bottom:1px solid var(--bd);display:flex;justify-content:space-between;align-items:center}"
-+ "\n.modal-header h3{font-size:18px;font-weight:600;margin:0}"
-+ "\n.modal-close{font-size:28px;font-weight:300;line-height:1;cursor:pointer;color:var(--tx3);transition:color .15s}"
-+ "\n.modal-close:hover{color:var(--tx)}"
-+ "\n.modal-body{padding:24px;overflow-y:auto}"
-+ "\n.modal-actions{display:flex;gap:12px;justify-content:flex-end;padding-top:16px;border-top:1px solid var(--bd);margin-top:16px}"
-+ "\n.form-group{margin-bottom:16px}"
-+ "\n.form-group label{display:block;font-size:13px;font-weight:500;margin-bottom:6px;color:var(--tx)}"
-+ "\n.form-group input,.form-group select,.form-group textarea{width:100%;padding:9px 14px;border:1px solid var(--bd);border-radius:var(--r);font-size:13px;font-family:var(--font);background:var(--card);color:var(--tx)}"
-+ "\n.form-group input:focus,.form-group select:focus,.form-group textarea:focus{outline:none;border-color:var(--tx3)}"
-+ "\n.btn-link{background:none;border:none;color:var(--tx);cursor:pointer;font-size:13px;text-decoration:underline;padding:0}"
-+ "\n.btn-link:hover{color:var(--tx2)}"
-+ "\n.btn-primary{padding:9px 18px;background:var(--tx);color:white;border:none;border-radius:var(--r);font-size:13px;font-weight:500;cursor:pointer;font-family:var(--font);transition:all .15s}"
-+ "\n.btn-primary:hover{background:var(--pri-l)}"
-+ "\n.btn-secondary{padding:9px 18px;background:var(--bg);color:var(--tx);border:1px solid var(--bd);border-radius:var(--r);font-size:13px;font-weight:500;cursor:pointer;font-family:var(--font);transition:all .15s}"
-+ "\n.btn-secondary:hover{background:#f3f4f6}"
-```
-
-### 2.6 添加收付款 JavaScript 函数
-
-在 JavaScript 部分添加:
-
-```typescript
-// 打开收付款弹窗
-+ "\nfunction openPaymentModal(companyId,paymentId){"
-+ "var modal=document.getElementById('payment-modal');"
-+ "var form=document.getElementById('payment-form');"
-+ "var title=document.getElementById('payment-modal-title');"
-+ "document.getElementById('payment-company-id').value=companyId;"
-+ "if(paymentId){"
-+ "title.textContent='编辑收付款';"
-+ "document.getElementById('payment-id').value=paymentId;"
-+ "fetch('/opc/admin/api/payments/'+paymentId).then(function(r){return r.json()}).then(function(p){"
-+ "form.direction.value=p.direction;"
-+ "form.counterparty.value=p.counterparty;"
-+ "form.amount.value=p.amount;"
-+ "form.due_date.value=p.due_date;"
-+ "form.category.value=p.category||'';"
-+ "form.payment_method.value=p.payment_method||'';"
-+ "form.notes.value=p.notes||'';"
-+ "}).catch(function(e){showToast('加载失败','err');});"
-+ "}else{"
-+ "title.textContent='新增收付款';"
-+ "document.getElementById('payment-id').value='';"
-+ "form.reset();"
-+ "}"
-+ "modal.style.display='flex';"
-+ "}"
-
-// 关闭弹窗
-+ "\nfunction closePaymentModal(){"
-+ "document.getElementById('payment-modal').style.display='none';"
-+ "}"
-
-// 保存收付款
-+ "\nfunction savePayment(event){"
-+ "event.preventDefault();"
-+ "var form=event.target;"
-+ "var data=new FormData(form);"
-+ "var json={};"
-+ "data.forEach(function(value,key){json[key]=value;});"
-+ "var url=json.payment_id?'/opc/admin/api/payments/'+json.payment_id:'/opc/admin/api/payments';"
-+ "var method=json.payment_id?'PUT':'POST';"
-+ "fetch(url,{method:method,headers:{'Content-Type':'application/json'},body:JSON.stringify(json)})"
-+ ".then(function(r){return r.json()}).then(function(d){"
-+ "if(d.ok||d.id){"
-+ "showToast('保存成功','ok');"
-+ "closePaymentModal();"
-+ "loadCompanyDetail(json.company_id);"
-+ "}else{showToast('保存失败','err');}"
-+ "}).catch(function(e){showToast('网络错误','err');});"
-+ "}"
-
-// 记账（更新已付金额）
-+ "\nfunction recordPayment(paymentId){"
-+ "var amount=prompt('请输入本次收/付款金额（元）:');"
-+ "if(!amount||isNaN(parseFloat(amount)))return;"
-+ "fetch('/opc/admin/api/payments/'+paymentId+'/record',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({paid_amount:parseFloat(amount)})})"
-+ ".then(function(r){return r.json()}).then(function(d){"
-+ "if(d.ok){"
-+ "showToast('记账成功','ok');"
-+ "location.reload();"
-+ "}else{showToast('记账失败','err');}"
-+ "}).catch(function(e){showToast('网络错误','err');});"
-+ "}"
-```
-
-### 2.7 添加收付款 API 端点
-
-需要在服务端添加以下 API 端点:
-
-```typescript
-// GET /opc/admin/api/payments/:id - 获取单个收付款
-// POST /opc/admin/api/payments - 创建收付款
-// PUT /opc/admin/api/payments/:id - 更新收付款
-// POST /opc/admin/api/payments/:id/record - 记账
-```
-
-这些端点可以通过调用 `finance-tool.ts` 中的相应 action 来实现。
-
----
-
-## 3. 测试清单
-
-完成集成后,请进行以下测试:
-
-### Dashboard 监控中心
-- [ ] 访问 `/opc/admin`，点击左侧"监控中心"菜单
-- [ ] 验证 4 个关键指标卡片显示正确
-- [ ] 验证风险预警列表显示
-- [ ] 验证今日待办列表显示
-- [ ] 验证 AI 建议显示
-- [ ] 点击预警的忽略按钮,验证功能正常
-- [ ] 在不同屏幕尺寸下测试响应式布局
-
-### 收付款管理
-- [ ] 进入公司详情页,点击"收付款" Tab
-- [ ] 验证汇总卡片显示正确
-- [ ] 验证收付款列表显示
-- [ ] 点击"新增收付款",填写表单并保存
-- [ ] 点击"编辑"按钮,修改收付款信息
-- [ ] 点击"记账"按钮,更新已付金额
-- [ ] 验证逾期状态自动标记
-- [ ] 验证部分付款状态显示
-
----
-
-## 4. 注意事项
-
-1. **文件太大**: `config-ui.ts` 文件已经超过 3800 行,建议考虑拆分成多个模块
-2. **性能优化**: Dashboard 数据实时计算可能较慢,考虑添加缓存
-3. **权限控制**: 如果启用了 `gatewayToken`,确保 API 端点有正确的权限检查
-4. **错误处理**: 所有 fetch 调用都应有完善的错误处理
-5. **深色模式**: 确保所有新增样式支持深色模式 CSS 变量
-
----
-
-## 5. 后续优化建议
-
-1. **Dashboard 刷新**: 添加自动刷新功能（每 5 分钟）
-2. **收付款提醒**: 集成到每日简报中
-3. **导出功能**: 添加收付款列表导出 Excel 功能
-4. **批量操作**: 支持批量标记收付款状态
-5. **图表可视化**: 在 Dashboard 中添加趋势图表