System Requirements Document (SRD) for Lunar-Modules

1. Introduction

The Lunar-Modules project is a professional DTZ B1 German exam preparation application tailored for individual users. This application is designed to provide a comprehensive, immersive, and AI-driven learning experience for Deutschlernende (German learners) aiming to achieve proficiency at the B1 level. The system ensures real exam simulation, detailed feedback, and progress tracking, all while maintaining a modern and user-friendly interface.

This document outlines the updated system requirements for the Lunar-Modules project, incorporating the latest request to focus on single-user usage and to ensure that processing and feedback execution occur immediately after the completion of each individual module.

2. System Overview

The Lunar-Modules application is a single-user platform designed to simulate the DTZ B1 German language exam. It features 40 fixed modules, each structured to mimic real exam conditions. The system leverages AI to provide instant feedback and analysis after the completion of each module, helping users identify their strengths and weaknesses. The application includes immersive audio and visual elements, a strict scoring system, and a results dashboard for tracking progress.

Key features include:

• Fixed module structure (40 modules).
• AI-driven feedback and correction.
• Immersive audio and visual content.
• Real-time progress tracking and analytics.
• Modern, responsive UI/UX with auto theme detection.

3. Functional Requirements

• As a User, I should be able to access 40 fixed modules, each labeled as "Modul 1" to "Modul 40."
• As a User, I should always see the Dashboard (Home screen) upon launching the application.
• As a User, I should receive AI-generated feedback immediately after completing each module.
• As a User, I should be able to track my progress, including scores, completion percentage, and improvement areas.
• As a User, I should be able to simulate the DTZ B1 exam with realistic audio and visual elements.
• As a User, I should be able to view detailed results for each module, including a breakdown of scores for Listening, Reading, Writing, and Speaking.
• As a User, I should be able to upload images or photos for writing tasks.
• As a User, I should be able to record my voice for speaking tasks and receive AI analysis on pronunciation, fluency, grammar, and vocabulary.
• As a User, I should be able to toggle between Light and Dark modes, with the system automatically detecting my device's theme preference.

4. User Personas

Primary User

Name: Individual Learner
Description: A single user aiming to prepare for the DTZ B1 German language exam. This user is self-motivated, tech-savvy, and seeks personalized feedback to improve their language skills.
Goals:

• Achieve a B1 level in German proficiency.
• Receive instant feedback and actionable improvement tips.
• Track progress and identify weak areas.

5. Visuals Colors and Theme

Unique Color Palette

The Lunar-Modules application features a modern and professional color scheme designed to enhance usability and aesthetics. The palette includes:

• Background: #1A1A2E (Deep Space Black)
• Surface: #16213E (Midnight Blue)
• Text: #EAEAEA (Soft White)
• Accent: #0F3460 (Cosmic Blue)
• Muted Tones: #53354A (Muted Plum)

This palette ensures a clean, immersive experience that aligns with the project's identity.

6. Signature Design Concept

Interactive Lunar Dashboard

The landing page of the Lunar-Modules application will feature an interactive lunar landscape. Users will see a 3D-rendered moon surface with 40 glowing craters, each representing a module. Hovering over a crater will display the module number, and clicking on it will zoom into the crater, transitioning seamlessly into the module content.

Key features:

• Animations: Smooth zoom-in and zoom-out transitions with subtle crater pulsations.
• Micro-interactions: Hover effects that cause craters to glow brighter and display module numbers.
• Ambient Background: A starry night sky with occasional shooting stars.
• Audio Feedback: A soft lunar ambiance with faint echoes and wind sounds.
• Theme Integration: The lunar landscape adapts to Light or Dark mode, with the moon glowing softly in Light mode and radiating a cool blue hue in Dark mode.

This design ensures an unforgettable first impression and a highly engaging user experience.

7. Non-Functional Requirements

• The application must support both Light and Dark modes with equal quality.
• The system must provide instant feedback after each module without delays.
• The application must maintain a responsive design for various screen sizes.
• The audio system must deliver high-quality, immersive sound without distortion.
• The application must operate seamlessly in German (de-DE) for all UI elements, labels, and content.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work
• Google Nano Banana for image generation

AI Tools

• Litellm for LLM Routing
• Langchain

Local Orchestration

• Docker
• docker-compose

Server-Side Orchestration

• Kubernetes

9. Assumptions and Constraints

Assumptions

• The application will be used by individual learners only.
• Users will have access to stable internet connections for AI processing and feedback.
• All modules will be completed sequentially, with no skipping allowed.

Constraints

• The application must strictly adhere to the DTZ B1 exam structure.
• Feedback must be generated and displayed immediately after each module.
• The system must not include dynamic or AI-generated modules.

10. Glossary

• DTZ B1: Deutsch-Test für Zuwanderer, a German language proficiency test for immigrants.
• AI Feedback: Automated analysis and suggestions provided by artificial intelligence.
• Module: A fixed unit of learning content, structured to simulate a part of the DTZ exam.
• TTS: Text-to-Speech, a system for converting text into spoken words.
• UI/UX: User Interface and User Experience, referring to the design and usability of the application.