The extension to feedback on CKAN datasets such as review, number of downloads,use-cases,resolved-problems, and way of use
Project description
ckanext-feedback
このCKAN Extensionはデータ利用者からのフィードバックを得るための機能を提供します。 本Extensionの利用者からの意見・要望や活用事例の報告を受け付ける仕組み等によって、データ利用者はデータの理解が進みデータ利活用が促進され、データ提供者はデータのニーズ理解やデータ改善プロセスの効率化が行えます。
フィードバックにより利用者と提供者間でデータを改善し続けるエコシステムを実現することができます。
主な機能
- 👀 集計情報の可視化機能(ダウンロード数、利活用数、課題解決数)
- 💬 データおよび利活用方法に対するコメント・評価機能
- 🖼 データを利活用したアプリやシステムの紹介機能
- 🏆 データを利活用したアプリやシステムの課題解決認定機能
クイックスタート
-
CKANの仮想環境をアクティブにする(CKANコンテナ等の環境内で実行してください)
. /usr/lib/ckan/venv/bin/activate
-
仮想環境にckanext-feedbackをインストールする
pip install ckanext-feedback
-
以下のコマンドで設定を行うファイルを開く
vim /etc/ckan/production.ini
-
以下の行に
feedback
を追加ckan.plugins = stats ・・・ recline_view feedback
-
フィードバック機能に必要なテーブルを作成する
ckan --config=/etc/ckan/production.ini feedback init
構成
本Extensionは3つのモジュールで構成されています
設定や管理に関するドキュメント
-
リソースや利活用方法へのコメントを管理することが出来ます
- 詳しくは管理者用画面ドキュメントをご覧ください
-
特定のモジュールのみを利用することも可能です
- 設定方法はオンオフ機能の詳細ドキュメントをご覧ください
開発者向け
ビルド方法
-
ckanext-feedback
をローカル環境にGitHub上からクローンするgit clone https://github.com/c-3lab/ckanext-feedback.git
-
ckanext-feedback/development
下にあるsetup.py
を実行し、コンテナを起動 -
CKAN公式の手順に従い、以下のコマンドを実行
docker exec ckan /usr/local/bin/ckan -c /etc/ckan/production.ini datastore set-permissions | docker exec -i db psql -U ckan
docker exec -it ckan /usr/local/bin/ckan -c /etc/ckan/production.ini sysadmin add admin
-
以下のコマンドを実行し、コンテナ内に入る
docker exec -it ckan bash
-
CKANの仮想環境をアクティブにする
. /usr/lib/ckan/venv/bin/activate
-
仮想環境にckanext-feedbackをインストールする
pip install /opt/ckanext-feedback
-
以下のコマンドで設定を行うためのファイルを開く
vim /etc/ckan/production.ini
-
以下の行に
feedback
を追加ckan.plugins = stats ・・・ recline_view feedback
-
フィードバック機能に必要なテーブルを作成する
ckan --config=/etc/ckan/production.ini feedback init
-
http://localhost:5000
にアクセスする
参考ドキュメント
テスト
-
上記のビルド方法に従い、ビルドを行う
-
コンテナ内に入る
docker exec -it --user root ckan /bin/bash
-
その他の必要なものをインストールする
pip install -r /usr/lib/ckan/venv/src/ckan/dev-requirements.txt pip install pytest-ckan
-
テスト用DBを作成する
createdb ckan_test -O ckan -E utf-8 -h db -U ckan
-
ディレクトリを移動
cd /usr/lib/ckan/venv/lib/python3.8/site-packages/ckanext/feedback/tests
-
テストを実行
CKAN_SQLALCHEMY_URL= CKAN_DATASTORE_READ_URL= CKAN_DATASTORE_WRITE_URL= pytest -s --ckan-ini=config/test.ini --cov=ckanext.feedback --cov-branch --disable-warnings ./
LICENSE
CopyRight
Copyright (c) 2023 C3Lab
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ckanext_feedback-1.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f648630603b77bf1a7be22ce455eabd1db0d65214194231d2075cb24a6cf2d80 |
|
MD5 | 6a1205481990d30f645ea236fb06e783 |
|
BLAKE2b-256 | 0fea06f7dd992c5500b4d610527b59edbb681a98c21cd5435a50380eab3ed917 |