HLD - SAAC

Documento de diseño de alto nivel

Versión: 1.0
Fecha: lunes, 08 de septiembre de 2025
Autor: José Alberto Hernández Galicia

---

Tabla de Contenido

1. Control de Cambios
2. Introducción
   • 2.2. Objetivo
   • 2.3. Alcance
   • 2.4. Glosario
3. Descripción general del contexto y Alcance
   • 3.2. Descripción General del Proyecto
   • 3.3. Descripción de Escenarios y Seguimiento
   • 3.4. DIAGRAMA DE CONTEXTO
4. Visión General de la Arquitectura
   • 4.2. Capa de la vista física
   • 4.3. Capa de la vista lógica
     • 4.3.1. Flujo 1
   • 4.4. Capa de la vista principal
5. Descripción de componentes clave
   • 5.2. Atributos de calidad
   • 5.3. Restricciones
6. Interacciones y flujos de datos
7. Decisiones Arquitectónicas y Justificación
8. Consideraciones de seguridad y escalabilidad
9. Requerimientos no funcionales
10. Lineamientos y Estandares de Codificación

• 10.2. Lineamientos Tecnológicos

---

1. Control de Cambios

Versión	Autor	Descripción	Fecha
1.0	José Alberto Hernández Galicia	Creación	09/08/2025

---

2. Introducción

El propósito de este documento de Definición de Arquitectura de Alto Nivel (High-Level Design, HLD) es proporcionar una visión global y comprensiva de la arquitectura del sistema propuesto. Este documento sirve como un puente entre los requisitos del negocio y la implementación técnica detallada, ofreciendo una representación abstracta de los componentes principales del sistema, sus interacciones y las decisiones arquitectónicas clave que guiarán el desarrollo.

A través de este HLD, buscamos proporcionar una guía clara y estructurada que facilitará la transición hacia las etapas de diseño detallado y desarrollo, asegurando que el sistema final sea robusto, eficiente y alineado con los objetivos del negocio.

2.2. Objetivo

Los objetivos del documento son:

Proporcionar una Visión General:

• Describir la arquitectura del sistema en un nivel alto, destacando los componentes principales, sus responsabilidades y cómo interactúan entre sí.

Facilitar la Comunicación:

• Actuar como una herramienta de comunicación entre las partes interesadas, incluyendo gerentes, desarrolladores, arquitectos, y otros involucrados en el proyecto, asegurando que todos tengan una comprensión común del sistema.

Establecer una Base Sólida:

• Sentar las bases para las fases de diseño detallado y desarrollo, proporcionando un marco estructural que guíe las decisiones técnicas y de implementación.

Asegurar la Coherencia y la Escalabilidad:

• Garantizar que el diseño del sistema sea coherente con los objetivos del negocio y pueda escalar para satisfacer futuras necesidades y requerimientos.

2.3. Alcance

Este documento está estructurado para cubrir los siguientes aspectos esenciales de la arquitectura del sistema:

Descripción del Contexto y Alcance:

• Definir el contexto en el que se desarrollará el sistema y los límites de su alcance.

Visión General de la Arquitectura:

• Presentar un diagrama de alto nivel y una descripción de los componentes principales del sistema.

Descripción de Componentes Clave:

• Detallar los componentes principales, sus roles y responsabilidades.

Interacciones y Flujos de Datos:

• Describir cómo interactúan los componentes entre sí y cómo fluyen los datos a través del sistema.

Decisiones Arquitectónicas y Justificación:

• Documentar las decisiones arquitectónicas clave y las razones detrás de ellas.

Consideraciones de Seguridad y Escalabilidad:

• Discutir cómo se abordarán las preocupaciones de seguridad y cómo el diseño permitirá la escalabilidad del sistema.

Requisitos No Funcionales:

• Identificar y describir los requisitos no funcionales importantes que deben ser considerados en el diseño.

2.4. Glosario

La siguiente tabla enlista los términos y sus significados a usarse en el documento:

TÉRMINO	SIGNIFICADO
MSA	Acrónimo usado para referirse a una arquitectura de microservicios. Proviene de las palabras en inglés: MicroServices Architecture
AR	Arquitectura de Referencia
SOA	Service Oriented Architecture
ACID	Atomicity, Consistency, Isolation, Durability
TDD	Test Driven Development
BDD	Behavior Driven Development
DevOps	Development and Operations
HTTP	Hypertext Transfer Protocol
DDD	Domain Driven Design
JSON	JavaScript Object Notation
REST	Representational state transfer
SOLID	Principios de diseño de software:
	- S – Single Responsibility Principle (SRP)
	- O – Open/Closed Principle (OCP)
	- L – Liskov Substitution Principle (LSP)
	- I – Interface Segregation Principle (ISP)
	- D – Dependency Inversion Principle (DIP)

---

3. Descripción general del contexto y Alcance

3.2. Descripción General del Proyecto

El presente proyecto tiene como principal objetivo gestionar de manera integral las acciones y participaciones de los socios de Alpura. Este sistema digitalizará procesos clave que actualmente se llevan a cabo en papel o en múltiples sistemas independientes, unificando la información de clientes, socios y acciones en un solo lugar. El objetivo es proporcionar mayor transparencia y eficiencia en la asignación y control de acciones de cada rancho asociado a Alpura. El presente documento describe los alcances técnicos y funcionales del MVP de SIEBEL para que todos los stakeholders comprendan qué se construirá, cómo y por qué.

Visión:

"SAAC (Sistema de Administración Accionaria de Alpura) será el sistema central de Alpura para garantizar la transparencia y trazabilidad del patrimonio accionario. Permitirá a Consejo y socios gestionar clientes, acciones y catálogos de manera clara y confiable, asegurando decisiones estratégicas basadas en información única y verificable. Nuestro propósito es que cada socio tenga la certeza de su participación y que el Consejo cuente con una herramienta sólida, simple y segura que trascienda la operación manual actual hacia un modelo digital sostenible."

Alcance del MVP

El Producto Mínimo Viable (MVP) de SAAC incluirá únicamente las funcionalidades esenciales para validar la idea de digitalizar la gestión accionaria. Por definición, un MVP es una versión inicial del producto con funcionalidades mínimas que permitan presentarlo a usuarios potenciales y comprobar su aceptación. En este proyecto, el alcance del MVP abarca:

• Gestión de Usuarios y Acceso: Módulo de login con autenticación segura y roles de usuario básicos.
• Módulo Clientes/Socios: Registro y consulta de información de clientes y socios (ranchos), incluyendo datos de contacto y referencias.
• Módulo Catálogos: Administración de datos estáticos requeridos (por ejemplo, tipos de accionistas, rangos, parámetros del sistema).
• Control Accionario: Funcionalidades para capturar solicitudes de servicio de asignación de acciones, realizar emisión accionaria con generación automática de folios (iniciando en 1 y final con base en la cantidad de acciones) y consultar títulos accionarios.
• Reportes Básicos: Visualización de reportes simples relacionados con la tenencia de acciones por socio y por serie.

Arquitectura Propuesta

La solución propuesta es llevar la implementación de estos procesos a una arquitectura en microservicios con microfrontend dentro de una infraestructura cloud.

Frontend - Módulos

Para el FrontEnd se tienen los diferentes módulos en los cuales va a estar interactuando el analista con las diferentes pantallas:

