Mayor Analitico - Modos de Operacion

Modulo: Contabilidad Tipo: Process Estado: Implementado Fecha: 2026-01-02

Referencia Arquitectural: Este documento implementa el patron de consolidacion multi-schema. Para contexto general, consultar:
/docs/architecture/consolidacion-informes-multi-schema.md
/docs/features/contabilidad/consolidacion-informes-contables.md
/docs/features/contabilidad/balance-comprobacion-modos-process.md (patron de referencia)

Descripcion General

Proposito

El Mayor Analitico es un informe contable detallado que muestra movimiento por movimiento de las cuentas contables seleccionadas. Este informe debe soportar tres modos de operacion que permiten al usuario seleccionar el origen de los datos contables a consultar. Estos modos determinan si el informe muestra datos de prueba, datos oficiales, o una vista consolidada de ambos.

A diferencia del Balance de Comprobacion que presenta saldos agregados, el Mayor Analitico ofrece un desglose linea por linea de cada transaccion, incluyendo: Fecha, Numero de Asiento, Detalle, Importe al Debe, Importe al Haber, y Saldo Progresivo acumulado.

Problema de Negocio

Actualmente el Mayor Analitico opera unicamente con datos oficiales. Las organizaciones necesitan:

Simular escenarios contables antes de oficializarlos (modo prueba) - ver el impacto detallado de cada asiento propuesto en cuentas especificas
Generar reportes oficiales para auditoria y analisis de movimientos (modo oficial)
Obtener una vision completa que incluya tanto movimientos oficiales como proyecciones en prueba, ordenados cronologicamente (modo consolidado)

Valor de Negocio

Planificacion financiera detallada: Permite simular asientos y ver su impacto linea por linea antes de oficializarlos, identificando exactamente como afecta cada movimiento el saldo de una cuenta
Cumplimiento normativo: Separacion clara entre datos oficiales y proyecciones para auditorias
Toma de decisiones informada: Vision completa del estado de cada cuenta incluyendo operaciones pendientes de oficializacion
Auditoria y trazabilidad: Capacidad de revisar cada movimiento individual y su origen temporal
Reconciliacion contable: Facilita la identificacion de discrepancias al analizar movimiento por movimiento

Modos de Operacion

Modo 0: Solo Prueba

Descripcion: El informe muestra exclusivamente los movimientos contables registrados en el ambiente de prueba, ordenados cronologicamente dentro de cada cuenta.

Casos de Uso:

Simular el impacto detallado de asientos contables antes de oficializarlos
Verificar como cada movimiento propuesto afecta el saldo progresivo de una cuenta
Evaluar proyecciones financieras movimiento por movimiento
Capacitacion de personal sin afectar datos oficiales
Pruebas de ajustes contables antes del cierre de ejercicio

Datos Incluidos:

Movimientos contables del ambiente de prueba ordenados por fecha y numero de asiento
Saldo anterior calculado desde el ambiente de prueba (movimientos previos al periodo consultado)
Saldo progresivo calculado solo con movimientos de prueba

Datos Excluidos:

Movimientos contables oficiales
Saldos del ambiente oficial

Comportamiento Esperado:

El informe utiliza el titulo estandar "MAYOR ANALITICO" (sin indicacion especial de modo)
Cada linea muestra: Fecha, Nro. Asiento, Detalle, Debe, Haber, Saldo
El saldo inicial (anterior) corresponde al acumulado de prueba hasta la fecha de inicio - 1
El saldo progresivo se recalcula con cada movimiento

Modo 1: Solo Oficial

Descripcion: El informe muestra exclusivamente los movimientos contables oficiales de la organizacion, ordenados cronologicamente. Este es el modo por defecto y el utilizado para reportes formales.

Casos de Uso:

Auditoria de cuentas contables especificas
Analisis de movimientos historicos reales
Reconciliacion bancaria contra extractos oficiales
Verificacion de asientos contables registrados
Reportes para auditores externos
Cumplimiento de obligaciones fiscales

Datos Incluidos:

Movimientos contables oficiales ordenados por fecha y numero de asiento
Saldo anterior oficial (acumulado hasta fecha de inicio - 1)
Saldo progresivo oficial

Datos Excluidos:

Movimientos contables de prueba
Proyecciones o simulaciones

Comportamiento Esperado:

El informe utiliza el titulo estandar "MAYOR ANALITICO" (sin indicacion especial, es el modo por defecto)
Los movimientos reflejan la situacion contable real de la organizacion
Cumple con requisitos de presentacion formal para auditoria

Modo 2: Consolidado (Oficial + Prueba)

Descripcion: El informe combina los movimientos contables de ambos ambientes (oficial y prueba), proporcionando una vision completa del estado de cada cuenta con todos los movimientos ordenados cronologicamente.

Casos de Uso:

Visualizar el impacto total incluyendo operaciones pendientes de oficializar
Analisis de escenarios "what-if" sobre el historial de una cuenta
Revision previa a cierre de periodo incluyendo ajustes propuestos
Verificar como quedaria una cuenta si se oficializan todos los movimientos pendientes
Planificacion detallada considerando compromisos en prueba

Datos Incluidos:

Movimientos contables oficiales
Movimientos contables de prueba
Ambos tipos mezclados y ordenados cronologicamente (por fecha y numero de asiento)
Saldo anterior consolidado (oficial + prueba hasta fecha inicio - 1)
Saldo progresivo consolidado

Comportamiento Esperado:

El informe indica claramente "MAYOR ANALITICO - CONSOLIDADO" en el titulo
Los movimientos de ambos ambientes se intercalan cronologicamente
El saldo progresivo refleja el acumulado de ambos ambientes
El usuario puede identificar que la informacion incluye datos de prueba mediante la indicacion en el titulo
No se distingue visualmente el origen (oficial vs prueba) de cada movimiento individual

Reglas de Negocio

RN-MAM-001: Fuente de Datos Maestros

Descripcion: La informacion de cuentas contables (codigo, nombre, tipo, nivel) siempre se obtiene del ambiente oficial, independientemente del modo seleccionado.

Justificacion: El plan de cuentas es unico para la organizacion y reside en el nivel empresa. No existe plan de cuentas separado por ambiente.

Comportamiento:

En modo 0 (prueba): Las cuentas se obtienen del maestro oficial
En modo 1 (oficial): Las cuentas se obtienen del maestro oficial
En modo 2 (consolidado): Las cuentas se obtienen del maestro oficial

RN-MAM-002: Calculo de Saldos Anteriores por Modo

Descripcion: El saldo anterior (saldo inicial) de cada cuenta se calcula segun el modo de operacion, considerando todos los movimientos previos a la fecha de inicio del periodo consultado.

Comportamiento:

Modo 0: Saldo anterior = Acumulado de movimientos de prueba hasta fecha inicio - 1
Modo 1: Saldo anterior = Acumulado de movimientos oficiales hasta fecha inicio - 1
Modo 2: Saldo anterior = Acumulado oficial + Acumulado prueba hasta fecha inicio - 1

Validacion: El saldo anterior debe mostrarse claramente como primera linea del mayor de cada cuenta.

RN-MAM-003: Ordenamiento de Movimientos del Periodo

Descripcion: Los movimientos del periodo se ordenan cronologicamente dentro de cada cuenta consultada.

Comportamiento:

Modo 0: Movimientos de prueba ordenados por fecha, luego por numero de asiento
Modo 1: Movimientos oficiales ordenados por fecha, luego por numero de asiento
Modo 2: Movimientos de ambos ambientes mezclados y ordenados por fecha, luego por numero de asiento

Nota: En modo consolidado, cuando un movimiento oficial y uno de prueba tienen la misma fecha y numero de asiento, el orden entre ellos no es determinante para el calculo del saldo final.

RN-MAM-004: Integridad del Saldo Progresivo

Descripcion: El saldo progresivo debe calcularse correctamente para cada linea del mayor, reflejando el acumulado hasta ese movimiento.

Validacion:

Saldo linea N = Saldo linea N-1 + Debe linea N - Haber linea N
Saldo final de cuenta = Saldo anterior + Suma(Debe periodo) - Suma(Haber periodo)

Comportamiento:

Cada movimiento muestra el saldo acumulado hasta ese punto
El saldo final debe coincidir con el calculo: saldo anterior + movimientos del periodo
Si hay inconsistencia, el sistema debe alertar al usuario

RN-MAM-005: Ejercicio Contable Compartido

Descripcion: El ejercicio contable seleccionado aplica por igual a ambos ambientes (oficial y prueba).

Justificacion: Los ejercicios contables residen en el nivel empresa y son compartidos por toda la organizacion.

Comportamiento:

El filtro de ejercicio aplica tanto a consultas oficiales como de prueba
No es posible consultar diferentes ejercicios por ambiente en el modo consolidado
El rango de fechas debe estar dentro del ejercicio seleccionado

RN-MAM-006: Cuentas sin Movimientos en el Periodo

Descripcion: Las cuentas que no tienen movimientos en el periodo seleccionado pueden mostrarse u ocultarse segun la configuracion del usuario.

Comportamiento por Modo:

Una cuenta puede tener movimientos en oficial pero no en prueba (o viceversa)
En modo consolidado, la cuenta aparece si tiene movimientos en al menos uno de los ambientes
Si una cuenta tiene saldo anterior pero no movimientos en el periodo, puede mostrarse solo el saldo anterior segun configuracion
El rango de cuentas consultado determina que cuentas se incluyen en el informe

RN-MAM-007: Detalle de Movimientos

Descripcion: Cada movimiento debe mostrar informacion suficiente para su identificacion y trazabilidad.

Comportamiento:

