Morella v1

Este repositorio corresponde a la versión 1 de Morella, un sistema de gestión desarrollado para una empresa de Rosario (Argentina), la cual se dedica a la administración de panteones sociales.

Módulos

El sistema consiste de 6 módulos:

Caja (caja.py):

Módulo destinado al registro de ingresos y egresos en la caja diaria y su impresión. También ofrece la impresión de la caja mensual de forma detallada, comprimida o dividida por cobradores.

Cuentas (cuentas.py):

Módulo destinado a la búsqueda de los estados de cuenta de los asociados y que permite generar un reporte con el estado de cuenta deseado.

Mantenimiento de tablas (mantenimiento.py):

Módulo destinado al mantenimiento de tablas en el cual se pueden crear o editar usuarios, panteones, nichos, cobradores, centros de egresos, precios y mails.

El mismo contiene un menú secreto para uso exclusivo del administrador de sistema, al cual se ingresa generando un error de tipo KeboardInterrupt al momento en el que el sistema solicita el nombre de usuario y escribiendo la palabra admin seguido de presionar la tecla enter. Desde ese menú el administrador tiene la posibilidad de restaurar su cuenta, en caso de haber sido bloqueada por varios intentos de login fallidos, y de modificar los datos de conexión con la base de datos.

Rendiciones (rendiciones.py):

Módulo destinado a la cobranza de las cuotas de compra y mantenimiento de los nichos y a la emisión de recibos para los cobradores.

Reporteador (reporteador.py):

Módulo destinado a la generación de diferentes reportes en PDF y XLSX como el listado de socios, listado de morosos (detallado y comprimido), listado de modificaciones de caja, listado de ingresos por débito automático, listado de panteones y listado de cobradores.

Ventas (ventas.py):

Módulo destinado a la venta de nichos y la creación y edición tanto de socios como de operaciones.

Para ingresar a cada uno de los módulos es necesario contar con un usuario y una contraseña, que pueden crearse a través del módulo de mantenimiento de tablas. Dependiendo del nivel de privilegios de cada usuario, éste podrá realizar ciertas acciones y otras estarán bloqueadas.

Admin Tools

Es una herramienta creada para que el usuario pueda arreglar errores en los pagos de los clientes, está pensada para ser utilizada durante un primer período ya que éstos fueron cargados uno por uno de forma manual debido que no fue posible extraer esa información del sistema predecesor.

Consiste en una ventana divida en dos sectores: sector de búsqueda y sector de registro.

En el sector de búsqueda se debe indicar el número de operación utilizado en el antiguo programa desarrollado en Cobol y al presionar el botón Buscar se mostrarán en la tabla los datos de relevancia de la/s operación/es que tengan ese número de operación en el sistema anterior.

En el sector de registro se debe indicar el nuevo número de operación y sistema de facturación correspondiente y el mes y año de la última cuota paga. Luego, al presionar el botón Registrar pago, la herramienta calcula la cantidad de cuotas que debe o tiene a favor dicha operación y modifica la base de datos para que coincida con esto.

Esta herramienta no requiere de usuario y contraseña y está planificada su obsolescencia a partir del segundo semestre de 2023.

Base de datos

La base de datos se encuentra en un servidor de PostgreSQL alojado en Ubuntu. Mediante la utilización de bash y cronejob se realizan automáticamente dos respaldos diarios de la base de datos, éstos se guardan en una carpeta sincronizada a la nube mediante el servicio de Dropbox.

Para ahorrar espacio sólo se almacenan 30 respaldos, luego, cada vez que se crea uno nuevo, se elimina el más antiguo.

También es posible realizar un respaldo de forma manual a través de un ícono en el menú de aplicaciones de Ubuntu, al cual puede accederse a través de RDP.

Documentación

En la documentación del programa (./docs/Manual de usuario - Morella.pdf) se puede encontrar de forma detallada los pasos a seguir para realizar cada acción posible, sus respectivos privilegios de usuario necesarios e información acerca del historial de versiones.

Versionado

Nomenclatura de versiones:

La nomenclatura de las versiones sigue la siguiente semántica: MAJOR.MINOR.PATCH.DATE

