# codingangel27/fullstack-products architecture

> Architecture diagram of the GitHub repository codingangel27/fullstack-products, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codingangel27/fullstack-products
- Repository: https://github.com/codingangel27/fullstack-products

## Overview

##### Tipo y propósito del proyecto (qué estás diagramando)
Este repo es un **full‑stack CRUD de productos** con:
- **Frontend**: Angular v17 (`frontend-products/`) con UI Bootstrap y alertas SweetAlert2.
- **Backend**: Spring Boot 2.x Java 8 (`products-app/`) expone un **REST API**.
- **Base de datos**: **Oracle 19c+** con **tabla**, **secuencia** y **stored procedure** (`conectionProductos.sql`).
- Reglas de negocio importantes a reflejar:
- **Borrado lógico**: productos pasan de `A` (activo) a `I` (inactivo); el frontend **solo lista `A`**.
- **Fechas automáticas**: `fecha_creacion` y `fecha_modificacion` gestionadas por el sistema (DB o backend según implementación).

Tu “mejor diagrama” debería mostrar claramente **capas**, **flujos CRUD**, **contratos API** y el **acoplamiento backend↔Oracle** (incluyendo stored procedures / secuencias).

##### Backend: `products-app/` (arquitectura por capas)
Rutas relevantes:
- `controller/ProductoController.java`: **REST endpoints** `/api/productos` (GET/POST/PUT/DELETE).
- `service/IProductoService.java` y `serviceImpl/ProductoServiceImpl.java`: **lógica de negocio** (estado A/I, validaciones, fechas).
- `repository/IProductoRepository.java`: **persistencia** (Spring Data JPA).
- `entity/Producto.java`: **modelo persistente**.
- `dto/ProductoDTO.java`, `dto/ApiResponse.java`: **contratos** hacia/desde API.
- `exception/*` + `GlobalExceptionHandler.java`: **manejo centralizado** de errores.
- `config/WebConfig.java`: típicamente **CORS / MVC config** (clave para frontend).
- `application.properties`: datasource Oracle, JPA dialect.

Esto sugiere un diagrama con **Controller → Service → Repository → Oracle** + “cross‑cutting” para excepciones/config.

##### Frontend: `frontend-products/` (feature-based Angular)
Rutas relevantes:
- `core/services/producto.service.ts`: **cliente HTTP** hacia `http://localhost:8080/api/productos`.
- `features/productos/pages/*`: UI por páginas: list/detail/form.
- `features/productos/models/producto.ts`: modelo TypeScript.
- `app.routes.ts`: rutas; según README, entry principal `/productos`.
- Presencia de `server.ts`, `main.server.ts`, `app.config.server.ts`: indica **SSR (Angular Universal / server-side rendering)** o preparación para SSR. En el diagrama, al menos marca que **Angular puede correr como SPA dev server** y potencialmente como **SSR Node server** (según cómo se despliegue).

##### DB y tooling
- `conectionProductos.sql`: crea **tabla PRODUCTO**, **SEQ_PRODUCTO**, **SP_CREAR_PRODUCTO**, data seed.
- `Api-productos.postman_collection.json`: evidencia de contrato API y escenarios de prueba.

##### Qué diagramas conviene producir (mínimo 3 vistas)
Para que sea “best and most accurate”, produce **múltiples vistas** (C4 recomendado):

Objetivo: quién usa el sistema y qué dependencias externas hay.
- Actor: **Usuario (Browser)**.
- Sistema: **Fullstack Products**.
- Dependencias: **Oracle DB**.

Objetivo: separar runtime containers y protocolos.
Incluye:
- **Browser** (Angular SPA) o “Angular SSR Node” (si aplica).
- **Angular App** (UI) → llama a → **Spring Boot API** (HTTP/JSON).
- **Spring Boot** → conecta a → **Oracle DB** (JDBC).
- Oracle incluye: **Tabla PRODUCTO**, **Secuencia**, **Stored Procedure**.

Aquí ya dibujas puertos:
- Frontend: `:4200`
- Backend: `:8080`
- Oracle: `:1521` (típico), service `XEPDB1` (según README).

