@iconsulting-dev/forgekit 1.1.0

package/dist/templates/ci/ci.yml.hbs

@@ -0,0 +1,87 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  changes:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    outputs:
+{{#if backend}}
+      backend: $\{{ steps.filter.outputs.backend }}
+{{/if}}
+{{#if frontend}}
+      frontend: $\{{ steps.filter.outputs.frontend }}
+{{/if}}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+{{#if backend}}
+            backend:
+              - 'backend/**'
+{{/if}}
+{{#if frontend}}
+            frontend:
+              - 'frontend/**'
+{{/if}}
+
+{{#if backend}}
+  backend:
+    needs: changes
+    if: needs.changes.outputs.backend == 'true'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: corretto
+          java-version: '21'
+          cache: maven
+
+      - name: Build & Test
+        run: ./mvnw verify --batch-mode --no-transfer-progress
+{{/if}}
+
+{{#if frontend}}
+  frontend:
+    needs: changes
+    if: needs.changes.outputs.frontend == 'true'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node 22
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Test
+        run: npm run test -- --watch=false --browsers=ChromeHeadless
+
+      - name: Build
+        run: npm run build
+{{/if}}

package/dist/templates/claude-code/CLAUDE.md.hbs

@@ -0,0 +1,79 @@
+# {{name}}
+
+{{description}}
+
+## Project Structure
+
+```
+{{name}}/
+{{#if backend}}
+├── backend/        # Spring Boot API
+{{/if}}
+{{#if frontend}}
+├── frontend/       # Angular SPA
+{{/if}}
+{{#if docker}}
+├── docker-compose.yml
+{{/if}}
+└── README.md
+```
+
+{{#if backend}}
+## Backend — Spring Boot {{versions.springBoot}}
+
+- **Java 21** with records, pattern matching, sealed classes
+- **Architecture:** Feature-based package structure
+- **DB:** PostgreSQL, Flyway migrations in `backend/src/main/resources/db/migration/`
+- **Conventions:** Records for DTOs, Lombok where useful, MapStruct for mappings
+- **Validation:** Jakarta Bean Validation
+- **Logging:** SLF4J
+
+### Commands
+
+```bash
+cd backend
+./mvnw spring-boot:run          # Start dev server
+./mvnw test                      # Run tests
+./mvnw package -DskipTests       # Build JAR
+```
+
+{{/if}}
+{{#if frontend}}
+## Frontend — Angular
+
+- **Angular {{versions.angular}}** with strict mode, standalone components, signals
+- **UI:** PrimeNG {{versions.primeng}}, theme Aura, PrimeFlex
+- **State:** NgRx SignalStore
+- **Conventions:** OnPush change detection, `input()`/`output()` functions, `inject()` for DI
+- **Control flow:** `@if`, `@for` (not *ngIf/*ngFor)
+- **Indentation:** 2 spaces
+
+### Commands
+
+```bash
+cd frontend
+npm install                      # Install dependencies
+ng serve                         # Start dev server (port 4200)
+ng build                         # Production build
+ng test                          # Run tests
+```
+
+{{/if}}
+{{#if docker}}
+## Infrastructure
+
+```bash
+docker compose up -d             # Start PostgreSQL + pgAdmin
+docker compose down              # Stop services
+```
+
+- **PostgreSQL:** localhost:5432
+- **pgAdmin:** localhost:5050 (admin@admin.com / admin)
+
+{{/if}}
+## Conventions
+
+- **Git:** Conventional commits (`feat:`, `fix:`, `refactor:`, `chore:`)
+- **Branches:** `feature/`, `fix/`, `refactor/`, `chore/`
+- **DB:** snake_case naming
+- **Security:** Never commit secrets, use environment variables

package/dist/templates/claude-code/settings.json.hbs

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+{{#each allowedCommands}}
+      "{{this}}"{{#unless @last}},{{/unless}}
+{{/each}}
+    ]
+  }
+}

package/dist/templates/docker/docker-compose.yml.hbs

@@ -0,0 +1,34 @@
+services:
+  postgres:
+    image: postgres:17
+    container_name: {{dbName}}_postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: {{dbName}}
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    container_name: {{dbName}}_pgadmin
+    restart: unless-stopped
+    environment:
+      PGADMIN_DEFAULT_EMAIL: admin@admin.com
+      PGADMIN_DEFAULT_PASSWORD: admin
+    ports:
+      - "5050:80"
+    depends_on:
+      postgres:
+        condition: service_healthy
+
+volumes:
+  postgres_data:

package/dist/templates/frontend/angular.json.hbs

@@ -0,0 +1,71 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "{{projectName}}": {
+      "projectType": "application",
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular/build:application",
+          "options": {
+            "outputPath": "dist/{{projectName}}",
+            "index": "src/index.html",
+            "browser": "src/main.ts",
+            "tsConfig": "tsconfig.app.json",
+            "inlineStyleLanguage": "scss",
+            "styles": [
+              "node_modules/primeicons/primeicons.css",
+              "node_modules/primeflex/primeflex.css",
+              "src/styles.scss"
+            ]
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "500kB",
+                  "maximumError": "1MB"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "4kB",
+                  "maximumError": "8kB"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true,
+              "fileReplacements": [
+                {
+                  "replace": "src/environments/environment.ts",
+                  "with": "src/environments/environment.development.ts"
+                }
+              ]
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular/build:dev-server",
+          "configurations": {
+            "production": {
+              "buildTarget": "{{projectName}}:build:production"
+            },
+            "development": {
+              "buildTarget": "{{projectName}}:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        }
+      }
+    }
+  }
+}

package/dist/templates/frontend/app.component.ts.hbs

@@ -0,0 +1,11 @@
+import { Component, ChangeDetectionStrategy } from '@angular/core';
+import { RouterOutlet } from '@angular/router';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [RouterOutlet],
+  template: '<router-outlet />',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class AppComponent {}

package/dist/templates/frontend/app.config.ts.hbs

@@ -0,0 +1,16 @@
+import { ApplicationConfig, provideZoneChangeDetection } from '@angular/core';
+import { provideRouter, withComponentInputBinding } from '@angular/router';
+import { provideHttpClient, withInterceptors } from '@angular/common/http';
+import { provideAnimationsAsync } from '@angular/platform-browser/animations/async';
+import { routes } from './app.routes';
+import { authInterceptor } from './core/interceptors/auth.interceptor';
+import { errorInterceptor } from './core/interceptors/error.interceptor';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideZoneChangeDetection({ eventCoalescing: true }),
+    provideRouter(routes, withComponentInputBinding()),
+    provideHttpClient(withInterceptors([authInterceptor, errorInterceptor])),
+    provideAnimationsAsync(),
+  ],
+};

package/dist/templates/frontend/app.routes.ts.hbs

@@ -0,0 +1,14 @@
+import { Routes } from '@angular/router';
+import { LayoutComponent } from './layout/layout.component';
+
+export const routes: Routes = [
+  {
+    path: '',
+    component: LayoutComponent,
+    children: [
+      // Add feature routes here with lazy loading:
+      // { path: 'dashboard', loadComponent: () => import('./features/dashboard/dashboard.component').then(m => m.DashboardComponent) },
+      { path: '', redirectTo: 'home', pathMatch: 'full' },
+    ],
+  },
+];

package/dist/templates/frontend/auth.guard.ts.hbs

@@ -0,0 +1,14 @@
+import { inject } from '@angular/core';
+import { CanActivateFn, Router } from '@angular/router';
+import { AuthService } from '../services/auth.service';
+
+export const authGuard: CanActivateFn = () => {
+  const authService = inject(AuthService);
+  const router = inject(Router);
+
+  if (authService.isAuthenticated()) {
+    return true;
+  }
+
+  return router.createUrlTree(['/login']);
+};

package/dist/templates/frontend/auth.interceptor.ts.hbs

@@ -0,0 +1,13 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+
+export const authInterceptor: HttpInterceptorFn = (req, next) => {
+  const token = localStorage.getItem('access_token');
+
+  if (token) {
+    req = req.clone({
+      setHeaders: { Authorization: `Bearer ${token}` },
+    });
+  }
+
+  return next(req);
+};

package/dist/templates/frontend/auth.service.ts.hbs

@@ -0,0 +1,18 @@
+import { Injectable, signal, computed } from '@angular/core';
+
+@Injectable({ providedIn: 'root' })
+export class AuthService {
+  private readonly token = signal<string | null>(localStorage.getItem('access_token'));
+
+  readonly isAuthenticated = computed(() => !!this.token());
+
+  login(token: string): void {
+    localStorage.setItem('access_token', token);
+    this.token.set(token);
+  }
+
+  logout(): void {
+    localStorage.removeItem('access_token');
+    this.token.set(null);
+  }
+}

package/dist/templates/frontend/environment.development.ts.hbs

@@ -0,0 +1,4 @@
+export const environment = {
+  production: false,
+  apiUrl: 'http://localhost:8080/api',
+};

package/dist/templates/frontend/environment.ts.hbs

@@ -0,0 +1,4 @@
+export const environment = {
+  production: true,
+  apiUrl: '/api',
+};

package/dist/templates/frontend/error.interceptor.ts.hbs

@@ -0,0 +1,14 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+import { catchError, throwError } from 'rxjs';
+
+export const errorInterceptor: HttpInterceptorFn = (req, next) => {
+  return next(req).pipe(
+    catchError((error) => {
+      if (error.status === 401) {
+        localStorage.removeItem('access_token');
+        window.location.href = '/login';
+      }
+      return throwError(() => error);
+    }),
+  );
+};

package/dist/templates/frontend/gitignore.hbs

@@ -0,0 +1,4 @@
+/dist
+/node_modules
+/.angular
+.DS_Store

package/dist/templates/frontend/index.html.hbs

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="fr">
+<head>
+  <meta charset="utf-8">
+  <title>{{name}}</title>
+  <base href="/">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="icon" type="image/x-icon" href="favicon.ico">
+</head>
+<body>
+  <app-root></app-root>
+</body>
+</html>

package/dist/templates/frontend/layout.component.ts.hbs

@@ -0,0 +1,42 @@
+import { Component, ChangeDetectionStrategy, signal } from '@angular/core';
+import { RouterOutlet } from '@angular/router';
+import { SidebarComponent } from './sidebar/sidebar.component';
+import { TopbarComponent } from './topbar/topbar.component';
+
+@Component({
+  selector: 'app-layout',
+  standalone: true,
+  imports: [RouterOutlet, SidebarComponent, TopbarComponent],
+  template: `
+    <div class="layout-wrapper">
+      <app-topbar (toggleSidebar)="sidebarVisible.set(!sidebarVisible())" />
+      <div class="layout-content-wrapper">
+        <app-sidebar [visible]="sidebarVisible()" />
+        <main class="layout-main">
+          <router-outlet />
+        </main>
+      </div>
+    </div>
+  `,
+  styles: `
+    .layout-wrapper {
+      display: flex;
+      flex-direction: column;
+      height: 100vh;
+    }
+    .layout-content-wrapper {
+      display: flex;
+      flex: 1;
+      overflow: hidden;
+    }
+    .layout-main {
+      flex: 1;
+      padding: 1.5rem;
+      overflow-y: auto;
+    }
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class LayoutComponent {
+  sidebarVisible = signal(true);
+}

package/dist/templates/frontend/main.ts.hbs

@@ -0,0 +1,6 @@
+import { bootstrapApplication } from '@angular/platform-browser';
+import { appConfig } from './app/app.config';
+import { AppComponent } from './app/app.component';
+
+bootstrapApplication(AppComponent, appConfig)
+  .catch((err) => console.error(err));

package/dist/templates/frontend/package.json.hbs

@@ -0,0 +1,35 @@
+{
+  "name": "{{projectName}}-frontend",
+  "version": "0.0.0",
+  "scripts": {
+    "ng": "ng",
+    "start": "ng serve",
+    "build": "ng build",
+    "watch": "ng build --watch --configuration development",
+    "test": "ng test"
+  },
+  "private": true,
+  "dependencies": {
+    "@angular/animations": "^{{versions.angular}}",
+    "@angular/common": "^{{versions.angular}}",
+    "@angular/compiler": "^{{versions.angular}}",
+    "@angular/core": "^{{versions.angular}}",
+    "@angular/forms": "^{{versions.angular}}",
+    "@angular/platform-browser": "^{{versions.angular}}",
+    "@angular/platform-browser-dynamic": "^{{versions.angular}}",
+    "@angular/router": "^{{versions.angular}}",
+    "@ngrx/signals": "^{{versions.ngrxSignals}}",
+    "primeng": "^{{versions.primeng}}",
+    "primeicons": "^{{versions.primeicons}}",
+    "primeflex": "^{{versions.primeflex}}",
+    "rxjs": "~{{versions.rxjs}}",
+    "tslib": "^2.8.0",
+    "zone.js": "~{{versions.zoneJs}}"
+  },
+  "devDependencies": {
+    "@angular/build": "^{{versions.angular}}",
+    "@angular/cli": "^{{versions.angular}}",
+    "@angular/compiler-cli": "^{{versions.angular}}",
+    "typescript": "~{{versions.typescript}}"
+  }
+}

package/dist/templates/frontend/sidebar.component.ts.hbs

@@ -0,0 +1,58 @@
+import { Component, ChangeDetectionStrategy, input } from '@angular/core';
+import { RouterLink, RouterLinkActive } from '@angular/router';
+
+@Component({
+  selector: 'app-sidebar',
+  standalone: true,
+  imports: [RouterLink, RouterLinkActive],
+  template: `
+    @if (visible()) {
+      <aside class="layout-sidebar">
+        <nav>
+          <ul class="sidebar-menu">
+            <li>
+              <a routerLink="/home" routerLinkActive="active-link">
+                <i class="pi pi-home"></i>
+                <span>Accueil</span>
+              </a>
+            </li>
+          </ul>
+        </nav>
+      </aside>
+    }
+  `,
+  styles: `
+    .layout-sidebar {
+      width: 250px;
+      background: var(--surface-card);
+      border-right: 1px solid var(--surface-border);
+      padding: 1rem;
+    }
+    .sidebar-menu {
+      list-style: none;
+      padding: 0;
+      margin: 0;
+    }
+    .sidebar-menu a {
+      display: flex;
+      align-items: center;
+      gap: 0.75rem;
+      padding: 0.75rem 1rem;
+      border-radius: var(--border-radius);
+      color: var(--text-color);
+      text-decoration: none;
+      transition: background 0.2s;
+    }
+    .sidebar-menu a:hover {
+      background: var(--surface-hover);
+    }
+    .active-link {
+      background: var(--primary-color) !important;
+      color: var(--primary-color-text) !important;
+    }
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class SidebarComponent {
+  visible = input(true);
+}

package/dist/templates/frontend/styles.scss.hbs

@@ -0,0 +1,8 @@
+@use 'primeng/resources/themes/aura-light-blue/theme.css';
+@use 'primeng/resources/primeng.css';
+
+html, body {
+  height: 100%;
+  margin: 0;
+  font-family: var(--font-family);
+}

package/dist/templates/frontend/topbar.component.ts.hbs

@@ -0,0 +1,59 @@
+import { Component, ChangeDetectionStrategy, output } from '@angular/core';
+
+@Component({
+  selector: 'app-topbar',
+  standalone: true,
+  template: `
+    <header class="layout-topbar">
+      <div class="topbar-left">
+        <button class="topbar-menu-btn" (click)="toggleSidebar.emit()">
+          <i class="pi pi-bars"></i>
+        </button>
+        <span class="topbar-title">ForgeKit App</span>
+      </div>
+      <div class="topbar-right">
+        <button class="topbar-avatar">
+          <i class="pi pi-user"></i>
+        </button>
+      </div>
+    </header>
+  `,
+  styles: `
+    .layout-topbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 0 1.5rem;
+      height: 60px;
+      background: var(--surface-card);
+      border-bottom: 1px solid var(--surface-border);
+    }
+    .topbar-left {
+      display: flex;
+      align-items: center;
+      gap: 1rem;
+    }
+    .topbar-menu-btn, .topbar-avatar {
+      background: none;
+      border: none;
+      cursor: pointer;
+      font-size: 1.25rem;
+      color: var(--text-color);
+      padding: 0.5rem;
+      border-radius: 50%;
+      transition: background 0.2s;
+    }
+    .topbar-menu-btn:hover, .topbar-avatar:hover {
+      background: var(--surface-hover);
+    }
+    .topbar-title {
+      font-size: 1.25rem;
+      font-weight: 600;
+      color: var(--text-color);
+    }
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class TopbarComponent {
+  toggleSidebar = output();
+}

package/dist/templates/frontend/tsconfig.app.json.hbs

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./out-tsc/app",
+    "types": []
+  },
+  "files": [
+    "src/main.ts"
+  ],
+  "include": [
+    "src/**/*.d.ts"
+  ]
+}

package/dist/templates/frontend/tsconfig.json.hbs

@@ -0,0 +1,24 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "outDir": "./dist/out-tsc",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "sourceMap": true,
+    "declaration": false,
+    "downlevelIteration": true,
+    "experimentalDecorators": true,
+    "moduleResolution": "node",
+    "importHelpers": true,
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": [
+      "ES2022",
+      "dom"
+    ],
+    "useDefineForClassFields": false
+  }
+}