udistrital / argo_documentacion

0 stars 0 forks source link

Revisión Integración Ágora - Datos contratista #53

Closed edwargl7 closed 4 months ago

edwargl7 commented 5 months ago

Se requiere realizar la revisión de la integración con Ágora, los datos requeridos del contratista que se deben consultar y la creación de un microservicios MID que permita ser el intermediario entre Ágora y ARGO v2, con el fin de mantener una interfaz entre este MID y los microservicios de ARGO v2 garantizando una mantenibilidad, reusabilidad e interoperabilidad dado que por medio de este MID se desacopla el nuevo ARGO y permite que en futuras migraciones de Ágora a un nuevo sistema o cambios en las fuentes de datos, o web services solo sea necesario realizar los ajustes en dicho MID conservando las interfaces entre ARGO v2 y el MID.

Sub Tareas

Criterios de aceptación

Requerimientos

No aplica

Definition of Ready - DoR

Definition of Done - DoD - Desarrollo

edwargl7 commented 5 months ago

Endpoints relacionados. image informacion_persona_natural

image informacion_persona_juridica

edwargl7 commented 5 months ago

Modelo de datos persona natural. udistrital - agora - informacion_persona_natural

edwargl7 commented 5 months ago

Imagen base con la que se consulta información del contratista. image

mau-oati commented 5 months ago

En la interface de ARGO - Información del contratista:

  1. Se consulta el endpoint informacion_persona_natural o informacion_persona_juridica dependiendo el caso (segun el dropdown).
  2. Se muestra en pantalla a información de retorno.
  3. Al dar en Siguiente, se crea un registro en contrato_general_crud en la coleccion contratista, que relaciona un numero_identificacion_id con el contrato actual.
sequenceDiagram
Cliente->>+contratista_mid: Seleccón del dropdown
    contratista_mid-->>+AGORA: GET informacion_persona_natural
    contratista_mid-->>+AGORA: GET informacion_persona_juridica
    AGORA->>+contratista_mid: RESPONSE
contratista_mid->>+Cliente: Representación de objeto (nombre, telefono, etc)
    contratista_mid->>+contrato_general_crud: SAVE numero_identificacion_id

En ARGOv2, la ínica información guardada, es el numero de indentificación de la persona juridica o natural, el resto de la información, será obtenida de ÁGORA.

mau-oati commented 5 months ago

Existirá un contratistas_mid que se encargue de consultar la información en ÁGORA y que se encargue del guardado de la relación en contrato_general_crud.

Dependencias: ÁGORA: La única fuente de verdad es ágora, no se mantendrán copias o información del parte de ARGO, por ende, si el servicio de ágora no está disponible, cualquier proceso que requiera obtener el nombre, contacto, dirección, teléfono, etc, para cualquier flujo, no será posible ejecutarse hasta que esté nuevamente ágora en funcionamiento.

edwargl7 commented 4 months ago

Buen trabajo, actualmente ARGO cuenta con un filtro que permite presentar tanto personas naturales como jurídicas por medio del mismo filtro, se debe consultar con más detalle el endpoint o lógica empleada para este funcionamiento.

Filtro contratista