GovOPlaN/govoplan-addresses
2
0
Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases Wiki Activity

[Feature] Complete the Addresses provider for AdreMa distribution lists #1

New Issue
Closed
opened 2026-07-06 21:44:12 +02:00 by zemion · 4 comments
zemion commented 2026-07-06 21:44:12 +02:00
Owner
Copy Link
Copy Source

Outcome

Addresses provides address books, contact points, classical address lists, communication-governance facts, and source provenance to the AdreMa vertical. The core audience/list product is Distribution Lists #5.

The evidence-based architecture is maintained in the Distribution Lists repository: AdreMa Capability Assessment And Distribution-List Roadmap.

Delivered Addresses Foundation

  • Scoped local address books and contact CRUD.
  • Multiple email, phone, and postal contact points.
  • vCard import/export and CardDAV synchronization.
  • Static classical address lists.
  • Read-only lookup, writer decisions, provenance, and immutable email-recipient snapshots.

Remaining Addresses Work

  • Contact-point consent, suppression, preference, and communication-purpose facts: #9.
  • Deduplication, merge, quality, provenance, and audit history: #10.
  • Channel-neutral contact-point resolution and frozen postal snapshots: #14.
  • Additional address source/import portfolio decomposed into independently tracked work: #15-#21 and GovOPlaN/govoplan-connectors#9.

Boundary

  • Organizations owns units and function definitions.
  • IDM owns typed groups, identity relationships, effective function assignments, and their validity/provenance.
  • Distribution Lists owns static/dynamic operational audiences, mixed expansion, and immutable expansion evidence.
  • Addresses may preserve vCard KIND/RELATED values and stable provider links, but does not create a second party or organizational relationship authority.

Completion Criteria

This Addresses contribution closes when Distribution Lists can obtain explainable, purpose-aware contact-point candidates and immutable postal/email snapshots without importing Addresses internals. The AdreMa umbrella itself is tracked in Distribution Lists #5.

## Outcome Addresses provides address books, contact points, classical address lists, communication-governance facts, and source provenance to the AdreMa vertical. The core audience/list product is [Distribution Lists #5](https://git.add-ideas.de/GovOPlaN/govoplan-dist-lists/issues/5). The evidence-based architecture is maintained in the Distribution Lists repository: [AdreMa Capability Assessment And Distribution-List Roadmap](https://git.add-ideas.de/GovOPlaN/govoplan-dist-lists/src/branch/main/docs/ADREMA_CAPABILITY_ASSESSMENT.md). ## Delivered Addresses Foundation - [x] Scoped local address books and contact CRUD. - [x] Multiple email, phone, and postal contact points. - [x] vCard import/export and CardDAV synchronization. - [x] Static classical address lists. - [x] Read-only lookup, writer decisions, provenance, and immutable email-recipient snapshots. ## Remaining Addresses Work - [x] Contact-point consent, suppression, preference, and communication-purpose facts: #9. - [x] Deduplication, merge, quality, provenance, and audit history: #10. - [x] Channel-neutral contact-point resolution and frozen postal snapshots: #14. - [x] Additional address source/import portfolio decomposed into independently tracked work: #15-#21 and GovOPlaN/govoplan-connectors#9. ## Boundary - Organizations owns units and function definitions. - IDM owns typed groups, identity relationships, effective function assignments, and their validity/provenance. - Distribution Lists owns static/dynamic operational audiences, mixed expansion, and immutable expansion evidence. - Addresses may preserve vCard `KIND`/`RELATED` values and stable provider links, but does not create a second party or organizational relationship authority. ## Completion Criteria This Addresses contribution closes when Distribution Lists can obtain explainable, purpose-aware contact-point candidates and immutable postal/email snapshots without importing Addresses internals. The AdreMa umbrella itself is tracked in Distribution Lists #5.
zemion added this to the Module And Integration Roadmap milestone 2026-07-06 21:44:12 +02:00
zemion commented 2026-07-13 00:54:47 +02:00
Author
Owner
Copy Link
Copy Source

Codex State: note

Summary

  • Split the address roadmap into concrete implementation issues: #3, #4, #5, #6, #7, #8, #9, and #10.
  • Added architecture and implementation-plan docs in docs/ADDRESS_MODULE_ARCHITECTURE.md and docs/IMPLEMENTATION_PLAN.md.
  • This issue can stay as the broad umbrella for Adrema-style address and distribution-list management.
    '',
    2:
