kartoza/kbims_uwsgi

BIMS

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

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

详细使用方法和配置说明

项目活动状态

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

快速项目设置

详细配置请参考https://github.com/kartoza/django-bims/blob/develop/deployment/ansible/README.md%E3%80%82%E7%A1%AE%E4%BF%9D%E5%B7%B2%E5%AE%89%E8%A3%85ansible%EF%BC%8C%E9%85%8D%E7%BD%AE%E5%A5%BDall.yml%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E4%BD%BF%E7%94%A8PyCharm%E6%89%93%E5%BC%80%E9%A1%B9%E7%9B%AE%EF%BC%8C%E6%89%A7%E8%A1%8C%E4%BB%A5%E4%B8%8B%E5%91%BD%E4%BB%A4%EF%BC%9A

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：***

相关链接

• http://github.com/kartoza/django-bims
• https://github.com/kartoza/django-bims/blob/develop/README-dev.md
• Docker官方网站
• https://github.com/kartoza/django-bims/blob/develop/deployment/ansible/README.md