Backend (muy valioso en este repo):
- `ProductoController`
- `ProductoServiceImpl` (implements `IProductoService`)
- `IProductoRepository` (Spring Data)
- `Producto` entity
- DTOs (`ProductoDTO`, `ApiResponse`)
- `GlobalExceptionHandler` (cross-cutting)
- `WebConfig` (CORS)
DB side:
- `PRODUCTO` table
- `SEQ_PRODUCTO`
- `SP_CREAR_PRODUCTO`

Frontend (opcional pero útil):
- Pages: `producto-list`, `producto-detail`, `producto-form`
- `ProductoService` (HttpClient)
- `Producto` TS model
- Router (`app.routes.ts`)

##### Frontend (Angular)
- **UI Pages/Components**
- `ProductoListComponent` (GET list; muestra solo `A`)
- `ProductoDetailComponent` (GET by id, si existe)
- `ProductoFormComponent` (POST create / PUT update)
- **Service**
- `ProductoService` (HTTP client)
- **Routing**
- `/productos` route
- **UI libs**
- Bootstrap (layout)
- SweetAlert2 (alerts/confirm delete)

##### Backend (Spring Boot)
- **REST Controller**
- `ProductoController` (CRUD endpoints)
- **Service layer**
- `ProductoServiceImpl` + `IProductoService`
- reglas: estado `A/I`, set de fechas, validaciones
- **Repository layer**
- `IProductoRepository` (JPA)
- **Domain + DTO**
- `Producto` entity
- `ProductoDTO`, `ApiResponse`
- **Cross-cutting**
- `GlobalExceptionHandler` + exceptions (`BadRequestException`, `ResourceNotFoundException`)
- `WebConfig` (CORS)
- **Runtime**
- Spring Boot app (`Main.java`)

##### Database (Oracle)
- `PRODUCTO` (campos + `estado`, fechas)
- `SEQ_PRODUCTO`
- `SP_CREAR_PRODUCTO` (usado para inserts seed y posiblemente create path si el backend lo invoca; si NO lo invoca, acláralo en la nota del diagrama)

##### Relaciones e interacciones (qué flechas dibujar)
Dibuja flechas **con protocolo + payload**:

##### Browser → Angular
- “User actions: view list / create / edit / delete”

##### Angular ProductoService → Spring Boot ProductoController
- `HTTP GET /api/productos` → lista (filtrada por estado `A` ya sea backend o frontend; README sugiere que el frontend solo muestra `A`, pero lo ideal es que el backend también filtre; en el diagrama puedes poner: “returns active products”).
- `HTTP POST /api/productos` → create product (backend asigna `fecha_creacion`)
- `HTTP PUT /api/productos/{id}` → update (backend actualiza `fecha_modificacion`)
- `HTTP DELETE /api/productos/{id}` → logical delete (set `estado='I'`)

##### ProductoController → ProductoServiceImpl
- llamadas internas (métodos `create/update/delete/list/get`)

##### ProductoServiceImpl → IProductoRepository
- persistencia JPA

##### IProductoRepository → Oracle DB
- JDBC / JPA / Hibernate
- Operaciones sobre tabla `PRODUCTO`
- Si se usa SP/sequence desde backend: flecha explícita “calls stored procedure / uses sequence”.
Si solo se usa en script de inicialización, marca SP/sequence como “DB initialization/seed”.

##### GlobalExceptionHandler
- flechas punteadas desde Controller layer: “translates exceptions → HTTP responses (ApiResponse)”

##### WebConfig (CORS)
- flecha punteada hacia Controller/API: “enables CORS for Angular origin :4200”

##### Patrones/diseño a resaltar (porque son “esenciales” aquí)
- **Arquitectura por capas**: Controller → Service → Repository → DB.
- **DTO pattern**: separar `ProductoDTO` de `Producto` entity (contrato vs persistencia).
- **Centralized exception handling**: `GlobalExceptionHandler`.
- **Soft delete**: `estado A/I` (esto debe aparecer explícitamente como regla de negocio).
- **Audit timestamps**: `fecha_creacion/fecha_modificacion` automáticas.
- (Frontend) **Feature-based structure**: `features/productos/pages` + `core/services`.