## Codex State: note ### Summary - Split the address roadmap into concrete implementation issues: #3, #4, #5, #6, #7, #8, #9, and #10. - Added architecture and implementation-plan docs in `docs/ADDRESS_MODULE_ARCHITECTURE.md` and `docs/IMPLEMENTATION_PLAN.md`. - This issue can stay as the broad umbrella for Adrema-style address and distribution-list management. '', 2:
zemion commented 2026-07-13 18:10:45 +02:00
Author
Owner
Copy Link
Copy Source

Codex State: progress

Summary

  • Implemented classical address-list backend support in govoplan-addresses: address-list tables, API/service layer, permissions, manifest ownership, tests, and addresses.recipient_source exposure using addresses:address_list:<id> source IDs.
  • Documented the boundary: address lists remain address-domain groupings; operational mixed Verteiler/distribution lists move to govoplan-dist-lists.
  • Created focused govoplan-dist-lists issues for DTO/contract, local implementation, and UI/provider integrations.

Remaining In Addresses

  • Address-list management UI and campaign picker polish.
  • Dynamic address-domain segments.
  • Consent, suppression, communication preferences, and privacy policy behavior.
## Codex State: progress ### Summary - Implemented classical address-list backend support in `govoplan-addresses`: address-list tables, API/service layer, permissions, manifest ownership, tests, and `addresses.recipient_source` exposure using `addresses:address_list:<id>` source IDs. - Documented the boundary: address lists remain address-domain groupings; operational mixed `Verteiler`/distribution lists move to `govoplan-dist-lists`. - Created focused `govoplan-dist-lists` issues for DTO/contract, local implementation, and UI/provider integrations. ### Remaining In Addresses - Address-list management UI and campaign picker polish. - Dynamic address-domain segments. - Consent, suppression, communication preferences, and privacy policy behavior.
zemion added
priority
p1
status
in-progress
 and removed
priority
p2
status
ready
 labels 2026-07-31 11:40:59 +02:00
zemion changed title from [Feature] Define Adrema-style address and distribution-list management to [Feature] Complete the Addresses provider for AdreMa distribution lists 2026-07-31 14:49:01 +02:00
zemion added the module/dist-lists label 2026-07-31 14:51:49 +02:00
zemion commented 2026-07-31 22:54:26 +02:00
Author
Owner
Copy Link
Copy Source

Progress update: #9 is complete in GovOPlaN/govoplan-addresses@41ccd4c, and Campaign consumption is complete in GovOPlaN/govoplan-campaign@82ddc0c.

This umbrella remains open for the explicitly listed work:

  • #10 deduplication/merge/quality and richer provenance history;
  • #14 channel-neutral resolution plus frozen postal snapshots;
  • #8 and Connectors #9 additional source/import profiles.

The AdreMa audience/segment authority remains Distribution Lists, not Addresses.

Progress update: #9 is complete in GovOPlaN/govoplan-addresses@41ccd4c, and Campaign consumption is complete in GovOPlaN/govoplan-campaign@82ddc0c. This umbrella remains open for the explicitly listed work: - #10 deduplication/merge/quality and richer provenance history; - #14 channel-neutral resolution plus frozen postal snapshots; - #8 and Connectors #9 additional source/import profiles. The AdreMa audience/segment authority remains Distribution Lists, not Addresses.
zemion commented 2026-08-02 07:25:39 +02:00
Author
Owner
Copy Link
Copy Source

