Extension:SecurePoll/ja

SecurePoll拡張機能は選挙、投票そして【調査】に用いる特別なページ拡張機能です. 【これは】【現在】、ウィキメディア財団の理事会選挙と裁定委員会選挙で使用されています. また【過去には】ウィキメディアのライセンス移行投票などにも用いられました.

インストール
また、新しい" "ユーザー権限を特定の利用者グループに割り当てる必要があります. ‎ この権限を管理者に割り当てるには、 に以下を追加します. ‎

‎これにより、すべての管理者が投票を作成できますが、すべての管理者が特定の投票を管理‎（投票の編集、利用者情報の閲覧などを含む）できるわけではありません. 個別の投票における管理者は、投票の作成もしくは編集の段階で決定します. 【特定の　←　a 特定のでOK？　】投票の管理ができるのは「 」グループの成員に限定されます. このグループを作成するには、以下を皆さんの に追加します. :

次にSpecial:UserRights経由で、特定【希望】の利用者を に割り当てます. 選挙管理者は投票者情報を閲覧できることから、このグループへの【任命←割り当て？】は【信頼された】利用者に限定するべき点にご留意ください. 当該グループから【除去された　←解任？　】場合、今後、一切の選挙で管理者になれません.

使用法
新規投票の作成

There are two ways to create a new poll: manually create an XML file and import it, or use the poll creation interface at Special:SecurePoll.

Manually
To create a poll manually, it is required to:


 * 1) write an XML file
 * 2) import it using the   command-line interface command

In the test folder you can find four example files:


 * info
 * info
 * info
 * info

To import a poll, run the following from the cli folder:

To import a poll using docker, run the following from the cli folder:

Via the web interface
A user with the  right can create a new poll via the link at the bottom of Special:SecurePoll.

To create a new poll, fill in the mandatory fields in the create form. Special care may be needed with the following fields:


 * When adding poll admins, only members of the  group are allowed. If   is set to , it will be logged whenever an admin is added to or removed from a poll. The logs can be viewed at Special:SecurePollLog.
 * To create an encrypted poll, select the radio for the encryption method. If you choose GnuPG, generate a (public) encryption key and a (private) decryption key. Enter the encryption key into the create form, and keep the private key safe somewhere offline (you will need it for tallying, once the election has finished). A detailed example can be found here.

Now visit Special:SecurePoll and you will see your poll.

既設の投票の編集
投票の編集は当該の投票の管理者のみに認められます. From Special:SecurePoll, click on the Edit link for the poll you want to edit.

Before an election has begun, anything about the election can be edited. After an election has begun, some fields can no longer be edited.

有権者の要件を編集
To edit who can vote in a poll, you must be an admin of the particular poll. From Special:SecurePoll, click on the Voter Eligibility link for the poll.

投票の翻訳
投票の翻訳は当該の投票の管理者にのみ認められます. From Special:SecurePoll, click on the Translate link for the poll you want to translate.

投票者一覧の閲覧
投票が作成されたときに、透明性機能が無効にされていない限り、誰でも投票者一覧を閲覧できます.

特定の投票の管理者には投票者一覧に加え、重複投票者の特定に役立つかもしれない個人情報が閲覧できます. （例＝IPアドレス、ユーザーエージェント情報、【共有クッキー←クッキー】. ）　 を   に設定しておくと、管理者が個人情報を閲覧するたびにログを記録します. ログはSpecial:SecurePollLogで閲覧できます.

管理者は重複であると確信した場合にどの票も無効にできます.

票の集計
票の集計は特定の投票の管理者のみに認められます. From Special:SecurePoll, click on the Tally link for the poll you want to tally.

If the poll has been tallied before, the results will be shown on the page. If not, or if you want to re-tally, there is a form for starting a new tally.


 * If the poll is unencrypted, click on the tally button.
 * If the poll is encrypted, you may need to enter more information. For example, if you used GnuPG, enter the (private) decryption key and click on the tally button. If an encrypted poll has many votes, it may take a long time to tally. You may need to check back later for the results.

Now visit Special:SecurePoll and you will see your poll.

(STV) 集計
STV（単記委譲式投票方式）の集計を有効にするにはLocalSettings.php に以下の設定を追記

単記委譲式投票方式（single transferable votes 略号STV）の詳細情報はこちらをご参照ください.

General algorithm implementation (source).

Quota is + .000001. Quota is the minimum value of votes to secure a seat.

1. Compute the quota. 2. Assign votes to candidates by first preferences. 3. Declare as winners all candidates who received at least the quota. 4. Transfer the excess votes from winners to hopefuls. 5. Repeat steps 3 and 4 until no new candidates are elected. (Under some systems, votes could initially be transferred in this step to prior winners or losers. This might affect the outcome.) '''If all seats have winners, the process is complete. Otherwise:''' 6. Eliminate one or more candidates, typically either the lowest candidate or all candidates whose combined votes are less than the vote of the lowest remaining candidate. 7. Transfer the votes of the losers to remaining hopeful candidates. 8. Repeat 3–7 until all seats are full.

The quota we will use (step 1) is the Droop quota (source):

The method for transferring votes from elected or eliminated candidates will be the Meek method:


 * Meek Method

Tallying (JobRunner)

 * Tallies can be processed via a scheduled job Manual:Job queue. Make sure to create a scheduled job for this task or execute the task manually.
 * Tallies can also be processed by executing the tallying script manually:

To execute a tally, run the following from the cli folder located at extensions/SecurePoll/cli:

To execute a tally using MediaWiki-Docker, run the following from the cli folder located at extensions/SecurePoll/cli:

Generating (STV)Test Elections

 * Test (STV)elections can be generated from the cli folder located at extensions/SecurePoll/cli:
 * To generate a test election, run the following from the cli folder located at extensions/SecurePoll/cli:
 * Test (STV) elections provide scaffolding from which to tally on

SecurePoll
SecurePoll（セキュアポル）に関する一般的な説明文書はSecurePollをご参照ください.

SecurePoll の改善
SecurePoll 改善の概要はAnti-Harassment Tools/SecurePoll Improvementsをご参照ください. （仮題：嫌がらせ行為対策ツール/セキュアポル改善）

STV 集計結果を理解する
STV 集計結果に関する解説文書はAnti-Harassment Tools/SecurePoll Improvements/Understanding the STV resultをご参照ください. （仮題：嫌がらせ行為対策ツール/セキュアポルの改善/STV集計結果を理解する）


 * SecurePoll 2014 Redesign