跳转到主要内容

搜索和咨询CADA建议

项目描述

CADA

Join the chat at https://gitter.im/etalab/cada

一个用于搜索和咨询CADA建议的简单界面。

这是https://cada.data.gouv.fr背后的引擎。

兼容性

CADA已经在Python 3.7、MongoDB 4.1和ElasticSearch 7.2上进行了测试。

需要ElasticSearch ICU分析插件

您可以使用以下命令安装它

elasticsearch-plugin install analysis-icu

安装

您可以使用pip安装Cada

$ pip install cada

您需要创建cada工作目录,本文件中用$HOME表示

$ mkdir -p $HOME && cd $HOME
$ vim cada.cfg  # See configuration
$ wget https://cada.data.gouv.fr/export -O data.csv
$ cada load data.csv  # Load initial data
$ cada static  # Optional: collect static assets for proper caching
$ cada runserver

本地开发环境

请确保您在一个干净的virtualenv中。

$ git clone https://github.com/etalab/cada
$ cd cada
$ docker-compose up -d
$ pip install -e .
$ wget https://cada.data.gouv.fr/export -O data.csv
$ cada load data.csv
$ cada reindex
$ cada runserver

配置

所有配置都是通过$HOME目录中的cada.cfg文件完成的。它基本上是一个包含常量的Python文件

  • SERVER_NAME:公共服务器名称。主要在电子邮件中使用。
  • SECRET_KEY:通用加密散列。例如,会话。使用openssl rand -hex 24作为起点应该是一个不错的选择。
  • ELASTICSEARCH_URL:以host:port格式表示的ElasticSearch服务器URL。未设置时默认为localhost:9200
  • MONGODB_SETTINGS:一个字典,用于配置MongoDB。默认为{'DB': 'cada'}。更多详情请参阅官方flask-mongoengine文档

邮件

邮件服务器配置通过以下变量完成

  • MAIL_SERVER:SMTP服务器主机名。默认为localhost
  • MAIL_PORT:SMTP服务器端口。默认为25
  • MAIL_USE_TLS:激活TLS。默认为False
  • MAIL_USE_SSL:激活SSL。默认为False
  • MAIL_USERNAME:可选的SMTP服务器用户名。
  • MAIL_PASSWORD:可选的SMTP服务器密码。
  • MAIL_DEFAULT_SENDER:用于邮件的发送者邮箱。默认为cada@localhost
  • ANON_ALERT_MAIL:匿名化警报的目标邮箱。默认为cada.alert@localhost

更多详情请参阅官方Flask-Mail文档

Sentry

可选支持Sentry。您需要安装所需的依赖项

$ pip install raven[flask]
# Or to install it with cada
$ pip install cada[sentry]

您需要将Sentry DSN添加到配置中

SENTRY_DSN = 'https://xxxxx:xxxxxx@sentry.mydomain.com/id'

Piwik

可选支持Piwik。您只需将Piwik服务器URL和Piwik项目ID添加到配置中

PIWIK_URL = 'piwik.mydomain.com'
PIWIK_ID = X

1.0.1 (2024-04-26)

  • 尚未添加

1.0.0 (2019-07-19)

  • 添加burnthemall命令#25
  • 在循环的主要命令中使用tqdm#25
  • Python 3 #28
  • Elastic Search 7.2 #29
  • Mongo 4.1 #29
  • 改进匿名化 #32
  • 显示API调用示例 #33
  • 修复文本查询 #33

0.2.1 (2019-07-15)

  • 修复建议部分罗马数字处理 #13
  • 为建议标签着色 #14
  • 修复关于页面 #11
  • 修复cli编码处理以及一些格式化问题 #18
  • 修复页脚(svg标志、对齐、https链接) #20
  • 升级jQuery、Bootstrap和Flatly资产,并修复响应式布局 #21
  • 修复Unicode问题 #26

0.2.0 (2018-10-05)

  • 升级到最新依赖项(Flask 1.0与flask.cli、pytest...) #6
  • 测试并修复警报邮件 #7
  • 添加“关于”页面 #9
  • 处理类型IV建议 #10

0.1.0 (2014-04-14)

  • 初始版本

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面