Gestión de clientes: Este apartado se va encargar de capturar, almacenar y actualizar la información de clientes, así como también empresas. De igual forma se estarán almacenando también los archivos adjuntos del cliente o empresa. La administración de los ranchos también se estaría realizando en este módulo del frontend.

Gestión de Pagos: En este apartado vamos a llevar a cabo los pagos referenciados, transacciones y los pagos cuenta.

Gestión de movimientos: Módulo encargado de realizar los movimientos accionarios. El usuario va poder consultar el histórico de movimientos accionarios.

Gestión de acciones: Encargado de realizar las solicitudes de suscripción de acciones. Generar los folios para los títulos accionarios.

Reportes: Encargado de realizar todas las consultas en base a los criterios de búsqueda del analista, administrador. Poder permitir exportarlo en diferentes tipos de archivos.

Backend - Microservicios

Para el backend se van tener diferentes microservicios por procesos y exponer diferentes APIs cumpliendo con los requerimientos del negocio. A continuación, enlistamos los siguientes microservicios propuestos:

alpura-back-java-msa-client-reference:

• Tiene como propósito llevar la administración de la información de los clientes y las referencias, adicionalmente se estaría resguardando en la base de datos.
• Encargado de llevar la administración de las direcciones de clientes.
• Para consultar información de ranches de clientes, se tiene propuesto reutilizar la api de CRM Ranchos.

alpura-back-java-msa-service-request:

• Encargado de realizar la administración de solicitud de servicio.

alpura-back-java-msa-subscription-share:

• Encargado de exponer las APIs para las solicitudes de suscripción, administración de acciones y folios de acciones donde se va estar realizando las operaciones con los títulos accionarios.

alpura-back-java-msa-payment-movent:

• Este microservicio va llevar las transacciones, pagos cuentas, así como también los pagos referenciados y los movimientos accionarios los otorga.

alpura-back-java-msa-file:

• Este microservicio se va encargar de llevar administración de los archivos adjuntos de los clientes/socios.

alpura-back-java-msa-ranch-contact:

• Este microservicio va contener los registros de los ranchos y contactos.

Catálogos: El sistema propuesto tiene una serie de catálogos que va interactuar con las diferentes pantallas, por lo que el portal ya cuenta con un módulo genérico donde vamos estar dando de alta todas las listas de valores.

Migración de Datos

Para el proceso de migración de información de cada módulo (proceso), se llevará con Apache Camel donde se va encargar de estructurar la información al nuevo esquema propuesta para el CRM SIEBEL.

Base de Datos

Para el sistema CRM SIEBEL se tiene como propuesta una base de datos estructurada (PostgreSQL) para almacenar toda información de clientes, socios, empresas, movimientos accionarios, etc.

Tecnología Frontend

Finalmente, para la interfaz del Usuario se pretende llevar el desarrollo con Angular, donde buscamos mejorar la interacción con las pantallas, que le sea fácil interactuar con la información en los diferentes módulos que proveerá el sistema.

En esta solución se busca mejorar la eficiencia, manejo de errores, ofrecerle al usuario una interfaz intuitiva y la alta disponibilidad de servicio.

Características no funcionales

Id	Atributo de Calidad	Descripción
RFN-1	Usabilidad	Interfaz intuitiva para el sistema web
RFN-2	Fiabilidad	El sistema debe estar resguardado en una base de datos para los procesos.
RFN-3	Desempeño	El sistema debe de estar funcionando durante la jornada laboral.
RFN-4	Performance	Los servicios consumidos por el front, deben ser menor a 5s.
RFN-5	Seguridad	El sistema debe poder llevar a cabo la trazabilidad de los servicios consumidos, como son canal, usuario etc. Tener una bitácora de seguimiento.
RFN-6	Seguridad	El sistema debe permitir manejar diferentes permisos basado en roles.
RFN-7	Usabilidad	Interfaz táctil optimizada para operarios con guantes: Botones grandes (mínimo 10 mm de altura), alto contraste, iconografía visual clara y confirmaciones sonoras/vibratorias.
RFN-8	Usabilidad	Operación con baja visibilidad: Tema oscuro y modo de alto brillo ajustable para entornos con poca o excesiva iluminación en planta.
RFN-9	Usabilidad	Navegación rápida: Máximo de 3 toques para ejecutar cualquier acción principal
RFN-10	Usabilidad	Lenguaje visual y auditivo
RFN-11	Usabilidad	Diseño responsivo y multiplataforma: La aplicación web debe adaptarse a pantallas de 7" – 24".
RFN-12	Disponibilidad	Los servicios backend y bases de datos deben garantizar una disponibilidad mínima del 99.5 %.
RFN-13	Disponibilidad	Los servicios backend y bases de datos deben garantizar una disponibilidad mínima del 99.5 %, con balanceo de carga.
RFN-14	Continuidad operativa	Recuperación ante fallas (DRP): El sistema debe contar con un mecanismo de recuperación automática que asegure la restauración de datos y continuidad en menos de 30 minutos ante fallas críticas.
RFN-15	Seguridad y control de acceso	Autenticación corporativa: Integración con SSO / Active Directory o sistema de credenciales corporativas de Alpura.
RFN-16	Seguridad y control de acceso	Autorización por rol y planta: Cada usuario sólo podrá acceder a las funciones habilitadas por su rol.
RFN-17	Seguridad y control de acceso	Cifrado de comunicaciones: Toda comunicación entre front-end, backend y realizarse mediante HTTPS.
RFN-18	Seguridad y control de acceso	Auditoría y trazabilidad: Cada transacción debe registrar usuario, dispositivo, ubicación, fecha/hora y cambios realizados (bitácora inalterable).
RFN-19	Seguridad y control de acceso	Protección de sesiones: Auto cierre de sesión tras 15 minutos de inactividad y bloqueo remoto de dispositivo en caso de pérdida o robo.
RFN-20	Rendimiento y escalabilidad	Escalabilidad horizontal: La arquitectura basada en microservicios debe permitir escalar dinámicamente instancias de API o bases de datos según demanda.
RFN-21	Mantenibilidad y monitoreo	Arquitectura modular: Separación clara por microservicios para facilitar despliegues independientes.
RFN-22	Mantenibilidad y monitoreo	Observabilidad: Implementación de logs centralizados, métricas y alertas (Grafana, Prometheus o Cloud Logging).
RFN-23	Mantenibilidad y monitoreo	Documentación técnica: Toda API y flujo debe contar con documentación Swagger y manual técnico actualizado.
RFN-24	Mantenibilidad y monitoreo	Soporte de versiones paralelas: El sistema debe permitir coexistencia temporal de versiones antiguas y nuevas durante migraciones.

3.3. Descripción de Escenarios y Seguimiento

Gestión de cliente

A continuación, se detallan los principales escenarios de negocio para la información de clientes o Socios:

Escenario 1: Proceso de administración de clientes

• Alta de nuevo registro de cliente: el usuario puede realizar el alta de cliente.
• Buscar Cliente: el usuario puede realizar diferentes tipos de búsqueda de la información del cliente.
• Actualizar Cliente: El usuario del sistema puede actualizar la información del cliente.
• Eliminar cliente: El usuario puede realizar una eliminación lógica del cliente/Socio.

Escenario 2: Proceso para la gestión de referencia de clientes.

