Documentación de Construbot#
Una Solución Operativa para Constructoras
Construbot es un sistema integral de gestión de construcción basado en Django para el seguimiento de contratos, estimaciones, contrapartes y operaciones financieras. Construido con multi-tenencia, estructuras de datos jerárquicas y una potente API REST.
Nota
Documentación en Español disponible | Spanish Documentation Available
🇪🇸 Versión en español: https://construbot.readthedocs.io/es/
🇬🇧 English version: https://construbot.readthedocs.io/
Nota
Nota sobre el idioma: Aunque el código base usa terminología en español (Contrato, Estimación, etc.), esta documentación está principalmente en inglés con traducciones al español disponibles. Consulte Glosario de términos de dominio para traducciones completas de términos.
Enlaces Rápidos#
¿Qué es Construbot?#
Construbot ayuda a las empresas constructoras a gestionar:
✅ Contratos Jerárquicos - Contratos padre con subcontratos usando estructuras de árbol
✅ Estimaciones de Avance - Seguimiento de la finalización de trabajos y pagos (Estimaciones)
✅ Gestión de Contrapartes - Clientes, subcontratistas y destajistas
✅ Seguimiento Financiero - Anticipos, retenciones y cálculos de pagos
✅ Soporte Multi-Empresa - Un sistema para múltiples entidades de negocio
✅ Generación de PDF - Creación automatizada de documentos
✅ Importación/Exportación Excel - Operaciones masivas de datos
✅ API REST - Integraciones móviles y externas
Características Principales#
Arquitectura Multi-Tenencia
Jerarquía de tres niveles (Cliente → Empresa → Usuario) con completo aislamiento de datos entre empresas.
Contratos Jerárquicos
Usa django-treebeard para relaciones padre/hijo de contratos con agregación financiera automática.
Autenticación Basada en Email
Autenticación moderna usando email (no nombres de usuario) con seis niveles de permisos desde Auxiliar hasta Superusuario.
Listo para Producción
Despliegue Docker, base de datos PostgreSQL, caché Redis, tareas Celery, almacenamiento S3 y seguridad integral.
Stack Tecnológico#
Backend Framework: Django 3.2.19 (Python 3.9.17+)
Database: PostgreSQL 12+
Cache/Queue: Redis 6+
Task Queue: Celery 5.2.7
API: Django REST Framework + SimpleJWT
PDF Generation: ReportLab
Tree Structures: django-treebeard
Inicio Rápido#
Para Usuarios:
# Access the application
https://your-construbot-instance.com
# Log in with your email and password
# See: user-guide/getting-started
Para Desarrolladores (Docker):
# Clone repository
git clone https://github.com/javier-llamas/construbot.git
cd construbot
# Build and start
make buildev
# Create superuser
make superuser
# Access at http://localhost:8000
Consulte Instalación para la configuración completa.
Estructura de la Documentación#
Esta documentación está organizada para tres audiencias:
Guía del Usuario#
Para usuarios finales que gestionan proyectos de construcción:
Introducción - Qué es Construbot
Empezando - Tutorial de primeros pasos
Conceptos básicos - Conceptos fundamentales (contratos, estimaciones, etc.)
Flujos de trabajo - Flujos de trabajo paso a paso
Características - Características avanzadas
Preguntas frecuentes - Preguntas frecuentes
Documentación para Desarrolladores#
Para desarrolladores que instalan o extienden Construbot:
Instalación - Configuración de desarrollo
Despliegue - Despliegue en producción
Arquitectura - Arquitectura del sistema
API - Referencia de API REST
Modelos - Modelos de datos
Guía del Colaborador#
Para colaboradores que mejoran Construbot:
Guía para contribuyentes - Primeros pasos
Pruebas - Guía de pruebas
Glosario de traducción - Glosario de traducción
Documentación - Guías de documentación
Referencia#
Referencia rápida para todos los usuarios:
Glosario - Términos Español→Inglés
Comandos de archivos Make - Comandos de desarrollo
Glosario de términos de dominio - Glosario completo
Páginas Populares#
Primeros Pasos:
Empezando - Tutorial de usuario
Configuración de la ventana acoplable - Desarrollo con Docker
Implementación de AWS EC2 - Despliegue en AWS
Conceptos Fundamentales:
Proyectos y Contratos - Entendiendo los contratos
Multi-inquilino - Arquitectura multi-tenencia
Glosario de términos de dominio - Glosario completo Español→Inglés
Configuración:
Configuración - Variables de entorno
Variables de entorno - Configuración de producción
Estructura de configuración - Configuración de Django
Terminología en Español#
El código usa terminología de negocios en español. Traducciones clave:
Español |
Inglés |
Descripción |
|---|---|---|
Contrato |
Contrato / Proyecto |
Entidad de negocio principal |
Contraparte |
Contraparte |
Cliente, subcontratista o destajista |
Estimación |
Estimación / Pago de Avance |
Solicitud de pago por trabajo completado |
Concepto |
Concepto / Partida |
Partida individual de trabajo en catálogo |
Retención |
Retención / Retención Fiscal |
Retención financiera |
Sitio |
Sitio |
Ubicación de obra de construcción |
Consulte Glosario de términos de dominio para más de 100 traducciones completas.
Repositorio y Licencia#
GitHub: https://github.com/javier-llamas/construbot
Licencia: GNU Affero General Public License v3 (AGPLv3)
Versión Actual: 1.1.04
Obtener Ayuda#
Problemas de Instalación: Instalación
Problemas de Despliegue: Despliegue
Preguntas de API: API
Reportar Errores: https://github.com/javier-llamas/construbot/issues