Define allocation policies and organizer-triggered shuffling #14
Labels
No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Blocks
#5 Define ticket-request allocation and fulfillment
MISChaufen/prevouch
#10 Define administrator authority, queue visibility, and event lifecycle
MISChaufen/prevouch
#16 Define upfront-payment tracking and refunds for central purchases
MISChaufen/prevouch
Reference
MISChaufen/prevouch#14
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Part of #1
Question
How should the three event-wide allocation policies establish the queue and serve ticket requests when vouchers become available?
Required policies:
The human revised the earlier voucher-arrival proposal: the initial shuffle is manual, its resulting order stays fixed, and new entries after it join the end. Voucher arrivals, duplicate messages, retries, and restarts do not trigger shuffling. An event's allocation policy can change until the first voucher is sent or the first ticket is bought by the Orga-team; afterwards it is fixed.
Settle the exact transition into distribution/purchasing, who triggers it, and whether consuming later stock is automatic or organizer-controlled. Decide how additions after the initial shuffle form tail entries/groups without enlarging an earlier group's turn, how quantity reductions and withdrawals affect the fixed order, and how a policy change after the initial shuffle but before the cutoff reconstructs the queue.
Clarify policy-change handling while delivery or organizer checkout is in progress, including an uncertain result. Decide what members see before and after the initial shuffle and what recorded evidence makes the chosen order and any permitted policy changes explainable without an unrequested reroll.
Use Alice/Bob/Cara examples with mixed +n quantities, eight initial vouchers, later additions, and successors. Cover a group larger than available stock and preserve its turn across arrivals. Grouped mode gives each initial group an equal chance; everyone mode gives each initial individual ticket request an equal chance. Preserve exclusive active assignments and the fixed ordering rather than redrawing previously ordered entries.
The allocation contract feeds Define ticket-request allocation and fulfillment. Funding eligibility and its consequences for unpaid or partially paid requests belong to Define upfront-payment tracking and refunds for central purchases, which must apply the chosen ordering contract.
Resolution: an agreed ordering/selection contract and worked examples in a resolution comment, not an allocator implementation. Earlier checkpoints are historical inputs; the latest human revisions supersede their arrival-triggered reshuffling assumptions.
Planning checkpoint — allocation questions Q10–Q13
The human agreed to the following inputs for this decision. This is a checkpoint, not the final resolution; batch semantics, additions after selection, policy changes, and member-visible progress remain to be settled.
These rules apply to the allocation contract. Funding eligibility, central-purchase fulfillment, and failure/recovery deadlines remain decisions in their existing tickets. Shared terms have been updated in the root glossary.
Define allocation policies and voucher-arrival shufflingto Define allocation policies and organizer-triggered shufflingPlanning checkpoint — revised shuffle and policy-change rules (Q14–Q17)
This records the human's latest changes and supersedes the automatic, repeated voucher-arrival shuffling described in earlier checkpoints. The decision remains open.
Still to clarify: post-shuffle additions and grouping, permitted policy changes between initial shuffle and first send/purchase, in-progress work at that boundary, ongoing allocation triggers, member-visible positions, and the record of the initial ordering. Funding and central-purchase fulfillment remain with their own decisions.
The map, lifecycle, recovery, administrator, architecture, funding, and prototype scopes and the glossary are updated to match the revised trigger and fixed-order requirement.
Planning checkpoint — allocation questions Q18–Q21
The human agreed to all four recommendations. This records inputs to the still-open allocation decision; it is not its final resolution.
Remaining allocation boundaries: how distribution starts in FCFS, how policy changes interact with active or uncertain sends/purchases, and what evidence is retained for the shuffle. Funding eligibility and central-purchase fulfillment remain in their existing decisions.
Planning checkpoint — allocation questions Q22–Q24
The human agreed to all three recommendations. These complete the remaining allocation boundaries; the consolidated contract and examples will receive a final shared-understanding check before this ticket is resolved.
Funding eligibility, central-purchase fulfillment, and detailed recovery procedures remain with their existing decisions.
Resolution — allocation policies and organizer-triggered shuffling
This consolidates the human's agreements and revisions during the grilling. It supersedes earlier checkpoint proposals for automatic reshuffling on voucher arrival and locking the policy at the first queue join.
Event policy and distribution start
Each event has one allocation policy shared by its participants:
Every policy requires an explicit organizer start action. Before start, usable voucher stock may accumulate without distribution. Starting a shuffled event establishes and records its initial order; starting FCFS uses accepted entry order. This decision concerns allocation policy; the scope of self-purchase versus central purchase remains in its own decision.
After start, accepted usable stock automatically serves the next eligible requests in the established order. In self-purchase this sends vouchers to members; in central purchase it creates purchasing assignments for the Orga-team. Central-purchase members never receive voucher codes. This allocation decision does not choose automated external checkout.
Fixed order, groups, and later entries
The shuffled order stays fixed. Voucher arrivals, batches of eight, duplicate mail, retries, restarts, page reloads, or repeating the start action do not trigger another draw. Consume later stock against the existing order.
For the initial grouped shuffle, all requests registered by one requester consolidate into one group, including additions before that shuffle. After the shuffle, every new submission creates a new group at the end, even if that person already has an earlier waiting or partly served group. Later additions cannot enlarge or extend an earlier group's turn.
A partly served group keeps its turn across voucher arrivals: its original remaining requests receive available vouchers before another group is served. This preserves contiguity; it does not promise sufficient stock to complete the group.
In everyone mode, new submissions append their individual requests at the end without shuffling the existing order. FCFS additions always append under accepted entry order. A permitted withdrawal removes the request from the current waiting order; rejoining is new demand rather than restoration of an earlier position. Lifecycle and funding decisions determine when withdrawal is permitted and any financial consequences.
Retain request identities and exclusive active assignments. One voucher and one request may participate in at most one active assignment each; retries reuse the assignment rather than allocating a second voucher. Historical safely released assignments may remain recorded.
Policy changes and the permanent lock
The event's allocation policy may change until the first successful voucher send to a member in self-purchase mode, or the first ticket bought by the Orga-team in central-purchase mode. After that milestone, the allocation policy is permanently fixed. Merely joining, starting, shuffling, reserving a voucher, or receiving an upfront payment is not that permanent-lock milestone.
For a permitted policy change, pause allocation and finish or safely release outstanding work first. A send or seller checkout that is in progress or has an uncertain outcome holds the change until its outcome is known. If it resolves without a successful send or purchase and outstanding work is safely released, policy changes remain possible. Uncertain or disclosed-voucher cases use the recovery policy rather than an automatic reassignment.
Changing policy before the lock rebuilds the waiting order under the new policy: FCFS uses original accepted request timestamps/order, and a shuffled policy requires a fresh explicit organizer shuffle. Keep the prior order and the policy change in history. Repeating the same start action without a permitted policy change reuses the already recorded result.
Member progress and recorded evidence
Members see their own current positions and group progress once the shuffled order exists. Before it exists, show that the event awaits the organizer's shuffle without a final rank. FCFS can show its current accepted-order positions. Positions advance as earlier requests are served or withdrawn; new tail entries do not jump ahead.
Record who started the shuffle, when, the selected policy, included requests/groups, and resulting order. Preserve permitted policy changes and replacement orders. Broader identity visibility and permissions belong to the administrator decision; this contract establishes the evidence that must exist, not its storage technology.
Worked examples
All examples assume the requests are eligible and each accepted voucher can serve any request in the event's pool. Alice requests self +2 (three requests), Bob self +1 (two), and Cara self +3 (four): nine requests for eight initial vouchers. Individual labels below identify requests, not separately decided companion identities.
Contracts with the remaining decisions
No additional allocation ticket is needed. The already-open lifecycle, purchase, funding, recovery, administration, architecture, and prototype decisions hold the remaining work toward the map's destination.
Funding qualification to group continuity
The agreed resolution in Define upfront-payment tracking and refunds for central purchases now supplies the explicit funding/eligibility qualification to this decision's grouped-turn continuity rule. Apply its “Funding eligibility and queue order” section, including restoration after another group's active turn. That ticket remains the canonical source for the qualification; this allocation-policy decision remains resolved.