• Agregar Referencia: El usuario de sistema puede agregar muchas referencias del cliente.
• Actualizar Referencia: El usuario de sistema puede actualizar las referencias de los clientes.
• Eliminar Referencia: El usuario de sistema puede realizar un baja de referencia lógico.
• Consultar Referencia: El usuario de sistema puede realizar consultar de las referencias de los clientes.

Gestión de Pagos

Gestión Movimientos

Administración de Catálogo

Control Accionario

En siguiente proceso se detalla el flujo cuando un cliente genera la solicitud de servicio para la suscripción de acciones e interactuando con los demás componentes clave:

1. El gerente administrador da de alta una emisión accionaria y coloca el tipo de acciones.
2. Obtenemos información de indicadores financieros: en este apartado tenemos los costos por acción como son:
   • Valor nominal: valor de la acción
   • Prima: es un impuesto de la acción
3. El cliente puede generar solicitud de servicio para suscribirse las acciones emitidas de control accionario.
4. El cliente debe contar con dinero para poder comprar acciones.
5. Puede realizar pagos referenciados.
6. Cuando se realiza un pago, se efectúa una transacción y a su vez se manda en pagos cuenta la información.
7. Cuando la solicitud es autorizada se debe realizar lo siguiente:
   • Se genera un movimiento accionario
   • Tipo de solicitud
   • Se actualiza la solicitud a autorizado.
   • Se genera el rango de folios que compró el cliente.
   • Se realiza el cargo por la suscripción de acciones.
   • El cliente cambia de estado a socio por la compra.

3.4. DIAGRAMA DE CONTEXTO

---

4. Visión General de la Arquitectura

La Arquitectura del sistema se describe en 3 principales vistas, una vista física, una vista lógica, y una vista de los principales componentes o drivers del sistema.

4.2. Capa de la vista física

(Nota: En este apartado se debe incluir la descripción y diagrama de la vista física)

4.3. Capa de la vista lógica

En el siguiente diagrama se muestra el CRM SAAC donde se va montar en el portal como microfrontend donde se muestran los diferentes módulos que va interactuar. Adicional podemos visualizar los diferentes microservicios que va tener el sistema propuesto.

En el siguiente diagrama podemos visualizar como van estar desacoplados los componentes del CRM.

4.3.1. Flujo 1

Diagrama de Secuencia de clientes:

• Consulta de clientes

• Actualización de clientes

• Baja de cliente

• Direcciones

• Referencias

4.4. Capa de la vista principal

(Nota: En este apartado se debe incluir la descripción y diagrama de la vista principal)

---

5. Descripción de componentes clave

(Nota: En este apartado se debe incluir la descripción detallada de los componentes principales del sistema)

5.2. Atributos de calidad

(Nota: En este apartado se deben listar y explicar los atributos de calidad requeridos para la arquitectura)

5.3. Restricciones

(Nota: En este apartado se deben listar las restricciones técnicas y de negocio que afectan la arquitectura)

---

6. Interacciones y flujos de datos

Entidades

En el siguiente diagrama podemos visualizar las principales entidades para la solución propuesta.

Diccionario de datos

Este diccionario describe las tablas y columnas de la base de datos PostgreSQL diseñada para el sistema de CRM SAAC.

---

6.1. alp_saac_accionista_relacionado

Columna	Tipo de Dato	Restricción	Descripción
accionista_relacionado_id	BIGINT	PK, NOT NULL	Identificador del accionista relacionado.
cliente_id	BIGINT	NULLABLE	ID del cliente principal.
is_votante	BOOLEAN	NULLABLE	Indica si tiene poder de voto.
is_accionista_relacionado	BOOLEAN	NULLABLE	Indica si la relación es a nivel de accionista.
numero_sucursal	VARCHAR(20)	NULLABLE	Código de la sucursal.
numero_accionista_relacionado	VARCHAR(50)	NULLABLE	Número de identificación del accionista vinculado.
clave_nombramiento	BIGINT	NULLABLE	ID del catálogo de nombramientos.
valor_visible_nombramiento	VARCHAR(255)	NULLABLE	Nombre descriptivo del nombramiento.
nombre_accionista_relacionado	VARCHAR(100)	NULLABLE	Nombre completo de la persona relacionada.
sucursal	VARCHAR(50)	NULLABLE	Nombre de la sucursal asignada.

6.2. alp_saac_cliente

Columna	Tipo de Dato	Restricción	Descripción
cliente_id	BIGSERIAL	PK, NOT NULL	Identificador maestro del cliente en el sistema.
fecha_alta	TIMESTAMP	NULLABLE	Fecha oficial de alta como cliente.
estatus	CHAR(1)	NULLABLE	Carácter indicador del estado (ej. 'A' activo).
numero_cliente	BIGINT	NULLABLE	Código numérico asignado al cliente.
clave_tipo_persona	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_persona	VARCHAR	NULLABLE	Descripción legible del tipo de persona.
rfc	VARCHAR	NULLABLE	Registro Federal de Contribuyentes.
clave_region	BIGINT	NULLABLE	Clave de catálogos.
region	VARCHAR	NULLABLE	Nombre de la región operativa.
nombre_empresa	VARCHAR	NULLABLE	Razón social en caso de ser Cliente Persona Moral.
nombre	VARCHAR	NULLABLE	Nombre o nombres de la persona física.
primer_apellido	VARCHAR	NULLABLE	Apellido paterno del cliente.
segundo_apellido	VARCHAR	NULLABLE	Apellido materno del cliente.
edad	INTEGER	NULLABLE	Edad calculada o registrada del cliente.
clave_genero	BIGINT	NULLABLE	ID del catálogo de géneros.
valor_visible_genero	VARCHAR	NULLABLE	Descripción del género.
fecha_nacimiento	TIMESTAMP	NULLABLE	Fecha de nacimiento para personas físicas.
curp	VARCHAR	NULLABLE	Clave Única de Registro de Población.
fecha_constitutucion	TIMESTAMP	NULLABLE	Fecha de creación de la empresa.
clave_categoria	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_categoria	VARCHAR	NULLABLE	Nombre de la categoría (ej. Productor).
clave_subcategoria	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_subcategoria	VARCHAR	NULLABLE	Nombre de la subcategoría.
numero_accionista	VARCHAR	NULLABLE	Matrícula o ID único como accionista.
sucursal	VARCHAR	NULLABLE	Sucursal física donde se atiende al cliente.
isvotante	CHAR(1)	NULLABLE	Indica si tiene derecho a sufragio en asambleas.
fecha_defuncion	TIMESTAMP	NULLABLE	Fecha de deceso, se usa para procesos de sucesión.
nacionalidad	VARCHAR	NULLABLE	País de origen del cliente.

6.3. alp_saac_cliente_archivo

Columna	Tipo de Dato	Restricción	Descripción
cliente_archivo_id	BIGSERIAL	PK, autoincrementable	Identificador único del registro de archivo.
cliente_id	BIGINT	NULL	Referencia al identificador del cliente.
nombre_archivo	VARCHAR	NULL	Nombre original del archivo cargado.
tam_bytes	BIGINT	NULL	Tamaño total del archivo expresado en bytes.
formato	VARCHAR	NULL	Formato o extensión del archivo (ej. pdf, png).
clave_tipo_documento	BIGINT	NULL	Clave de catálogos.
valor_visible_tipo_documento	VARCHAR	NULL	Descripción o valor legible del tipo de documento.
fecha_vigencia	TIMESTAMP	NULL	Fecha límite de validez del documento.
comentarios	VARCHAR	NULL	Observaciones o comentarios adicionales.
ruta	VARCHAR	NULL	Ruta física o URI de almacenamiento del archivo.

