Merge branch 'main' into main

Author: AlexBa16

.github/workflows/php-cs-fixer.yml

@@ -0,0 +1,24 @@
+name: PHP Code Style
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  php-cs-fixer:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.2
+
+      - name: Install dependencies
+        run: composer install --no-interaction --no-progress
+
+      - name: Run PHP CS Fixer
+        run: vendor/bin/php-cs-fixer fix --dry-run --diff

.php-cs-fixer.php

@@ -0,0 +1,10 @@
+<?php
+
+return (new PhpCsFixer\Config())
+    ->setRules([
+        '@PSR12' => true,
+    ])
+    ->setFinder(
+        PhpCsFixer\Finder::create()
+            ->in(__DIR__)
+    );

15_digital_meal_plan.pdf

@@ -1,173 +1,75 @@
-# WEBT_25-26_04-CORE
+# WEBT_25-26_03-ADV
 
-WEBT-VT | CORE | 04 - Composer and Views in MVC
+WEBT-VT | ADV | 03 - Coding Standards
 
-## Composer Infos
-
-* ```composer require {package}``` to install
-* https://packagist.org to search for composer packages
-* ```composer dump-autoload``` to reload Autoloading
-
-## Digital Meal Plan – Project Overview
-
-This project is a sample web application for a **Digital Meal Plan** and was developed as part of the exercise **WEBT
-Core – Composer & MVC Templating**.
-
-The goal of the project is to demonstrate:
-
-* how to use Composer in a PHP project
-* how to implement a simple custom templating engine
-* how to render dynamic content using loops
-* how to generate and integrate QR codes using `endroid/qr-code`
-
----
-
-## Project Structure (High-Level)
-
-```
-├── composer.json              # Composer configuration & dependencies
-├── composer.lock              # Locked dependency versions
-├── public/
-│   ├── index.php               # Main page: displays all meal plans
-│   ├── api.php                 # JSON API for single meal
-│   ├── form.php                # Interactive QR code generator form
-│   ├── qrCodeExample.php       # Simple QR code demo script
-│   └── styles/
-│       └── style.css           # Global styling for the project
-├── src/
-│   ├── Api/
-│   │   └── GetMeals.php        # Returns a meal as JSON
-│   ├── QrCode/
-│   │   └── QrCodeBuilder.php   # Wrapper for endroid/qr-code
-│   ├── Seeder/
-│   │   └── MealSeeder.php      # Generates example meal plans
-│   └── View/
-│       └── TemplateEngine.php  # Custom templating engine
-├── templates/
-│   ├── index.html              # Template for meal plan overview
-│   └── form.html               # Template for QR code form
-└── vendor/                     # Composer dependencies (auto-generated)
-```
-
----
-
-### User Stories 1–3: Composer & QR Code Package
-
-**Relevant files:**
-
-* `composer.json`
-* `vendor/`
-* `public/qrCodeExample.php`
-
-Composer is initialized, PSR-4 autoloading is configured, and the package `endroid/qr-code` is
-installed and used.
-
----
-
-### User Story 4: Meal Plan HTML Prototype
-
-**Relevant files:**
-
-* `templates/index.html`
-* `public/styles/style.css`
+### PHP Interpreter aus Docker in PhpStorm einrichten
 
-Defines the responsive HTML structure and basic styling for displaying multiple meal plans.
+* File -> Settings -> PHP
+* Auf `...` neben **CLI Interpreter** klicken
+* `+` -> **From Docker** -> **Docker Composer**
 
----
+- **Server:** Docker
+- **Configuration file:** `./WEBT_25-26_03-ADV/docker-compose.yaml`
+- **Service:** `web`
+- **PHP executable:** `php`
 
-### User Stories 5 & 6: Templating Engine & Dynamic Rendering
+* **Lifecycle:** Connect to existing container ('docker-compose exec')
+* **CLI Interpreter:** `web`
 
-**Relevant files:**
+### PHP CS Fixer in PhpStorm konfigurieren
 