Cada linea incluye: Fecha, Numero de Asiento, Detalle/Concepto, Debe, Haber, Saldo
El detalle proviene del concepto del asiento contable
Los importes se muestran con el formato numerico configurado en el sistema
El saldo se muestra con signo segun corresponda (Deudor positivo o Acreedor negativo, o viceversa segun configuracion)

RN-MAM-008: Identificacion de Sucursal en Consolidacion Multi-Schema

Descripcion: Cuando el informe consolida datos de multiples sucursales/schemas mediante consolidacion multi-schema, cada movimiento debe identificar claramente su sucursal de origen.

Importante: Esta regla aplica exclusivamente para consolidacion multi-schema, NO para consolidacion de modos (modo 0, 1 o 2). Son dos tipos de consolidacion independientes que pueden coexistir:

Consolidacion Multi-Schema: Combina datos de multiples schemas/sucursales (suc0001, suc0002, etc.) dentro de la misma base de datos
Consolidacion de Modos: Combina datos de dos bases de datos PostgreSQL separadas (base oficial + base de prueba con sufijo _p)

Condicion de Aplicacion:

Se activa solo cuando:
- La consolidacion multi-schema esta activa (se solicito consolidar multiples sucursales/schemas)
Y ademas:
- Hay mas de una sucursal/schema con datos en el periodo consultado

NO se activa cuando:

Solo hay consolidacion de modos (modo 2: oficial + prueba) sin consolidacion multi-schema
Solo hay una sucursal/schema con datos
No hay consolidacion multi-schema activa

Comportamiento:

Se agrega una columna adicional llamada "Sucursal" antes de las columnas de datos numericos
El formato de la columna debe ser: "Sucursal N" donde N es el numero de sucursal extraido del schema
Ejemplos de formato:
- Schema suc0001 → "Sucursal 1"
- Schema suc0001caja0001 → "Sucursal 1"
- Schema suc0010 → "Sucursal 10"
Si solo hay una sucursal con datos, la columna NO se muestra (no aporta valor)
Si no hay consolidacion multi-schema activa, la columna NO se muestra

Estructura con Columna de Sucursal:

Orden de las Columnas:

Sucursal (solo si aplica segun condiciones)
Fecha
Nro. Asiento
Detalle
Debe
Haber
Saldo

Entidades Involucradas

Cuentas Contables

Ubicacion: Nivel Empresa (datos maestros compartidos)

Atributos Relevantes:

Codigo de cuenta
Descripcion/Nombre
Tipo de cuenta (Activo, Pasivo, Patrimonio, Resultado)
Nivel jerarquico (Rubro, Subrubro, Cuenta imputable)
Indicador de cuenta imputable (admite movimientos directos)

Rol en el Informe: Define la estructura y el rango de cuentas a consultar. El mayor solo se genera para cuentas imputables o el rango especificado.

Movimientos Contables (Tabla `items`)

Ubicacion: Nivel Sucursal o Caja (segun configuracion), en base de datos oficial o de prueba

Tabla de Base de Datos: items

Atributos Relevantes:

cuenta: Numero de cuenta contable afectada
importe: Monto del movimiento
es: Tipo de movimiento ('D' = Debe, 'H' = Haber)
fecha: Fecha del movimiento
nroasi: Numero de asiento contable
comen, comen1: Detalle/Concepto del movimiento (lineas 1 y 2)
ejercicio: Ejercicio contable
nroimp: Numero de imputacion operativa (para variante operativas)

Bases de Datos Segun Modo:

Modo 0 (Prueba): Consulta tabla items en base de datos de prueba (nombre con sufijo _p)
Modo 1 (Oficial): Consulta tabla items en base de datos oficial (sin sufijo)
Modo 2 (Consolidado): Consulta tabla items en AMBAS bases de datos (oficial + prueba) y combina los resultados cronologicamente

Importante: Los modos NO combinan datos "dentro de la misma sucursal". Los modos utilizan dos bases de datos PostgreSQL completamente separadas: una oficial (produccion) y una de prueba (con sufijo _p en el nombre). El modo 2 combina datos de ambas bases de datos.

Rol en el Informe: Son los datos transaccionales que componen cada linea del mayor. El modo seleccionado determina de que base(s) de datos se obtienen los movimientos.

Ejercicios Contables

Ubicacion: Nivel Empresa (datos maestros compartidos)

Atributos Relevantes:

Periodo (identificador del ejercicio)
Estado (Abierto, Cerrado)
Fecha inicio
Fecha fin

Rol en el Informe: Define el contexto temporal del informe y limita las fechas disponibles para consulta.

Flujo de Usuario

Generacion del Informe por Modo

1. Usuario accede a "Informes > Mayor Analitico"

2. Usuario selecciona parametros:
   - Ejercicio contable
   - Rango de fechas (dentro del ejercicio)
   - Rango de cuentas (codigo desde - codigo hasta)
   - Modo de operacion: Prueba | Oficial | Consolidado
   - Opciones adicionales:
     - Variante: Estandar u Operativas (cuentas imputables)
     - Incluir cuentas sin movimientos: Si | No
     - Formato de salida: Pantalla | PDF | Excel