6.4. alp_saac_contacto

Columna	Tipo de Dato	Restricción	Descripción
contacto_id	BIGSERIAL	PK	Identificador único del contacto.
cliente_id	BIGINT	NULLABLE	Identificador del cliente asociado.
fecha_alta	TIMESTAMP	NULLABLE	Fecha en que se dio de alta el contacto.
estatus	VARCHAR	NULLABLE	Estatus actual del contacto.
is_principal	BOOLEAN	NULLABLE	Indica si este es el contacto principal del cliente.
clave_tipo	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo	VARCHAR	NULLABLE	Descripción legible del tipo de contacto.
telefono	VARCHAR	NULLABLE	Número telefónico de contacto.
correo	VARCHAR	NULLABLE	Dirección de correo electrónico.
observaciones	VARCHAR	NULLABLE	Comentarios u observaciones adicionales.

6.5. alp_saac_control_accion

Columna	Tipo de Dato	Restricción	Descripción
control_accion_id	BIGSERIAL	PK, NOT NULL	ID de control para emisiones accionarias.
indicador_financiero_id	BIGINT	NOT NULL, FK	Vínculo con los indicadores financieros.
fecha_alta	DATE	NOT NULL	Fecha de alta de la emisión en el sistema.
folio	INTEGER	NOT NULL	Número de folio de control secuencial.
empresa	VARCHAR(500)	NULLABLE	Empresa que emite el control de acciones.
estatus	VARCHAR	NOT NULL	Estatus actual de la emisión (ej. ACTIVA).
tipo_acciones	VARCHAR(50)	NOT NULL	Tipo de acciones representadas.
serie	VARCHAR(2)	NULLABLE	Serie específica de la emisión.
fecha_operacion	DATE	NOT NULL	Fecha en que se materializó la operación contable.
emision_total	INTEGER	NOT NULL	Cantidad total de acciones emitidas en este bloque.
accion_inicial	INTEGER	NOT NULL	Número de acción inicial del bloque.
accion_final	INTEGER	NOT NULL	Número de acción final del bloque.
valor_nominal	DECIMAL(15,2)	NOT NULL	Valor unitario impreso en el título.
total_capital	DECIMAL(15,2)	NOT NULL	Valor monetario total representado.
montoprima	DECIMAL(15,2)	NULLABLE	Monto de prima recolectada en la suscripción.
acciones_ex_no_suscritas	INTEGER	NULLABLE	Conteo de acciones existentes sin dueño.
acciones_sus_no_pagada	INTEGER	NULLABLE	Acciones con dueño pero con adeudo.
acciones_sus_pagadas	INTEGER	NULLABLE	Acciones suscritas y pagadas.
moneda	VARCHAR(3)	NOT NULL	Divisa de la emisión (MXN/USD).
codigo_organizacion	VARCHAR	NULLABLE	Código organizacional.

6.6. alp_saac_direccion

Columna	Tipo de Dato	Restricción	Descripción
direccion_id	BIGSERIAL	PK, NOT NULL	Identificador único de la dirección.
cliente_id	BIGINT	NOT NULL, FK	Relación con el cliente dueño de la dirección.
fecha_alta	DATE	NULLABLE	Fecha de registro de la dirección.
estatus	VARCHAR(15)	NULLABLE	Estado actual de la dirección.
isprimario	BOOLEAN	NULLABLE	Indica si es la dirección principal del cliente.
clave_tipo_direccion	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_direccion	VARCHAR(100)	NULLABLE	Descripción del tipo de dirección.
comentarios	VARCHAR(255)	NULLABLE	Notas adicionales sobre el domicilio.
calle	VARCHAR(255)	NULLABLE	Nombre de la calle.
numero_exterior	VARCHAR(50)	NULLABLE	Número exterior del domicilio.
numero_interior	VARCHAR(50)	NULLABLE	Número interior del domicilio.
lote	VARCHAR(50)	NULLABLE	Lote del predio.
manzana	VARCHAR(50)	NULLABLE	Manzana del predio.
codigo_postal	VARCHAR(20)	NULLABLE	Código postal del domicilio.
colonia	VARCHAR(100)	NULLABLE	Colonia o asentamiento.
municipio	VARCHAR(100)	NULLABLE	Municipio o delegación.
ciudad	VARCHAR(100)	NULLABLE	Ciudad del domicilio.
entidad_federativa	VARCHAR(100)	NULLABLE	Estado o provincia.
nombre_rancho	VARCHAR(255)	NULLABLE	Nombre del rancho asociado a esta dirección.
pais	VARCHAR(100)	NULLABLE	País de residencia.
nacionalidad	VARCHAR(100)	NULLABLE	Nacionalidad.
latitud	DECIMAL(12,8)	NULLABLE	Coordenada geográfica (Latitud).
longitud	DECIMAL(12,8)	NULLABLE	Coordenada geográfica (Longitud).

6.7. alp_saac_folio_accion

Columna	Tipo de Dato	Restricción	Descripción
folio_accion_id	BIGSERIAL	PK, NOT NULL	Identificador único del folio accionarial.
cliente_id	BIGINT	NULLABLE	Relación con el socio titular de los folios.
solicitud_suscripcion_id	BIGINT	NULLABLE	Referencia a la solicitud que originó los folios.
clave_tipo_capital	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_capital	VARCHAR	NULLABLE	Nombre legible del tipo de capital.
clave_tipo_serie	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_serie	VARCHAR	NULLABLE	Nombre legible de la serie.
folio_inicial	VARCHAR	NULLABLE	Primer número de folio en el rango asignado.
folio_final	VARCHAR	NULLABLE	Último número de folio en el rango asignado.
acciones	DECIMAL	NULLABLE	Cantidad de acciones del paquete foliado.
total_acciones	DECIMAL	NULLABLE	Sumatoria total de acciones vinculadas al ID.
fecha_alta	TIMESTAMP	NULLABLE	Fecha de generación del folio.
fecha_actualizacion	TIMESTAMP	NULLABLE	Fecha de último movimiento en el folio.

6.8. alp_saac_indicador_financiero

Columna	Tipo de Dato	Restricción	Descripción
indicador_financiero_id	BIGSERIAL	PK, NOT NULL	ID Indicador.
fecha_alta	TIMESTAMP	NOT NULL	Alta.
moneda	VARCHAR(5)	NOT NULL	MXN/USD.
valor	DECIMAL(25,4)	NOT NULL	Valor económico.
descripcion	VARCHAR	NOT NULL	Nombre.
tipo_indicador	VARCHAR(50)	NOT NULL	Tipo (ACCIONES, PRIMA).
fecha_pago	DATE	NOT NULL	Orden/Fecha.

6.9. alp_saac_informacion_adicional

Columna	Tipo de Dato	Restricción	Descripción
informacion_adicional_id	BIGSERIAL	PK, NOT NULL	Identificador único de información complementaria.
cliente_id	BIGINT	NULLABLE	Relación con el registro maestro del cliente.
numero_ranchos	INTEGER	NULLABLE	Registro de unidades de producción.
numero_vacas	INTEGER	NULLABLE	Registro de unidades de producción.
referencia_bancaria	DECIMAL(25,0)	NULLABLE	Número de referencia para depósitos y pagos.

