https://github.com/eddys912/pymexpro
Sistema de gestión de inventario diseñado para administrar materiales, máquinas, empleados, proveedores y clientes de una maderería. Permite controlar el almacenamiento, gestionar compras y ventas, generar reportes y hacer seguimiento de costos de producción.
https://github.com/eddys912/pymexpro
mysql python python-dotenv qt6-designer
Last synced: 2 months ago
JSON representation
Sistema de gestión de inventario diseñado para administrar materiales, máquinas, empleados, proveedores y clientes de una maderería. Permite controlar el almacenamiento, gestionar compras y ventas, generar reportes y hacer seguimiento de costos de producción.
- Host: GitHub
- URL: https://github.com/eddys912/pymexpro
- Owner: Eddys912
- Created: 2025-02-03T04:08:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-11T06:02:12.000Z (2 months ago)
- Last Synced: 2025-03-11T06:27:08.651Z (2 months ago)
- Topics: mysql, python, python-dotenv, qt6-designer
- Homepage:
- Size: 626 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🏭 PyMexPro - Gestión de Inventario para Maderería 🏭
Sistema para la administración de inventarios en una maderería, desarrollado con Python, PyQt6, MySQL y XAMPP.
## 🌟 Bienvenido
Este es un sistema de **gestión de inventario** diseñado para administrar eficientemente los materiales, máquinas, empleados, proveedores y clientes de una maderería. Permite controlar el almacenamiento, gestionar compras y ventas, generar reportes y hacer seguimiento de costos de producción.
## 📂 Módulos Principales
| Módulo | Descripción |
|---------------|-----------------------------------------------------|
| **Inventario**| Control y gestión de materiales y productos. |
| **Máquinas** | Gestión de equipos y mantenimiento. |
| **Usuarios** | Administración de empleados, proveedores y clientes.|
| **Compras** | Registro y control de compras de materiales. |
| **Ventas** | Gestión de ventas y clientes. |
| **Reportes** | Generación de informes en PDF y Excel. |
## 🚀 Instalación y Configuración
### 🛠️ Requisitos Previos
- **Python 3.11** - Instalar desde [Python](https://www.python.org/downloads/).
- **XAMPP** - Para MySQL y phpMyAdmin [XAMPP](https://www.apachefriends.org/es/download.html).
- **PyQt6 Designer 6.4.2.3.3** - Para la interfaz gráfica.
### 📥 Instalación
1. **Clonar el repositorio en tu máquina local:**
```bash
git clone https://github.com/Eddys912/pymexpro.git
```
2. **Acceder a la carpeta del proyecto:**
```bash
cd pymexpro
```
3. **Crear y activar un entorno virtual en Visual Studio Code:**
- Git Bash:
```bash
python -m venv venv
source venv\Scripts\activate
```
4. **Instalar dependencias:**
```bash
pip install -r requirements.txt
```
5. **Configurar XAMPP y la base de datos:**
- Ejecuta `XAMPP` y activa los módulos `Apache` y `MySQL`.
- Abre `phpMyAdmin` en: [http://localhost/phpmyadmin](http://localhost/phpmyadmin).
- Crea una base de datos llamada `pymexpro_db`.
- Ejecuta el archivo `database/init_db.py` para inicializar la base de datos.
6. **Configurar credenciales:**
- Renombrar el archivo `.env.example` a `.env` y configurar las variables:
```bash
DB_HOST = "localhost"
DB_USER = "root" # Usuario por defecto de XAMPP
DB_PASSWORD = "" # Contraseña vacia por defecto
DB_NAME = "pymexpro_db"
```
7. **Ejecutar la aplicación:**
```bash
python main.py
```
## 🚀 ¿Cómo Contribuir?
1. **Realiza un Fork** del proyecto haciendo clic en el botón `Fork`.
2. **Sigue los pasos de Instalación.**
3. **Realiza tus cambios**:
- Guarda los archivos.
- Crea un commit con una descripción clara:
```bash
git add .
git commit -m "Descripción de los cambios realizados"
```
4. **Envía los cambios** a tu repositorio fork:
```bash
git push origin mi-nueva-funcionalidad
```
5. **Abre un Pull Request** 🚀:
- Dirígete al repositorio original y crea un **Pull Request**.
- Describe los cambios realizados.