Extension:SecurePoll/he

התוסף SecurePoll הוא הרחבה לדף מיוחד לבחירות, סקרים והצבעות אחרות. הוא משמש בעיקר לבחירות לדירקטוריון קרן ויקימדיה ולבחירות לוועדות בוררות, ושימש בין היתר להצבעת המעבר לרישיון ויקימדיה.

התקנה
יש להוסיף את ההרשאה " " לקבוצות משתמשים רלוונטיות. כדי להקצות זכות זו למפעילי מערכת, יש להוסיף ל- את הדבר הבא:

זה מאפשר לכל מפעילי המערכת ליצור סקרים, אבל זה לא מאפשר לכל מפעילי המערכת לנהל סקר מסוים (כולל עריכות סקר, צפייה בנתוני משתמשים וכו'). מנהלים של הצבעה מאובטחת מסוימת מוגדרים בעת יצירה או עריכה של סקר. רק בעלי ההרשאה " " רשאים לנהל סקר. כדי להוסיף קבוצה זו, יש להוסיף ל- את הדבר הבא:

לאחר מכן, ניתן להקצות למשתמש את  דרך Special:UserRights. יש לשים לב כי מנהלי הצבעות מאובטחות יכולים לראות נתוני בוחרים, ולכן יש להקצות לקבוצה זו רק משתמשים מהימנים. במידה ומשתמש מוסר מהרשימה, אותו משתמש לא יוכל לנהל הצבעות מאובטחות.

אופן השימוש


יצירה הצבעה מאובטחת חדשה
ישנן שתי דרכים ליצור הצבעה מאובטחת חדשה: יצירה באופן ידני קובץ XML וייבוא שלו, או השתמשות בממשק המשתמש ב-Special:SecurePoll.

ידני
כדי ליצור הצבעה מאובטחת באופן ידני, יש צורך לעשות את הדברים הבאים:


 * 1) לכתוב קובץ XML
 * 2) לייבא אותו באמצעות פקודת הממשק

בתיקיית הבדיקות תוכלו למצוא ארבעה קבצים לדוגמה:


 * info
 * info
 * info
 * info

כדי לייבא הצבעה מאובטחת, יש לבצע את הפעולות הבאות מתיקיית cli:

כדי לייבא הצבעה מאובטחת באמצעות docker, יש לבצע את הפעולות הבאות מתיקיית cli:



דרך ממשק המשתמש
משתמש עם ההרשאה  יכול ליצור הצבעה מאובטחת חדשה באמצעות Special:SecurePoll.

כדי ליצור הצבעה מאובטחת חדשה, יש למלא את שדות החובה בטופס היצירה. 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 seen.

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

Edit an existing poll
To edit a poll, you must be an admin of the particular 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.

Edit who can vote in a poll
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.

Translate a poll
To translate a poll, you must be an admin of the particular poll. From Special:SecurePoll, click on the Translate link for the poll you want to translate.

See a list of voters
Anyone can see a list of voters, unless transparency features were disabled when the poll was created.

Admins of a particular poll can see a list of voters, along with private information that may help to identify duplicate voters (e.g. IP addresses, user agent information, shared cookies). If  is set to , it will be logged whenever an admin views private data. The logs can be viewed at Special:SecurePollLog.

Admins may strike any votes that they believe to be duplicates.

Tally a poll
To tally a poll, you must be an admin of the particular poll. 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) Tallying
To enable STV tallying please add the below configuration value to LocalSettings.php

More information on Counting single transferable votes (STV) can be found at Wikipedia.

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 general documentation can be found at SecurePoll.

SecurePoll Improvements
A summary of improvements to SecurePoll can be found at Anti-Harassment Tools/SecurePoll Improvements.

Understanding the STV result
Documentation on STV results can be found at Anti-Harassment Tools/SecurePoll Improvements/Understanding the STV result.


 * SecurePoll 2014 Redesign