1. MAJOR: Cuando se realizan cambios importantes en los módulos
2. MINOR: Cuando se agrega funcionalidad de manera compatible o cambios moderados
3. PATCH: Cuando se arreglan errores menores o se agrega funcionalidad mínima
4. DATE: Mes y año de lanzamiento de la versión con formato AAMM

Nomenclaturas de commit:

La nomenclatura de los commit sigue la siguiente semántica:

• Actualizaciones y mejoras: Upd #AAMMDDNN

• Arreglos de errores y problemas: Fix #AAMMDDNN

• Modificaciones por refactorización: Rfc #AAMMDDNN

Donde:

1. AA: Número de dos cifras correspondiente al año
2. MM: Número de dos cifras correspondiente al mes
3. DD: Número de dos cifras correspondiente al día
4. NN: Número de dos cifras identificador del arreglo, actualización o refactorización

Notas sobre versionado

*Hasta el 17/11/2022 se realizó versionado local en PC, luego se realizó la subida de cada versión disponible en un commit y se registró la versión en Git.

**Los primeros dos commit de arreglos se realizaron con nomenclatura erronea siguiendo la siguiente semántica: Fix #AADDMMNN

Descarga y uso

En la carpeta descargas se encuentran los instaladores para la última versión de Morella y el widget Admin Tools.

Para poder utilizarlos deberá instalar un servidor de PostgreSQL y crear la base de datos, ya sea en la misma PC o en otra con cualquier sistema operativo.

Una vez realizado esto, se deberá ingresar al módulo Mantenimiento de tablas (carpeta de instalación\modulos\mantenimiento.exe) y, una vez allí, ingresar al menú secreto para modificar los datos de acceso a la base de datos (generar un error KeyboardInterrupt en el momento que el sistema pide el nombre de usuario).

* Al instalar Morella por primera vez puede ser necesario instalar también Visual C++ Redistributable, para ello debe ejecutar el archivo VC_redist.x64.exe, ubicado en la carpeta de instalación de Morella (por defecto: C:\Program Files\MF Soluciones Informaticas\Morella).

Crear DB en Windows:

Para crear la base de datos en windows seguir los siguentes pasos:

1. Ejecutar SQL Shell (psql) e ingresar a postgres.
2. Crear la base de datos utilizando db_script_create.sql (en carpeta descargas) como ejemplo.
3. Descargar schema.sql (ubicado en la carpeta descargas).
4. Desde la consola de windows ubicarse en la carpeta bin de postgres (por defecto C:\Program Files\PostgreSQL\VV\bin\ donde VV es el número de version).
5. Ejecutar psql.exe -h localhost -p 5432 -U postgres -d morella -f C:\~\schema.sql . Donde:
   • localhost es la dirección IP donde está alojada la base de datos.
   • 5432 es el puerto de conexión a la base de datos.
   • postgres es el usuario de PostgreSQL.
   • morella es el nombre de la base de datos.
   • C:\~\schema.sql es la ruta completa hacia el archivo schema.sql descargado previamente.

Crear DB en Linux:

Para crear la base de datos en linux seguir los siguientes pasos:

1. Ingresar a la terminal y ejecutar psql -h localhost -p 5432 -U postgres -d postgres . Donde:
   • localhost es la dirección IP donde está alojada la base de datos.
   • 5432 es el puerto de conexión a la base de datos.
   • postgres es el usuario de PostgreSQL.
   • postgres es el nombre de la base de datos de mantenimiento de PostgreSQL.
2. Crear la base de datos utilizando db_script_create.sql (en carpeta descargas) como ejemplo.
3. Descargar schema.sql (ubicado en la carpeta descargas).
4. Ejecutar psql -h localhost -p 5432 -U postgres -d morella -f \home\~\schema.sql . Donde:
   • localhost es la dirección IP donde está alojada la base de datos.
   • 5432 es el puerto de conexión a la base de datos.
   • postgres es el usuario de PostgreSQL.
   • morella es el nombre de la base de datos.
   • \home\~\schema.sql es la ruta completa hacia el archivo schema.sql descargado previamente.