6.10. alp_saac_informacion_votante

Columna	Tipo de Dato	Restricción	Descripción
id_votante	BIGSERIAL	PK, NOT NULL	Identificador del registro en el padrón electoral.
isvotante	CHAR(1)	NULLABLE	Indica si el socio cubrió los requisitos para votar.
fecha_corte	TIMESTAMP	NULLABLE	Fecha de cierre del padrón para el cálculo.
nombramiento	VARCHAR	NULLABLE	Puesto o representación dentro de la asamblea.
clave_region	BIGINT	NULLABLE	Clave de catálogos.
region	VARCHAR	NULLABLE	Nombre de la región.
numero_accionista	VARCHAR	NULLABLE	Número asignado como socio capitalista.
sucursal	VARCHAR	NULLABLE	Sucursal donde radica su voto.
suc_accionista	BIGINT	NULLABLE	ID técnico de la sucursal.
nombre_rancho	VARCHAR	NULLABLE	Nombre de la entidad productiva madre.
nombre	VARCHAR	NULLABLE	Nombre completo del votante.
primer_apellido	VARCHAR	NULLABLE	Apellido paterno.
segundo_apellido	VARCHAR	NULLABLE	Apellido materno.
edad	INTEGER	NULLABLE	Edad a la fecha de la asamblea.
folio_inicial	BIGINT	NULLABLE	Primer folio de acciones representado.
folio_final	BIGINT	NULLABLE	Último folio de acciones representado.
acciones	DECIMAL	NULLABLE	Peso proporcional del voto basado en acciones.
total_acciones	DECIMAL	NULLABLE	Total de cuota accionaria votante.
accionista_relacionado	VARCHAR	NULLABLE	RFC o ID de socio vinculado.
nombre_accionista_relacionado	VARCHAR	NULLABLE	Nombre de la persona física o moral vinculada.
folio1 a folio5	BIGINT	NULLABLE	Folios de desglose de categoría.
valor_visible_categoria	VARCHAR	NULLABLE	Descripción de categoría socio.
valor_visible_subcategoria	VARCHAR	NULLABLE	Descripción subcategoría socio.
valor_visible_tipo_serie	VARCHAR	NULLABLE	Descripción de la serie de acciones.
cliente_id	BIGINT	NULLABLE	ID maestro del cliente.
fecha_alta	TIMESTAMP	NULLABLE	Fecha en que se habilitó para la asamblea.

6.11. alp_saac_movimientos

Columna	Tipo de Dato	Restricción	Descripción
movimiento_id	BIGSERIAL	PK, NOT NULL	Identificador único del movimiento operativo.
cliente_id	BIGINT	NULLABLE	Socio que origina el movimiento.
folio_accion_id	BIGINT	NULLABLE	Folio receptor de los cambios.
folio_accion_id_origen	BIGINT	NULLABLE	Folio del cual se descuentan las acciones.
indicador_financiero_id	BIGINT	NULLABLE	Referencia financiera vinculada al movimiento.
solicitud_suscripcion_id	BIGINT	NULLABLE	Solicitud de suscripción relacionada.
fecha_alta	TIMESTAMP	NULLABLE	Fecha de creación del movimiento.
fecha_autorizacion	TIMESTAMP	NULLABLE	Fecha de revisión y visto bueno administrativo.
clave_tipo_movimiento	VARCHAR	NULLABLE	Clave de catálogos.
valor_visible_tipo_movimiento	VARCHAR	NULLABLE	Descripción legible de la operación.
clave_tipo_acciones	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_acciones	VARCHAR	NULLABLE	Descripción tipo acciones.
clave_tipo_serie	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_serie	VARCHAR	NULLABLE	Descripción de la serie.
acciones_aplicar	DECIMAL	NULLABLE	Cantidad de acciones pactadas para aplicación.
acciones	DECIMAL	NULLABLE	Cantidad neta de acciones impactadas.
clave_empresa	BIGINT	NULLABLE	Clave de catálogos.
codigo_organizacion	VARCHAR	NULLABLE	Código de organización ERP/Sistema.
valor_visible_empresa	VARCHAR	NULLABLE	Nombre corporativo.
aplicado	CHAR(1)	NULLABLE	Indica si el movimiento ya afectó el saldo real.
numero_socio_contraparte	VARCHAR	NULLABLE	Identificación del socio contraparte.
nombre_socio_contraparte	VARCHAR	NULLABLE	Nombre del socio contraparte.
comentarios	VARCHAR	NULLABLE	Detalle libre de la causa.
aplica_prima_actual	VARCHAR	NULLABLE	Indica si se calculó con la prima actual.

6.12. alp_saac_movimientos_historico

Columna	Tipo de Dato	Restricción	Descripción
movimiento_id	BIGSERIAL	PK, NOT NULL	ID secuencial histórico de movimientos.
cliente_id	BIGINT	NULLABLE	Cliente histórico involucrado.
folio_accion_id	BIGINT	NULLABLE	Folio de acciones impactado.
indicador_financiero_id	BIGINT	NULLABLE	Relación con indicadores económicos.
solicitud_suscripcion_id	BIGINT	NULLABLE	Solicitud original del histórico.
fecha_alta	TIMESTAMP	NULLABLE	Fecha en que nació el registro.
fecha_autorizacion	TIMESTAMP	NULLABLE	Fecha de aprobación institucional.
clave_tipo_movimiento	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_movimiento	VARCHAR	NULLABLE	Nombre de la operación.
clave_tipo_acciones	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_acciones	VARCHAR	NULLABLE	Nombre del tipo de acciones.
clave_tipo_serie	BIGINT	NULLABLE	Clave de catálogos.
acciones_aplicar	INTEGER	NULLABLE	Cantidad de acciones en transito.
acciones	INTEGER	NULLABLE	Monto de acciones registradas en el pasado.
clave_empresa	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_empresa	VARCHAR	NULLABLE	Nombre de la empresa.
aplicado	CHAR(1)	NULLABLE	Validador de ejecución satisfactoria ('S'/'N').
numero_socio_contraparte	BIGINT	NULLABLE	Socio contraparte.
nombre_socio_contraparte	VARCHAR	NULLABLE	Nombre contraparte.
comentarios	TEXT	NULLABLE	Detalle de la naturaleza del cambio histórico.

6.13. alp_saac_pagos_cuenta

Columna	Tipo de Dato	Restricción	Descripción
id_pago	BIGSERIAL	PK, NOT NULL	ID del pago consolidado en cuenta.
fecha_registro	TIMESTAMP	NOT NULL	Fecha y hora de entrada al sistema central.
cuenta_bancaria	VARCHAR(50)	NULLABLE	Cuenta destino donde se recibió el fondo.
referencia_bancaria	VARCHAR(50)	NOT NULL	Folio único bancario para conciliación.
convenio	VARCHAR(20)	NOT NULL	ID de convenio con el banco.
fecha_pago	DATE	NOT NULL	Fecha en la que el banco cobró.
monto	DECIMAL(15,2)	NOT NULL	Importe total depositado por el cliente.
moneda	VARCHAR(3)	NOT NULL	Tipo de moneda (MXN/USD).
total_aplicado	DECIMAL(15,2)	NOT NULL	Suma de montos ya asociados a solicitudes.
saldo_pendiente	DECIMAL(15,2)	NOT NULL	Saldo a favor del cliente no utilizado.
cuenta_procedencia	VARCHAR(50)	NOT NULL	Cuenta bancaria del socio emisor.
estatus	VARCHAR(20)	NOT NULL	Estatus del pago (PENDIENTE/APLICADO).
cliente_id	BIGINT	NOT NULL, FK	Relación con la entidad del socio pagador.

