PROPUESTA TÉCNICA Y ECONÓMICA DE UN SISTEMA DE ADHERENCIA

COLEGIO DE INGENIEROS DEL PERÚ

1. RESUMEN EJECUTIVO:

La presente propuesta tiene como objetivo implementar un sistema web de

adherencias para el Colegio de Ingenieros del Perú. Se implementarán los siguientes
servicios de Módulo de registro de candidatos y adherencia.

2. DESCRIPCIÓN DEL PROYECTO:

El proyecto consiste en implementar un sistema web de adherencias del colegiado.

Se detallan las funcionalidades que debe tener el sistema:

• Login basado en JWT: Proporciona un sistema de autenticación seguro basado en

tokens JWT para el acceso al módulo de actualización.
• Verificación de datos por DNI o CIP: Permite verificar la identidad del colegiado por
DNI o CIP.
• Registro de Candidatos: Permite registrar al candidato en el sistema web de acuerdo
a tipos de consejo nacional, departamental y presidentes de capítulo.
• Verificación de habilidad del candidato: Permite verificar el estado de habilidad del
candidato.
• Envío de constancia de confirmación: Permite enviar correo electrónico al colegiado
de la candidatura inscrita.
• Registro de Adherencia: Permite el registro de adherencia del colegiado a un
candidato.
• Verificación de habilidad del adherente: Permite verificar el estado de habilidad del
adherente.
• Envío de constancia del adherente: Permite enviar correo electrónico al colegiado
de la adherencia realizada.
• Pasarela de Pagos: Permite realizar pagos mediante la integración de pasarelas de
pago mediante una entidad bancaria.

3. REQUISITOS FUNCIONALES:

Los siguientes son los requisitos funcionales de los servicios de APIs propuestos:

• Login basado en JWT

• Verificación de datos por DNI o CIP
• Registro de Candidatos
• Verificación de habilidad del candidato
• Envío de constancia de confirmación
• Registro de Adherencia
• Verificación de habilidad del adherente
• Envío de constancia del adherente
• Pasarela de Pagos

1
4. ALCANCES Y DESCRIPCIÓN DEL SERVICIO

Se realizará las siguientes actividades tanto para Back como Front:

• Elaborar el diseño API y documentación los endpoint a desarrollar (swagger).

• Realizar la carga de archivos en el repositorio de código centralizado (GitLab ó
Bitbucket).
• Desarrollar los endpoint de consulta de los requisitos funcionales (Postman).
• Incorporar las pruebas unitarias de los servicios a desarrollar (Core Unit Test).
• Elaboración de los prototipos e integración de las APIs con la parte de FrontEnd.

5. BENEFICIOS

La implementación de la propuesta técnica brindará beneficios tecnológicos al Colegio de

Ingenieros del Perú, como una arquitectura modular y escalable, mayor eficiencia en el
desarrollo y despliegue de los servicios, flexibilidad tecnológica, seguridad en las
comunicaciones y una mayor disponibilidad del sistema. Acceso a información
actualizada y precisa, consultas rápidas y eficientes, seguridad en el acceso a los
servicios.

• Escalabilidad y disponibilidad
• Seguridad y autenticación:
• Acceso a información actualizada y precisa
• Consultas rápidas y eficientes
• Seguridad y privacidad de los datos
• Actualizaciones y mejoras continuas

6. TECNOLOGÍAS Y HERRAMIENTAS PROPUESTAS:

• Base de datos Oracle 12c: Sistema de gestión de base de datos para almacenar y
gestionar los datos del sistema.
• Spring Boot: Framework de desarrollo de aplicaciones Java que simplifica la creación
de microservicios.
• Administración de esquema por usuarios Oracle: Utilización de usuarios específicos
para la administración y gestión del esquema de la base de datos Oracle.
• Hibernate basado en Spring y JPA: Framework de mapeo objeto-relacional para el
acceso a datos en aplicaciones Java basadas en Spring.
• RestControllers: Componentes de Spring para la exposición de APIs REST.
• JWT (JSON Web Tokens): Método de autenticación basado en tokens firmados
digitalmente para garantizar la seguridad de las comunicaciones y la identificación de
los usuarios.
• IDEs de desarrollo: Spring Suite Tools e IntelliJ IDEA para el desarrollo de los
microservicios.
• DBeaver: Herramienta de gestión de bases de datos para administrar y consultar la
base de datos Oracle.
• Bitbucket: Plataforma versátil y potente para la gestión de repositorios de código fuente
y la colaboración en línea. Facilita la colaboración en equipo, el control de versiones, la
revisión de código y la integración con otras herramientas de desarrollo, lo que

