Files

T

Patrick Plate dabdda167f docs(wiki): migrate to git-based workflow with persistent wiki/ clone

- Extract all wiki content from create_wiki_pages.py into docs/wiki/pages/*.md
- Add docs/wiki/deploy_wiki.sh: copies pages to wiki/ repo, commits, pushes
- Add /wiki/ to .gitignore (anchored — does not affect docs/wiki/)
- 12 pages: Home, MCP-Servers-Overview, mcp-image-gen, ComfyUI-Setup,
  mcp-webscraper (8 tools incl. search_hint), BigMind (schema v8),
  Development-Conventions, Java-Projects, Java-wellmann-shop,
  Java-mss-failsafe, Java-Architecture, _Sidebar
- Workflow: edit docs/wiki/pages/*.md → ./docs/wiki/deploy_wiki.sh

2026-04-05 09:48:19 +02:00

3.0 KiB

Raw Blame History

🏢 mss-failsafe — Multi-Module Enterprise Application

mss-failsafe is a multi-module Java EE enterprise web application demonstrating advanced patterns: modular Maven builds, Jakarta Security (Soteria), and multi-layer JPA architecture.

Tech Stack

Component	Technology
Language	Java 11
Web Framework	JSF 2.3 (Facelets/XHTML)
UI Components	PrimeFaces 10
Persistence	JPA (multi-module)
Security	Jakarta Security / Soteria
Build	Maven multi-module
App Server	WildFly/JBoss

Module Structure

java/mss-failsafe/
├── pom.xml                    ← Parent POM (multi-module)
├── mssfailsafe.datalayer/     ← JPA entities + persistence
│   ├── pom.xml
│   └── src/main/resources/META-INF/persistence.xml
├── userdata/                  ← User data model module
│   └── pom.xml
└── userManagement/            ← Web UI module (JSF/PrimeFaces)
    ├── pom.xml
    ├── nb-configuration.xml   ← NetBeans config
    └── src/main/webapp/
        ├── index.xhtml        ← Landing page
        ├── error.xhtml        ← Error handling page
        ├── admin/
        │   └── welcome.xhtml  ← Admin dashboard
        ├── user/
        │   └── welcome.xhtml  ← User welcome page
        └── WEB-INF/
            ├── web.xml
            ├── jboss-web.xml
            └── jboss-app.xml

Architecture Layers

userManagement (Web/UI layer)
      │
      ▼
userdata (Domain model layer)
      │
      ▼
mssfailsafe.datalayer (JPA persistence layer)
      │
      ▼
Database (via persistence.xml datasource)

Key Features

Multi-Module Maven — Clean separation of concerns across 4 modules
Jakarta Security (Soteria) — Modern declarative security replacing legacy JAAS
Role-Based Access — Admin vs User role segregation (admin/ and user/ view paths)
PrimeFaces 10 — Modern PrimeFaces with updated component API
Error Handling — Dedicated error.xhtml with JSF error page mapping

Security Model

Soteria-based security with two roles:

Role	Path	Access
`admin`	`/admin/*`	Full admin dashboard
`user`	`/user/*`	Standard user views

Building

cd java/mss-failsafe
mvn clean install  # builds all modules in dependency order
# Deploy userManagement.war to WildFly

Notes

Represents a more mature architecture than wellmann-shop (Java 11, PrimeFaces 10)
Demonstrates multi-module Maven project management
Soteria replaces legacy JAAS — more modern Jakarta EE security approach
Pattern mirrors what Patrick uses professionally in the Paisy/ADP codebase

Source

java/mss-failsafe/

3.0 KiB Raw Blame History