6.14. alp_saac_pagos_referenciados

Columna	Tipo de Dato	Restricción	Descripción
pago_referenciado_id	BIGSERIAL	PK, NOT NULL	ID único del pago vía referencia.
cuenta_bancaria	VARCHAR(50)	NULLABLE	Cuenta de destino Alpura.
convenio	VARCHAR(20)	NOT NULL	Convenio bancario configurado.
referencia_bancaria	VARCHAR(50)	NOT NULL	Referencia capturada por el banco.
banco	VARCHAR(100)	NULLABLE	Nombre de la institución financiera.
nombre_cliente	VARCHAR(200)	NULLABLE	Nombre que viene en el layout bancario.
importe	DECIMAL(15,2)	NOT NULL	Monto bruto captado por el banco.
fecha_pago	DATE	NOT NULL	Fecha valor reportada por el banco.
moneda	VARCHAR(3)	NOT NULL	Divisa de la operación (MXN/USD).
cuenta_procedencia	VARCHAR(50)	NOT NULL	Cuenta origen del depositante.
fecha_identificacion	DATE	NULLABLE	Fecha en que el sistema encontró al socio.
procesado	CHAR(1)	NOT NULL	Indica si ya se integró a la contabilidad.
identificado	CHAR(1)	NOT NULL	Indica si se pudo asignar a un socio específico.
cliente_id	BIGINT	NULLABLE, FK	Vínculo al socio identificado.
transaccion_id	BIGINT	NULLABLE, FK	Folio de transacción contable SAAC.
fecha_registro	TIMESTAMP	NOT NULL	Fecha de registro en la base de datos.

6.15. alp_saac_rancho

Columna	Tipo de Dato	Restricción	Descripción
rancho_id	BIGSERIAL	PK, autoincrementable	Identificador único del rancho.
cliente_id	BIGINT	FK, NOT NULL	Identificador del cliente dueño o asociado.
rancho_cliente_id	BIGINT	NULLABLE	Identificador alternativo del rancho por cliente.
fecha_alta	TIMESTAMP	NULLABLE	Fecha en que se registró el rancho.
estatus	CHAR(1)	NULLABLE	Estatus operativo del rancho.
is_primario	BOOLEAN	NULLABLE	Indica si es el rancho principal/primario.
clave_tipo_rancho	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_rancho	CHAR(1)	NULLABLE	Valor visible o código corto del tipo de rancho.
comentarios	VARCHAR	NULLABLE	Observaciones generales del rancho.
nombre_rancho	VARCHAR	NULLABLE	Nombre descriptivo del rancho.
produccion_leche	BIGINT	NULLABLE	Cantidad de producción de leche propia.
produccion_leche_terceros	BIGINT	NULLABLE	Cantidad de producción de leche de terceros.
produccion_total_leche	BIGINT	NULLABLE	Suma total de producción de leche.
porcentaje_produccion_leche	BIGINT	NULLABLE	Porcentaje de la producción propia.
porcentaje_produccion_leche_tercero	BIGINT	NULLABLE	Porcentaje de la producción de terceros.
porcentaje_total_leche	BIGINT	NULLABLE	Porcentaje total de producción.
hato_ganadero_linea	BIGINT	NULLABLE	Cantidad de ganado en línea.
hato_ganadero_secas	BIGINT	NULLABLE	Cantidad de ganado en periodo seco.
hato_ganadero_recria	BIGINT	NULLABLE	Cantidad de ganado en recría.
porcentaje_hato_ganadero_linea	BIGINT	NULLABLE	Porcentaje de ganado en línea.
porcentaje_hato_ganadero_secas	BIGINT	NULLABLE	Porcentaje de ganado seco.
porcentaje_hato_ganadero_recria	BIGINT	NULLABLE	Porcentaje de ganado en recría.
vacas_hato	BIGINT	NULLABLE	Número total de vacas en el hato.
productividad_hato	DECIMAL	NULLABLE	Índice de productividad del hato.
productividad_linea	DECIMAL	NULLABLE	Índice de productividad en línea.
precio_alpura_leche	BIGINT	NULLABLE	Precio establecido por Alpura para la leche.
precio_leche_terceros	BIGINT	NULLABLE	Precio de leche comprada a terceros.

6.16. alp_saac_referencia_cliente

Columna	Tipo de Dato	Restricción	Descripción
referencia_id	BIGSERIAL	PK, NOT NULL	Identificador único de la referencia.
cliente_id	BIGINT	NULLABLE	ID del cliente al que pertenece esta referencia.
fecha_alta	DATE	NULLABLE	Fecha de alta de la referencia.
estatus	VARCHAR(15)	NULLABLE	Estado de la referencia.
isprimario	BOOLEAN	NULLABLE	Indica si es la referencia primaria.
clave_tipo_referencia	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_referencia	VARCHAR(100)	NULLABLE	Descripción del tipo de referencia.
comentarios	VARCHAR(500)	NULLABLE	Notas adicionales sobre la referencia.
iscontacto	CHAR(1)	NULLABLE	Indica si la referencia también funciona como contacto.
razon_social	VARCHAR(255)	NULLABLE	Razón social (si la referencia es persona moral).
nombre	VARCHAR(100)	NULLABLE	Nombre(s) de la referencia.
primer_apellido	VARCHAR(100)	NULLABLE	Apellido paterno de la referencia.
segundo_apellido	VARCHAR(100)	NULLABLE	Apellido materno de la referencia.
telefono	VARCHAR(50)	NULLABLE	Teléfono de contacto de la referencia.
correo	VARCHAR(150)	NULLABLE	Correo electrónico de la referencia.
clave_tipo_personalidad	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_personalidad	VARCHAR(100)	NULLABLE	Descripción de la personalidad.
clave_tipo_poder	BIGINT	NULLABLE	Clave de catálogos.
valor_visible_tipo_poder	VARCHAR(100)	NULLABLE	Descripción del poder asociado.

6.17. alp_saac_referencia_cliente_relacion

Columna	Tipo de Dato	Restricción	Descripción
referencia_cliente_relacion_id	BIGINT	PK, NOT NULL	Identificador de la relación cliente-referencia.
cliente_id	BIGINT	NOT NULL, FK	Identificador del cliente.
referencia_id	BIGINT	NOT NULL, FK	Identificador de la referencia.

6.18. alp_saac_relacion_rancho_cliente

Columna	Tipo de Dato	Restricción	Descripción
rancho_cliente_relacion_id	BIGSERIAL	PK, NOT NULL	Identificador único de la relación rancho-cliente.
cliente_id	BIGINT	FK, NOT NULL	Identificador del cliente.
rancho_id	BIGINT	FK, NOT NULL	Identificador del rancho.

6.19. alp_saac_socio_lql

