docs: documentación extensiva del proyecto

- README.md con guía completa de instalación y arquitectura
- docs/BACKEND.md — guía detallada del API
- docs/FRONTEND.md — guía del SPA React
- docs/DATABASE.md — funciones SQL y patrones de datos
- docs/API.md — referencia completa de endpoints REST
- docs/DEPLOYMENT.md — guía de despliegue en producción
- docs/TROUBLESHOOTING.md — solución de problemas comunes
- CHANGELOG.md — historial de cambios
- CONTRIBUTING.md — guía de contribución

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# 🤝 Guía de Contribución
+
+## Cómo Trabajar en Este Proyecto
+
+### 1. Flujo de Trabajo con Git
+
+```bash
+# Clonar el repositorio
+git clone https://git.consultoria-as.com/consultoria-as/hotel-hacienda.git
+
+# Crear una rama para tu cambio
+git checkout -b feature/nombre-de-la-funcionalidad
+
+# Hacer commit con mensajes descriptivos
+git add .
+git commit -m "feat: descripción clara del cambio"
+
+# Subir y crear Pull Request
+git push origin feature/nombre-de-la-funcionalidad
+```
+
+### 2. Convención de Commits
+
+| Prefijo | Uso |
+|---------|-----|
+| `feat:` | Nueva funcionalidad |
+| `fix:` | Corrección de bug |
+| `docs:` | Cambios en documentación |
+| `style:` | Cambios de formato (espacios, comas) |
+| `refactor:` | Refactorización de código |
+| `test:` | Agregar o corregir tests |
+| `chore:` | Tareas de mantenimiento |
+
+### 3. Antes de Modificar Cualquier Cosa
+
+1. **Lee `DOCUMENTACION_TECNICA.md`** — entiende la arquitectura.
+2. **Si modificas lógica de negocio:** revisa la función SQL correspondiente en PostgreSQL.
+3. **Si agregas un endpoint:** sigue el patrón `route → controller → función SQL`.
+4. **Si agregas una página:** actualiza `menuconfig.js`, `App.jsx` y `Layout2.jsx`.
+
+### 4. Reglas de Oro
+
+- No hardcodees `localhost` en el frontend. Usa `import.meta.env.VITE_API_BASE_URL`.
+- Usa queries parametrizadas (`$1`, `$2`) en PostgreSQL para evitar SQL Injection.
+- Si cambias una función SQL, busca TODOS los controllers que la usen.
+- Mantén la consistencia en la respuesta JSON: `{ message, data, status }`.
+- Agrega traducciones EN/ES para todo texto visible.
+
+### 5. Testing
+
+Actualmente no hay tests. Si agregas funcionalidad crítica, considera:
+- Probar la función SQL directamente en PostgreSQL.
+- Probar el endpoint con `curl` o Postman.
+- Probar el flujo completo en el navegador.
+
+### 6. Documentación
+
+Si tu cambio afecta:
+- **Endpoints:** actualiza `docs/API.md`
+- **Base de datos:** actualiza `docs/DATABASE.md`
+- **Despliegue:** actualiza `docs/DEPLOYMENT.md`
+- **Arquitectura:** actualiza `DOCUMENTACION_TECNICA.md`