ContaProX - Sistemas Contables

👥 Equipo de Desarrollo

• Díaz Linarez, Daniel Alejandro - DL23001
• Granadino Mendoza, Ever Alexander - GM23004
• Mendoza Ramos, Miguel Angel - MR23061
• Olivares Martínez, Diego Enrique - OM23008

---

📋 Descripción del Proyecto

ContaProX es una aplicación web desarrollada en Django que proporciona una solución integral para la gestión contable y facturación de pequeñas y medianas empresas. El sistema incluye módulos completos para contabilidad, inventario, facturación, planillas y reportes financieros.

✨ Características Principales

📊 Módulo de Contabilidad

• Catálogo de Cuentas: Gestión completa del plan de cuentas contables
• Partidas Diarias: Registro y control de asientos contables
• Mayorizacion: Proceso de mayorización automática
• Balance Inicial: Configuración de saldos iniciales
• Períodos Contables: Control de ejercicios fiscales
• Tipos de Folio: Manejo de diferentes tipos de documentos contables

💰 Estados Financieros

• Balance General: Generación automática del estado de situación financiera
• Estado de Resultados: Cálculo de pérdidas y ganancias
• Reportes Personalizados: Formato de exportación (PDF)

🧾 Sistema de Facturación

• Facturación Electrónica: Generación de facturas con códigos QR
• Configuración Flexible: Personalización de datos del negocio
• Múltiples Tipos de Contribuyente: Soporte para crédito fiscal y consumidor final
• Gestión de Clientes: Base de datos completa de clientes

📦 Control de Inventario

• Gestión de Productos: Catálogo completo de productos y servicios
• Control de Stock: Seguimiento de existencias en tiempo real
• Proveedores: Gestión de base de datos de proveedores
• Compras y Ventas: Registro integrado con contabilidad

👥 Recursos Humanos

• Gestión de Empleados: Base de datos de personal
• Planillas de Pago: Cálculo automático de salarios y deducciones
• Reportes de Planilla: Generación de reportes por período

🔐 Seguridad y Usuarios

• Autenticación de Usuarios: Sistema de login seguro
• Control de Acceso: Gestión de permisos por módulo
• Auditoría: Registro de transacciones por usuario

🛠️ Tecnologías Utilizadas

Backend

• Django 5.2.5: Framework web de Python
• Postgress: Base de datos
• Python 3.x: Lenguaje de programación principal

Frontend

• HTML5/CSS3: Estructura y estilos
• Bootstrap: Framework CSS para diseño responsivo
• JavaScript: Interactividad del lado del cliente
• Bootstrap Icons: Iconografía

Librerías Especializadas

• django-qr-code: Generación de códigos QR para facturas
• WeasyPrint: Generación de PDFs
• OpenPyXL: Exportación a Excel
• Pillow: Procesamiento de imágenes
• Gunicorn: Servidor WSGI para producción

📁 Estructura del Proyecto

ProyectoDeAsignaturaSIC/
├── manage.py                    # Comando principal de Django
├── requirements.txt             # Dependencias del proyecto
├── runtime.txt                 # Versión de Python para deployment
├── Procfile                    # Configuración para Heroku
├── db.sqlite3                  # Base de datos SQLite
│
├── sicproject/                 # Configuración del proyecto Django
│   ├── settings.py            # Configuraciones principales
│   ├── urls.py                # URLs principales
│   ├── wsgi.py                # Configuración WSGI
│   └── asgi.py                # Configuración ASGI
│
└── sicapp/                     # Aplicación principal
    ├── models.py              # Modelos de base de datos
    ├── forms.py               # Formularios Django
    ├── admin.py               # Configuración del admin
    ├── urls.py                # URLs de la aplicación
    │
    ├── views/                 # Vistas organizadas por módulo
    │   ├── views.py           # Vistas principales
    │   ├── views_cuenta.py    # Gestión de cuentas
    │   ├── views_balance_inicial.py
    │   ├── views_estados_financieros.py
    │   ├── views_venta.py     # Módulo de ventas
    │   ├── views_compra.py    # Módulo de compras
    │   ├── views_inventario.py
    │   ├── views_planilla.py  # Recursos humanos
    │   └── ... (otros módulos)
    │
    ├── templates/             # Plantillas HTML
    │   ├── layouts/           # Plantillas base
    │   ├── contabilidad/      # Módulo contable
    │   ├── facturas/          # Sistema de facturación
    │   ├── reportes/          # Reportes y estados financieros
    │   └── compra-venta/      # Compras y ventas
    │
    ├── static/                # Archivos estáticos
    │   ├── uploads/           # Archivos subidos (logos, etc.)
    │   └── facturas/          # PDFs de facturas generadas
    │
    ├── migrations/            # Migraciones de base de datos
    └── templatetags/          # Filtros personalizados

🚀 Instalación y Configuración

Prerrequisitos

• Python 3.8 o superior
• pip (gestor de paquetes de Python)
• Git

Pasos de Instalación

1. Clonar el repositorio

git clone [URL_DEL_REPOSITORIO]
cd ProyectoDeAsignaturaSIC

2. Crear entorno virtual (recomendado)

python -m venv venv
source venv/bin/activate  # En Linux/Mac
# o
venv\Scripts\activate     # En Windows

3. Instalar dependencias

pip install -r requirements.txt

4. Aplicar migraciones

python manage.py migrate

5. Crear superusuario (opcional)

python manage.py createsuperuser

6. Ejecutar servidor de desarrollo

python manage.py runserver

7. Acceder a la aplicación
   • Abrir navegador en: http://127.0.0.1:8000/
   • Panel de administración: http://127.0.0.1:8000/admin/

📊 Funcionalidades por Módulo

🏗️ Configuración Inicial

1. Configuración del Negocio: Datos empresariales, logo, NIT
2. Catálogo de Cuentas: Creación del plan contable
3. Períodos Contables: Definición de ejercicios fiscales
4. Balance Inicial: Registro de saldos de apertura

💼 Operaciones Diarias

1. Registro de Transacciones: Partidas diarias y asientos contables
2. Facturación: Emisión de facturas y créditos fiscales
3. Compras: Registro de facturas de proveedores
4. Inventario: Control de entradas y salidas de productos

📈 Reportes y Análisis

1. Estados Financieros: Balance General y Estado de Resultados
2. Reportes de Inventario: Existencias y movimientos
3. Análisis de Ventas: Reportes por período y cliente
4. Planillas: Reportes de nómina y deducciones

🤝 Contribución

Para contribuir al proyecto:

1. Fork el repositorio
2. Crear una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abrir un Pull Request

📝 Licencia

Este proyecto es desarrollado como trabajo académico para la materia de Sistemas Contables.

📞 Soporte

Para soporte técnico o consultas sobre el proyecto, contactar a cualquier miembro del equipo de desarrollo.

---

Desarrollado con ❤️ por el equipo SIC - Universidad de El Salvador