direkt-vermittlung-de/SCOPE.md
tegwick 9d731d5a7f
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Complete State Hub bootstrap (DVD-WP-0001); add DVD-WP-0002
2026-07-08 15:07:23 +02:00

37 lines
1.6 KiB
Markdown

# 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/