2
 contribuye a una mayor productividad y eficiencia en los proyectos de desarrollo de
software.
• Docker: Se utilizará Docker para crear contenedores ligeros y portátiles que encapsulen
los microservicios, sus dependencias y configuraciones. Esto permitirá una fácil
implementación y despliegue de los microservicios en diferentes entornos.
• SonarQube: Herramienta de análisis estático de código que ayuda a evaluar y mejorar
la calidad del código en proyectos de desarrollo de software. Proporciona análisis
detallado, detección de problemas, seguimiento de métricas y monitoreo continuo de la
calidad del código, lo que contribuye a un código más limpio, seguro y mantenible.
• Postman: Herramienta versátil y potente para probar y documentar APIs. Facilita la
realización de pruebas de API, la automatización de pruebas, la documentación
interactiva, la colaboración en equipo y la integración con otras herramientas de
desarrollo. Postman es ampliamente utilizado por desarrolladores y equipos de
desarrollo para mejorar la calidad y la eficiencia en el desarrollo de APIs.
• Swagger: Herramienta poderosa para diseñar, documentar y construir APIs de forma
eficiente. Proporciona una especificación estándar y comprensible (OpenAPI) que
permite describir las APIs de manera clara y detallada. Swagger ofrece documentación
interactiva, generación de código, validación y una integración fluida con otras
herramientas de desarrollo, lo que contribuye a un desarrollo de APIs más rápido y
eficiente.

7. PROPUESTA A NIVEL DE BASE DE DATOS:

Esto implica implementar estrategias y técnicas para mejorar el rendimiento de las

consultas en la base de datos Oracle 12c.

• Diseño eficiente de consultas: Se analizarán las consultas existentes y se buscarán

formas de optimizarlas mediante el uso adecuado de índices, claves primarias y
secundarias, y otras estructuras de optimización de Oracle.

8. DOCUMENTACIÓN DE ARQUITECTURA Y API

Estos documentos proporcionan información detallada sobre la arquitectura propuesta, los

servicios de API implementados en la parte Backend y Frontend y cómo interactuar con ellos.

La documentación de arquitectura tiene como objetivo principal proporcionar una visión general
de alto nivel de la arquitectura propuesta. Incluye los siguientes elementos:

• Descripción de la arquitectura: Un resumen que describe los principios y enfoques

utilizados en la arquitectura, como la adopción de microservicios.

• Diagrama de arquitectura: Un diagrama visual que muestra la estructura de la

arquitectura, incluyendo los componentes principales, la interacción entre ellos y las
tecnologías utilizadas. El diagrama proporciona una representación visual clara de cómo
se organizan y comunican los componentes de la arquitectura.

• Componentes de la arquitectura: Una descripción detallada de los componentes clave

de la arquitectura, como los microservicios, la base de datos Sql Server. Se detallarán las

3
 funciones y responsabilidades de cada componente, así como las tecnologías y
herramientas utilizadas en su implementación.

Por otro lado, la documentación de API se centra en describir los servicios de API implementados
y cómo interactuar con ellos. Esta documentación incluirá los siguientes elementos:

• Descripción de las APIs: Una descripción detallada de cada servicio de API

implementado, como Estado Cuenta Colegiado, Consulta Colegiado, Consulta Habilidad
del Colegiado, Consulta Deuda del Colegiado, Actualizar Datos del Colegiado y Login
basado en JWT. Se proporcionará una visión general de los datos y funcionalidades que
cada servicio ofrece.

• Endpoints y operaciones: Se detallarán los endpoints disponibles para cada API y las
operaciones que se pueden realizar en cada uno, como GET, POST, PUT, DELETE, etc.
Se describirán los parámetros de entrada, las respuestas esperadas y los posibles
códigos de estado HTTP.

• Ejemplos de solicitud y respuesta: Se proporcionarán ejemplos prácticos de cómo

realizar solicitudes a los endpoints de la API y cómo interpretar las respuestas. Estos
ejemplos ayudarán a los desarrolladores a comprender cómo interactuar correctamente
con los servicios de la API.

• Autenticación y autorización: Se explicará el proceso de autenticación y autorización

