# Architecture
Ce document dΓ©crit l'architecture de **PrimeFaces Freya Extension**.
## ποΈ Vue d'ensemble
PrimeFaces Freya Extension est une bibliothèque de **composants composites Jakarta Faces** qui simplifie l'utilisation de PrimeFaces avec le thème Freya.
### Principe de base
```
XHTML Page β Freya Extension β PrimeFaces β Jakarta Faces β HTML/CSS/JS
```
## π Diagramme d'architecture
```
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Application Layer β
β ββββββββββββββββ ββββββββββββββββ ββββββββββββββ β
β β XHTML Pages β βββ> β Managed Beansβ βββ> β Business β β
β ββββββββββββββββ ββββββββββββββββ β Logic β β
β β ββββββββββββββ β
βββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β PrimeFaces Freya Extension (46 composants) β
β ββββββββββββββββ ββββββββββββββββ ββββββββββββββββ β
β β fr:fieldInputβ β fr:fieldSelectβ βfr:actionDialogβ β
β ββββββββ¬ββββββββ ββββββββ¬ββββββββ ββββββββ¬ββββββββ β
β β β β β
β βββββββββββββββββββ΄βββββββββββββββββββ β
β β β
β ββββββββββΌβββββββββ β
β β Composite β β
β β Components β β
β ββββββββββ¬βββββββββ β
β β β
β ββββββββββΌβββββββββ β
β β freya.taglib.xmlβ β
β βββββββββββββββββββ β
βββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β PrimeFaces Core β
β ββββββββββββββββ ββββββββββββββββ ββββββββββββββββ β
β β p:inputText β βp:selectOneMenuβ β p:dialog β β
β ββββββββ¬ββββββββ ββββββββ¬ββββββββ ββββββββ¬ββββββββ β
β βββββββββββββββββββ΄βββββββββββββββββββ β
β β β
β ββββββββββΌβββββββββ β
β β PrimeFaces β β
β β Components β β
β ββββββββββ¬βββββββββ β
βββββββββββββββββββββββββββ¬ββ΄ββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Jakarta Faces β
β ββββββββββββββββ ββββββββββββββββ ββββββββββββββββ β
β β Facelets ββ>β JSF Lifecycleββ>β Rendering β β
β ββββββββββββββββ ββββββββββββββββ ββββββββ¬ββββββββ β
βββββββββββββββββββββββββββββββββββββββββββββββΌββββββββββββββββ
β
βββββββββββββββββββββ
β
βββββββββββββββββ΄ββββββββββββββββ
β β
βΌ βΌ
ββββββββββββββββββββ ββββββββββββββββββββ
β Freya Theme β β HTML/CSS/JS β
β ββββββββββββββββ β β β
β βlayout-*.css β β β Final Output β
β βprimeicons.cssβ βββββββββββββ>β to Browser β
β βprimeflex.css β β β β
β ββββββββββββββββ β ββββββββββββββββββββ
ββββββββββββββββββββ
```
## π§ Composants
### Structure d'un composant composite
Chaque composant Freya Extension suit cette structure :
```xml
```
### CatΓ©gories de composants
| CatΓ©gorie | Nombre | Exemples |
|-----------|--------|----------|
| Formulaires | 18 | fieldInput, fieldSelect, fieldCalendar |
| DonnΓ©es | 4 | dataTable, dataView, tree, treeTable |
| Navigation | 3 | breadcrumb, steps, tabView |
| Actions | 4 | button, commandButton, linkButton |
| Feedback | 3 | message, growl, inplace |
| Utilitaires | 6 | avatar, badge, tag, progressBar |
| Layout | 2 | card, panel |
| Dialogs | 2 | actionDialog, formDialog |
| AvancΓ©s | 3 | tree, fieldEditor, chart |
| Thème | 1 | themeSelector |
## π Structure du projet
```
primefaces-freya-extension/
βββ runtime/ # Module principal
β βββ pom.xml # DΓ©pendances runtime
β βββ src/main/resources/
β βββ META-INF/
β βββ freya.taglib.xml # DΓ©claration des 46 composants
β βββ resources/
β βββ freya/ # Composants composites (.xhtml)
β βββ fieldInput.xhtml
β βββ fieldSelect.xhtml
β βββ actionDialog.xhtml
β βββ ... (43 autres)
β
βββ integration-tests/ # Tests et dΓ©monstration
β βββ pom.xml # DΓ©pendances de test
β βββ src/main/
β βββ java/
β β βββ dev/lions/freya/demo/
β β βββ DemoBean.java # Bean de dΓ©monstration
β βββ resources/
β βββ application.properties # Configuration Quarkus
β βββ META-INF/resources/
β βββ index.xhtml # Page d'accueil
β βββ components-demo.xhtml # DΓ©mo complΓ¨te
β
βββ README.md # Documentation principale
βββ QUICKSTART.md # Guide de dΓ©marrage rapide
βββ CONTRIBUTING.md # Guide de contribution
βββ ACCESSIBILITY.md # Guide d'accessibilitΓ©
βββ DEPLOYMENT.md # Guide de dΓ©ploiement
βββ CHANGELOG.md # Historique des versions
βββ LICENSE # Licence Apache 2.0
βββ pom.xml # Configuration Maven parent
```
## π Flux de donnΓ©es
### 1. Rendu d'un composant
```
User Request
β
βΌ
XHTML Page (fr:fieldInput)
β
βΌ
freya.taglib.xml (rΓ©solution du composant)
β
βΌ
fieldInput.xhtml (composite component)
β
βΌ
PrimeFaces p:inputText
β
βΌ
Jakarta Faces Lifecycle
β
βΌ
HTML Output + Freya CSS
β
βΌ
Browser
```
### 2. Soumission d'un formulaire
```
User Submit
β
βΌ
AJAX Request (PrimeFaces)
β
βΌ
Jakarta Faces Lifecycle
β
ββ> Apply Request Values
ββ> Process Validations
ββ> Update Model Values
ββ> Invoke Application (Bean method)
ββ> Render Response
β
βΌ
AJAX Response (partial update)
β
βΌ
Browser (DOM update)
```
## π¨ IntΓ©gration avec Freya Theme
### Ressources Freya
```xml
```
### Pattern Freya
Tous les composants `fr:field*` appliquent automatiquement :
```html
...
...
```
## π Technologies utilisΓ©es
| Technologie | Version | RΓ΄le |
|-------------|---------|------|
| Java | 17+ | Langage de programmation |
| Quarkus | 3.15+ | Framework d'application |
| Jakarta Faces | 4.0 | Framework web MVC |
| PrimeFaces | 14.0.0 | Bibliothèque de composants UI |
| Freya Theme | 5.0.0 | Thème CSS moderne |
| PrimeFlex | 3.3.1 | Système de grille CSS |
| Maven | 3.8+ | Gestion de build |
## π Principes de conception
1. **SimplicitΓ©** - RΓ©duire le boilerplate de 80%
2. **CohΓ©rence** - Pattern uniforme pour tous les composants
3. **CompatibilitΓ©** - 100% compatible avec PrimeFaces standard
4. **MaintenabilitΓ©** - Un seul endroit pour modifier le pattern
5. **AccessibilitΓ©** - Support WCAG 2.1 niveau AA
6. **Performance** - Pas de surcharge, juste du wrapping
## π DΓ©pendances
### Runtime
- `io.quarkus:quarkus-myfaces` - Jakarta Faces pour Quarkus
- `org.primefaces:primefaces:14.0.0:jakarta` - PrimeFaces
- `org.primefaces:freya:5.0.0` - Thème Freya
### Build
- `maven-compiler-plugin` - Compilation Java
- `maven-resources-plugin` - Copie des ressources
- `quarkus-maven-plugin` - Build Quarkus
## π Ressources
- [Jakarta Faces Specification](https://jakarta.ee/specifications/faces/)
- [PrimeFaces Documentation](https://primefaces.github.io/primefaces/)
- [Freya Theme](https://freya.primefaces.org/)
- [Quarkus Guide](https://quarkus.io/guides/)