-* `src/View/TemplateEngine.php`
-* `public/index.php`
-* `templates/index.html`
+* File -> Settings -> PHP -> Quality Tools -> PHP CS Fixer
+* Auf `...` neben **Configuration** klicken
+* `+` -> **Interpreter:** `web`
+* **PHP CS Fixer path:** `./vendor/bin/php-cs-fixer`
+* **Path mappings:** Map ADV3 Folder to `/var/www/html`
 
-The custom `TemplateEngine` replaces placeholders and supports loop constructs to dynamically render any number of meal
-plans and meals.
+### Reformat specific File with PhpStorm
 
----
+`Ctrl + Shift + A -> "Fix CS"`
 
-### User Story 7: QR Code Generation & Integration
+### Reformat at File save
 
-**Relevant files:**
+* File -> Settings -> PHP -> Quality Tools -> **External Formatters:** `PHP CS Fixer`
+* `Settings -> Tools -> Action on Save`
 
-* `src/QrCode/QrCodeBuilder.php`
-* `public/index.php`
-* `public/api.php`
+- Select `Reformat code` & `Rearrange code`
 
-QR codes are generated for each meal plan and link to a JSON API endpoint that returns the meal data.
+### PHP Coding Standards
 
----
+#### Standard
 
-### User Story 8: Interactive QR Code Generator
+* PSR-12
 
-**Relevant files:**
+#### Tooling
 
-* `public/form.php`
-* `templates/form.html`
+* PHP CS Fixer
+* Configuration: .php-cs-fixer.php
 
-Users can enter a meal ID and generate a QR code dynamically via a styled form.
+#### Rules
 
----
+* 4-space indentation
+* One class per file
+* Strict type declarations
 
-## File Descriptions
-
-### `public/index.php`
-
-* Main entry point of the application
-* Loads demo data using `MealSeeder`
-* Generates QR codes for each meal plan
-* Passes structured data to the template engine
-
-### `public/api.php`
-
-* Simple JSON API endpoint
-* Returns a single meal plan by ID
-* Used as the target URL for QR codes
-
-### `public/form.php`
-
-* Handles POST requests
-* Validates user input (meal ID)
-* Generates QR codes dynamically
-* Renders output via `form.html`
-
-### `src/View/TemplateEngine.php`
-
-* Custom mini templating engine
-* Replaces placeholders in HTML templates
-* Supports loops and nested loops
-* Ensures separation of logic and presentation
-
-### `src/QrCode/QrCodeBuilder.php`
-
-* Encapsulates QR code generation logic
-* Wraps the `endroid/qr-code` library
-* Provides a clean and reusable interface
-
-### `src/Seeder/MealSeeder.php`
+## Composer Infos
 
-* Generates demo meal plan data
-* Simulates database content
-* Used for dynamic rendering
+`composer require --dev friendsofphp/php-cs-fixer`
 
----
-
-## Setup & Run the Project
+### Using PHP CS Fixer via the command line
 
 ```bash
-
-docker compose up -d
-docker exec -it CORE4 bash
-
-git config --global --add safe.directory /var/www/html
-composer install
+  docker exec -it ADV3 bash
+  vendor/bin/php-cs-fixer fix
+  exit
 ```
 
-Open in your browser:
-
-* http://localhost:8080
-* http://localhost:8080/form.php
+## Setup & Run the Project
 
----
+```bash
+  docker compose up -d
+  docker exec -it ADV3 bash
+  
+  git config --global --add safe.directory /var/www/html
+  composer install
+```

README.md

@@ -1,12 +1,16 @@
 {
-    "name": "radlinger/mealplan",
-    "description": "Project for our WEBT Core 4 exercise with the topic MealPlan",
-    "autoload": {
-        "psr-4": {
-            "Radlinger\\Mealplan\\": "src/"
-        }
-    },
-    "require": {
-        "endroid/qr-code": "^6.0"
+  "name": "radlinger/mealplan",
+  "description": "Project for our WEBT ADV 3 exercise with the topic MealPlan",
+  "autoload": {
+    "psr-4": {
+      "Radlinger\\Mealplan\\": "src/"
     }
+  },
+  "require": {
+    "php": "^8.2",
+    "endroid/qr-code": "^6.0"
+  },
+  "require-dev": {
+    "friendsofphp/php-cs-fixer": "^3.92"
+  }
 }