Loading repository data…
EzerZuniga / repository
Final project for the Software Analysis & Design course. Desktop application built with Python using a modular layered architecture (UI, services, models, core). Includes user authentication, automated database backup, and packaging as a native Windows installer via Inno Setup.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Doña Rosa es una aplicación de escritorio, desarrollada en Python, orientada a la gestión completa de bodegas y comercios minoristas. Su objetivo es centralizar operaciones (inventario, ventas, compras, proveedores, empleados y reportes) para mejorar la eficiencia operativa y reducir pérdidas por control deficiente de stock.
Este README ofrece instrucciones técnicas y operativas pensadas tanto para administradores de la solución como para desarrolladores que contribuyan al código.
Instrucciones pensadas para desarrollo local.
Windows (PowerShell):
# Activar entorno virtual (si existe)
& "C:/Users/jose/Desktop/PROYECTOS GIT/Sistema-Integral-de-Gesti-n-Comercial/.venv/Scripts/Activate.ps1"
# Actualizar pip e instalar dependencias
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
# (Opcional) Inicializar base de datos y cargar seeds
python scripts/setup_mysql_and_seeds.py
# Ejecutar la aplicación
python main.py
Linux / macOS (bash):
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python scripts/setup_mysql_and_seeds.py
python main.py
DEBUG=True en .env o config/environment.py para logging más detallado.core/logger.py para la configuración del logger y niveles.Crea un archivo .env en la raíz o ajusta config/environment.py con los valores de conexión y entorno.
Ejemplo mínimo:
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASS=secret
DB_NAME=dona_rosa
DEBUG=True
SECRET_KEY=clave_segura
Revisa config/settings.py para opciones adicionales: rutas de datos, políticas de backup y parámetros de la UI.
python scripts/setup_mysql_and_seeds.py para crear tablas y cargar datos iniciales.data/seeds/ contiene ejemplos de usuarios y productos; puedes editarlos antes de cargar.Comandos útiles:
python scripts/test_mysql_connection.py
python scripts/setup_mysql_and_seeds.py
python main.py — inicia la aplicación.data/seeds).Procesos → Venta.data/backups/tickets/)..
├── app/
│ ├── app_context.py # Inicializa contexto de la app, DI y singletons
│ ├── controller.py # Controlador principal / orquestación de flujos
│ └── router.py # Registro de rutas/vistas entre módulos
├── assets/
│ ├── icons/ # Iconos SVG/PNG usados en la UI
│ └── images/ # Capturas, logos y recursos estáticos
├── build/
│ ├── installer.iss # Plantilla Inno Setup (Windows installer)
│ └── build.ps1 # Script PowerShell para generar instalador
├── config/
│ ├── database.py # Conexiones y adaptadores a BD
│ ├── environment.py # Lectura de variables de entorno / .env
│ └── settings.py # Ajustes generales (paths, constantes)
├── core/
│ ├── auth.py # Lógica de autenticación y sesiones
│ ├── authorization.py # Reglas / roles / permisos
│ ├── logger.py # Configuración del logging central
│ ├── security.py # Funciones de seguridad (hash, salt)
│ └── utils.py # Utilidades generales reutilizables
├── data/
│ ├── backups/ # Backups automáticos y manuales
│ ├── logs/ # Logs generados por la app
│ └── seeds/ # Datos de ejemplo y scripts de seed
├── models/
│ ├── producto.py # Modelo Producto
│ ├── proveedor.py # Modelo Proveedor
│ ├── venta.py # Modelo Venta / Ticket
│ └── ... # Otros modelos del dominio
├── modules/
│ ├── inicio/ # Dashboard, vistas iniciales
│ ├── inventario/ # Vistas y lógica de inventario
│ └── procesos/ # Compras, ventas, emisión de tickets
├── services/
│ ├── producto_service.py # Operaciones del dominio (CRUD, validaciones)
│ ├── venta_service.py
│ └── ...
├── scripts/
│ ├── setup_mysql_and_seeds.py
│ ├── test_mysql_connection.py
│ └── tools/ # Scripts auxiliares (export, backup)
├── ui/
│ ├── components/ # Botones, tablas, modales reutilizables
│ │ ├── button.py
│ │ └── table.py
│ ├── login/ # Login view + controller
│ └── styles/ # Temas CSS/Python para la UI
├── requirements.txt
├── build.ps1
└── main.py # Punto de entrada de la aplicación
Descripción y convenciones útiles
app/: punto donde se inicializan dependencias y se monta la aplicación. Si añades un nuevo módulo, registra su ruta en router.py.config/: mantiene la configuración por ambiente. No guardar credenciales en texto; usa variables de entorno o un gestor de secretos.core/: lógica transversal (auth, logging, seguridad). Evita introducir lógica de negocio aquí; usa services/.modules/ + ui/: la UI se organiza por módulos; cada módulo debe contener sus vistas y controladores locales. Sigue la convención modules/<nombre>/ <nombre>_view.py.services/ y models/: los services implementan reglas de negocio usando models como entidad; los controladores deben invocar a los services.scripts/: scripts de ayuda (migrations, seeds, export/import). Son utilitarios y no forman parte del runtime normal.data/: carpeta para backups y seeds; configúrala en .gitignore según tu política de backups.Buenas prácticas recomendadas
tests/ (unidad y/o integración) y usa pytest.pre-commit con black, isort y flake8 para mantener consistencia.README.md o en docs/ si creas un conjunto mayor de documentación.Si quieres, puedo:
ARCHITECTURE.md con diagramas y responsabilidades por módulo.tests/ con un ejemplo de prueba y configurar pytest en requirements-dev.txt.CODE_CONVENTIONS.md con reglas de commit, style y estructura.Recomendaciones para colaboradores:
pip install -r requirements.txt.Instalación de herramientas de calidad:
python -m pip install pre-commit black flake8 isort
pre-commit install
Ejecutar tests:
python -m pip install pytest
pytest -q
PR checklist (sugerido):
black) y revisado (flake8)El repositorio incluye build/installer.iss y build.ps1 para crear instaladores en Windows.
Flujo recomendado:
pyinstaller --onefile main.py
Crear instalador con Inno Setup usando build/installer.iss.
Probar instalador en máquinas objetivo y validar permisos y dependencias.
.env o variables de entorno.data/backups/ — automatiza con tareas programadas.Si quieres, añado una guía de hardening y rotación de secrets.
feature/<descripcion> o fix/<descripcion>.Suggested commit message format:
type(scope): short description
body (optional)
footer (issue reference)
Ejemplo:
docs(readme): mejorar documentación de instalación Windows
Q: No arranca la aplicación después de instalar dependencias.
A: Verifica la versión de Python, activa el entorno virtual y revisa core/logger.py para la traza. Ejecuta python -m pip install -r requirements.txt de nuevo.
Q: Error de conexión a MySQL.
A: Comprueba config/environment.py y ejecuta python scripts/test_mysql_connection.py.
Revisa LICENSE para detalles legales. Mantenedor: Ezer Zúñiga — abre un issue para soporte o propuestas de mejora.
Selected from shared topics, language and repository description—not editorial ratings.
Itsfoss0 /
MVP for a car renting web application in django, tailwind and mysql - Power Learn Project Final Project
67/100 healthpranshuj73 /
Diary/to-do app made with tkinter library for my final high-school computer science project themed on MySQL and Python.
41/100 healthIganza-roy /
The goal of this project was to deploy a simple copy of the AirBnB website. It consists of A command interpreter to manipulate data without a visual interface, like in a Shell (perfect for development and debugging) A website that shows the final product: static and dynamic; A database or files that store data. It is majorly built with python.
gabrielzezze /
First software project of the computer engineering degree at INSPER (college in Brazil). The concept was to create a backend of any site in Python using the Flask library, the group chose to create a site for sharing files between users, the backend in Flask uses MySQL as a database for user information and Firebase Storage for file saving. The frontend template was taken from the internet (https://www.w3schools.com/w3css/w3css_templates.asp, start page template) beacause the main project ideia was the backend development in Python.
18/100 health