3. Sistema valida parametros:
   - Ejercicio existe y es valido
   - Rango de fechas es valido dentro del ejercicio
   - Rango de cuentas existe en el plan de cuentas
   - Usuario tiene permisos para el modo seleccionado

4. Sistema genera el informe:
   a) Obtiene estructura de cuentas del rango solicitado (siempre desde maestro oficial)
   b) Para cada cuenta en el rango:
      - Segun modo seleccionado:
        - Modo 0: Consulta movimientos de prueba
        - Modo 1: Consulta movimientos oficiales
        - Modo 2: Consulta ambos y consolida
      - Calcula saldo anterior segun modo
      - Ordena movimientos cronologicamente
      - Calcula saldo progresivo para cada movimiento
   c) Genera la presentacion del mayor por cuenta

5. Sistema presenta resultados:
   - Indica modo de operacion en encabezado (solo "- CONSOLIDADO" si aplica)
   - Para cada cuenta:
     - Muestra codigo y nombre de cuenta
     - Muestra saldo anterior
     - Lista movimientos con: Fecha, Nro. Asiento, Detalle, Debe, Haber, Saldo
     - Muestra totales: Suma Debe, Suma Haber, Saldo Final
   - Permite exportar a PDF o Excel

Consideraciones Especiales

Ambiente de Prueba

Arquitectura de Base de Datos:

Es una base de datos PostgreSQL completamente separada de la base oficial
El nombre de la base de prueba tiene sufijo _p (ejemplo: database_oficial_p)
Contiene la misma estructura de schemas y tablas que la base oficial
Los schemas de sucursales tienen los mismos nombres (suc0001, suc0002, etc.)
La tabla items existe en ambas bases de datos con la misma estructura

Caracteristicas de Datos:

Contiene datos transaccionales de prueba en la tabla items
Los datos maestros (cuentas, ejercicios) se leen siempre de la base oficial, no de la base de prueba
Los movimientos de prueba no afectan reportes en modo oficial
Puede contener asientos sin oficializar, simulaciones o proyecciones

Implicacion para el Mayor Analitico:

Modo 0 (Prueba): Se conecta a la base de prueba (_p) y consulta tabla items
Modo 1 (Oficial): Se conecta a la base oficial y consulta tabla items
Modo 2 (Consolidado): Se conecta a AMBAS bases de datos, consulta items en cada una y combina los resultados
Al consultar datos de prueba, la estructura de cuentas siempre proviene de la base oficial
La relacion entre movimiento y cuenta se establece mediante el campo cuenta en la tabla items
Los movimientos de prueba se muestran con el mismo formato que los oficiales

Consolidacion de Datos

Proceso de Consolidacion (Modo 2):

Consulta de movimientos oficiales para el rango de cuentas y fechas
Consulta de movimientos de prueba para el rango de cuentas y fechas
Combinacion de resultados por cuenta:
- Los movimientos se mezclan cronologicamente
- Se ordenan por fecha, luego por numero de asiento
Recalculo de saldos progresivos consolidados
Calculo de totales consolidados por cuenta

Ordenamiento en Consolidado:

Los movimientos se intercalan segun fecha y numero de asiento
No se distingue visualmente el origen (oficial vs prueba) en el mayor final
El saldo progresivo refleja el acumulado de ambos ambientes

Validaciones por Modo

Validacion	Modo 0	Modo 1	Modo 2
Ejercicio existe	Si	Si	Si
Rango fechas valido	Si	Si	Si
Rango cuentas existe	Si	Si	Si
Existen movimientos	En prueba	En oficial	En alguno
Integridad saldo progresivo	Si	Si	Si

Variante Operativas (Cuentas Imputables)

El Mayor Analitico puede generarse en dos variantes:

Estandar: Incluye todas las cuentas del rango especificado
Operativas: Solo incluye cuentas imputables (que admiten movimientos directos)

Ambas variantes soportan los tres modos de operacion de manera identica.

Casos de Uso

UC-MAM-001: Generar Mayor Oficial para Auditoria de Cuenta

Actor: Contador

Precondiciones:

Usuario tiene permiso de informes contables
Existe ejercicio contable con movimientos oficiales
La cuenta a auditar tiene movimientos en el periodo

Flujo:

Usuario selecciona ejercicio y rango de fechas
Usuario especifica la cuenta o rango de cuentas a auditar
Usuario selecciona Modo 1 (Oficial)
Sistema genera mayor con todos los movimientos oficiales
Usuario revisa cada movimiento, verificando fecha, asiento y detalle
Usuario exporta a PDF para anexar a documentacion de auditoria

Postcondiciones:

Mayor refleja todos los movimientos oficiales de la cuenta
Documento apto para presentacion formal a auditores
Saldo final coincide con el saldo en Balance de Comprobacion

UC-MAM-002: Simular Impacto Detallado de Asientos Propuestos

Actor: Analista Contable

Precondiciones:

Usuario tiene permisos de informes contables
Existen asientos en ambiente de prueba
Se conocen las cuentas afectadas por los asientos propuestos

Flujo:

Usuario selecciona ejercicio y periodo de interes
Usuario especifica las cuentas afectadas por los asientos de prueba
Usuario selecciona Modo 0 (Prueba)
Sistema genera mayor con movimientos de prueba
Usuario analiza linea por linea el impacto de cada asiento propuesto
Usuario verifica el saldo progresivo en cada paso
Usuario decide si los asientos estan correctos para oficializar

Postcondiciones:

Usuario tiene visibilidad detallada del impacto de cambios propuestos
Datos oficiales no fueron afectados
Usuario puede identificar errores antes de oficializar

UC-MAM-003: Revisar Estado Completo de Cuenta con Proyecciones

Actor: Gerente Financiero

Precondiciones:

Usuario tiene permisos de informes contables
Existen movimientos en ambos ambientes para la cuenta de interes

Flujo:

Usuario selecciona ejercicio y rango de fechas
Usuario especifica la cuenta de interes (ej: Bancos, Caja)
Usuario selecciona Modo 2 (Consolidado)
Sistema genera mayor combinando movimientos oficiales y de prueba
Usuario visualiza cronologicamente todos los movimientos
Usuario identifica el saldo proyectado incluyendo operaciones pendientes
Usuario toma decisiones considerando el panorama completo

Postcondiciones:

Usuario tiene vision completa de la cuenta incluyendo proyecciones
Puede identificar que la informacion incluye datos no oficiales
Saldo final muestra la proyeccion consolidada

UC-MAM-004: Comparar Movimientos Oficiales vs Proyectados de una Cuenta

Actor: Contador Senior

Precondiciones:

Usuario tiene todos los permisos requeridos
Existen movimientos en ambos ambientes para la cuenta

Flujo:

Usuario genera mayor en Modo 1 (Oficial) para la cuenta de interes
Usuario anota el saldo final oficial y cuenta los movimientos
Usuario genera mayor en Modo 2 (Consolidado) para la misma cuenta
Usuario compara:
- Cantidad de movimientos adicionales (provenientes de prueba)
- Diferencia en el saldo final
- Fechas y detalles de los movimientos de prueba
Usuario identifica el impacto de operaciones pendientes
Usuario prioriza oficializacion de asientos criticos

Postcondiciones:

Usuario conoce la diferencia entre estado actual y proyectado de la cuenta
Puede identificar cada movimiento pendiente de oficializar
Tiene informacion para decidir prioridades de oficializacion

Criterios de Aceptacion

Funcionales

[ ] AC-MAM-001: El usuario puede seleccionar entre tres modos de operacion: Prueba, Oficial, Consolidado
[ ] AC-MAM-002: En modo Prueba, el mayor muestra exclusivamente movimientos del ambiente de prueba
[ ] AC-MAM-003: En modo Oficial, el mayor muestra exclusivamente movimientos del ambiente oficial
[ ] AC-MAM-004: En modo Consolidado, el mayor muestra los movimientos de ambos ambientes mezclados cronologicamente
[ ] AC-MAM-005: La estructura de cuentas es obtenida del maestro oficial en los tres modos
[ ] AC-MAM-006: El saldo anterior se calcula correctamente segun el modo seleccionado
[ ] AC-MAM-007: El encabezado del informe indica claramente el modo de operacion (solo en modo Consolidado se muestra "- CONSOLIDADO" en el titulo)
[ ] AC-MAM-008: El saldo progresivo se calcula correctamente para cada movimiento
[ ] AC-MAM-009: Usuario sin permiso de ambiente de prueba solo puede generar modo Oficial
[ ] AC-MAM-010: El saldo final de cada cuenta coincide con: saldo anterior + suma(debe) - suma(haber)

De Presentacion

[ ] AC-MAM-011: Cada movimiento muestra: Fecha, Nro. Asiento, Detalle, Debe, Haber, Saldo progresivo
[ ] AC-MAM-012: El modo seleccionado se muestra visualmente en el informe generado (aplica solo a modo Consolidado)
[ ] AC-MAM-013: La exportacion a Excel incluye indicacion del modo de operacion
[ ] AC-MAM-014: La exportacion a PDF incluye indicacion del modo de operacion
[ ] AC-MAM-015: Los movimientos aparecen ordenados cronologicamente (fecha, luego numero de asiento)
[ ] AC-MAM-016: Cuando hay consolidacion multi-schema activa con mas de una sucursal, se muestra columna "Sucursal"
[ ] AC-MAM-017: La columna "Sucursal" muestra formato "Sucursal N" donde N es el numero de sucursal extraido del schema (ej: suc0001 → "Sucursal 1")
[ ] AC-MAM-018: La columna "Sucursal" aparece entre "Nro. Asiento" y "Detalle"
[ ] AC-MAM-019: Cuando solo hay una sucursal con datos, la columna "Sucursal" NO se muestra
[ ] AC-MAM-020: Cuando no hay consolidacion activa, la columna "Sucursal" NO se muestra

