oneacrefund/kpi

oneacrefund/kpi 镜像说明

镜像概述

oneacrefund/kpi是Kobotoolbox生态系统的核心组件之一，基于Django框架开发，专注于关键绩效指标（KPI）管理。它提供数据资产查询、管理员报表、多语言支持等功能，帮助组织高效监控项目绩效与数据收集情况。

核心功能

• 数据资产过滤：通过tags和api/v2/assets端点，使用布尔查询（如owner__username:meg AND name__icontains:quixotic）筛选资产；
• 管理员报表：超级用户可获取用户详情、项目部署数、提交数据量等CSV格式报表；
• 多语言支持：通过Transifex拉取翻译文件，编译后实现界面多语言切换；
• Django管理界面：超级用户通过/admin访问，可配置用户账户或模拟登录其他用户；
• 图标管理：支持自定义SVG图标，生成字体类名并预览。

使用场景

• 组织内部项目绩效监控与分析；
• 数据收集平台的KPI跟踪；
• 多语言环境下的项目管理与数据可视化。

配置说明

1. Python依赖管理：使用pip-tools，更新dependencies/pip/*.in文件后执行make pip_compile；
2. Ubuntu系统依赖：安装dependencies/apt_requirements.txt中的包（如apt-get install $(cat dependencies/apt_requirements.txt)）；
3. 翻译配置：拉取子模块→用tx pull --all获取最新翻译→执行python manage.py compilemessages生成.mo文件；
4. 升级注意：从2.020.18版本前升级需迁移数据库至独立实例，否则使用shared-database-obsolete分支。

部署示例（docker-compose）

yaml
version: '3'
services:
  kpi:
    image: oneacrefund/kpi
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgres://kpi_user:kpi_pass@db:5432/kpi_db
    depends_on:
      - db
  db:
    image: postgres:12
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      - POSTGRES_USER=kpi_user
      - POSTGRES_PASSWORD=kpi_pass
      - POSTGRES_DB=kpi_db
volumes:
  postgres_data: