财务感知与预警

财务感知与预警

AI 只读财务数据，出分析和预警，不操作资金。

流程图：财务预警流程

flowchart TD
    A[每日定时计算财务指标] --> B[采集佣金数据]
    B --> C[按供应商/代理商/维度聚合]
    C --> D[计算环比/同比变化]
    D --> E{触发预警规则?}
    E -->|否| F[更新财务看板]
    E -->|是| G[生成 financial_alert]
    G --> H{预警类型?}
    H -->|收入下降| I[分析下降原因
供应商/渠道/时段维度]
    H -->|欠款预警| J[查代理商欠款详情
计算欠款天数]
    H -->|信用额度| K[查代理商额度使用率]
    H -->|结算延迟| L[查供应商结算状态]
    I --> M[生成分析报告]
    J --> M
    K --> M
    L --> M
    M --> N[推送预警到飞书]
    N --> O{需要操作?}
    O -->|需要人工| P[标记为待处理]
    O -->|自动处理| Q[触发对应权限流程]
    P --> R[等待用户决策]
    Q --> S[执行并记录]
    class E,H,O decision
    class P,R warning
    class A,B,C,D,F,G,I,J,K,L,M,N,Q,S process
    classDef process fill:#1a2744,stroke:#58a6ff,stroke-width:1px,color:#c9d1d9
    classDef decision fill:#3a2a1a,stroke:#f0883e,stroke-width:2px,color:#f0883e
    classDef done fill:#1a3a2a,stroke:#3fb950,stroke-width:1px,color:#3fb950
    classDef error fill:#3a1a1a,stroke:#f85149,stroke-width:2px,color:#f85149
    classDef warning fill:#3a2a1a,stroke:#d29922,stroke-width:1px,color:#d29922
    classDef skip fill:#21262d,stroke:#484f58,color:#8b949e

数据模型

CREATE TABLE  financial_metrics (
    id              BIGSERIAL PRIMARY KEY,
    metric_date     DATE NOT NULL,
    metric_type     VARCHAR(64) NOT NULL,    -- daily_commission/supplier_contribution/agent_revenue
    dimension_key   VARCHAR(128),            -- supplier_id/agent_id
    dimension_value VARCHAR(128),
    amount          DECIMAL(14,2) NOT NULL,
    change_pct      DECIMAL(5,2),
    change_reason   TEXT,
    calculated_at   TIMESTAMPTZ DEFAULT now()
);

CREATE TABLE financial_alerts (
    id              BIGSERIAL PRIMARY KEY,
    alert_type      VARCHAR(64) NOT NULL,    -- revenue_drop/overdue_payment/credit_limit
    entity_type     VARCHAR(32),             -- supplier/agent
    entity_id       VARCHAR(64),
    current_value   DECIMAL(14,2),
    threshold_value DECIMAL(14,2),
    suggestion      TEXT,
    status          VARCHAR(16) DEFAULT 'pending',
    created_at      TIMESTAMPTZ DEFAULT now()
);

API 接口

业务逻辑

每日定时任务从结算模块拉取前一日财务数据，计算各维度的佣金、供应商贡献、代理商收入等指标，写入 financial_metrics。系统根据预设阈值检测异常（如收入环比下降超过 10%、供应商回款逾期、信用额度接近上限），触发后生成 financial_alerts 记录并通过飞书推送。所有 API 仅提供只读访问，不暴露任何资金操作接口。