##### Notación y estilo
- **Cajas** por contenedor: “Angular App”, “Spring Boot API”, “Oracle DB”.
- Dentro de cada caja, **subcajas** por capa/componente.
- **Flechas direccionales** con:
- protocolo (HTTP/JSON, JDBC)
- endpoint (GET/POST/PUT/DELETE `/api/productos`)
- efecto de negocio (“logical delete sets estado=I”)
- Azul: Frontend components/services
- Verde: Backend components
- Naranja: Database objects (table/sequence/SP)
- Gris punteado: cross-cutting (CORS, exception handler)

##### Etiquetas obligatorias (para máxima precisión)
- Puertos: `4200`, `8080`, `1521`
- URL API base: `http://localhost:8080/api/productos`
- Estado: `A`/`I`
- Campos fecha: `fecha_creacion`, `fecha_modificacion`

##### Plantilla concreta de diagrama (qué dibujar exactamente)
Si tuviera que decirte “dibuja esto”:

**Nivel Contenedores**
- [User Browser]
→ (HTTP) → [Angular Frontend (ng serve :4200)]
→ (HTTP/JSON) → [Spring Boot Products API (:8080)]
→ (JDBC) → [Oracle DB 19c (:1521/XEPDB1)]

**Nivel Componentes dentro de Spring Boot**
- `ProductoController` (REST)
→ `ProductoServiceImpl`
→ `IProductoRepository`
→ `PRODUCTO` table
- A un lado: `GlobalExceptionHandler` (punteado desde controller)
- A un lado: `WebConfig (CORS)` (punteado habilitando requests desde :4200)
- DB objects cerca de `PRODUCTO`: `SEQ_PRODUCTO`, `SP_CREAR_PRODUCTO` (anotar “seed/init” o “used by backend” según aplique)

**Nivel Componentes dentro de Angular**
- Router `/productos`
- `ProductoListComponent` ↔ `ProductoService`
- `ProductoFormComponent` ↔ `ProductoService`
- `ProductoDetailComponent` ↔ `ProductoService`
- Anota Bootstrap/SweetAlert2 como librerías de UI.

##### Checklist final (para validar que el diagrama es fiel al repo)
- Aparece el **borrado lógico A→I** y su efecto en el **listado**.
- Se distinguen **DTO vs Entity**.
- Se ven las **capas** (controller/service/repository) explícitas.
- Se muestra Oracle con **tabla + secuencia + SP** (al menos como artefactos).
- Se indica **CORS** y el **origen Angular**.
- Se anotan **endpoints CRUD** y protocolo.
- El diagrama separa claramente **dev runtime** (ng serve) vs backend (Spring Boot) y DB.

Con estas vistas, el diagrama resultante no solo “se entiende”, sino que es **trazable** a carpetas/archivos concretos del repo (lo que lo hace preciso y defendible en una revisión técnica).

## Diagram (Mermaid)