Columna	Tipo de Dato	Restricción	Descripción
socio_lql_id	BIGINT	PK, NOT NULL	Identificador del registro LQL del socio.
cliente_id	BIGINT	NOT NULL, FK	Relación con el socio principal.
lql	VARCHAR(25)	NULLABLE	Número de liquidación
nombre_cliente_socio_id	VARCHAR(200)	NULLABLE	Nombre descriptivo vinculado al ID del socio.

6.20. alp_saac_solicitud_servicio

Columna	Tipo de Dato	Restricción	Descripción
solicitud_suscripcion_id	BIGSERIAL	PK, NOT NULL	ID unívoco de la solicitud de servicio.
cliente_id	BIGINT	FK, NULLABLE	Socio que efectúa la solicitud formal.
control_accion_id	BIGINT	NULLABLE, FK	Datos maestros de la emisión de acciones.
indicador_financiero_id	BIGINT	NULLABLE, FK	Parámetros financieros configurados.
folio	VARCHAR	NULLABLE	Número asignado al documento.
fecha_alta	DATE	NULLABLE	Fecha de recepción.
estatus	VARCHAR	NULLABLE	Estado actual del flujo de aprobación.
tipo_solicitud	VARCHAR	NULLABLE	Naturaleza del trámite.
acciones	INTEGER	NULLABLE	Cantidad de acciones solicitadas a suscribir.
numero_solicitud	VARCHAR	NULLABLE	Folio automatizado de control interno.
aprobador	VARCHAR	NULLABLE	Usuario que autoriza.
solicitante	VARCHAR	NULLABLE	Personal de Alpura que inició el trámite.
nombre_socio	VARCHAR	NULLABLE	Nombre capturado del accionista.
tipo_persona	VARCHAR	NULLABLE	Persona Moral / Persona Física.
tipo_acciones	VARCHAR	NULLABLE	Suscritas / Pagadas / Otro.
aplica_prima_actual	VARCHAR	NULLABLE	Validador de prima económica.
suscribir_accion	INTEGER	NULLABLE	Conteo accionista a suscribir.
monto_prima	DECIMAL	NULLABLE	Prima por acción.
precio_accion	DECIMAL	NULLABLE	Costo base por acción.
monto_total_prima	DECIMAL	NULLABLE	Cálculo total de la prima a cubrir.
numero_acciones	INTEGER	NULLABLE	Cantidad final aprobada.
importe_movimiento	VARCHAR	NULLABLE	Descripción del total monetario.
forma_pago	INTEGER	NULLABLE	ID de catálogo forma de pago.
referencia_bancaria	VARCHAR	NULLABLE	Referencia ingresada en la solicitud.
fecha_solicitud	DATE	NULLABLE	Fecha formal de petición.
usuario_modificacion	VARCHAR	NULLABLE	Auditoría detallada de cambio.
comentarios	VARCHAR	NULLABLE	Observaciones de negocio.
tipo_serie	VARCHAR	NULLABLE	Serie accionaria objetivo.
monto_total_precio_accion	DECIMAL	NULLABLE	Valor total del capital solicitado.
fecha_autorizacion	TIMESTAMP	NULLABLE	Fecha/hora exacta de aprobación administrativa.

6.21. alp_saac_tabla_temporal

Columna	Tipo de Dato	Restricción	Descripción
tabla_temporal_id	BIGSERIAL	PK, NOT NULL	ID para el manejo de carga masiva/temporal.
nombre_tabla	VARCHAR	NULLABLE	Nombre físico de la tabla técnica en uso.

6.22. alp_saac_titulo_accionario

Columna	Tipo de Dato	Restricción	Descripción
id_titulo_accionario	BIGSERIAL	PK, NOT NULL	Identificador legal del título emitido.
fecha_alta	TIMESTAMP	NOT NULL	Momento de emisión del título.
estatus	VARCHAR(10)	NOT NULL	Estatus vigente del certificado (VIGENTE/NULO).
folio_titulo	VARCHAR(15)	NOT NULL, UNIQUE	Folio titulo.
cliente_id	BIGINT	NOT NULL, FK	Relación con el dueño legal del título.
control_accion_id	BIGINT	NOT NULL, FK	Bloque de emisión del que proviene el título.
nombre_empresa	VARCHAR(500)	NOT NULL	Razón social de la empresa ante notario.
tipo_acciones	VARCHAR(25)	NOT NULL	Categoría del capital certificado.
serie	VARCHAR(5)	NOT NULL	Serie que ampara el título.
acciones	DECIMAL(25,0)	NOT NULL	Volumen de acciones protegido por el título.
total_acciones	DECIMAL(25,0)	NOT NULL	Saldo total.

6.23. alp_saac_titulo_accionario_historico

Columna	Tipo de Dato	Restricción	Descripción
id_titulo_accionario	BIGSERIAL	PK, NOT NULL	ID histórico del título.
fecha_alta	TIMESTAMP	NULLABLE	Fecha en que se registró el título original.
estatus	VARCHAR(10)	NULLABLE	Estatus del título en el histórico.
folio_titulo	VARCHAR(100)	NULLABLE	Folio del certificado accionario.
cliente_id	INTEGER	NULLABLE	Socio histórico dueño del título.
control_accion_id	INTEGER	NULLABLE	Control de emisión histórico.
nombre_empresa	VARCHAR(500)	NULLABLE	Razón social de la empresa emisora.
tipo_acciones	VARCHAR(25)	NULLABLE	Categoría del capital certificado.
serie	VARCHAR(5)	NULLABLE	Serie del título.
acciones	DECIMAL(25,0)	NULLABLE	Cantidad de acciones amparadas históricamente.
total_acciones	DECIMAL(25,0)	NULLABLE	Acumulado de acciones.

6.24. alp_saac_transaccion

Columna	Tipo de Dato	Restricción	Descripción
transaccion_id	BIGSERIAL	PK, NOT NULL	Identificador contable de la transacción.
fecha_registro	TIMESTAMP	NOT NULL	Fecha sistema del registro financiero.
cuenta_bancaria	VARCHAR(50)	NULLABLE	Cuenta destino del dinero.
referencia_bancaria	VARCHAR(50)	NOT NULL	Referencia que ampara el abono/cargo.
convenio	VARCHAR(20)	NOT NULL	Número de convenio de recaudo bancario.
fecha_pago	DATE	NOT NULL	Fecha efectiva del movimiento.
importe	DECIMAL(15,2)	NOT NULL	Valor monetario de la afectación de saldos.
moneda	VARCHAR(3)	NOT NULL	Sigla de divisa (MXN/USD).
descripcion	VARCHAR(500)	NULLABLE	Notas explicativas del cargo/abono.
tipo	VARCHAR(10)	NOT NULL	Clasificación (Abono, Cargo, Ajuste).
aplicar_a	BIGINT	NULLABLE	Referencia a ID de otro documento financiero.
cuenta_procedencia	VARCHAR(50)	NOT NULL	Cuenta bancaria origen del cliente.
estatus	VARCHAR(20)	NOT NULL	Estado de la confirmación bancaria/contable.
cliente_id	BIGINT	NOT NULL, FK	Cliente cuyo saldo fue impactado.
pago_referenciado_id	BIGINT	NULLABLE	ID del pago referenciado que detonó este registro.

6.25. alp_saac_uso_propiedad_accionaria

