jawanndennダウンロード - jawanndennソースコードのダウンロード

jawanndenn

その他のソースコード

2.6.0

ダウンロード

ジャワンデンとは何ですか？

jamanndenn は、会議をスケジュールし、投票を実行するためのシンプルな Web アプリケーションであり、Doodle に代わる自由な代替手段です。以下のテクノロジーを使用しています。

パイソン
- Docker Compose
- ジャンゴ
  Django 拡張機能
  Django Ratelimit + msgpack-python
  ジャンゴレディス
  Django REST フレームワーク
  ファクトリーボーイ
- ガニコーン + ガニコーンカラーロガー
- パラメータ化された
- 事前コミット
- python-rapidjson
- セントリーパイソン
- 待ってください
JavaScript / CSS / フォント
- Google ウェブフォントヘルパー
- jQuery
- jQueryの注目点
- 実体化する
- ロボト
ストレージ
- PostgreSQL
- レディス
- SQLite
スケジュール設定
- 超クロニック

jamanndenn はSebastian Pipping によって開発されたリブレソフトウェアです。サーバーコードは GNU Affero GPL ライセンスバージョン 3 以降に基づいてライセンスされ、クライアントコードは GNU GPL ライセンスバージョン 3 以降に基づいてライセンスされます。

バグを報告して、気に入った場合はお知らせください。

ポーリング設定フォーマット

「セットアップ (JSON)」というタイトルのテキストエリアでは、次のキーを認識する単純な JSON ベースの形式が使用されます。

equal_width — 潜在的な投票者のバイアスに対抗するために、すべてのオプションを同じ幅 ( trueまたはfalse ) に引き上げるかどうかを制御するブール値
lifetime — このポーリングが削除されるまでの期間。 "week"または"month"を指定できます。 enum のような文字列
options — オプションごとに 1 つずつの文字列のリスト。マークダウンに似た構文をサポート: 太字、斜体、インラインコード
title — 実行する投票のタイトルまたは見出し。マークダウンに似た構文をサポート: 太字、斜体、インラインコード

インストール

Git リポジトリのクローンを作成せずに最新リリースをインストールするには:

 # pip3 インストール jamanndenn --user

Git クローンからインストールするには:

 # ./setup.py インストール --user

docker-compose を使用したデプロイメント

次のような単純なファイル.envを作成します。

 JAWANNDENN_POSTGRES_NAME=ジャワンデン
JAWANNDENN_POSTGRES_USER=ジャワンデン
JAWANDENN_POSTGRES_PASSWORD=dEb2PIcinemA8poH
JAWANNDENN_SECRET_KEY=606ea88f183a27919d5c27ec7f948906d23fdd7821684eb59e8bcf7377e3853b

コピーして貼り付けた後は、必ずこれらの値を調整してください。

その後、 docker-compose up --build使用して Docker イメージをビルドして実行できます。

アプリはlocalhost:54080で提供されます。 PostgreSQL データは、ホストシステム上の~/.jawanndenn-docker-pgdata/に保存されます。また、プロセス間のレート制限に使用される Redis のインスタンスと、構成された有効期間を超えたポーリングを 60 分ごとに削除する「cron」ハウスキーピングコンテナーもあります。

(jawanndenn の前にメンテナンスの手間がかからない SSL リバースプロキシが必要な場合は、docker-ssl-reverse-proxy が興味深いかもしれません。)

ご使用の環境で調整できる環境変数がさらにいくつかあります。全体として、次の変数があります。

環境変数

`DJANGO_SETTINGS_MODULE`

使用する Django 設定モジュール。デフォルトはjawanndenn.settingsです ( docker-compose.ymlを参照)。

`JAWANNDENN_ALLOWED_HOSTS`

jamanndenn にサービスを提供するホスト名 (カンマ区切りのリスト) は、メイン実稼働サーバーではjawanndenn.de,www.jawanndenn.deに設定され、デフォルトは127.0.0.1,0.0.0.0,localhostです ( jawanndenn/settings.pyを参照)

`JAWANNDENN_DEBUG`

デバッグモードは、 Trueを除くすべての値で無効になっており、デフォルトで無効になっていますが、セキュリティのために運用環境では有効にしないでください ( jawanndenn/settings.py参照)

`JAWANNDENN_MAX_POLLS`

保存するポーリングの最大合計数、サービス拒否保護、デフォルトは1000 ( jawanndenn/settings.pyおよびdocker-compose.ymlを参照)

`JAWANNDENN_MAX_VOTES_PER_POLL`

保存するポーリングの最大合計数、サービス拒否保護、デフォルトは40 ( jawanndenn/settings.pyを参照)

`JAWANNDENN_POSTGRES_HOST`

接続先の PostgreSQL データベースのホスト名。デフォルトはpostgres ( docker-compose.ymlを参照)

`JAWANNDENN_POSTGRES_NAME`

接続する PostgreSQL データベースのデータベース名。デフォルトなし、常に必須

`JAWANNDENN_POSTGRES_PASSWORD`

PostgreSQL データベースにログインするためのパスワード。デフォルトなし、常に必須

`JAWANNDENN_POSTGRES_PORT`

接続する PostgreSQL データベースのポート。デフォルトは5432 ( docker-compose.ymlを参照)

`JAWANNDENN_POSTGRES_USER`

