[Feature] Add API DTOs and routes for postbox directory, access checks, message listing, message creation, and binding administration #4

Closed
opened 2026-07-07 21:01:04 +02:00 by zemion · 3 comments
Owner

Imported from the repository seed backlog.

  • Source: /mnt/DATA/git/govoplan-postbox/docs/POSTBOX_BACKLOG.md
  • Line: 8
  • Section: P1 Immediate
  • Milestone: P1 Immediate

Backlog item:

Add API DTOs and routes for postbox directory, access checks, message listing, message creation, and binding administration

Refined API scope

Add tenant-scoped APIs/capabilities for template validation/publishing, stable address resolution, visible directory/group queries, explainable access checks, idempotent delivery acceptance, message list/detail, read/acknowledge/reply state, attachment/evidence refs, binding/routing administration, and dry-run hierarchy resolution. Every list is paginated and batch-oriented; all write paths are auditable and use optimistic concurrency/idempotency where applicable. Parent story: #16.

<!-- codex-module-seed-fingerprint:7fbbd2f288842faafa8dbe24 --> Imported from the repository seed backlog. - Source: `/mnt/DATA/git/govoplan-postbox/docs/POSTBOX_BACKLOG.md` - Line: `8` - Section: `P1 Immediate` - Milestone: `P1 Immediate` Backlog item: ```text Add API DTOs and routes for postbox directory, access checks, message listing, message creation, and binding administration ``` <!-- codex-postbox-api-refinement-2026-07-28 --> ## Refined API scope Add tenant-scoped APIs/capabilities for template validation/publishing, stable address resolution, visible directory/group queries, explainable access checks, idempotent delivery acceptance, message list/detail, read/acknowledge/reply state, attachment/evidence refs, binding/routing administration, and dry-run hierarchy resolution. Every list is paginated and batch-oriented; all write paths are auditable and use optimistic concurrency/idempotency where applicable. Parent story: #16.
zemion added this to the P1 Immediate milestone 2026-07-07 21:01:04 +02:00
Author
Owner

Codex State: progress

Implemented tenant-scoped directory/access, paginated message list/detail, read/acknowledge, idempotent delivery, evidence linking, grouping, organization-target, exact-postbox, template revision/publish/retire, materialization, and archive routes. Remaining acceptance work is reply/message authoring, routing dry-run, and richer concurrency/version controls.

## Codex State: progress Implemented tenant-scoped directory/access, paginated message list/detail, read/acknowledge, idempotent delivery, evidence linking, grouping, organization-target, exact-postbox, template revision/publish/retire, materialization, and archive routes. Remaining acceptance work is reply/message authoring, routing dry-run, and richer concurrency/version controls.
zemion added
status
in-progress
and removed
status
ready
labels 2026-07-29 00:20:18 +02:00
zemion added the source/backlog-import label 2026-07-29 14:15:14 +02:00
Author
Owner

Close-out audit, 2026-07-31

The later hierarchy-routing slice completed the dry-run API that the previous note listed as missing. Directory/access, stable target resolution, idempotent delivery, paginated list/detail, read/acknowledge, evidence references, templates, bindings, grouping, hierarchy preview, and administration routes are present and the 24-test backend suite passes.

Remaining before closure:

  • first-class message authoring/reply API and DTOs;
  • explicit optimistic concurrency/ETag handling for mutable administration resources;
  • focused conflict and reply round-trip tests.
## Close-out audit, 2026-07-31 The later hierarchy-routing slice completed the dry-run API that the previous note listed as missing. Directory/access, stable target resolution, idempotent delivery, paginated list/detail, read/acknowledge, evidence references, templates, bindings, grouping, hierarchy preview, and administration routes are present and the 24-test backend suite passes. Remaining before closure: - first-class message authoring/reply API and DTOs; - explicit optimistic concurrency/ETag handling for mutable administration resources; - focused conflict and reply round-trip tests.
Author
Owner

Implemented and pushed in GovOPlaN/govoplan-core@42b5019 and GovOPlaN/govoplan-postbox@dc6f81d. Added first-class message authoring and reply routes/DTOs, idempotent authoring, thread linkage, classification constraints, strong ETag/If-Match optimistic concurrency for mutable postbox/template/grouping resources, compose/reply WebUI, migration coverage, stale-write conflict tests, and author/reply round-trip tests. Verification: 33 Postbox backend tests, Ruff, Postbox UI structure checks, Core contract tests, and linked Core TypeScript compile pass.

Implemented and pushed in GovOPlaN/govoplan-core@42b5019 and GovOPlaN/govoplan-postbox@dc6f81d. Added first-class message authoring and reply routes/DTOs, idempotent authoring, thread linkage, classification constraints, strong ETag/If-Match optimistic concurrency for mutable postbox/template/grouping resources, compose/reply WebUI, migration coverage, stale-write conflict tests, and author/reply round-trip tests. Verification: 33 Postbox backend tests, Ruff, Postbox UI structure checks, Core contract tests, and linked Core TypeScript compile pass.
zemion removed the
status
in-progress
label 2026-07-31 18:41:04 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-postbox#4