Columna	Tipo de Dato	Restricción	Descripción
uso_propiedad_accionaria_id	BIGSERIAL	PK, NOT NULL	Identificador único de la administración accionaria.
cliente_id	BIGINT	NOT NULL, FK	Relación obligatoria con el cliente titular.
fecha_inicio	TIMESTAMP	NOT NULL	Fecha de inicio de la vigencia de la propiedad/uso.
fecha_fin	TIMESTAMP	NOT NULL	Fecha de terminación de la vigencia.
numero_socio	BIGINT	NOT NULL	Número correlativo del socio en la administración.
acciones_propiedad	BIGINT	NULLABLE	Cantidad de acciones en propiedad directa del socio.
acciones_uso	BIGINT	NULLABLE	Cantidad de acciones en derecho de uso.
tendencia_accionaria	VARCHAR(50)	NULLABLE	Descripción de la tenencia.
acciones_disponibles	BIGINT	NULLABLE	Saldo remanente de acciones para asignación.
serie	VARCHAR(5)	NOT NULL	Identificador de la serie accionaria.
tipo_acciones	VARCHAR(25)	NOT NULL	Clasificación del tipo de acción permitida.
rancho_id	BIGINT	NULLABLE	Identificador del rancho vinculado a la explotación.
estatus	VARCHAR(10)	NOT NULL	Estado actual (ACTIVO o INACTIVO).
relacion	VARCHAR(25)	NOT NULL	Tipo de vínculo legal (ej. Accionista).
fecha_registro	TIMESTAMP	NOT NULL	Fecha administrativa de registro en plataforma.
empresa	VARCHAR	NULLABLE	Empresa corporativa vinculada al registro.

6.26. alp_ti_fh_document_definition

Columna	Tipo de Dato	Restricción	Descripción
id	DECIMAL	PK, NOT NULL	Identificador de la definición de documento.
description	VARCHAR	NULLABLE	Descripción del uso del documento.
path_template	VARCHAR	NULLABLE	Ruta física o URI del template de origen.
type_code	VARCHAR	NULLABLE	Código interno del tipo de documento.
active	BOOLEAN	NULLABLE	Bandera de estado activo.

6.27. cat_cp

Columna	Tipo de Dato	Restricción	Descripción
id	BIGSERIAL	PK, NOT NULL	Identificador único del CP.
codigo_postal	VARCHAR(15)	NULLABLE	Código postal numérico.
colonia	VARCHAR(100)	NULLABLE	Asentamiento o colonia correspondiente.
delegacion_municipio	VARCHAR(200)	NULLABLE	Nombre de la delegación o municipio.
ciudad	VARCHAR(100)	NULLABLE	Ciudad a la que pertenece.
estado	VARCHAR(100)	NULLABLE	Estado o entidad federativa.
pais	VARCHAR(50)	NULLABLE	País al que pertenece el CP.

6.28. cat_saac_reportes

Columna	Tipo de Dato	Restricción	Descripción
id	INTEGER	PK, NOT NULL	Identificador del catálogo de reporte.
NOMBRE LISTA VALORES	VARCHAR(255)	NULLABLE	Categoría o grupo al que pertenece el valor.
VALOR VISIBLE	VARCHAR(255)	NULLABLE	Etiqueta visible en la interfaz para el usuario.
DESCRIPCION	VARCHAR(255)	NULLABLE	Detalle o propósito de este reporte.
activo	BOOLEAN	NULLABLE	Indica si está disponible para generarse.
VALORES	VARCHAR(255)	NULLABLE	Valores o parámetros de configuración internos.
ROLES	VARCHAR(255)	NULLABLE	Roles de seguridad que tienen permiso a este reporte.

6.29. crm_saac_catalogs

Columna	Tipo de Dato	Restricción	Descripción
id	BIGSERIAL	PK, NOT NULL	Identificador del catálogo de valores.
nombre_lista_valores	VARCHAR	NULLABLE	Nombre técnico del grupo de datos.
valor_visible	VARCHAR	NULLABLE	Texto descriptivo mostrado al usuario en UI.
descripcion	VARCHAR	NULLABLE	Explicación detallada del valor.
activo	BOOLEAN	NULLABLE	Indica si el valor es seleccionable actualmente.
valores	VARCHAR	NULLABLE	Código interno o valor técnico relacionado.

6.30. operation_tbl

Columna	Tipo de Dato	Restricción	Descripción
id	BIGSERIAL	PK, NOT NULL	ID único de la operación.
description	VARCHAR(255)	NULLABLE	Descripción de la operación realizada.
operation	JSONB	NULLABLE	Carga útil o detalle en formato JSON.
template_id	BIGINT	NULLABLE	ID del template relacionado a la operación.
tx_template_param	VARCHAR(100)	NULLABLE	Parámetros de transacción para el template.
dn_parameter_type	INTEGER	NULLABLE	Tipo de parámetro asociado a la operación.

6.31. report_tbl

Columna	Tipo de Dato	Restricción	Descripción
id	BIGSERIAL	PK, autoincrementable	Identificador interno único para el reporte.
rkey	VARCHAR	NULL	Identificador de negocio o clave única funcional.
name	VARCHAR	NULL	Nombre descriptivo del reporte generado.
template_id	BIGINT	NULL	Referencia a la plantilla utilizada para el reporte.

6.32. template_tbl

Columna	Tipo de Dato	Restricción	Descripción
id	BIGSERIAL	PK, NOT NULL	Identificador principal y único del template.
tkey	VARCHAR(255)	NULLABLE	Clave técnica o identificador único del template.
name	VARCHAR(255)	NULLABLE	Nombre descriptivo del template.
description	VARCHAR(255)	NULLABLE	Descripción detallada sobre el propósito o uso.
content	TEXT	NULLABLE	Contenido, cuerpo o estructura del template (HTML/Texto).

---

7. Decisiones Arquitectónicas y Justificación

[Explicar de manera clara las decisiones de arquitectura de los principales componentes utilizados]

---

8. Consideraciones de seguridad y escalabilidad

[Se deberá indicar el número de transacciones soportadas por cada uno de los componentes así como las réplicas requeridas en ambientes productivos]

[Agregar los aspectos de seguridad]

Escalabilidad horizontal: La arquitectura basada en microservicios debe permitir escalar dinámicamente instancias de API o bases de datos según demanda.

Arquitectura modular: Los componentes deben estar desacoplados para facilitar el mantenimiento y la escalabilidad.

---

9. Requerimientos no funcionales

[Listar y explicar los requerimientos no funcionales a considerar en la arquitectura]

(Ver sección 3.2 para la tabla completa de características no funcionales)

---

10. Lineamientos y Estandares de Codificación

Un estándar de codificación completo comprende todos los aspectos de la generación de código. Si bien los programadores deben implementar un estándar de forma prudente, éste debe tender siempre a lo práctico. Un código fuente completo debe reflejar un estilo armonioso, como si un único programador hubiera escrito todo el código de una sola vez.

El estándar busca asegurarse de que todos los programadores del proyecto trabajen de forma coordinada.

[Incluir el estándar de codificación utilizado actualmente]

10.2. Lineamientos Tecnológicos

A continuación, se presentan los estándares y componentes considerados dentro del desarrollo. Si existiera alguna excepción o desviación en implementación forzada por la tecnología deberá ser informado para su aprobación.

[Pendiente por realizar definición]

---

Fin del documento

Pág. 15