Skip to content

feat(ti/documentacion-api): campo Empresa, filtros del catalogo y nombres cortos

Rafael Bautista requested to merge ti into qa

La hoja de origen dejo una sola columna de empresa: el campo doble "Empresa o area solicitante" hacia ruido al momento del registro.

Formulario

  • El campo se llama Empresa, a secas. Se conservan el combo con busqueda sobre el catalogo maestro y el escape a texto libre para cuando la empresa no aparece; el aviso de ese escape ahora dice POR QUE importa darla de alta en /admin -- que la informacion cruce y traiga portafolio y estado-- en vez de solo avisar que no esta.

Tres filtros del catalogo: Portafolio, Empresa y Operatividad

  • Van al frente de la barra: son la pregunta de negocio; estatus, vigencia, clasificacion, ambiente y destino son clasificacion tecnica de la API.
  • Operatividad sale de empresas_grupo_caabsa.estado (operativa / no_operativa / patrimonial), que no se serializaba. Se agrega al router junto al portafolio.
  • Una sola funcion por dimension (portafolioDe / empresaDe / operatividadDe) arma las opciones Y filtra. Si cada lado derivara su etiqueta por separado, una opcion del desplegable podria no casar con ninguna fila y el filtro devolveria vacio en silencio.
  • Lo que no cruza se etiqueta "Sin cruce al catalogo" en vez de desaparecer del filtro: OAE no cruza a proposito --es un portal, no una empresa-- y aun asi tiene que poder seleccionarse.

Nombres cortos en el filtro de Empresa

  • La etiqueta pasa a ser la razon social de tipo 'reportes' ("ENTRA"), no el nombre comercial largo ("Coordinadora De Servicios Opera S.A. De C.V."): 10 caracteres de promedio contra 27, y en mayusculas. Cambian 48 de 208 empresas activas; las demas no tienen alias de reportes y se quedan igual.
  • NO se usan las razones sociales de tipo 'ssbt': no son un nombre, son la taxonomia de portafolio del CCC (SERVICIOS, CONCESIONES) y como etiqueta de empresa serian falsas.
  • Si el nombre canonico ya esta entre los alias, gana el canonico (CONCRET sobre ABASTECEDORA CONCRET). El alias solo se usa si es mas corto que el canonico: la razon de usarlo es acortar, no debe alargar (MEDIASURF no se vuelve MEDIASURF CC).
  • CAABSA es el alias de reportes de TRES empresas distintas. Ante colision, las involucradas vuelven a su nombre completo: una sola opcion que devuelve filas de tres empresas no habria forma de notarla.
  • El nombre completo no se pierde: viaja como solicitante_completo, va en el title de la celda y como segunda linea en el modal de detalle.

La columna de la tabla y la del modal se llaman Empresa, no Solicitante, y la celda muestra portafolio y operatividad: una columna por la que se filtra pero que no se ve no se entiende.

Verificado: npm run build en portal_ti OK, ci_validate_models.py OK, check_lookandfeel.py sin hallazgos, GET /api/ti/doc-api 200 con las tres dimensiones pobladas.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com

Merge request reports