naturecons/whattodo

What To Do：交互式管理行动优先级排序应用

概述和主要用途

What To Do应用是加拿大自然保护协会（Nature Conservancy of Canada）的交互式决策支持工具，旨在帮助优先排序管理行动。该工具支持通过Excel表格和（可选）shapefile上传数据（shapefile用于描述站点的空间位置），采用混合整数规划技术生成优先级方案，并提供汇总统计数据和表格以分析候选优先级的表现，最终支持数据和优先级结果下载用于后续分析。

核心功能和特性

• 多格式数据上传：支持Excel表格上传核心数据，可选上传shapefile以提供站点空间位置信息
• 科学优先级生成：采用混合整数规划技术，基于输入数据生成管理行动优先级
• 结果可视化分析：通过汇总统计数据和表格直观展示候选优先级的表现
• 数据导出功能：支持下载原始数据和生成的优先级结果，便于后续深入分析

使用场景和适用范围

主要适用于加拿大自然保护协会的管理决策场景，尤其适合需要考虑空间位置信息的站点管理行动优先级排序，帮助决策者基于数据驱动方式确定优先实施的管理措施。

使用方法和配置说明

在线使用

应用提供在线服务（[*] Chrome浏览器访问。输入数据需符合特定格式，建议通过https://github.com/NCC-CNC/whattemplatemaker%E5%87%86%E5%A4%87%E8%BE%93%E5%85%A5%E6%95%B0%E6%8D%AE%E3%80%82

本地部署（Docker方式）

前提条件

• 安装Docker Engine（参考Docker官方安装指南）

部署步骤

1. 拉取并运行镜像
   执行以下命令启动应用容器：

   bash
   docker run -dp 3838:3838 --name whattodo -it naturecons/whattodo:latest
   

   • -d：后台运行容器
   • -p 3838:3838：将容器3838端口映射到主机3838端口
   • --name whattodo：指定容器名称为whattodo
   • naturecons/whattodo:latest：使用最新版镜像

2. 访问应用
   在Google Chrome浏览器中打开：http://localhost:3838

3. 停止应用
   使用完毕后，执行以下命令停止并删除容器：

   bash
   docker rm -f whattodo
   

   注意：若不主动停止，容器将在后台持续运行

本地部署（Docker Compose方式）

前提条件

• 安装Docker Engine和Docker Compose（分别参考Docker安装指南和Docker Compose安装指南）

部署步骤

1. 克隆代码仓库
   参考https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github/cloning-a-repository%E5%85%8B%E9%9A%86%E5%BA%94%E7%94%A8%E4%BB%93%E5%BA%93

2. 启动服务
   在仓库目录下执行：

   bash
   docker-compose pull
   docker-compose up -d
   

   • docker-compose pull：拉取最新镜像
   • docker-compose up -d：后台启动服务

3. 访问应用
   在Google Chrome浏览器中打开：http://localhost:3838

4. 停止服务
   使用完毕后，执行以下命令停止并清理服务：

   bash
   docker-compose down
   

技术架构（开发参考）

应用基于R统计计算环境开发，是一个Shiny Web应用，采用golem框架构建（本质为R包形式）。代码文件（位于./R目录）按功能模块组织，遵循以下命名规范：

• app_*：应用核心定义（配置、初始化、服务端逻辑、用户界面）
• server_*：服务端逻辑组件
• ui_*：前端界面元素生成函数
• fct_*：后端分析与数据处理函数
• utils_*：通用工具函数

获取帮助

• 缺陷报告：若遇到应用崩溃、异常行为或拼写错误，可在https://github.com/NCC-CNC/whattodo/issues%E6%8F%90%E4%BA%A4
• 使用咨询：联系Richard Schuster博士（）或Joe Bennett教授（）