Este repositorio contiene el código fuente del servicio backend para el proyecto TelcoNova SupportSuite, una plataforma integral desarrollada bajo la iniciativa Fábrica Escuela para la gestión de soporte técnico en telecomunicaciones.
El objetivo de este backend es proveer una API RESTful robusta, segura y escalable para gestionar el registro de usuarios, administración de técnicos, asignación de recursos y el ciclo de vida completo de las órdenes de trabajo.
Este proyecto es el entregable central para las siguientes materias de Ingeniería de Sistemas en la Universidad de Antioquia:
| Materia | Profesor |
|---|---|
| Bases de Datos y Laboratorio | John Jairo Prado Piedrahita |
| Arquitectura de Software | Didier Correa Londoño |
- Cristian David Diez Lopez
- Roller Andrés Hernández López
Este backend está construido sobre una arquitectura de Monolito Modular moderna en Java, enfocada en la mantenibilidad, la seguridad y el despliegue automatizado.
- Framework: Spring Boot 3.5.x
- Lenguaje: Java 21
- Seguridad: Spring Security (con hashing BCrypt)
- Base de Datos: Spring Data JPA / Hibernate
- [cite_start]Base de Datos (Desarrollo): H2 (En memoria) [cite: 310-311]
- Validación:
jakarta.validation - [cite_start]Documentación API: SpringDoc (OpenAPI 3 / Swagger) [cite: 312-313]
- Build: Apache Maven
- Monitoreo: Spring Boot Actuator + Micrometer (para Prometheus)
- Containerización: Docker
-
Clonar el repositorio:
git clone https://github.com/codeFactory20252Feature7/BackendFabrica.git cd BackendFabrica -
Ejecutar la aplicación (con Maven Wrapper): En Windows:
./mvnw spring-boot:run
En macOS/Linux:
./mvnw spring-boot:run
La aplicación estará disponible en http://localhost:8080.
La documentación completa de la API se genera automáticamente con Swagger y está disponible una vez que la aplicación está en ejecución.
- Interfaz de Swagger (UI):
http://localhost:8080/swagger-ui.html - Definición OpenAPI (JSON):
http://localhost:8080/v3/api-docs
POST /api/auth/register: Registra un nuevo usuario (User).POST /api/auth/login: Autentica un usuario.POST /api/technicians/create: Crea un nuevo técnico (Technician).GET /api/technicians/all: Lista todos los técnicos.POST /api/orders: (Nuevo) Crea una nueva orden de trabajo (WorkOrder).
El proyecto incluye un Dockerfile optimizado (multi-etapa) para crear una imagen de producción ligera.
-
Construir la imagen de Docker:
docker build -t telconova-backend . -
Ejecutar el contenedor:
docker run -p 8080:8080 telconova-backend ```# Backend del Proyecto: TelcoNova SupportSuite
Este repositorio contiene el código fuente del servicio backend para el proyecto TelcoNova SupportSuite, desarrollado como parte de la iniciativa Fábrica Escuela.
El objetivo de este backend es proveer una API RESTful robusta para gestionar el registro, asignación y seguimiento de órdenes de trabajo de soporte técnico.
Este proyecto es el entregable central para las siguientes materias de Ingeniería de Sistemas en la Universidad de Antioquia:
| Materia | Profesor |
|---|---|
| Bases de Datos y Laboratorio | John Prado y Joaquín Molina |
| Arquitectura de Software | Didier Correa Londoño |
- Cristian David Diez Lopez
- Roller Andrés Hernández López
Este backend está construido con una arquitectura moderna de Java, enfocada en la mantenibilidad y el despliegue.
- Framework: Spring Boot 3
- Lenguaje: Java 21
- Seguridad: Spring Security (con hashing BCrypt)
- Base de Datos: Spring Data JPA / Hibernate
- [cite_start]Base de Datos (Desarrollo): H2 (En memoria) [cite: 310-311]
- Validación:
jakarta.validation - [cite_start]Documentación API: SpringDoc (OpenAPI 3 / Swagger) [cite: 312-313]
- Build: Apache Maven
- Monitoreo: Spring Boot Actuator + Micrometer (para Prometheus)
- Containerización: Docker
-
Clonar el repositorio:
git clone [https://github.com/codeFactory20252Feature7/BackendFabrica.git](https://github.com/codeFactory20252Feature7/BackendFabrica.git) cd BackendFabrica -
Ejecutar la aplicación (con Maven Wrapper): En Windows:
./mvnw spring-boot:run
En macOS/Linux:
./mvnw spring-boot:run
La aplicación estará disponible en http://localhost:8080.
La documentación completa de la API se genera automáticamente con Swagger y está disponible una vez que la aplicación está en ejecución.
- Interfaz de Swagger (UI):
http://localhost:8080/swagger-ui.html - Definición OpenAPI (JSON):
http://localhost:8080/v3/api-docs
POST /api/auth/register: Registra un nuevo usuario (User).POST /api/auth/login: Autentica un usuario.POST /api/technicians/create: Crea un nuevo técnico (Technician).GET /api/technicians/all: Lista todos los técnicos.POST /api/orders: (Nuevo) Crea una nueva orden de trabajo (WorkOrder).
El proyecto incluye un Dockerfile optimizado (multi-etapa) para crear una imagen de producción ligera.
-
Construir la imagen de Docker:
docker build -t telconova-backend . -
Ejecutar el contenedor:
docker run -p 8080:8080 telconova-backend