Added cookie user identification and meal preference functionality (#1)

---------

Co-authored-by: Deniz Öztürk <750282004C4DEC44@mytum.de>
Co-authored-by: Sindi Buklaji <ge43yif@mytum.de>
Co-authored-by: Cem Sinan <cem.sinan@tum.de>
Co-authored-by: Robert Jandow <robert.jandow@tum.de>

Author: 5 people

.github/workflows/deploy_docker.yml

@@ -0,0 +1,123 @@
+# IDE and Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Dependency directories
+node_modules/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Docker
+.dockerignore
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Build outputs
+dist/
+build/
+target/
+out/
+*.jar
+*.war
+*.ear
+*.class
+
+# Gradle
+.gradle/
+gradle-app.setting
+!gradle-wrapper.jar
+!gradle-wrapper.properties
+
+# Maven
+.mvn/
+mvnw
+mvnw.cmd
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.pytest_cache/
+
+# Helm
+*.tgz
+
+# SSL certificates and keys
+*.pem
+*.key
+*.crt
+*.csr
+letsencrypt/
+
+# Temporary files
+*.tmp
+*.temp
+temp/
+tmp/
+
+# Backup files
+*.bak
+*.backup
+
+# Local development overrides
+docker-compose.override.yml
+compose.override.yml
+
+# Kubernetes secrets
+secrets/
+*.secret.yaml
+*.secret.yml

.gitignore

@@ -1,21 +1,25 @@
-# DevOps W07 In-Class Exercise Template
+# DevOps W07 In-Class Exercise Solution
 
-This repository contains a full-stack application with a SvelteKit client and a Spring Boot server. It demonstrates modern web application architecture and DevOps practices.
+This repository contains a full-stack canteen application with a SvelteKit client, Spring Boot server, and LLM recommendation service. It demonstrates modern web application architecture and DevOps practices.
 
 ## Project Overview
 
 This project includes:
-- **Client**: SvelteKit with TypeScript, TailwindCSS, and reusable UI components.
-- **Server**: Spring Boot Java application with RESTful APIs.
-- **DevOps**: Dockerized services, CI/CD pipelines, and production-ready deployment configurations.
+- **Client**: SvelteKit with TypeScript, TailwindCSS, and reusable UI components for browsing canteen meals.
+- **Server**: Spring Boot Java application with RESTful APIs, gRPC communication, and PostgreSQL integration.
+- **LLM Service**: Python FastAPI service for generating meal recommendations using AI.
+- **Database**: PostgreSQL for storing user preferences and application data.
+- **DevOps**: Dockerized services, CI/CD pipelines, Helm charts, and production-ready deployment configurations.
 
 ## Prerequisites
 
 - Node.js (v22 or later)
 - Java JDK 21+
+- Python 3.x
 - Gradle
 - Docker and Docker Compose
 - Git
+- Kubernetes and Helm (for Kubernetes deployment)
 
 ## Setup Instructions
 
@@ -48,8 +52,27 @@ cd w07-solution
    ./gradlew build
    ```
 
+### LLM Service Setup
+
+1. Navigate to the `llm` directory:
+   ```bash
+   cd llm
+   ```
+2. Install dependencies:
+   ```bash
+   python3 -m venv .venv
+   source .venv/bin/activate
+   pip3 install -r requirements.txt
+   ```
+
 ## Running the Application
 
+### Start the Database
+
+```bash
+docker compose up database -d
+```
+
 ### Start the Client
 
 ```bash
@@ -66,21 +89,39 @@ cd server
 ```
 The server API will be available at [http://localhost:8080](http://localhost:8080).
 
+### Start the LLM Service
+
+```bash
+cd llm
+python main.py
+```
+The LLM service will be available at [http://localhost:5000](http://localhost:5000).
+
 ## Development Workflow
 
 ### Client Development
 
 - Built with SvelteKit and TypeScript for a modern, reactive UI.
 - TailwindCSS for styling.
 - Components and routes are organized in the `src` directory.
+- Features meal browsing, favoriting, and user preferences.
 
 ### Server Development
 
 - Built with Spring Boot for scalable and maintainable server services.
+- Includes gRPC communication with the LLM service.
+- PostgreSQL integration for user preferences storage.
+- RESTful APIs for canteen data and user management.
 - Gradle is used for dependency management and building.
 - Source code is in the `src/main/java` directory.
 - Tests are in the `src/test/java` directory.
 
+### LLM Service Development
+
+- Built with FastAPI for AI-powered meal recommendations.
+- Integrates with external LLM APIs for generating personalized suggestions.
+- Source code is in the `llm` directory.
+
 ## Building for Production
 
 ### Client Build
@@ -103,13 +144,31 @@ The project includes Docker configurations for containerized deployment.
 
 ### Build and Run with Docker Compose
 
-1. Build and start the services:
+1. Build and start all services:
    ```bash
    docker compose up --build
    ```
 2. Access the application:
    - Client: [http://localhost:3000](http://localhost:3000)
    - Server: [http://localhost:8080](http://localhost:8080)
+   - LLM Service: [http://localhost:5000](http://localhost:5000)
+   - Database: PostgreSQL on port 5432
+
+## Kubernetes Deployment
+
+The project includes Helm charts for Kubernetes deployment.
+
+### Deploy with Helm
+
+1. Update the `tumid` value in [`helm/canteen-app/values.yaml`](helm/canteen-app/values.yaml):
+   ```yaml
+   tumid: your-tum-id
+   ```
+
+2. Install the Helm chart:
+   ```bash
+   helm install canteen ./helm/canteen-app
+   ```
 
 ## CI/CD Pipeline
 
@@ -122,18 +181,28 @@ The project includes GitHub Actions workflows for:
 ```
 ├── client/                  # SvelteKit client
 │   ├── src/                 # Source code
-│   ├── public/              # Static assets
+│   ├── static/              # Static assets
 │   └── package.json         # Client dependencies
 │
 ├── server/                  # Spring Boot server
-│   ├── src/                 # Source code
+│   ├── src/                 # Source code including gRPC services
 │   ├── build.gradle         # Gradle build file
 │   └── Dockerfile           # Server Dockerfile
 │
+├── llm/                     # Python LLM service
+│   ├── main.py              # FastAPI application
+│   ├── requirements.txt     # Python dependencies
+│   └── Dockerfile           # LLM service Dockerfile
+│
+├── docs/                    # API documentation (Bruno collection)
 ├── compose.yml              # Docker Compose for local development
 └── .github/workflows/       # CI/CD workflows
 ```
 
+## API Documentation
+
+API documentation is available in the [`docs/CanteenApp Bruno`](docs/CanteenApp%20Bruno) directory as a Bruno collection for testing endpoints.
+
 ## License
 
 This project is licensed under the MIT License.