Finish a job and publish its result reference in one transaction
A result is visible while its job remains assigned because completion and result linking commit separately.
- Focused work estimate
- 5h + prerequisites
- Priority in the scenario
- Medium
- Engineering practice
- Transactions · Result integrity
Estimated field mix
- Database engineering80%
- Backend20%
Field percentages are editorial estimates of the ticket's engineering focus. They total 100%; they are not measured time, proficiency scores, or ownership evidence.
Review it, then add it to your workspace.
The board opens an editable draft; nothing is saved until you confirm it. Sign-in and workspace permissions apply, and Demo boards remain ephemeral.
Project context
A fictional inspection service assigns review jobs to staff. Polling clients sometimes claim the same job and a disconnected client can finish work after reassignment.
Setup prerequisites
- Create synthetic jobs and two independent database clients.
- Use explicit state methods and an injected clock.
Preceding work
Complete these dependencies, or supply their agreed outputs before taking this ticket.
- ACLAIM-101 · Define assignment states and their required database fields
- ACLAIM-102 · Order eligible jobs with a stable tie break
- ACLAIM-103 · Scope work assignment queries to the operator's organization
- ACLAIM-104 · Claim one pending job atomically under competing pollers
- ACLAIM-105 · Issue a monotonically increasing assignment generation on every reclaim
- ACLAIM-106 · Renew assignment leases without extending a completed job
Acceptance criteria
- Check assignment authority and lease at commit.
- Commit terminal state and result reference atomically.
- Duplicate identical completion returns the original outcome.
Implementation constraints
- Keep result bytes outside the database transaction; link only verified immutable identity.
Verification to include
- Complete a valid assignment with one result reference.
- Force transaction failure and verify neither completion nor result publication persists.
Deliverables
- Completion transaction and rollback tests
Rollout and recovery
Enable completion on synthetic jobs; suspend writes if authority or result verification is unavailable.
Value of the work
For the engineer: Practice database concurrency, leases and transactional invariants.
For the team: Review whether assignment authority remains reliable during contention and recovery.
Evidence boundaries
Outcome Evidence: Tests, patches, and runbooks are requested deliverables. They become Outcome Evidence only through a qualified Mission and immutable Evidence IDs.
Ownership Evidence: Independent adaptation must be observed under a declared verification policy and cite immutable Evidence IDs. Completing a planning ticket establishes no Ownership Evidence.