```mermaid
flowchart TD

%% =========================
%% View A — Context (C4 L1)
%% =========================
subgraph "Context (C4 — Nivel 1)"
direction TB
U["Usuario<br/>(Browser)"]:::actor

SYS["Fullstack Products CRUD<br/>(Angular + Spring Boot + Oracle)"]:::system

ORCL["Oracle Database 19c+<br/>(PRODUCTO / SEQ / SP)"]:::db

U -->|"usa UI"| SYS
SYS -->|"lee/escribe datos"| ORCL
end

%% =========================
%% View B — Containers (C4 L2)
%% =========================
subgraph "Containers (C4 — Nivel 2)"
direction TB

subgraph "Cliente"
direction TB
BROWSER["Browser"]:::external

subgraph "Angular Frontend"
direction TB
ANG_DEV["Angular SPA (ng serve)<br/>:4200"]:::frontend
ANG_SSR["Angular SSR Node Server (opcional)<br/>server.ts"]:::frontend
end
end

subgraph "Servidor"
direction TB
API["Spring Boot Products API<br/>:8080"]:::backend
end

subgraph "Data"
direction TB
ORACLE["Oracle DB 19c+<br/>:1521 / XEPDB1"]:::db
TBL["Tabla PRODUCTO<br/>(estado A/I, fechas)"]:::dbobj
SEQ["Secuencia SEQ_PRODUCTO"]:::dbobj
SP["Stored Procedure SP_CREAR_PRODUCTO"]:::dbobj
end

BROWSER -->|"navega UI"| ANG_DEV
BROWSER -->|"SSR render (opcional)"| ANG_SSR
ANG_SSR -->|"sirve HTML + hidrata SPA"| ANG_DEV

ANG_DEV -->|"HTTP/JSON<br/>base http://localhost:8080/api/productos"| API
API -->|"JDBC (JPA/Hibernate)"| ORACLE
ORACLE -->|"contiene"| TBL
ORACLE -->|"contiene"| SEQ
ORACLE -->|"contiene"| SP
end

%% =========================
%% View C — Components (C4 L3)
%% =========================
subgraph "Componentes (C4 — Nivel 3)"
direction TB

%% -------- Frontend components
subgraph "Frontend (Angular v17)"
direction TB

ROUTER["Router<br/>ruta: /productos"]:::frontend
UI_LIBS["UI Libraries<br/>Bootstrap + SweetAlert2"]:::frontendNote

subgraph "Feature: productos"
direction TB
LIST["ProductoListComponent<br/>(lista solo estado='A')"]:::frontend
DETAIL["ProductoDetailComponent"]:::frontend
FORM["ProductoFormComponent<br/>(create/update)"]:::frontend
TS_MODEL["Producto (TS model)"]:::frontend
end

NG_SVC["ProductoService (HttpClient)"]:::frontend

ROUTER -->|"navega"| LIST
ROUTER -->|"navega"| DETAIL
ROUTER -->|"navega"| FORM

LIST -->|"usa"| NG_SVC
DETAIL -->|"usa"| NG_SVC
FORM -->|"usa"| NG_SVC

LIST -.->|"UI"| UI_LIBS
DETAIL -.->|"UI"| UI_LIBS
FORM -.->|"UI"| UI_LIBS
NG_SVC -.->|"mapea"| TS_MODEL
end

%% -------- Backend components
subgraph "Backend (Spring Boot 2.x / Java 8)"
direction TB

MAIN["Main (Spring Boot entry)"]:::backendNote

subgraph "Web / API Layer"
direction TB
CTRL["ProductoController<br/>/api/productos"]:::backend
CORS["WebConfig (CORS)<br/>permite origen :4200"]:::cross
EXH["GlobalExceptionHandler<br/>→ ApiResponse + HTTP status"]:::cross
end

subgraph "Service Layer"
direction TB
ISVC["IProductoService"]:::backend
SVC["ProductoServiceImpl<br/>Reglas: estado A/I, fechas, validaciones"]:::backend
end

subgraph "Persistence Layer"
direction TB
REPO["IProductoRepository<br/>(Spring Data JPA)"]:::backend
ENTITY["Producto (JPA Entity)"]:::backend
DTO["ProductoDTO (API contract)"]:::backend
RESP["ApiResponse (wrapper)"]:::backend
end

%% Internal wiring
MAIN --> CTRL
CTRL -->|"calls"| ISVC
ISVC -->|"implemented by"| SVC
SVC -->|"uses"| REPO
REPO -->|"maps"| ENTITY

CTRL -.->|"returns/accepts"| DTO
CTRL -.->|"returns"| RESP

CTRL -.->|"throws/exceptions → translate"| EXH
CORS -.->|"enables requests"| CTRL
end

%% -------- Database objects + rules
subgraph "Oracle Schema Objects"
direction TB
DB_TBL["PRODUCTO<br/>- estado: 'A'|'I'<br/>- fecha_creacion<br/>- fecha_modificacion"]:::dbobj
DB_SEQ["SEQ_PRODUCTO"]:::dbobj
DB_SP["SP_CREAR_PRODUCTO<br/>(init/seed y/o create path)"]:::dbobj
end

%% -------- Cross-container flows (CRUD)
NG_SVC -->|"GET /api/productos<br/>lista activos (estado='A')"| CTRL
NG_SVC -->|"GET /api/productos/{id}"| CTRL
NG_SVC -->|"POST /api/productos<br/>set fecha_creacion"| CTRL
NG_SVC -->|"PUT /api/productos/{id}<br/>set fecha_modificacion"| CTRL
NG_SVC -->|"DELETE /api/productos/{id}<br/>borrado lógico: estado='I'"| CTRL

REPO -->|"JPA/Hibernate SQL"| DB_TBL
DB_TBL -.->|"usa (DB-managed)"| DB_SEQ
DB_TBL -.->|"opcional: invoca/relaciona"| DB_SP
end

%% =========================
%% Click events (from mapping)
%% =========================
click ANG_DEV "https://github.com/codingangel27/fullstack-products/tree/main/frontend-products/"
click ANG_SSR "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/server.ts"
click ROUTER "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/app.routes.ts"
click NG_SVC "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/core/services/producto.service.ts"
click TS_MODEL "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/features/productos/models/producto.ts"
click LIST "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/features/productos/pages/producto-list/producto-list.component.ts"
click DETAIL "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/features/productos/pages/producto-detail/producto-detail.component.ts"
click FORM "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/features/productos/pages/producto-form/producto-form.component.ts"

click API "https://github.com/codingangel27/fullstack-products/tree/main/products-app/"
click MAIN "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/Main.java"
click CTRL "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/controller/ProductoController.java"
click ISVC "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/service/IProductoService.java"
click SVC "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/service/serviceImpl/ProductoServiceImpl.java"
click REPO "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/repository/IProductoRepository.java"
click ENTITY "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/entity/Producto.java"
click DTO "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/dto/ProductoDTO.java"
click RESP "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/dto/ApiResponse.java"
click EXH "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/exception/GlobalExceptionHandler.java"
click CORS "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/config/WebConfig.java"

click DB_SP "https://github.com/codingangel27/fullstack-products/blob/main/conectionProductos.sql"
click DB_SEQ "https://github.com/codingangel27/fullstack-products/blob/main/conectionProductos.sql"
click DB_TBL "https://github.com/codingangel27/fullstack-products/blob/main/conectionProductos.sql"
click ORACLE "https://github.com/codingangel27/fullstack-products/blob/main/conectionProductos.sql"

click UI_LIBS "https://github.com/codingangel27/fullstack-products/tree/main/frontend-products/"
click MAIN "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/java/com/appproducts/Main.java"
click SYS "https://github.com/codingangel27/fullstack-products/blob/main/Api-productos.postman_collection.json"

click ANG_SSR "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/main.server.ts"
click ANG_SSR "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/app.config.server.ts"
click ANG_DEV "https://github.com/codingangel27/fullstack-products/blob/main/frontend-products/src/app/app.config.ts"
click API "https://github.com/codingangel27/fullstack-products/blob/main/products-app/src/main/resources/application.properties"

%% =========================
%% Styles
%% =========================
classDef actor fill:#111827,stroke:#0b1220,color:#ffffff,stroke-width:2px
classDef system fill:#1f2937,stroke:#0b1220,color:#ffffff,stroke-width:2px
classDef external fill:#0f172a,stroke:#1e293b,color:#ffffff,stroke-width:1.5px

classDef frontend fill:#1d4ed8,stroke:#0b3aa6,color:#ffffff,stroke-width:1.5px
classDef frontendNote fill:#2563eb,stroke:#0b3aa6,color:#ffffff,stroke-width:1px,stroke-dasharray: 4 3

classDef backend fill:#16a34a,stroke:#0f6b30,color:#ffffff,stroke-width:1.5px
classDef backendNote fill:#22c55e,stroke:#0f6b30,color:#052e16,stroke-width:1px

classDef cross fill:#6b7280,stroke:#374151,color:#ffffff,stroke-width:1px,stroke-dasharray: 6 4

classDef db fill:#f59e0b,stroke:#b45309,color:#111827,stroke-width:2px
classDef dbobj fill:#fbbf24,stroke:#b45309,color:#111827,stroke-width:1.5px
```
