Feat/refacto front signal forms

.github/workflows/cicd.yml

@@ -115,26 +115,8 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v6
 
-      - name: Build docker image app
-        working-directory: e2e
-        run: docker compose -f ../devops/compose-e2e.yaml up -d --wait app-e2e
-
       - name: Cypress run
         working-directory: e2e
         run: |
           npm i
-          npm run cypress:ci
-
-      - name: Upload Cypress screenshots on failure
-        uses: actions/upload-artifact@v6
-        if: failure()
-        with:
-          name: cypress-screenshots
-          path: e2e/cypress/screenshots
-
-      - name: Cleanup on failure
-        if: failure()
-        run: |
-          echo "=== Debug Info on Failure ==="
-          docker ps -a
-          docker logs devops-app-e2e-1
+          npm run cypress:run:docker

README.md

@@ -1,30 +1,61 @@
 # ✈️ Tripr
 
-> **fast SaaS Starter** combining the power of **Spring Boot 3 (Kotlin)** and the reactivity of **Angular 21 (Signals)**.
+> **Modern SaaS Starter** combining the power of **Spring Boot 4 (Kotlin)** and the reactivity of **Angular 21 (Signals)**.
 
 [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/example/tripr/actions)
 [![Kotlin](https://img.shields.io/badge/Kotlin-2.3.10-blue.svg)](https://kotlinlang.org/)
 [![Angular](https://img.shields.io/badge/Angular-21-red.svg)](https://angular.dev/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
-Tripr is a production-ready template designed for scalability, security, and a smooth developer experience. It integrates a strict hexagonal architecture on the backend and a reactive zoneless approach on the frontend.
+Tripr is a production-ready template designed for scalability, security, and a smooth developer experience. It features a **contract-first approach** using OpenAPI to bridge the gap between a strict Hexagonal backend and a reactive Zoneless frontend.
 
 ### 🏗️ Architecture Overview
 
 ```mermaid
 graph LR
-    User((User)) <--> Front[Angular App <br/><i>Signals & Zoneless</i>]
-    Front <--> Back[Spring Boot API <br/><i>Hexagonal Architecture</i>]
-    Back <--> DB[(PostgreSQL)]
-    Back <--> SMTP[SMTP Service]
+
+  subgraph Angular
+    A1[Components]
+    A2[Services]
+  end
+
+  subgraph OpenAPI-Generator
+    O1[openapi.yaml]
+    O2[TS Client]
+  end
+
+  subgraph Spring-Boot
+    subgraph adapters-in
+      B1[REST Controllers]
+    end
+    subgraph domain
+      B2[Ports In]
+      B3[Services / Use Cases]
+      B4[Ports Out]
+    end
+    subgraph adapters-out
+      B5[Persistence JPA]
+      B6[Notification Email]
+    end
+    subgraph application
+      B7[Main / Config]
+    end
+
+    B1 --> B2 --> B3 --> B4
+    B4 --> B5
+    B4 --> B6
+  end
+
+  A2 --> O1 --> O2 --> B1
 ```
 
 ### 🛠️ Tech Stack
 
 | Component    | Key Technologies                                                                     |
 |:-------------|:-------------------------------------------------------------------------------------|
 | **Backend**  | Kotlin, Spring Boot 4.+, Spring Security (JWT), Liquibase, MapStruct, Testcontainers |
-| **Frontend** | Angular 21, Vite, Vitest, Bootstrap 5, Transloco (i18n), Signals                     |
+| **Frontend** | Angular 21, Vite, Vitest, Bootstrap 5, Transloco (i18n), Signals, Zoneless           |
+| **Bridge**   | **OpenAPI Generator** (Automatic Model & API Synchronization)                        |
 | **DevOps**   | Docker, GitHub Actions, Ansible                                                      |
 
 ---
@@ -49,6 +80,12 @@ cd backend && ./gradlew bootRun
 cd frontend && npm install && npm run dev
 ```
 
+### 🛠️ Dev Links
+
+- 🌐 **Frontend** → http://localhost:4200
+- 📄 **Swagger UI** → http://localhost:8080/api/swagger-ui
+- 📬 **Mailpit** → http://localhost:8026
+
 ### 📁 Monorepo Structure
 
 ```text
@@ -63,4 +100,4 @@ cd frontend && npm install && npm run dev
 ---
 
 - 📖 [**Backend Documentation**](backend/README.md) — *Architecture, API & Tests*
-- 📖 [**Frontend Documentation**](frontend/README.md) — *Signals, Standalone & Vite*
+- 📖 [**Frontend Documentation**](frontend/README.md) — *Modern Angular, Tooling & Vite*

api-spec/src/main/openapi/auth.yaml

@@ -303,7 +303,6 @@ components:
           type: string
           description: Username or email for password reset
           example: "john.doe@example.com"
-          minLength: 3
           maxLength: 100
 
     PasswordResetDto:

backend/README.md

@@ -1,8 +1,8 @@
 # 🏗️ Tripr API — Backend
 
-Robust API built with **Spring Boot 3.4** and **Kotlin**, using a strict **Hexagonal Architecture** to ensure domain isolation and testability.
+Robust API built with **Spring Boot 4** and **Kotlin**, using a strict **Hexagonal Architecture** to ensure domain isolation and testability.
 
-🔗 **Swagger UI** (dev mode): [http://localhost:8080/api/swagger-ui](http://localhost:8080/api/swagger-ui)
+The project follows a **Contract-First** approach using **OpenAPI**. The server-side code is generated from the OpenAPI spec, ensuring a perfect sync between documentation and implementation.
 
 ---
 
@@ -13,14 +13,14 @@ The project follows the **Ports & Adapters** pattern to decouple business logic
 - **`domain/`**: **The Core**.
     - `model/`: Domain entities and value objects.
     - `port/`: Inbound (In) and Outbound (Out) interfaces.
-    - `service/`: Business orchestration implementing *In-Ports* by using *Out-Ports*.
+    - `service/`: Business orchestration. Services implement *In-Ports* and use *Out-Ports* to execute business logic.
 - **`infrastructure/`**: **The Adapters**.
-    - Concrete port implementations (JPA/PostgreSQL Persistence, JWT Security, SMTP Email).
-    - REST Controllers and external configurations.
+    - Concrete implementations of *Out-Ports* (Persistence with JPA/PostgreSQL, Security with JWT, Email with SMTP).
+    - Inbound adapters such as REST Controllers.
 - **`application/`**: **The Shell**.
-    - Application bootstrap (Main class).
-    - Global configuration (Spring, Security, Liquibase).
-    - Integration tests and architectural compliance (**ArchUnit**).
+    - Entry point of the application (Main class).
+    - Global configurations (Spring, Security, Docker Compose).
+    - Integration tests and architectural validation (**ArchUnit**).
 
 ---
 

backend/application/src/main/resources/application-e2e.yml

@@ -9,4 +9,6 @@ spring:
 jwt:
   secret: verySecretKeyThatShouldBeAtLeast32CharactersLong
 password-reset:
-  base-url: localhost:8080
+  base-url: localhost:8081
+server:
+  port: 8081

backend/build.gradle.kts

@@ -8,12 +8,12 @@ plugins {
     alias(libs.plugins.kotlin.noarg) apply false
     alias(libs.plugins.spring.boot) apply false
     alias(libs.plugins.kotlin.kapt) apply false
-    jacoco
+    alias(libs.plugins.kover)
 }
 
 subprojects {
     apply(plugin = rootProject.libs.plugins.kotlin.jvm.get().pluginId)
-    apply(plugin = "jacoco")
+    apply(plugin = rootProject.libs.plugins.kover.get().pluginId)
 
     kotlin {
         compilerOptions {
@@ -28,7 +28,7 @@ subprojects {
 
     tasks.withType<Test> {
         useJUnitPlatform()
-        finalizedBy("jacocoTestReport")
+        finalizedBy("koverHtmlReport", "koverXmlReport")
     }
 
     tasks.withType<BootRun> {
@@ -39,29 +39,43 @@ subprojects {
         enabled = false
     }
 
-    jacoco {
-        toolVersion = rootProject.libs.versions.jacoco.get()
-    }
-
-    afterEvaluate {
-        tasks.named<JacocoReport>("jacocoTestReport") {
-            dependsOn(tasks.test)
-
-            reports {
-                xml.required.set(true)
-            }
-
-            classDirectories.setFrom(
-                fileTree("build/classes/kotlin/main") {
-                    exclude(
-                        "**/config/**",
-                        "**/dto/**",
-                        "**/enums/**",
-                        "**/exception/**",
-                        "**/annotation/**"
+    kover {
+        reports {
+            filters {
+                excludes {
+                    classes(
+                        "**.config.**",
+                        "**.dto.**",
+                        "**.enums.**",
+                        "**.exception.**",
+                        "**.annotation.**",
+                        "**.entity.**",
+                        "**.model.**",
+                        "**.*DefaultImpls",
+                        "**.*Api",
+                        "**.*Delegate",
+                        "**.*ExceptionHandler",
+                        "**.*ApiUtil",
+                        "**.*Exception",
+                        $$"**.*$Companion"
                     )
                 }
-            )
+            }
+            total {
+                xml {
+                    onCheck = true
+                }
+                html {
+                    onCheck = true
+                }
+            }
+            verify {
+                rule {
+                    bound {
+                        minValue = 80
+                    }
+                }
+            }
         }
     }
 }

backend/domain/src/main/kotlin/com/adsearch/domain/service/PasswordResetService.kt

@@ -39,8 +39,7 @@ class PasswordResetService(
      * Request a password reset for a user
      */
     override fun requestPasswordReset(username: String) {
-        val user: User = userPersistence.findByUsername(username)
-            ?: throw UserNotFoundException("Password reset request failed - user not found with username: $username")
+        val user: User = userPersistence.findByUsername(username) ?: return // For security reason, we must not throw any error if the user doesn't exist
 
         // Delete any existing tokens for this user
         tokenPersistence.deletePasswordResetTokenByUser(user)