De Integridad

[ ] AC-MAM-021: Si no existen movimientos en el modo seleccionado, el sistema informa al usuario
[ ] AC-MAM-022: Los datos oficiales nunca se mezclan con datos de prueba excepto en modo Consolidado
[ ] AC-MAM-023: El cambio de modo no afecta los datos almacenados, solo la consulta
[ ] AC-MAM-024: El saldo progresivo mantiene consistencia matematica en todos los movimientos

Dependencias

Funcionalidades Relacionadas

Sistema de ejercicios contables
Plan de cuentas contables
Registro de asientos contables
Balance de Comprobacion con modos (balance-comprobacion-modos-process.md)
Consolidacion multi-schema (consolidacion-informes-contables.md)

Integraciones

Modulo de Seguridad: verificacion de permisos por modo
Sistema de ambientes (oficial/prueba): determinacion de fuente de datos
Sistema de exportacion: generacion de PDF y Excel

Consolidacion Multi-Schema

Estado: Implementado

El Mayor Analitico deberia soportar consolidacion multi-schema ademas de la consolidacion de modos, siguiendo el mismo patron del Balance de Comprobacion.

Combinacion de Consolidaciones

El informe podra consolidar en dos dimensiones independientes:

Consolidacion de Modos (Oficial/Prueba):
- Modo 0: Solo datos de prueba
- Modo 1: Solo datos oficiales
- Modo 2: Oficial + Prueba
Consolidacion Multi-Schema (Sucursales):
- Sin consolidacion: Solo sucursal actual
- Con consolidacion: Todas las sucursales de la organizacion

Matriz de Consolidacion

Modo	Consolidacion Multi-Schema	Resultado
0	No	Movimientos de prueba de la sucursal actual
0	Si	Movimientos de prueba de todas las sucursales
1	No	Movimientos oficiales de la sucursal actual
1	Si	Movimientos oficiales de todas las sucursales
2	No	Movimientos oficial+prueba de la sucursal actual
2	Si	Movimientos oficial+prueba de todas las sucursales

Columna de Identificacion de Sucursal

Importante - Diferencia entre Consolidaciones:

El sistema soporta DOS tipos de consolidacion INDEPENDIENTES que pueden coexistir:

Consolidacion de Modos (RN-MAM-001 a RN-MAM-007):
- Combina datos de dos bases de datos PostgreSQL separadas: oficial (produccion) y prueba (con sufijo _p)
- La base oficial es la de produccion (ej: database_oficial)
- La base de prueba tiene sufijo _p (ej: database_oficial_p)
- Modo 2 consulta tabla items en AMBAS bases de datos y combina los resultados
- NO agrega columna de sucursal
- Ejemplo: Modo 2 combina datos de database_oficial.suc0001.items + database_oficial_p.suc0001.items
Consolidacion Multi-Schema (RN-MAM-008):
- Combina datos de multiples schemas dentro de la misma base de datos (suc0001, suc0002, etc.)
- Consulta la tabla items en cada schema de sucursal
- SI agrega columna de sucursal
- Ejemplo: Consolida database.suc0001.items + database.suc0002.items + database.suc0003.items

Cuando se Muestra la Columna "Sucursal":

Siguiendo la regla RN-MAM-008, la columna "Sucursal" se agrega automaticamente SOLO cuando:

Hay consolidacion multi-schema activa (se solicito consolidar multiples sucursales/schemas)
Y hay mas de una sucursal con datos en el periodo consultado

NO se muestra la columna cuando:

Solo hay consolidacion de modos (modo 2) sin consolidacion multi-schema
Solo hay una sucursal con datos
No hay consolidacion multi-schema activa

Formato de la Columna:

Ubicacion: Entre "Nro. Asiento" y "Detalle"
Nombre: "Sucursal"
Formato del Valor: "Sucursal N" donde N es el numero extraido del schema
Ejemplos:
- Schema suc0001 → Muestra "Sucursal 1"
- Schema suc0001caja0001 → Muestra "Sucursal 1"
- Schema suc0010 → Muestra "Sucursal 10"

Utilidad:

Permite al usuario identificar el origen de cada movimiento
Facilita auditoria y trazabilidad en reportes consolidados
Esencial para reconciliacion cuando hay movimientos de multiples sucursales

Ejemplos de Consolidacion:

Ejemplo 1: Solo consolidacion de modos (modo 2) - SIN columna de sucursal

MAYOR ANALITICO - CONSOLIDADO
Cuenta: 1101 - Caja
Sucursal: 0001

Fecha       Nro. Asiento  Detalle                 Debe      Haber     Saldo
----------  ------------  ---------------------  --------  --------  --------
01/01/2026  SALDO ANTERIOR                                           10.000,00
05/01/2026  ASI-001       Cobro cliente (OFIC)    5.000,00            15.000,00
07/01/2026  ASI-P15       Cobro proyectado (PRUE) 3.000,00            18.000,00
----------  ------------  ---------------------  --------  --------  --------
TOTALES                                           8.000,00  0,00
SALDO FINAL                                                          18.000,00

