How digitalservicebund/steuerlotse works
Main Components
a. Frontend Layer:
• React-based client application (webapp/client)
• Storybook for component documentation
b. Backend Layer:
• Flask web application (webapp/app)
• Form handling system (webapp/app/forms)
• Authentication and encryption (webapp/app/crypto)
• Data access layer (webapp/app/data_access)
c. Storage Layer:
• PostgreSQL database
• Redis for server-side sessions (as per ADR 0002)
d. External Services:
• ELSTER integration via Erica service
• Email service (webapp/app/email)
Key Architectural Patterns to Highlight
a. Multi-step Form Flow Architecture:
• Flow management system (webapp/app/forms/flows)
• Step handling (webapp/app/forms/steps)
• Form validation (webapp/app/forms/validations)
b. Data Management:
• Model layer (webapp/app/model)
• Database models (webapp/app/data_access/db_model)
• Storage implementations (webapp/app/data_access/storage)
[Frontend Layer]
React Components <-> React Pages <-> Static Assets
• ↕
[API Layer]
Flask Routes <-> Form Flows <-> Step Management
• ↕
[Service Layer]
User Controller <-> Form Storage <-> Encryption
• ↕
[Data Layer]
PostgreSQL <-> Redis Sessions
• ↕
[External Services]
ELSTER (Erica) <-> Email Service
Important Elements
a. Security Components:
• Encryption service
• Password hashing
• Session management
• Audit logging
b. Integration Points:
• ELSTER client integration
• Email service integration
• Database connections
• Redis session storage
c. Development Tools:
• Storybook integration
• Testing infrastructure
• CI/CD pipelines