PostgreSQL データベースにログインするためのユーザー名。デフォルトなし、常に必須

`JAWANNDENN_REDIS_HOST`

接続する Redis データベースのホスト名。デフォルトはredis ( docker-compose.ymlを参照)

`JAWANNDENN_REDIS_PORT`

接続する Redis データベースのポート。デフォルトは6379 ( docker-compose.ymlを参照)

`JAWANNDENN_SECRET_KEY`

Django の秘密鍵。長く、生成され、他の場所で使用されないようにする必要があります。デフォルトなし、常に必須

`JAWANNDENN_SENTRY_DSN`

Sentry で使用するデータソース名 (DSN)、デフォルトで無効/空 ( jawanndenn/settings.py参照)

`JAWANNDENN_URL_PREFIX`

同じドメインで複数のアプリを並べてホストするのに役立つように、ドメイン名の後ろではなく URL に挿入するプレフィックス文字列。たとえば、プレフィックスprefix123はhttps://<domain>/prefix123/poll/<id>のような URL になります。デフォルトでは空です ( jawanndenn/settings.py参照)

コマンドラインの使用法

インストールすると、呼び出しは次のように簡単になります。

 # ジャワンデン

開発中に、次を使用して Git クローンからjamanndenn を実行することもできます。

 # パイソンパス=。 python3 -m jamanndenn --debug

現在サポートされている引数は次のとおりです。

 # ジョワンデン -- ヘルプ
使用法: jamanndenn [-h] [--debug] [--host HOST] [--port PORT]
                  [--url-prefix PATH] [--database-sqlite3 ファイル]
                  [--django-secret-key-file ファイル] [--max-polls COUNT]
                  [--投票ごとの最大投票数 COUNT] [--dumpdata]
                  [--loaddata ファイル.json]

オプションの引数:
  -h、--help このヘルプ メッセージを表示して終了します
  --debug デバッグ モードを有効にします (デフォルト: 無効)
  --host HOST リッスンするホスト名または IP アドレス (デフォルト:
                        127.0.0.1)
  --port PORT リッスンするポート (デフォルト: 8080)
  --url-prefix PATH URL の前に付加するパス (デフォルト: "")
  --database-sqlite3 ファイル
                        データベースに書き込むファイル (デフォルト:
                        ~/jawanndenn.sqlite3)
  --django-secret-key-file ファイル
                        Django 秘密鍵データに使用するファイル (デフォルト:
                        ~/jawanndenn.secret_key)

制限設定:
  --max-polls COUNT 合計ポーリングの最大数 (デフォルト: 1000)
  --投票あたりの最大投票数 COUNT
                        投票ごとの最大投票数 (デフォルト: 40)

データのインポート/エクスポート引数:
  --dumpdata データベースの JSON エクスポートを標準出力にダンプします。
                        それからやめてください。
  --loaddata FILE.json FILE.json からデータベースの JSON エクスポートをロードします。
                        それからやめてください。

jamanndenn 1.x から 2.x へのデータの移行

移行には 4 つの手順が必要です。

たとえば、次のコマンドを実行して、jawanndenn 1.x の最新バージョンに更新します。 pip2 install --upgrade 'jawanndenn<2' ; JSON データエクスポートはリリース 1.6.3 で初めて導入されました。
既存の投票をエクスポートします。
1. コマンドラインアプリを使用している場合: python2 -m jawanndenn --dumpdata > dump.json
2. docker-compose を使用している場合: docker-compose run -T jawanndenn --database-pickle /data/polls.pickle --dumpdata > dump.json
最新の jamanndenn 2.x をどこかにデプロイするか (上記のとおり)、あるいは単にpip3 install 'jawanndenn>=2'
手順 (2) で作成した JSON ダンプをインポートします。
1. コマンドラインアプリを使用している場合: python3 -m jawanndenn --loaddata dump.json
2. docker-compose を使用している場合: docker-compose run -T jawanndenn sh -c 'cat > /tmp/dump.json && DJANGO_SETTINGS_MODULE=jawanndenn.settings python3 -m django loaddata /tmp/dump.json' < dump.json

目標

Doodleとは異なり、自分自身をホストするLibreソフトウェア
リブレよりもシンプルで、セクシーで、楽しいものをアルファベット順に並べたもの:
- Bitpoll (例: Dudel)
- クラブフィット
- クルドル
- ダドル
- (Drupal 日付ピッカーフォーマッタ)
- (Foodle (廃止; GitHub 上、ex. DFN スケジューラ、ex. DFN Terminplaner+))
- Framadata (ソース、例: OpenSondage、例: STUdS)
- Nextcloud 投票
- 麺
- ヌアージュ
- プレフト
- ラリー
- RDVz
- いつか
- 投票日
物事をシンプルに、使いやすく、保守しやすくする
コマンドラインからの呼び出しのサポート (LAN 内での自発的なポーリングなど)
セキュリティを念頭に置く

今後の機能のリストをご確認ください。

非目標

重いフロントエンドフレームワークの使用: ビルディングブロックのみ
カレンダーから空き状況を読み取る

ありがとう

XSS 脆弱性を責任を持って報告してくださった Arne Maier (@KordonDev) に心より感謝いたします。

拡大する

追加情報

バージョン 2.6.0
タイプその他のソースコード
更新時間 2024-12-20
サイズ 3.53MB
から Github