feat: Release version 1.3.1 with Docker optimization and comprehensive documentation

- Update version to 1.3.1 in package.json and docker-compose.yml
- Optimize Dockerfile with proper data directory structure for production
- Add comprehensive Docker documentation (DOCKER.md)
- Include deployment and backup scripts (deploy.sh, backup.sh)
- Add .env.example for environment configuration
- Improve README with detailed deployment instructions
- Fix database path handling for Docker production environment
- Add health checks and proper Docker Compose configuration
- Remove development task documentation
- Update .gitignore to exclude backup directories

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Marco Gallegos
2025-08-25 18:40:44 -06:00
parent edf1be22fb
commit bbcd85eff7
10 changed files with 261 additions and 16 deletions

92
DOCKER.md Normal file
View File

@@ -0,0 +1,92 @@
# Guía de Docker para AP-POS
## Configuración inicial
1. **Configurar variables de entorno**:
```bash
cp .env.example .env
# Editar .env con tus valores específicos
```
2. **Construir y levantar los servicios**:
```bash
docker-compose up -d --build
```
3. **Verificar que esté funcionando**:
```bash
docker-compose ps
docker-compose logs ap-pos
```
4. **Acceder a la aplicación**:
- URL: http://localhost:3111
- Primera vez: será redirigido a `/setup.html` para crear el usuario admin
## Comandos útiles
### Ver logs en tiempo real
```bash
docker-compose logs -f ap-pos
```
### Reiniciar el servicio
```bash
docker-compose restart ap-pos
```
### Detener y eliminar todo
```bash
docker-compose down
```
### Backup de la base de datos
```bash
# Crear backup
docker-compose exec ap-pos cp /app/data/ap-pos.db /app/data/backup-$(date +%Y%m%d_%H%M%S).db
# O desde el host
docker cp ap-pos:/app/data/ap-pos.db ./backup-ap-pos.db
```
### Restaurar base de datos
```bash
# Detener el servicio
docker-compose stop ap-pos
# Restaurar desde backup
docker cp ./backup-ap-pos.db ap-pos:/app/data/ap-pos.db
# Reiniciar
docker-compose start ap-pos
```
## Persistencia de datos
- La base de datos SQLite se almacena en el volumen Docker `ap_pos_data`
- Los datos persisten entre reinicios del contenedor
- El volumen se mantiene incluso si el contenedor se elimina
## Troubleshooting
### El contenedor no inicia
```bash
# Ver logs detallados
docker-compose logs ap-pos
# Verificar el health check
docker-compose ps
```
### Problemas de permisos
```bash
# Verificar permisos del volumen
docker-compose exec ap-pos ls -la /app/data/
```
### Reset completo
```bash
# CUIDADO: Esto elimina todos los datos
docker-compose down -v
docker-compose up -d --build
```