codefornl/consul

CONSUL：公民参与和开放***应用平台

!https://raw.githubusercontent.com/consul/consul/master/public/consul_logo.png

概述

CONSUL是一个开源的公民参与和开放应用平台，最初为马德里市的电子参与网站开发。该平台旨在促进公民参与公共决策，提供提案提交、公开辩论、投票和协商等功能，支持开放治理和民主参与。

核心功能和特性

主要功能

• 提案管理：公民可提交公共政策提案，进行讨论和完善
• 公开辩论：支持针对提案的多方讨论和意见交流
• 投票系统：实现对提案的民主投票，反映公民意愿
• 协商机制：促进***与公民之间的双向沟通
• 参与式预算：支持公民参与预算分配决策

技术特性

• 多语言支持：通过Crowdin平台支持多语言本地化
• 可访问性：符合WAI:AA无障碍标准，确保广泛使用
• 开源代码：基于AGPL v3许可证，支持自定义和二次开发
• 持续集成：通过Travis CI进行构建验证，Code Climate保障代码质量

使用场景和适用范围

CONSUL适用于需要增强公民参与的各类组织和机构，包括：

• 地方***和市政机构
• 公共政策制定部门
• 社区组织和非营利机构
• 学术研究机构（用于参与式治理研究）

使用方法和配置说明

Docker开发环境配置

bash
# 克隆代码仓库
git clone https://github.com/consul/consul.git
cd consul

# 启动Docker服务
docker-compose up -d app

# 数据库迁移
docker-compose run migration

# （可选）安装示例数据
docker-compose run prepare

开发和测试环境配置

前提条件

• git
• Ruby 2.3.8
• bundler gem
• Node.js
• PostgreSQL (>=9.4)
• ChromeDriver >= 2.33（用于测试）

配置步骤

bash
# 克隆代码仓库
git clone https://github.com/consul/consul.git
cd consul

# 安装依赖
bundle install

# 配置数据库和密钥
cp config/database.yml.example config/database.yml
cp config/secrets.yml.example config/secrets.yml

# 初始化数据库
bin/rake db:create
bin/rake db:migrate
bin/rake db:dev_seed

# 配置测试环境数据库
RAILS_ENV=test rake db:setup

本地运行应用

bash
bin/rails s

运行测试

bash
bin/rspec

默认用户

• 管理员用户：，密码：
• 已验证用户（用于投票等操作）：，密码：

生产环境配置

生产环境配置请参考官方安装工具：https://github.com/consul/installer

项目状态

• 开发始于2015年7月15日
• 2015年9月7日部署至生产环境（decide.madrid.es）
• 持续添加新功能，当前功能可在项目官网查看
• 未来功能规划见https://github.com/consul/consul/projects/6%E5%92%8Chttps://github.com/consul/consul/issues

许可证

代码基于AGPL v3许可证发布（详见LICENSE-AGPLv3.txt）

贡献

贡献指南详见CONTRIBUTING.md

相关资源

• 项目文档：[***]
• 项目官网：[***]
• 社区交流：Gitter聊天室