BIMS

镜像概述和主要用途

BIMS是一个基于Django框架开发的应用程序，目前处于开发阶段，功能尚未完全完善。其主要用途与健康河流（HealthyRivers）相关功能实现有关，支持通过Docker进行部署，最新源代码可通过GitHub仓库获取。

核心功能和特性

• 基于Django框架构建，便于集成到现有Django项目
• 支持Docker容器化部署，简化环境配置流程
• 提供命令行工具（make命令）辅助项目构建、部署和维护
• 可作为独立Django应用包集成到其他Django项目中

使用场景和适用范围

适用于需要开发或部署健康河流相关功能的开发者，以及需要快速搭建Django应用原型的场景。由于项目处于开发中，建议用于测试和开发环境，暂不推荐生产环境直接使用。

详细使用方法和配置说明

项目活动状态

• 任务状态：包含"就绪"（Ready）和"进行中"（In Progress）两种状态
• 测试状态：
  • master分支：Travis CI构建状态
  • develop分支：Travis CI构建状态

快速项目设置

详细配置请参考项目设置指南。确保已安装ansible，配置好all.yml文件，并使用PyCharm打开项目，执行以下命令：

bash
make ansible-check  # 检查并空运行ansible任务（ dry-run ）
make setup-ansible  # 生成项目配置文件

Docker快速安装指南

部署需依赖Docker环境，请确保主机已运行Docker服务。建议具备基本的Django应用运行知识以更好地理解部署流程。

bash
# 1. 克隆源代码仓库
git clone git://github.com/kartoza/django-bims.git

# 2. 构建项目
make build

# 3. 设置文件权限
make permissions

# 4. 启动Web服务（需等待数据库启动完成，建议等待几秒后执行后续命令）
make web

# 5. 执行数据库迁移
make migrate

# 6. 收集静态文件
make collectstatic

创建管理员账户

部署完成后，通过以下命令创建管理员账户：

bash
make superuser

作为Django应用包安装

若需将BIMS集成到现有Django项目中，按以下步骤操作：

1. 在项目的INSTALLED_APPS配置中添加"bims"：

   python
   INSTALLED_APPS = [
       'bims',  # 添加BIMS应用
   ]
   

2. 在项目的urls.py中包含BIMS的URL配置：

   python
   from django.urls import path, include
   
   urlpatterns = [
       # 其他URL配置...
       path('bims/', include('bims.urls')),  # 添加BIMS URL路由
   ]
   

3. 执行数据库迁移以创建BIMS所需的数据表：

   bash
   python manage.py migrate
   

可选配置参数

使用地图相关功能时，需在core/settings/secret.py文件中配置以下参数：

边界生成

BIMS通过边界数据实现聚类功能，生成边界数据的命令如下：

bash
make generate-boundaries

贡献者

感谢以下开发者对项目的贡献：

• Christian Christelis（首席开发者）：***
• Tim Sutton（首席开发者）：***
• Dimas Ciptura：***
• Irwan Fathurrahman：***
• Anita Hapsari：***

相关链接

• 源代码仓库
• 开发者指南
• Docker***网站
• 项目设置指南