Skip to content
soforeePublic

About

Plataforma integral de gestión de giras, itinerarios y logística para artistas y tour managers

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Kampu Tour Manager

Plataforma integral de gestión operativa y comercial
para agencias de turismo y operadores de viajes

Angular      Java      Spring Boot      Oracle

Descripción  ·  Módulos  ·  Arquitectura  ·  Instalación  ·  Equipo


Descripción general

Kampu es una solución Full Stack que centraliza, estandariza y automatiza los flujos de trabajo de una agencia de viajes. Cubre todo el ciclo operativo: desde la estructuración de paquetes turísticos y la programación de salidas, hasta la gestión de reservas, la asignación de recursos logísticos y el control financiero multimoneda.


Módulos principales

Panel de control (Dashboard)
Resumen ejecutivo de métricas operativas, ocupación y estado general de la agencia.
Catálogo de paquetes turísticos
Administración de tours, itinerarios, tarifas base y material multimedia.
Programación de salidas
Control de fechas, disponibilidad de cupos y asignación de recursos por salida.
Gestión de reservas y pasajeros
Flujo completo de registro, seguimiento detallado de pasajeros y procesamiento de anulaciones.
Directorio de clientes
Registro centralizado e historial comercial de clientes.
Recursos operativos
Administración de guías turísticos y flota de transporte asignada.
Pagos y multimoneda
Registro de abonos, liquidación de pagos y conversión de divisas integrada.
Autenticación y seguridad
Control de sesiones mediante interceptores, validación de acceso y gestión de roles de usuario.

Arquitectura

Monorepo desacoplado en dos aplicaciones principales:

Estructura del proyecto
kampu-app/
├── assets/                    # Identidad visual y recursos estáticos
├── kampu-frontend/            # Single Page Application (Angular)
│   └── src/app/
│       ├── core/              # Modelos, servicios HTTP, autenticación y utilidades
│       ├── features/          # Módulos funcionales (dashboard, paquetes, salidas, reservas, pagos...)
│       ├── layout/            # Contenedor principal y navegación
│       └── shared/            # Componentes reutilizables
│
└── kampu-backend/             # API RESTful (Java / Spring Boot)
    └── src/main/
        ├── java/.../lp2_gp2/
        │   ├── config/        # Seguridad, CORS, interceptores y OpenAPI
        │   ├── controller/    # Controladores REST
        │   ├── dto/           # Objetos de transferencia y validaciones
        │   ├── entity/        # Entidades JPA
        │   ├── exception/     # Manejador global de excepciones
        │   ├── repository/    # Persistencia (Spring Data JPA)
        │   └── services/      # Lógica de negocio, archivos y conversión de moneda
        └── resources/
            └── db/            # 01_schema.sql (esquema) y 02_data.sql (datos iniciales)

Instalación

Requisitos previos

  • Java JDK 17 o superior
  • Node.js 18+ y npm
  • Angular CLI
  • Motor de base de datos relacional configurado según application.yaml

1. Clonar el repositorio

git clone https://github.com/soforee/kampu-app.git
cd kampu-app

2. Backend

Ver pasos del backend
  1. Edita kampu-backend/src/main/resources/application.yaml con las credenciales de tu base de datos local.
  2. Ejecuta los scripts de kampu-backend/src/main/resources/db/ (01_schema.sql y luego 02_data.sql) para cargar la estructura y los datos de prueba.
  3. Inicia el servidor:
cd kampu-backend
./mvnw spring-boot:run

La documentación interactiva de los endpoints queda disponible en Swagger / OpenAPI una vez iniciado el servicio.

3. Frontend

Ver pasos del frontend

En una nueva terminal:

cd kampu-frontend
npm install
npm start

Abre la aplicación en http://localhost:4200


Equipo

About

Plataforma integral de gestión de giras, itinerarios y logística para artistas y tour managers

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors