Epic: seat allocation for the most common scenario

[praseodym]

Seat allocation (zetelverdeling, apportionment) for the most common scenario, e.g. no drawing of lots. Display results on a placeholder page.

For municipal elections, calculation differs for municipal council with < 19 seats and 19 seats or above, mainly regarding the algorithm used for allocation of remainder seats (restzetels) and the preference threshold (voorkeursdrempel) for candidates.

Main differences are described on the website of the Kiesraad. We also have a summary of the process for municipal elections in Dutch.

Tbd: Non common scenario's that are out of scope:

• drawing by lot for remainder seats
• deceased candidates
• list exhaustion

Conditions:

• all code for seat allocation should be in a single module (directory)
• no ‘outside’ calls in seat allocation algorithm (no database calls, etc.)

[Lionqueen94]

I think "lottery" or "raffle" is a more common and well known term instead of "drawing of lots" and for the "remainder seats" maybe "remaining seats". At least those seem more clear to me.

[praseodym]

Design for this epic is not finished yet.

[marjoleintamis]

The correct term is 'drawing' or 'drawing by lot' according to IATE https://iate.europa.eu/search/result/1731931498385/1 'Lottery' and 'raffle' are used in different contexts :)

[jorisleker]

Voorbeeld- / testdata om onze code tegen te testen

Cases

• geen restzetels (alle zetels als volle zetel toegewezen)
• met restzetels, maar zonder loting
• met restzetels met 1 loting
• met restzetels met meerdere lotingen
• met lijstuitputting vanwege overleden kandidaat
• met lijstuitputting bij toewijzing volle zetels
• met lijstuitputting bij toewijzing restzetels

Bovenstaande voor verkiezingen met => 19 zetels en < 19 zetels

Impact van kiesdrempel tbd; er een wetswijziging rondom de kiesdrempel en restzetels.

[praseodym]

WIP code from today: https://github.com/kiesraad/abacus/tree/apportionment