siscc/dotstatsuite-data-viewer

SIS-CC .Stat Suite Data Viewer Docker 镜像文档

一、镜像概述

1.1 简介

本镜像为 SIS-CC .Stat Suite 套件中的 dotstatsuite-data-viewer 服务提供官方容器化部署支持，是一款专注于统计数据可视化与交互展示的应用组件。

1.2 主要用途

作为 .Stat Suite 生态的核心展示层，用于对接统计数据源，提供数据查询、可视化呈现、报表生成及交互式数据分析功能，支持用户通过Web界面直观获取统计信息。

二、核心功能与特性

• 数据可视化展示
  支持折线图、柱状图、饼图等多种图表类型，实现统计数据的直观呈现。

• 交互式数据探索
  提供筛选、排序、钻取等交互功能，允许用户按需查询和分析数据维度。

• 报表生成与导出
  支持将可视化结果导出为PDF、Excel等格式，满足离线分析和报告需求。

• .Stat Suite 生态集成
  无缝对接 .Stat Suite 数据源服务（如 dotstatsuite-data-access），支持标准化统计数据接入。

• 响应式设计
  适配桌面端、平板及移动设备，确保多终端一致的用户体验。

注：具体功能细节请参考官方源代码仓库：dotstatsuite-data-viewer

三、使用场景与适用范围

3.1 适用场景

• ***统计数据发布：用于国家/地区统计机构向公众展示经济、人口、社会等领域的官方统计数据。
• 科研机构数据共享：支持研究团队对外展示实验数据、调研结果。
• 企业数据分析平台：作为内部数据分析门户，呈现业务指标、运营数据。

3.2 适用群体

• ***统计部门技术团队
• 科研机构数据管理团队
• 企业BI/数据分析部门
• 需展示标准化统计数据的组织或单位

四、使用方法与配置说明

4.1 前提条件

• Docker Engine 20.10+ 或 Docker Desktop 对应版本
• 已部署 .Stat Suite 数据源服务（如 dotstatsuite-data-access）及依赖数据库（如 PostgreSQL）

4.2 Docker 快速部署

4.2.1 基础运行命令

bash
docker run -d \
  --name dotstatsuite-data-viewer \
  -p 8080:8080 \
  -e PORT=8080 \
  -e API_BASE_URL=http://dotstatsuite-data-access:8081 \
  -e LOG_LEVEL=info \
  registry.gitlab.com/sis-cc/.stat-suite/dotstatsuite-data-viewer:latest

参数说明：

• -p 8080:8080：端口映射，将容器内 8080 端口映射到主机 8080 端口（可根据需求修改主机端口）
• API_BASE_URL：.Stat Suite 数据源服务地址（需替换为实际部署的 data-access 服务URL）
• LOG_LEVEL：日志级别，可选值：debug/info/warn/error

4.3 Docker Compose 部署示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  data-viewer:
    image: registry.gitlab.com/sis-cc/.stat-suite/dotstatsuite-data-viewer:latest
    container_name: dotstatsuite-data-viewer
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - API_BASE_URL=http://data-access:8081  # 假设 data-access 为同网络下的数据源服务名
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=dotstatsuite
      - DB_USER=stats_user
      - DB_PASSWORD=secure_password
      - LOG_LEVEL=info
    depends_on:
      - data-access
      - postgres
    networks:
      - stat-suite-network

  # 依赖服务示例（需单独部署，此处仅为关联示意）
  data-access:
    image: registry.gitlab.com/sis-cc/.stat-suite/dotstatsuite-data-access:latest
    # ... 数据源服务配置 ...

  postgres:
    image: postgres:14-alpine
    # ... 数据库配置 ...

networks:
  stat-suite-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

4.4 核心配置参数

注：完整配置参数请参考官方仓库的 application.properties 或部署文档。

五、注意事项

1. 版本兼容性
   需确保本镜像版本与 .Stat Suite 其他组件（如 data-access、数据库）版本兼容，建议使用官方推荐的版本组合。

2. 数据持久化
   若需保存用户配置、报表模板等数据，需通过 volumes 挂载容器内数据目录（具体路径参考官方文档）。

3. 生产环境安全

   • 避免使用默认密码，通过环境变量注入敏感信息（如 DB_PASSWORD）
   • 配置 CORS_ALLOWED_ORIGINS 限制跨域请求源，禁用通配符 *
   • 使用 HTTPS 加密传输（可配合 Nginx 或 Traefik 等反向代理实现）

4. 日志与监控
   容器日志可通过 docker logs 查看，建议集成外部日志系统（如 ELK Stack）进行持久化和分析。

六、参考链接

• 官方源代码仓库：dotstatsuite-data-viewer
• .Stat Suite 官方文档：SIS-CC .Stat Suite Documentation