coulomb/direkt-vermittlung-de
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
direkt-vermittlung-de/SCOPE.md
tegwick 9d731d5a7f
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 2s
Details
Complete State Hub bootstrap (DVD-WP-0001); add DVD-WP-0002
2026-07-08 15:07:23 +02:00

1.6 KiB
Raw Blame History

SCOPE

Lightweight boundary for agents and contributors.

One-liner

DirektVermittlungDe is a document-centric platform that routes citizens' documents or reference numbers (Aktenzeichen) directly to the responsible German authority caseworker and opens a communication thread, replacing manual phone-routing hunts.

Core Idea

direkt-vermittlung-de exists to provide the capability described in INTENT.md.

In Scope

  • Document/reference-number intake and metadata-based routing to the responsible authority unit
  • Citizen-official communication threads (text chat, callback requests, appointment scheduling)
  • Stateless OAuth2/JWT authentication with citizen/official scopes
  • Async data export workflow for authority systems
  • GDPR-compliant document/thread retention and TTL cleanup
  • Migration from prototype implementations to a unified, TDD-driven /src production codebase

Out of Scope

  • Decrypting or otherwise processing encrypted document payload contents in the main backend service
  • General-purpose CRM/ticketing functionality unrelated to authority-citizen routing
  • Non-government (private sector) support-routing use cases
  • Maintaining the prototype-* directories as live code (archived reference only)

Current State

  • Pre-production: three parallel prototypes (chatgpt5, geminiNbt3pro, grok4.1) exist under /prototype-*; no unified /src codebase yet. Architecture is documented via 8 ADRs and a migration workplan, but the target production codebase has not been started.

Getting Oriented

  • Start with: INTENT.md
  • Agent instructions: AGENTS.md
  • Workplans: workplans/