← 返回文档中心

数据智能

数据智能

优先级: P2（智能增长模块）
开发周期: 3-4 周

目标

基于平台运营数据提供商业洞察，包括 BI 看板、需求预测、渠道评分等，辅助运营决策。

核心功能

功能 描述
BI 看板 实时运营数据看板：订单量、GMV、利润率、供应商表现
需求预测 基于历史数据预测未来日期的需求热度，辅助采购决策
渠道评分 多维度评估供应商和代理商的表现质量
价格趋势 酒店价格走势分析、竞品价格对比
用户行为分析 代理商查价/下单行为分析
自动化报表 定时生成日报/周报/月报

数据模型

-- 以下表主要在 ClickHouse 中创建，PG 中保留简化版本

-- ClickHouse: 每日聚合统计表
-- CREATE TABLE daily_stats (date Date, metric String, dimension String, value Int64, amount Float64) 
-- ENGINE = SummingMergeTree() ORDER BY (date, metric, dimension)

-- 供应商评分表 (PG)
CREATE TABLE supplier_scores (
    id              BIGSERIAL PRIMARY KEY,
    supplier_code   VARCHAR(32) NOT NULL,
    period_date     DATE NOT NULL,

    availability_score  DECIMAL(5, 2),       # 可用率评分
    price_score         DECIMAL(5, 2),       # 价格竞争力评分
    response_score      DECIMAL(5, 2),       # 响应速度评分
    quality_score       DECIMAL(5, 2),       # 综合质量评分
    booking_rate        DECIMAL(5, 2),       # 预订成功率
    cancellation_rate   DECIMAL(5, 2),       # 取消率

    total_bookings      INT DEFAULT 0,
    total_revenue       DECIMAL(14, 2) DEFAULT 0,

    rank                INT,                     # 排名

    calculated_at       TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(supplier_code, period_date)
);

-- 代理商评分表
CREATE TABLE agent_scores (
    id              BIGSERIAL PRIMARY KEY,
    agent_code      VARCHAR(32) NOT NULL,
    period_date     DATE NOT NULL,

    booking_score       DECIMAL(5, 2),       # 预订量评分
    revenue_score       DECIMAL(5, 2),       # 营收贡献评分
    payment_score       DECIMAL(5, 2),       # 付款及时性评分
    cancellation_score  DECIMAL(5, 2),       # 取消率评分(低好)
    overall_score       DECIMAL(5, 2),       # 综合评分

    total_bookings      INT DEFAULT 0,
    total_revenue       DECIMAL(14, 2) DEFAULT 0,
    avg_booking_value   DECIMAL(10, 2),

    calculated_at       TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(agent_code, period_date)
);

-- 需求预测表
CREATE TABLE demand_forecasts (
    id              BIGSERIAL PRIMARY KEY,
    hotel_id        BIGINT NOT NULL,
    stay_date       DATE NOT NULL,

    predicted_demand INT,                     # 预测需求热度 1-100
    confidence      DECIMAL(5, 2),           # 预测置信度
    model_version   VARCHAR(16),

    actual_demand   INT,                     # 实际值(事后回填)

    created_at      TIMESTAMPTZ DEFAULT NOW(),
    UNIQUE(hotel_id, stay_date)
);

-- 报表配置表
CREATE TABLE report_configs (
    id              SERIAL PRIMARY KEY,
    report_name     VARCHAR(128) NOT NULL,
    report_type     VARCHAR(32) NOT NULL,     -- daily/weekly/monthly/custom
    schedule_cron   VARCHAR(64),             # 定时表达式
    recipients      JSONB,                   # 接收人列表
    config          JSONB,                   # 报表参数
    enabled         BOOLEAN DEFAULT true,
    last_run_at     TIMESTAMPTZ,
    created_at      TIMESTAMPTZ DEFAULT NOW()
);

接口设计

# BI API
GET    /api/v1/analytics/dashboard             # 看板概览数据
# 响应: { "today": { "orders": 150, "gmv": 285000, "profit": 42000 }, ... }

GET    /api/v1/analytics/trends               # 趋势数据
# 参数: metric=orders/gmv/profit, period=7d/30d/90d, granularity=day/week

GET    /api/v1/analytics/hotels/top            # 热门酒店排行
GET    /api/v1/analytics/suppliers/ranking     # 供应商排行

# 评分 API
GET    /api/v1/analytics/suppliers/:code/score # 供应商评分详情
GET    /api/v1/analytics/agents/:code/score    # 代理商评分详情

# 预测 API
GET    /api/v1/analytics/forecast?hotel_id=123&date_from=2025-03-01&date_to=2025-03-31

# 报表 API
GET    /api/v1/reports                        # 报表列表
POST   /api/v1/reports/generate               # 手动生成报表
GET    /api/v1/reports/:id/download           # 下载报表

与其他模块的关系

关联模块 关系
查价引擎 查价日志数据
订单管理 订单数据
结算管理 财务数据
销售管理 代理商/供应商元数据
管理后台 BI 看板嵌入

技术选型建议