direkt-vermittlung-de/SCOPE.md
tegwick 6a9d417c12
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
CI Smoke / container-smoke (push) Successful in 7s
Seeded INTENT.md and stuff
2026-07-08 14:33:11 +02:00

1.6 KiB

SCOPE

This file was generated by statehub register. Refine it as the repository boundaries become clearer.

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/