# dansilva41/uniph architecture

> Architecture diagram of the GitHub repository dansilva41/uniph, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dansilva41/uniph
- Repository: https://github.com/dansilva41/uniph

## Overview

##### Project Type Analysis
This is a Java web application that uses JSF (JavaServer Faces) with PrimeFaces for the frontend, JPA/Hibernate for persistence, and follows DDD architecture. It appears to be an educational management system (UniPH) with features for managing students, professors, courses, and classes.

##### Main Architectural Components

A. Presentation Layer (Web Layer)
- JSF Pages (.xhtml files)
- Managed Beans (in aplicacao.managedsbeans)
- Templates and Resources

B. Application Layer
- Listeners
- Utilities
- Converters

C. Domain Layer
- Entities
- Repositories
- Services

D. Infrastructure Layer
- DAO Implementation
- Persistence Configuration
- Transaction Management

**[Web Layer (JSF/PrimeFaces)]**
- ↓
**[Application Layer]**
- ↓
**[Domain Layer]**
- ↓
**[Infrastructure Layer]**
- ↓
**[Database]**

##### Specific Components

Frontend Section:
- .xhtml pages (login.xhtml, aluno.xhtml, etc.)
- Them to their respective managed beans
- Template structure (Layout.xhtml, Menu.xhtml)

Application Layer:
- AutorizadorListener
- Converters (DisciplinaConverter, ProfessorConverter, etc.)
- Utility classes

Domain Layer:
- Entities (Aluno, Professor, Disciplina, Turma, Usuario)
- Services for each entity
- Repository interfaces

Infrastructure Layer:
- DAO implementations
- EntityManagerProducer
- Transaction management components

##### Additional Elements

- Technology badges (JSF 2.3.3, PrimeFaces 6.2, JPA 2.1, etc.)
- External dependencies (Hibernate, CDI)
- Database connection configuration

##### Key Relationships to Highlight

- ManagedBeans → Services
- Services → Repositories
- Repositories → DAOs
- DAOs → Database
- Entity relationships (e.g., Turma containing Alunos and Professores)

##### Technical Details

- CDI injection points
- Transaction boundaries
- JPA entity mappings
- Template inheritance structure
- Authentication/authorization flow

Remember to include notes about:
- The CDI dependency injection system
- Transaction management through @Transacional
- Entity conversion for JSF components
- Template-based layout system
- Authentication/authorization flow through AutorizadorListener

This will provide a complete picture of both the architectural structure and the technical implementation details of the UniPH system.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef presentation fill:#3498db,stroke:#2980b9,color:white
    classDef application fill:#9b59b6,stroke:#8e44ad,color:white
    classDef domain fill:#2ecc71,stroke:#27ae60,color:white
    classDef infrastructure fill:#e67e22,stroke:#d35400,color:white
    classDef database fill:#95a5a6,stroke:#7f8c8d,color:white

    %% Web Layer
    subgraph WebLayer
        JSFPages["JSF Pages (.xhtml)"]:::presentation
        ManagedBeans["Managed Beans"]:::presentation
        Templates["Page Templates"]:::presentation
        Resources["Web Resources"]:::presentation
    end

    %% Application Layer
    subgraph ApplicationLayer
        AuthListener["Authorization Listener"]:::application
        Converters["Converters"]:::application
        Utils["Utilities"]:::application
    end

    %% Domain Layer
    subgraph DomainLayer
        Entities["Domain Entities"]:::domain
        Repositories["Domain Repositories"]:::domain
        Services["Domain Services"]:::domain
    end

    %% Infrastructure Layer
    subgraph InfrastructureLayer
        DAOImpl["DAO Implementation"]:::infrastructure
        PersistenceConfig["Persistence Configuration"]:::infrastructure
        TransactionMgmt["Transaction Management"]:::infrastructure
        EntityMgrProducer["Entity Manager Producer"]:::infrastructure
        JPAConfig["JPA Configuration"]:::infrastructure
    end

    %% Database
    DB[(Database)]:::database

    %% Relationships
    JSFPages --> ManagedBeans
    JSFPages --> Templates
    JSFPages --> Resources
    ManagedBeans --> Services
    ManagedBeans --> Converters
    AuthListener --> Services
    Services --> Repositories
    Repositories --> DAOImpl
    DAOImpl --> EntityMgrProducer
    EntityMgrProducer --> JPAConfig
    TransactionMgmt --> EntityMgrProducer
    DAOImpl --> DB
    PersistenceConfig --> DB

    %% Click Events
    click JSFPages "https://github.com/DanSilva41/uniph/blob/master/src/main/webapp/*.xhtml"
    click ManagedBeans "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/aplicacao/managedsbeans/"
    click Templates "https://github.com/DanSilva41/uniph/tree/master/src/main/webapp/WEB-INF/templates/"
    click Resources "https://github.com/DanSilva41/uniph/tree/master/src/main/webapp/resources/uniph/"
    click AuthListener "https://github.com/DanSilva41/uniph/blob/master/src/main/java/br/com/sitedoph/uniph/aplicacao/listeners/AutorizadorListener.java"
    click Converters "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/aplicacao/util/"
    click Entities "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/dominio/entidades/"
    click Repositories "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/dominio/repositorios/"
    click Services "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/dominio/services/"
    click DAOImpl "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/infraestrutura/dao/impl/"
    click PersistenceConfig "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/infraestrutura/persistencia/"
    click TransactionMgmt "https://github.com/DanSilva41/uniph/tree/master/src/main/java/br/com/sitedoph/uniph/infraestrutura/persistencia/util/"
    click EntityMgrProducer "https://github.com/DanSilva41/uniph/blob/master/src/main/java/br/com/sitedoph/uniph/infraestrutura/persistencia/util/EntityManagerProducer.java"
    click JPAConfig "https://github.com/DanSilva41/uniph/blob/master/src/main/resources/META-INF/persistence.xml"

    %% Legend
    subgraph Legend
        P[Presentation]:::presentation
        A[Application]:::application
        D[Domain]:::domain
        I[Infrastructure]:::infrastructure
        DB2[(Database)]:::database
    end
```
