🏢 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/

🔧 pi_mcps Wiki

Overview

MCP Servers

Java Projects

🌿 CannaManage

Gitea Repo