utilizado en las APIs, incluyendo el flujo de autenticación basado en JWT y cómo se deben
incluir los tokens JWT en las solicitudes.

• Formato de datos: Se especificará el formato de los datos que se envían y reciben en

las API, como JSON o XML. Además, se proporcionarán definiciones de los modelos de
datos utilizados en las respuestas y solicitudes de la API.

La documentación de arquitectura y API proporciona una guía completa y detallada para los
desarrolladores, usuarios y otros interesados en comprender y utilizar la arquitectura de software
y las APIs implementadas. Facilita la comprensión de la estructura y el funcionamiento del
sistema, promueve las mejores prácticas de desarrollo y mejora la colaboración entre los equipos
de desarrollo y los usuarios finales.

9. RECURSOS HUMANOS:

Para el desarrollo del proyecto se requerirá el siguiente personal:

• Analista programador: Encargado de analizar los requerimientos del sistema, diseñar

la arquitectura, definir las especificaciones técnicas. Así como diseñar la base de datos y
responsable de realizar pruebas de calidad y asegurar que el sistema cumpla con los
requisitos establecidos.
• Personal de calidad QA: Responsable de realizar pruebas de calidad y asegurar que el
sistema cumpla con los requisitos establecidos.

4
10. PROPUESTA ECONÓMICA:

La propuesta económica para el proyecto es de 28,000.00 soles (veinte ocho mil

soles). El costo incluye la garantía de un año según los siguientes aspectos:

• Recursos humanos: Honorarios profesionales para el analista programador.

• Mantenimiento: Consideración de un plan de soporte y mantenimiento del sistema una
vez desplegado.
• Garantía: Consideración de un plan de soporte y mantenimiento una vez desplegado
en ambiente de producción por 12 meses.

Nota: El costo del desarrollo del sistema de actualización de datos del colegiado no incluye
el costo de alojamiento en la nube, existiendo muchos proveedores para alojar el sistema
tanto para el backend como frontend.

11. TIEMPO DE ENTREGA:

El tiempo de entrega estimado para el proyecto es de 90 días calendarios, considerando

el desarrollo, pruebas y puesta en producción del sistema.

12. ENTREGABLES

Los entregables deberán ser presentados a través de la Mesa de Partes del Colegio de
Ingenieros del Perú, ubicado en Calle Barcelona Nº 240, San Isidro, o a través de la
ventanilla electrónica del CIP.

Entregable 1:
Informe que deberá de contener los documentos del resultado de las actividades descritas
en el numeral (2.- ALCANCES Y DESCRIPCIÓN DEL SERVICIO), para cada una de las
siguientes funcionalidades:

a) Login basado en JWT

b) Verificación de datos por DNI o CIP
c) Registro de Candidatos
d) Pasarela de Pagos
e) Verificación de habilidad del candidato
f) Envío de constancia de confirmación

Entregable 2:
Informe que deberá de contener los documentos del resultado de las actividades descritas
en el numeral (2.- ALCANCES Y DESCRIPCIÓN DEL SERVICIO), para cada una de las
siguientes funcionalidades:

a) Login basado en JWT

b) Registro de Adherencia
c) Verificación de habilidad del adherente
d) Envío de constancia del adherente

5
 Plazo de Entrega: Dentro de un plazo máximo de noventa (90) días calendario, contados
a partir del día siguiente de notificada la orden de servicio y/o suscrito el contrato.

13. FORMA Y CONDICIONES DE PAGO

El costo del servicio incluye los impuestos de ley y cualquier otro concepto que incida sobre
el costo total del servicio, debiéndose abonar en cuatro (03) cuotas, según siguiente detalle:

o Primer pago: 1/2 del monto total del servicio, previa presentación y conformidad
del primer entregable.
o Segundo pago: 2/2 del monto total del servicio, previa presentación y conformidad
del segundo entregable.

14. GARANTÍA DEL PRODUCTO

El tiempo de garantía será de 03 meses previa presentación y conformidad del producto.

15. CONFORMIDAD

El cumplimiento de las condiciones contractuales del servicio, en concordancia al

presente Propuesta Técnica para el Colegio de Ingenieros del Perú, generará la
conformidad del servicio emitida por la Oficina de Sistemas de Información del Colegio de
Ingenieros del Perú, dentro del plazo de siete (7) días calendario de cumplida la
presentación por parte del contratista.