Ejemplo 2: Consolidacion multi-schema - CON columna de sucursal

MAYOR ANALITICO - CONSOLIDADO
Cuenta: 1101 - Caja
Consolidado: Todas las sucursales

Fecha       Nro. Asiento  Sucursal     Detalle              Debe      Haber     Saldo
----------  ------------  -----------  ------------------  --------  --------  --------
01/01/2026  SALDO ANTERIOR                                                      10.000,00
05/01/2026  ASI-001       Sucursal 1   Cobro a cliente      5.000,00            15.000,00
07/01/2026  ASI-015       Sucursal 2   Cobro a cliente      3.000,00            18.000,00
10/01/2026  ASI-025       Sucursal 1   Pago a proveedor                2.000,00 16.000,00
----------  ------------  -----------  ------------------  --------  --------  --------
TOTALES                                                      8.000,00  2.000,00
SALDO FINAL                                                                     16.000,00

Ejemplo 3: Ambos tipos de consolidacion - CON columna de sucursal

MAYOR ANALITICO - CONSOLIDADO
Cuenta: 1101 - Caja
Consolidado: Todas las sucursales (Oficial + Prueba)

Fecha       Nro. Asiento  Sucursal     Detalle              Debe      Haber     Saldo
----------  ------------  -----------  ------------------  --------  --------  --------
01/01/2026  SALDO ANTERIOR                                                      10.000,00
05/01/2026  ASI-001       Sucursal 1   Cobro cliente (OF)   5.000,00            15.000,00
05/01/2026  ASI-P05       Sucursal 1   Cobro proyecto (PR)  2.000,00            17.000,00
07/01/2026  ASI-015       Sucursal 2   Cobro cliente (OF)   3.000,00            20.000,00
10/01/2026  ASI-025       Sucursal 1   Pago proveedor (OF)             2.000,00 18.000,00
----------  ------------  -----------  ------------------  --------  --------  --------
TOTALES                                                     10.000,00  2.000,00
SALDO FINAL                                                                     18.000,00

Indicacion Visual

Cuando esta activa la consolidacion multi-schema o de modos, el titulo del informe muestra:

"MAYOR ANALITICO - CONSOLIDADO"

Para mas detalles sobre consolidacion multi-schema, consultar:

Riesgos y Mitigaciones

Riesgo	Impacto	Mitigacion
Usuario confunde datos de prueba con oficiales	Alto	Indicacion clara y prominente del modo en el titulo del informe
Datos de prueba incompletos generan saldos inconsistentes	Medio	Validacion de integridad del saldo progresivo y alerta al usuario
Performance degradada en modo consolidado con muchos movimientos	Medio	Optimizacion de consultas, paginacion si es necesario, feedback de progreso
Acceso no autorizado a datos de prueba	Alto	Validacion estricta de permisos antes de generar el informe
Ordenamiento incorrecto de movimientos en consolidado	Medio	Pruebas exhaustivas de ordenamiento cronologico
Gran volumen de movimientos dificulta la lectura	Bajo	Opciones de filtrado adicionales, exportacion a Excel para analisis

Historial de Cambios

Fecha	Version	Autor	Descripcion
2026-01-02	2.0	Sistema	IMPLEMENTACION COMPLETADA: Funcionalidad completamente implementada en el sistema de informes. Ambas variantes (estandar y operativas) ahora soportan los tres modos de operacion (0-Prueba, 1-Oficial, 2-Consolidado) y consolidacion multi-schema. La implementacion sigue el patron de separacion de responsabilidades establecido en Balance de Comprobacion (extraccion de datos separada de renderizado). Todas las reglas de negocio (RN-MAM-001 a RN-MAM-008) fueron implementadas segun especificacion. Todos los criterios de aceptacion (AC-MAM-001 a AC-MAM-024) pueden ser validados. Estado actualizado de "Planificado" a "Implementado".
2026-01-02	1.2	Sistema	Correcciones tecnicas basadas en implementacion real del Balance de Comprobacion: (1) Especificada tabla de base de datos `items` con campos exactos (`cuenta`, `importe`, `es`, `fecha`, `nroasi`, `comen`, `comen1`, `ejercicio`, `nroimp`). (2) Aclarado que los modos utilizan DOS BASES DE DATOS POSTGRESQL SEPARADAS: base oficial (produccion) y base de prueba (con sufijo `_p`), NO "datos dentro de la misma sucursal". (3) Modo 2 consulta tabla `items` en AMBAS bases de datos y combina resultados. (4) Actualizada seccion "Ambiente de Prueba" especificando arquitectura de bases de datos separadas con misma estructura de schemas. (5) Diferenciacion clara entre consolidacion de modos (bases de datos separadas) y consolidacion multi-schema (schemas separados dentro de misma base).
2026-01-02	1.1	Sistema	Agregada regla de negocio RN-MAM-008 para identificacion de sucursal en consolidacion multi-schema. Cuando se consolidan multiples sucursales/schemas, se agrega columna "Sucursal" con formato "Sucursal N". Aclarado que esta columna aplica SOLO para consolidacion multi-schema, NO para consolidacion de modos. Agregados ejemplos visuales mostrando diferencia entre: (1) solo consolidacion de modos sin columna, (2) solo consolidacion multi-schema con columna, y (3) ambos tipos de consolidacion con columna. Actualizados criterios de aceptacion AC-MAM-016 a AC-MAM-020 para validar comportamiento de columna de sucursal.
2026-01-02	1.0	Sistema	Creacion del documento de requerimientos para soporte de modos de operacion en Mayor Analitico, siguiendo el patron establecido en Balance de Comprobacion

