afterwork-server-impl-quarkus

Backend REST — application sociale AfterWork (événements, chat temps réel, social feed, stories)

Dépôt Git

https://git.lions.dev/lionsdev/afterwork-server-impl-quarkus

---

Responsabilités

• API REST sécurisée (JWT HS256 + OIDC Keycloak)
• Gestion des utilisateurs, amis, événements, cotisations
• Chat temps réel (WebSocket)
• Notifications push temps réel
• Social feed (posts, likes, commentaires, stories)
• Upload médias (images/vidéos)
• Emailing transactionnel (via Brevo SMTP)

---

API principales

Domaine	Path
Auth	/api/auth/*
Utilisateurs	/api/users/*
Amis	/api/friends/*
Événements	/api/events/*
Posts / Stories	/api/posts/*, /api/stories/*
Chat	/api/chat/* + WebSocket /ws/chat/{userId}
Notifications	WebSocket /ws/notifications/{userId}
Health	/q/health
Swagger	/q/swagger-ui

---

Stack

Composant	Technologie
Framework	Quarkus 3.27.3 LTS
API	Quarkus REST (RESTEasy Reactive) + Jackson
Auth	JWT HS256 + quarkus-oidc (Keycloak)
ORM	Hibernate ORM Panache
Base de données	PostgreSQL 15
Migrations	Flyway
Messaging	Kafka (event streaming)
Emailing	Brevo SMTP (via quarkus-mailer)
Temps réel	WebSockets-Next
Templates	Qute
Docs	SmallRye OpenAPI (Swagger UI)

---

Développement local

Prérequis

• Java 21 LTS
• Maven 3.9+
• PostgreSQL sur localhost:5432 (DB : afterwork)
• Keycloak sur localhost:8180 (realm à configurer)

Démarrage

mvn quarkus:dev

Swagger UI : http://localhost:8080/q/swagger-ui

Configuration dev

Variables d'environnement recommandées (voir .env.example) :

DB_NAME=afterwork
DB_USERNAME=lionsuser
DB_PASSWORD=...
JWT_SECRET=dev-jwt-secret-min-32-chars

---

Configuration production

Fichier : src/main/resources/application-prod.properties

Toutes les valeurs sensibles via variables d'env ou secrets K8s. Principales :

Variable	Description
DB_HOST / DB_PORT / DB_NAME	PostgreSQL (défaut DB afterwork)
QUARKUS_DATASOURCE_USERNAME / QUARKUS_DATASOURCE_PASSWORD	Injectés via secret afterwork-db-eso (ESO Vault)
QUARKUS_OIDC_*	Config Keycloak (via afterwork-oidc-eso)
JWT_SECRET	Clé HS256 ≥32 caractères
STORAGE_PATH	Chemin stockage uploads (défaut /app/storage en prod)
Brevo SMTP	QUARKUS_MAILER_* via brevo-smtp-eso

---

Build

# Build standard (dev)
mvn clean package -DskipTests

# Build production (fast-jar)
mvn clean package -Pprod -DskipTests

Produit target/quarkus-app/ (fast-jar, runnable via java -jar target/quarkus-app/quarkus-run.jar).

---

Déploiement (lionsctl)

lionsctl pipeline \
  -u https://git.lions.dev/lionsdev/afterwork-server-impl-quarkus \
  -b develop -j 21 -e production -c k1 -p prod

ℹ️ La branche prod est develop (pas main).

Pipeline : clone → mvn package -P prod → docker build -f Dockerfile (racine, fast-jar, ubi8/openjdk-21:1.21, UID 1001) → push registry.lions.dev → kubectl apply → health check

URL prod : https://api.lions.dev/afterwork Health prod : https://api.lions.dev/afterwork/q/health

Pré-requis infrastructure (migration Helm → lionsctl pipeline, fait 2026-04-24) :

• Secret K8s afterwork-server-impl-quarkus-db-secret (clés QUARKUS_DATASOURCE_USERNAME/PASSWORD)
• ExternalSecrets afterwork-db-eso + afterwork-oidc-eso (ESO Vault, path applications/afterwork-server/*)
• DB PostgreSQL afterwork (renommée depuis mic-after-work-server-impl-quarkus-main)
• Override QUARKUS_DATASOURCE_JDBC_URL=jdbc:postgresql://postgresql-service.postgresql.svc.cluster.local:5432/afterwork sur le deployment
• Deployment Helm existant supprimé au préalable (selector immutable)
• envFrom: [afterwork-db-eso, afterwork-oidc-eso] patché post-deploy

Helm (alternative GitOps)

Repo values dédié : afterwork-server-impl-quarkus-k1 (Chart lions-app 1.0.3).

---

Tests

mvn test          # unitaires
mvn verify        # avec intégration

---

Structure

src/main/
├── java/com/lions/dev/
│   ├── entity/         # Entités JPA (User, Event, Post, Story, Message, ...)
│   ├── repository/     # Repositories Panache
│   ├── service/        # Services métier
│   ├── resource/       # Resources JAX-RS
│   ├── websocket/      # Endpoints WebSocket (chat, notifications)
│   ├── security/       # JWT + OIDC filters
│   └── mapper/         # MapStruct mappers
└── resources/
    ├── db/migration/   # Scripts Flyway
    ├── application.properties
    └── application-prod.properties

---

Historique récent

• 2026-04-24 — Refactor mic-after-work-server-impl-quarkus-main → afterwork-server-impl-quarkus (Gitea repo, artifactId, DB afterwork, ingress path /afterwork, ExternalSecrets ESO). Déployé en prod via lionsctl pipeline.
• 2026-04-24 — Upgrade Quarkus 3.16.3 → 3.27.3 LTS + Java 17 → 21 (cohérence avec les autres backends de l'écosystème).

---

Licence

Propriétaire — Lions Dev © 2026