smartcitiesdata/discovery_ui

智慧城市数据集探索前端层镜像文档

镜像概述

本镜像为智慧城市数据集提供专用前端层解决方案，旨在构建用户友好的交互界面，实现对城市交通、环境监测、能源消耗、公共服务等多维度数据集的可视化探索。作为连接智慧城市后端数据服务与终端用户的桥梁，该镜像简化了数据访问流程，支持非技术人员通过直观操作获取数据洞察。

核心功能与特性

数据可视化能力

• 集成多种可视化组件，支持折线图、柱状图、热力图、地理信息地图等展示形式
• 支持大规模数据集的动态渲染与实时更新
• 提供自定义图表配置，满足不同场景下的数据展示需求

交互探索功能

• 数据集筛选：支持按时间范围、区域、数据类型等多条件组合筛选
• 数据下钻：从宏观数据逐层深入至微观细节，如从城市级数据下钻至街区级数据
• 搜索与定位：快速检索特定数据集或地理位置相关数据
• 数据导出：支持将探索结果导出为CSV、PNG等格式

数据集管理支持

• 集成数据集元数据展示，包括数据来源、更新频率、字段说明等
• 支持数据集收藏与历史查询记录保存
• 提供数据质量指标可视化，辅助用户评估数据可靠性

系统兼容性

• 响应式设计，适配桌面端、平板及移动端设备
• 支持主流现代浏览器（Chrome、Firefox、Safari、Edge）
• 可与常见智慧城市数据平台（如CKAN、ArcGIS、IoT平台）后端API对接

使用场景与适用范围

城市规划与管理部门

用于日常城市运行数据监控、规划方案效果模拟分析，辅助决策制定。

智慧城市研究机构

支持科研人员快速探索多源城市数据，加速城市问题研究与解决方案验证。

城市运营中心

作为实时数据监控看板，展示城市关键指标（如交通流量、空气质量、能源使用），支持运营调度。

公众数据开放平台

为市民提供直观的城市数据访问渠道，提升城市治理透明度与公众参与度。

使用方法与配置说明

基本运行命令

通过以下命令快速启动镜像（默认配置）：

bash
docker run -d \
  -p 80:80 \
  --name smart-city-frontend \
  [镜像名称]:[版本标签]

环境变量配置

示例（指定中文界面与后端API）：

bash
docker run -d \
  -p 8080:80 \
  -e DATA_API_URL="https://smart-city-backend.example.com/api" \
  -e LANG="zh-CN" \
  -e THEME="dark" \
  --name smart-city-frontend \
  [镜像名称]:[版本标签]

Docker Compose 配置示例

以下为配合后端API服务的典型docker-compose.yml配置：

yaml
version: '3.8'

services:
  frontend:
    image: [镜像名称]:[版本标签]
    ports:
      - "80:80"
    environment:
      - DATA_API_URL="http://backend:8080/api"
      - LANG="zh-CN"
      - PORT="80"
    depends_on:
      - backend
    restart: unless-stopped

  backend:
    image: [后端API镜像名称]:[版本标签]
    # 后端服务配置（示例）
    ports:
      - "8080:8080"
    environment:
      - DB_HOST="db"
      - DB_PORT="5432"
    # ...（其他后端配置）

  db:
    # 数据库服务配置（示例）
    image: postgres:14
    volumes:
      - postgres-data:/var/lib/postgresql/data
    # ...（其他数据库配置）

volumes:
  postgres-data:

数据接口要求

前端镜像需与符合以下规范的后端API对接：

• 基础路径：${DATA_API_URL}/datasets（数据集列表）
• 支持HTTP方法：GET（查询）、OPTIONS（跨域预检）
• 响应格式：JSON，包含data（数据集内容）、metadata（元数据）、status（状态码）字段

注意事项

• 镜像本身不存储数据集，需确保后端API服务（DATA_API_URL）可访问且返回有效数据
• 生产环境建议配置HTTPS（可通过反向代理如Nginx实现）
• 大规模数据集探索时，建议调整CACHE_TTL参数以平衡性能与数据实时性
• 首次启动时可能需要几分钟加载基础资源，具体时间取决于网络环境