How digitalservicebund/ris-backend-service works
Main Components
a. Client Layer:
• Vue.js 3 Frontend Application
• Components for document management, case law, and periodical evaluation
• Text editor with specialized features
• Authentication interface
b. API Layer:
• Spring MVC REST API endpoints
• Authentication/Authorization controllers
• Documentation unit controllers
• File handling controllers
c. Service Layer:
• Documentation unit services
• Conversion services (DOCX)
• Authentication services
• Mail services
• XML export services
d. Data Layer:
• PostgreSQL database
• Document storage (S3)
• Lookup tables
• Migration systems
e. External Systems:
• Keycloak (Authentication)
• ArgoCD (Deployment)
• Monitoring (Grafana/Prometheus)
• Mail services
Relationships and Data Flow
• User requests flowing from frontend through API endpoints
• Authentication flows through Keycloak
• Document processing flows (upload → conversion → storage)
• Database interactions
• Export processes to XML
• Monitoring data collection
Important Architectural Patterns to Highlight
• Ports and Adapters architecture (shown in backend structure)
• Domain-driven design elements
• Microservices-like separation of concerns
• Event-driven components for document processing
• Layered frontend architecture
Specific Implementation Details
Technical labels for:
• Vue 3 + Vite (Frontend)
• Spring Boot (Backend)
• PostgreSQL (Database)
• S3 (Document Storage)
• Docker containers
• Kubernetes deployment
Security Layer
Highlight:
• OIDC authentication flow
• API security measures
• CSRF protection
• Role-based access control
Monitoring and Operations
Show:
• Grafana dashboards
• Prometheus metrics collection
• Health check endpoints
• Logging flows