teamdigitale/anpr-dashboard

ANPR仪表板服务器

镜像概述

ANPR仪表板服务器是基于Go语言开发的应用，用于提供意大利市政当局向国家注册处（ANPR）迁移状态的数据。该服务通过REST API接口和图形用户界面（GUI）暴露数据，支持下载现有数据集及上传CSV格式的新数据，相关统计图表可在ANPR迁移状态网站查看。

核心功能

1. 数据交互：支持CSV格式的数据集下载与新数据上传；
2. 数据暴露：通过REST API和GUI提供迁移状态数据；
3. 统计展示：通过GUI呈现关键统计图表；
4. 多环境支持：可在本地开发机或Docker容器中运行；
5. 定期更新：通过cronjob脚本周期性获取最新ANPR数据。

使用场景

• 意大利市政迁移状态的实时监控与统计分析；
• 开发人员在本地或容器环境中测试验证应用功能；
• 相关机构获取并分析迁移数据以支持决策。

配置说明

本地运行

shell
# 配置
cd anpr-dashboard-server/server
mkdir creds
cp {管理员提供的三个配置文件} creds
mkdir dashboard-subentro
cp {管理员提供的另一配置文件} subentroconfig.yaml dashboard-subentro/

# 构建项目
make build

# 运行服务
./server --mode=debug --config-file=/<你的工作区路径>/anpr-dashboard-server/dashboard-subentro/subentroconfig.yaml

Docker容器运行

仓库根目录提供Dockerfile和docker-compose.yaml文件。默认挂载示例配置文件到容器，可按需修改。

注意：cookie-creds/data.json初始为空，每次运行生成新密钥。

启动容器：

shell
docker-compose up [-d] [--build]

参数说明：

• -d：后台运行容器；
• --build：强制重新构建容器。

服务启动后，GUI访问地址为http://127.0.0.1:8080/，API访问地址为http://127.0.0.1:8080/api/（例如：http://127.0.0.1:8080/api/dashboard/data.json可获取演示数据）。

停止容器：

shell
docker-compose down

Cronjob镜像与脚本

自定义脚本定期获取最新ANPR数据并更新仪表板，通常以Docker容器形式在Kubernetes上运行。相关脚本、Dockerfile及docker-compose文件位于仓库cronjob目录。

查询示例

查询示例页面提供从数据库提取有用信息的相关查询示例。

贡献方式

欢迎贡献！随时提交issue或pull request。

许可证

版权所有 (c) 2020 意大利部长会议主席

本程序是自由软件：您可根据自由软件基金会发布的GNU Affero通用公共许可证（版本3或更高版本）重新分发和/或修改它。

本程序发布旨在希望它有用，但不提供任何担保，甚至不隐含适销性或特定用途的担保。详见GNU Affero通用公共许可证。

您应已收到该许可证副本，如未收到，请查看<[***]>。