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

38 lines
1.6 KiB
Markdown

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