# italo1001/pi-ii-2026-2-equipe-7 architecture

> Architecture diagram of the GitHub repository italo1001/pi-ii-2026-2-equipe-7, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/italo1001/pi-ii-2026-2-equipe-7
- Repository: https://github.com/italo1001/pi-ii-2026-2-equipe-7

## Overview

JurisFácil is a web glossary that helps non-specialists find plain-language legal definitions and examples, with category browsing and a protected administrator area. Public users enter through the frontend routes and search/detail experience; the frontend API communicates with backend controllers, services, and persistence. Administrators log in, then manage terms and taxonomy. The README documents these product capabilities; unsampled pages and integrations are represented only where the tree or documentation supports them, so some feature links are dashed.

Main entry points: [`JurisFacil/frontend/src/api/api.js`](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/api/api.js) (HTTP API client), [`JurisFacil/backend/src/main/java/backend/service/TermoService.java`](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/TermoService.java) (Term operations), [`JurisFacil/frontend/src/App.jsx`](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/App.jsx) (Route application), [`JurisFacil/frontend/src/components/HeaderSearch.jsx`](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/components/HeaderSearch.jsx) (Term search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public glossary"]
  node_app["Route application<br/>[App.jsx]"]
  node_home["Search and browse<br/>[Home.jsx]"]
  node_search["Term search<br/>[HeaderSearch.jsx]"]
  node_detail["Term details<br/>[TermDetail.jsx]"]
  node_searchutil["Search matching<br/>[search.js]"]
  node_api["HTTP API client<br/>[api.js]"]
end

subgraph group_admin["Administration"]
  node_login["Admin login<br/>[AdminLogin.jsx]"]
  node_session["Session handling<br/>[session.js]"]
  node_adminroutes["Protected routes<br/>[ProtectedRoute.jsx]"]
  node_adminterms["Term management<br/>[AdminTerms.jsx]"]
  node_termform["Term editor<br/>[AdminTermForm.jsx]"]
  node_taxonomy["Taxonomy management<br/>[AdminTaxonomy.jsx]"]
end

subgraph group_backend["Backend services"]
  node_authcontroller["Authentication endpoint"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_termcontroller["Term endpoints"]
  node_termservice["Term operations<br/>[TermoService.java]"]
  node_categorycontroller["Category endpoints"]
  node_categoryservice["Category queries"]
  node_areacontroller["Legal-area endpoints"]
  node_areaserivce["Legal-area queries"]
end

subgraph group_data["Domain data"]
  node_termo_repo[("Term repository")]
  node_category_repo[("Category repository")]
  node_area_repo[("Area repository")]
  node_admin_repo[("Admin repository")]
  node_example_repo[("Example repository")]
  node_term_model["Legal term<br/>[Termo.java]"]
end

node_visitor(("Glossary visitor"))
node_adminuser(("Administrator"))

node_visitor -->|"opens site"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_detail
node_home -.->|"uses search"| node_search
node_search -->|"matches terms"| node_searchutil
node_search -->|"requests terms"| node_api
node_detail -.->|"loads term"| node_api
node_adminuser -->|"signs in"| node_login
node_login -->|"submits credentials"| node_api
node_login -->|"starts session"| node_session
node_app -->|"guards routes"| node_adminroutes
node_adminroutes -.->|"allows access"| node_adminterms
node_adminroutes -.->|"allows access"| node_taxonomy
node_adminterms -.->|"opens editor"| node_termform
node_termform -->|"saves terms"| node_api
node_taxonomy -.->|"manages taxonomy"| node_api
node_api -.->|"calls endpoints"| node_termcontroller
node_api -.->|"calls endpoints"| node_authcontroller
node_authcontroller -->|"delegates login"| node_authservice
node_authservice -->|"looks up admin"| node_admin_repo
node_termcontroller -->|"delegates requests"| node_termservice
node_termservice -->|"queries and writes"| node_termo_repo
node_termservice -->|"resolves category"| node_category_repo
node_termservice -->|"resolves area"| node_area_repo
node_termservice -->|"stores examples"| node_example_repo
node_categorycontroller -->|"delegates queries"| node_categoryservice
node_categoryservice -->|"loads categories"| node_category_repo
node_categoryservice -->|"loads categorized terms"| node_termo_repo
node_areacontroller -->|"delegates queries"| node_areaserivce
node_areaserivce -->|"loads legal areas"| node_area_repo
node_areaserivce -->|"loads area terms"| node_termo_repo
node_termservice -->|"creates terms"| node_term_model

click node_app "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/App.jsx"
click node_home "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/Home.jsx"
click node_search "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/components/HeaderSearch.jsx"
click node_detail "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/TermDetail.jsx"
click node_searchutil "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/utils/search.js"
click node_api "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/api/api.js"
click node_login "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/AdminLogin.jsx"
click node_session "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/auth/session.js"
click node_adminroutes "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/components/ProtectedRoute.jsx"
click node_adminterms "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/admin/AdminTerms.jsx"
click node_termform "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/admin/AdminTermForm.jsx"
click node_taxonomy "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/admin/AdminTaxonomy.jsx"
click node_authcontroller "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/AuthController.java"
click node_authservice "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/AuthService.java"
click node_termcontroller "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/TermoController.java"
click node_termservice "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/TermoService.java"
click node_categorycontroller "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/CategoriaController.java"
click node_categoryservice "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/CategoriaService.java"
click node_areacontroller "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/AreaDireitoController.java"
click node_areaserivce "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/AreaDireitoService.java"
click node_termo_repo "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/TermoRepository.java"
click node_category_repo "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/CategoriaRepository.java"
click node_area_repo "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/AreaDireitoRepository.java"
click node_admin_repo "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/AdministradorRepository.java"
click node_example_repo "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/ExemploRepository.java"
click node_term_model "https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/model/Termo.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_home,node_search,node_detail,node_searchutil,node_api toneBlue
class node_login,node_session,node_adminroutes,node_adminterms,node_termform,node_taxonomy toneAmber
class node_authcontroller,node_authservice,node_termcontroller,node_termservice,node_categorycontroller,node_categoryservice,node_areacontroller,node_areaserivce toneMint
class node_termo_repo,node_category_repo,node_area_repo,node_admin_repo,node_example_repo,node_term_model toneRose
class node_visitor,node_adminuser toneIndigo
```

## Components

### Public glossary

- [Route application](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/App.jsx): `JurisFacil/frontend/src/App.jsx`
- [Search and browse](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/Home.jsx): `JurisFacil/frontend/src/pages/Home.jsx`
- [Term search](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/components/HeaderSearch.jsx): `JurisFacil/frontend/src/components/HeaderSearch.jsx`
- [Term details](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/TermDetail.jsx): `JurisFacil/frontend/src/pages/TermDetail.jsx`
- [Search matching](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/utils/search.js): `JurisFacil/frontend/src/utils/search.js`
- [HTTP API client](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/api/api.js): `JurisFacil/frontend/src/api/api.js`

### Administration

- [Admin login](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/AdminLogin.jsx): `JurisFacil/frontend/src/pages/AdminLogin.jsx`
- [Session handling](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/auth/session.js): `JurisFacil/frontend/src/auth/session.js`
- [Protected routes](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/components/ProtectedRoute.jsx): `JurisFacil/frontend/src/components/ProtectedRoute.jsx`
- [Term management](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/admin/AdminTerms.jsx): `JurisFacil/frontend/src/pages/admin/AdminTerms.jsx`
- [Term editor](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/admin/AdminTermForm.jsx): `JurisFacil/frontend/src/pages/admin/AdminTermForm.jsx`
- [Taxonomy management](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/frontend/src/pages/admin/AdminTaxonomy.jsx): `JurisFacil/frontend/src/pages/admin/AdminTaxonomy.jsx`

### Backend services

- [Authentication endpoint](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/AuthController.java): `JurisFacil/backend/src/main/java/backend/controller/AuthController.java`
- [Authentication service](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/AuthService.java): `JurisFacil/backend/src/main/java/backend/service/AuthService.java`
- [Term endpoints](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/TermoController.java): `JurisFacil/backend/src/main/java/backend/controller/TermoController.java`
- [Term operations](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/TermoService.java): `JurisFacil/backend/src/main/java/backend/service/TermoService.java`
- [Category endpoints](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/CategoriaController.java): `JurisFacil/backend/src/main/java/backend/controller/CategoriaController.java`
- [Category queries](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/CategoriaService.java): `JurisFacil/backend/src/main/java/backend/service/CategoriaService.java`
- [Legal-area endpoints](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/controller/AreaDireitoController.java): `JurisFacil/backend/src/main/java/backend/controller/AreaDireitoController.java`
- [Legal-area queries](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/service/AreaDireitoService.java): `JurisFacil/backend/src/main/java/backend/service/AreaDireitoService.java`

### Domain data

- [Term repository](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/TermoRepository.java): `JurisFacil/backend/src/main/java/backend/repository/TermoRepository.java`
- [Category repository](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/CategoriaRepository.java): `JurisFacil/backend/src/main/java/backend/repository/CategoriaRepository.java`
- [Area repository](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/AreaDireitoRepository.java): `JurisFacil/backend/src/main/java/backend/repository/AreaDireitoRepository.java`
- [Admin repository](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/AdministradorRepository.java): `JurisFacil/backend/src/main/java/backend/repository/AdministradorRepository.java`
- [Example repository](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/repository/ExemploRepository.java): `JurisFacil/backend/src/main/java/backend/repository/ExemploRepository.java`
- [Legal term](https://github.com/italo1001/pi-ii-2026-2-equipe-7/blob/master/JurisFacil/backend/src/main/java/backend/model/Termo.java): `JurisFacil/backend/src/main/java/backend/model/Termo.java`

### Other components

- **Glossary visitor**
- **Administrator**

## Connections

- Glossary visitor → Route application: opens site (evidence: `JurisFacil/frontend/src/App.jsx`)
- Route application → Search and browse: routes to (evidence: `JurisFacil/frontend/src/App.jsx`)
- Route application → Term details: routes to (evidence: `JurisFacil/frontend/src/App.jsx`)
- Search and browse → Term search: uses search
- Term search → Search matching: matches terms (evidence: `JurisFacil/frontend/src/components/HeaderSearch.jsx`)
- Term search → HTTP API client: requests terms (evidence: `JurisFacil/frontend/src/components/HeaderSearch.jsx`)
- Term details → HTTP API client: loads term
- Administrator → Admin login: signs in
- Admin login → HTTP API client: submits credentials (evidence: `JurisFacil/frontend/src/pages/AdminLogin.jsx`)
- Admin login → Session handling: starts session (evidence: `JurisFacil/frontend/src/pages/AdminLogin.jsx`)
- Route application → Protected routes: guards routes (evidence: `JurisFacil/frontend/src/App.jsx`)
- Protected routes → Term management: allows access
- Protected routes → Taxonomy management: allows access
- Term management → Term editor: opens editor
- Term editor → HTTP API client: saves terms (evidence: `JurisFacil/frontend/src/pages/admin/AdminTermForm.jsx`)
- Taxonomy management → HTTP API client: manages taxonomy
- HTTP API client → Term endpoints: calls endpoints
- HTTP API client → Authentication endpoint: calls endpoints
- Authentication endpoint → Authentication service: delegates login (evidence: `JurisFacil/backend/src/main/java/backend/controller/AuthController.java`)
- Authentication service → Admin repository: looks up admin (evidence: `JurisFacil/backend/src/main/java/backend/service/AuthService.java`)
- Term endpoints → Term operations: delegates requests (evidence: `JurisFacil/backend/src/main/java/backend/controller/TermoController.java`)
- Term operations → Term repository: queries and writes (evidence: `JurisFacil/backend/src/main/java/backend/service/TermoService.java`)
- Term operations → Category repository: resolves category (evidence: `JurisFacil/backend/src/main/java/backend/service/TermoService.java`)
- Term operations → Area repository: resolves area (evidence: `JurisFacil/backend/src/main/java/backend/service/TermoService.java`)
- Term operations → Example repository: stores examples (evidence: `JurisFacil/backend/src/main/java/backend/service/TermoService.java`)
- Category endpoints → Category queries: delegates queries (evidence: `JurisFacil/backend/src/main/java/backend/controller/CategoriaController.java`)
- Category queries → Category repository: loads categories (evidence: `JurisFacil/backend/src/main/java/backend/service/CategoriaService.java`)
- Category queries → Term repository: loads categorized terms (evidence: `JurisFacil/backend/src/main/java/backend/service/CategoriaService.java`)
- Legal-area endpoints → Legal-area queries: delegates queries (evidence: `JurisFacil/backend/src/main/java/backend/controller/AreaDireitoController.java`)
- Legal-area queries → Area repository: loads legal areas (evidence: `JurisFacil/backend/src/main/java/backend/service/AreaDireitoService.java`)
- Legal-area queries → Term repository: loads area terms (evidence: `JurisFacil/backend/src/main/java/backend/service/AreaDireitoService.java`)
- Term operations → Legal term: creates terms (evidence: `JurisFacil/backend/src/main/java/backend/service/TermoService.java`)