Implemented and verified end to end.

  • Addresses quality, provenance, deduplication, reversible merge, and recovery: 19e9096 (#10).
  • Versioned channel-neutral contact-point resolution and immutable source snapshots: 2e78b9a (#14).
  • Same-transaction source revision normalization for SQLite and UTC-aware rows: e60339a.
  • Distribution Lists consumption, bounded source paging, purpose/address-purpose/fallback/locale/postal-format controls, explainable exclusions, legacy fallback, and immutable expansion evidence: GovOPlaN/govoplan-dist-lists commit 8099e34.
  • Additional connector/import formats were decomposed under #15-#21; they extend source coverage but do not block this provider contract.

Verification: 35 Addresses tests, 10 Distribution Lists tests, both Ruff suites, module TypeScript check, integrated Core WebUI production build and bundle budgets, 64/64 manifest scan, strict cross-repository contract scan, and a real Addresses -> Distribution Lists postal snapshot smoke test all pass.

The completion criterion is satisfied: Distribution Lists consumes the public addresses.contact_point_resolution contract without importing Addresses internals and freezes exact email/postal targets, contact-point IDs, revisions, fingerprints, explanations, and decision provenance.

Implemented and verified end to end. - Addresses quality, provenance, deduplication, reversible merge, and recovery: `19e9096` (#10). - Versioned channel-neutral contact-point resolution and immutable source snapshots: `2e78b9a` (#14). - Same-transaction source revision normalization for SQLite and UTC-aware rows: `e60339a`. - Distribution Lists consumption, bounded source paging, purpose/address-purpose/fallback/locale/postal-format controls, explainable exclusions, legacy fallback, and immutable expansion evidence: GovOPlaN/govoplan-dist-lists commit `8099e34`. - Additional connector/import formats were decomposed under #15-#21; they extend source coverage but do not block this provider contract. Verification: 35 Addresses tests, 10 Distribution Lists tests, both Ruff suites, module TypeScript check, integrated Core WebUI production build and bundle budgets, 64/64 manifest scan, strict cross-repository contract scan, and a real Addresses -> Distribution Lists postal snapshot smoke test all pass. The completion criterion is satisfied: Distribution Lists consumes the public `addresses.contact_point_resolution` contract without importing Addresses internals and freezes exact email/postal targets, contact-point IDs, revisions, fingerprints, explanations, and decision provenance.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/api
HTTP API contracts, routers, schemas, or API smoke behavior.
 area/auth
Authentication, sessions, access bootstrap, or login behavior.
 area/db
Database sessions, models, transactions, or persistence primitives.
 area/devex
Local developer workflow, scripts, tests, tooling, or release helpers.
 area/docs
Durable documentation and project guidance.
 area/governance
Governance policy, audit, privacy, retention, or compliance behavior.
 area/marketing
Public website, product messaging, publication copy, or legal page content.
 area/migrations
Alembic migrations, schema bootstrap, or persistence evolution.
 area/module-system
Module discovery, manifests, capabilities, routing, or optional integrations.
 area/rbac
Permissions, roles, delegation, or authorization policy.
 area/release
Versioning, release locks, tags, packaging, or dependency pins.
 area/security
Security posture, static analysis, supply-chain hardening, or vulnerability remediation.
 area/tenancy
Tenant boundaries, provisioning, or tenant-scoped data behavior.
 area/webui
Shared WebUI shell, frontend components, routing, or frontend tests.
 audit/complexity
Complexity finding from Radon, Xenon, or equivalent maintainability scans.
 audit/duplication
Duplicated-code finding from jscpd or equivalent similarity scans.
 audit/false-positive
Audit finding reviewed as a narrow false positive or acceptable risk.
 audit/needs-design
Audit finding that needs an architectural or product decision before implementation.
 audit/quick-fix
Audit finding that appears narrow and directly fixable.
 audit/structural
Audit finding that needs design, refactoring, or behavior review.
 codex/needs-human
Needs an explicit human decision before Codex should implement.
 codex/ready
Suitable for Codex to pick up with the existing issue context.
 module/access
GovOPlaN access, identity, authentication, RBAC, and administration behavior.
 module/addresses
GovOPlaN Addresses module behavior or integration.
 module/admin
GovOPlaN Admin module behavior or integration.
 module/appointments
GovOPlaN Appointments module behavior or integration.
 module/approvals
GovOPlaN Approvals module behavior or integration.
 module/audit
GovOPlaN Audit module behavior or integration.
 module/calendar
GovOPlaN Calendar module behavior or integration.
 module/campaign
GovOPlaN campaign module behavior or integration.
 module/cases
GovOPlaN Cases module behavior or integration.
 module/committee
GovOPlaN Committee module behavior or integration.
 module/connectors
GovOPlaN Connectors module behavior or integration.
 module/core
GovOPlaN core runner, shared primitives, shell, or extension points.
 module/dashboard
GovOPlaN Dashboard module behavior or integration.
 module/dataflow
GovOPlaN Dataflow module behavior or integration.
 module/datasources
GovOPlaN governed datasource contracts, catalogs, and integrations.
 module/decisions
GovOPlaN formal Decisions module behavior or integration.
 module/dist-lists
GovOPlaN Distribution Lists module behavior or integration.
 module/dms
GovOPlaN Dms module behavior or integration.
 module/docs
GovOPlaN Docs module behavior or integration.
 module/encryption
GovOPlaN Encryption key custody, cryptographic policy, and E2EE integration.
 module/erp
GovOPlaN Erp module behavior or integration.
 module/evaluation
GovOPlaN Evaluation module behavior or integration.
 module/files
GovOPlaN files module behavior or integration.
 module/fit-connect
GovOPlaN Fit Connect module behavior or integration.
 module/forms
GovOPlaN Forms module behavior or integration.
 module/forms-runtime
GovOPlaN Forms Runtime module behavior or integration.
 module/helpdesk
GovOPlaN Helpdesk module behavior or integration.
 module/identity
GovOPlaN Identity module behavior or integration.
 module/identity-trust
GovOPlaN Identity Trust module behavior or integration.
 module/idm
GovOPlaN Idm module behavior or integration.
 module/ledger
GovOPlaN Ledger module behavior or integration.
 module/mail
GovOPlaN mail module behavior or integration.
 module/mandates
GovOPlaN Mandates, jurisdiction, responsibility, and authority behavior or integration.
 module/notifications
GovOPlaN Notifications module behavior or integration.
 module/ops
GovOPlaN Ops module behavior or integration.
 module/organizations
GovOPlaN Organizations module behavior or integration.
 module/parties
GovOPlaN procedure Parties, representation, and delivery-authority behavior or integration.
 module/payments
GovOPlaN Payments module behavior or integration.
 module/permits
GovOPlaN Permits module behavior or integration.
 module/policy
GovOPlaN Policy module behavior or integration.
 module/poll
GovOPlaN Poll module behavior or integration.
 module/portal
GovOPlaN Portal module behavior or integration.
 module/postbox
GovOPlaN Postbox module behavior or integration.
 module/projects
GovOPlaN Projects module behavior or integration.
 module/quick-access
GovOPlaN configurable task-local Quick Access behavior and integrations.
 module/records
GovOPlaN Records and eAkte lifecycle behavior or integration.
 module/reporting
GovOPlaN Reporting module behavior or integration.
 module/risk-compliance
GovOPlaN Risk Compliance module behavior or integration.
 module/scheduling
GovOPlaN Scheduling module behavior or integration.
 module/search
GovOPlaN Search module behavior or integration.
 module/services
GovOPlaN versioned institutional Services behavior or integration.
 module/tasks
GovOPlaN Tasks module behavior or integration.
 module/templates
GovOPlaN Templates module behavior or integration.
 module/tenancy
GovOPlaN Tenancy module behavior or integration.
 module/tickets
GovOPlaN Tickets module behavior or integration.
 module/views
GovOPlaN governed task views, interface projections, and workflow view integration.
 module/voting
GovOPlaN Voting module behavior or integration.
 module/wiki
GovOPlaN Wiki module behavior or integration.
 module/workflow
GovOPlaN Workflow module behavior or integration.
 module/workflow-engine
GovOPlaN Workflow Engine runtime, persistence, or integration.
 module/xoev
GovOPlaN Xoev module behavior or integration.
 module/xrechnung
GovOPlaN Xrechnung module behavior or integration.
 module/xta-osci
GovOPlaN Xta Osci module behavior or integration.
priority
p0
Immediate stop-the-line priority.
priority
p1
High priority for the next focused work window.
priority
p2
Normal planned priority.
priority
p3
Low priority or opportunistic cleanup.
source/backlog-import
Imported from markdown backlog, roadmap, plan, or TODO files.
 source/security-audit
Created from a structured security or code-quality audit report.
 source/todo-scan
Imported from inline TODO/FIXME/HACK markers by the Gitea TODO importer.
status
blocked
Cannot progress without a decision, dependency, credential, or external change.
status
in-progress
Currently being worked.
status
needs-info
Needs clarifying input before implementation can proceed safely.
status
ready
Ready for implementation.
status
triage
Needs review, ownership, priority, or acceptance criteria.
type
bug
A reproducible defect, regression, or incorrect behavior.
type
debt
Cleanup, refactoring, risk reduction, or deferred engineering work.
type
docs
Documentation, process, or developer workflow work.
type
feature
New user-visible behavior or platform capability.
type
task
Implementation, maintenance, migration, or operational work.
type
user-story
End-to-end user journey or real-world process story used to steer product slices.
No labels area/api codex/ready module/addresses module/dist-lists
priority
p1
 source/backlog-import
status
in-progress
type
feature
Milestone
No items
No Milestone Module And Integration Roadmap
Projects
Clear projects
No projects
Assignees
Clear assignees
govoplan-package-publisher zemion (Albrecht Degering)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-addresses#1