Retenciones

Ganancias

Retenciones

Mayor Analitico - Modos de Operacion ​

Descripcion General ​

Proposito ​

Problema de Negocio ​

Valor de Negocio ​

Modos de Operacion ​

Modo 0: Solo Prueba ​

Modo 1: Solo Oficial ​

Modo 2: Consolidado (Oficial + Prueba) ​

Reglas de Negocio ​

RN-MAM-001: Fuente de Datos Maestros ​

RN-MAM-002: Calculo de Saldos Anteriores por Modo ​

RN-MAM-003: Ordenamiento de Movimientos del Periodo ​

RN-MAM-004: Integridad del Saldo Progresivo ​

RN-MAM-005: Ejercicio Contable Compartido ​

RN-MAM-006: Cuentas sin Movimientos en el Periodo ​

RN-MAM-007: Detalle de Movimientos ​

RN-MAM-008: Identificacion de Sucursal en Consolidacion Multi-Schema ​

Entidades Involucradas ​

Cuentas Contables ​

Movimientos Contables (Tabla items) ​

Ejercicios Contables ​

Flujo de Usuario ​

Generacion del Informe por Modo ​

Consideraciones Especiales ​

Ambiente de Prueba ​

Consolidacion de Datos ​

Validaciones por Modo ​

Variante Operativas (Cuentas Imputables) ​

Casos de Uso ​

UC-MAM-001: Generar Mayor Oficial para Auditoria de Cuenta ​

UC-MAM-002: Simular Impacto Detallado de Asientos Propuestos ​

UC-MAM-003: Revisar Estado Completo de Cuenta con Proyecciones ​

UC-MAM-004: Comparar Movimientos Oficiales vs Proyectados de una Cuenta ​

Criterios de Aceptacion ​

Funcionales ​

De Presentacion ​

De Integridad ​

Dependencias ​

Funcionalidades Relacionadas ​

Integraciones ​

Consolidacion Multi-Schema ​

Combinacion de Consolidaciones ​

Matriz de Consolidacion ​

Columna de Identificacion de Sucursal ​

Indicacion Visual ​

Riesgos y Mitigaciones ​

Historial de Cambios ​

Mayor Analitico - Modos de Operacion

Descripcion General

Proposito

Problema de Negocio

Valor de Negocio

Modos de Operacion

Modo 0: Solo Prueba

Modo 1: Solo Oficial

Modo 2: Consolidado (Oficial + Prueba)

Reglas de Negocio

RN-MAM-001: Fuente de Datos Maestros

RN-MAM-002: Calculo de Saldos Anteriores por Modo

RN-MAM-003: Ordenamiento de Movimientos del Periodo

RN-MAM-004: Integridad del Saldo Progresivo

RN-MAM-005: Ejercicio Contable Compartido

RN-MAM-006: Cuentas sin Movimientos en el Periodo

RN-MAM-007: Detalle de Movimientos

RN-MAM-008: Identificacion de Sucursal en Consolidacion Multi-Schema

Entidades Involucradas

Cuentas Contables

Movimientos Contables (Tabla `items`)

Ejercicios Contables

Flujo de Usuario

Generacion del Informe por Modo

Consideraciones Especiales

Ambiente de Prueba

Consolidacion de Datos

Validaciones por Modo

Variante Operativas (Cuentas Imputables)

Casos de Uso

UC-MAM-001: Generar Mayor Oficial para Auditoria de Cuenta

UC-MAM-002: Simular Impacto Detallado de Asientos Propuestos

UC-MAM-003: Revisar Estado Completo de Cuenta con Proyecciones

UC-MAM-004: Comparar Movimientos Oficiales vs Proyectados de una Cuenta

Criterios de Aceptacion

Funcionales

De Presentacion

De Integridad

Dependencias

Funcionalidades Relacionadas

Integraciones

Consolidacion Multi-Schema

Combinacion de Consolidaciones

Matriz de Consolidacion

Columna de Identificacion de Sucursal

Indicacion Visual

Riesgos y Mitigaciones

Historial de Cambios