Configuración del Entorno¶

Guia para configurar el entorno de desarrollo local.

Prerequisitos¶

Asegurate de tener instalado:

Docker 24.0+
Docker Compose 2.20+
Git
Editor de texto (VS Code recomendado)
Acceso SSH al repositorio

Clonar el Repositorio¶

# En tu máquina local o servidor
cd /opt
git clone git@github.com:Rodrigo-Flores/full3d-odoo.git
cd full3d-odoo

Configurar Variables de Entorno¶

# Copiar plantilla
cp .env.example .env

# Editar configuración
naño .env

Variables Obligatorias¶

# Base de datos
POSTGRES_USER=odoo
POSTGRES_PASSWORD=ContrasenaSegura123
ODOO_DATABASE=odoo_full3d

# Odoo
ODOO_ADMIN_PASSWD=OtraContrasena456

# Dominio (usar localhost para desarrollo local)
DOMAIN=localhost
LETS_ENCRYPT_EMAIL=dev@example.com

Variables Opcionales¶

# Modo de despliegue
DEPLOYMENT_MODE=image    # 'image' o 'source'
ODOO_VERSION=19.0

# Para modo source (desarrollo con código Odoo)
ODOO_REPO=https://github.com/odoo/odoo.git
ODOO_BRANCH=saas-18.4

Preparar Directorios¶

# Certificado SSL
touch config/acme.json
chmod 600 config/acme.json

# Datos
mkdir -p data/odoo/sessions data/odoo/filestore data/postgresql
mkdir -p backups

# Permisos (UID 100 = usuario odoo en contenedor)
chown -R 100:101 data/odoo

NUNCA elimines ./data/

El directorio ./data/ contiene:

postgresql/ - Toda la base de datos
odoo/ - Todos los archivos adjuntos

Comandos peligrosos a evitar:

# NUNCA ejecutar sin backup:
rm -rf data/
git clean -fdx
docker compose down -v
docker system prune -a --volumes

Construir y Ejecutar¶

# Construir imagen personalizada de Odoo
docker compose build

# Iniciar servicios en segúndo plano
docker compose up -d

# Ver logs en tiempo real
docker compose logs -f

Verificar Instalación¶

# Estado de contenedores
docker compose ps

# Deberia mostrar:
# NAME         STATUS
# traefik      running
# postgresql   healthy
# odoo         running

Acceder a Odoo¶

Produccion: https://tu-dominio.com
Desarrollo local: http://localhost:8069

Desarrollo Local sin Traefik

Para desarrollo local, puedes exponer el puerto de Odoo directamente:

# En docker-compose.yml, agregar a servicio odoo:
ports:
  - "8069:8069"

Estructura de Trabajo¶

full3d-odoo/
├── addons/
│   ├── extra/          # TUS módulos (full3d_repairs)
│   └── custom/         # Módulos de terceros
├── config/
│   └── odoo.conf.template
├── data/               # NO tocar sin backup
├── scripts/            # backup.sh, restore.sh
└── docs/               # Esta documentación

Flujo de Desarrollo¶

Crear rama desde dev
Modificar código en addons/extra/
Reiniciar Odoo para cargar cambios
Probar en el navegador
Commit con mensaje descriptivo
Push y crear PR

# Ejemplo de flujo
git checkout dev
git pull origin dev
git checkout -b feature/nueva-funciónalidad

# ... hacer cambios ...

docker compose restart odoo
# probar...

git add .
git commit -m "feat(repairs): agregar campo X"
git push origin feature/nueva-funciónalidad

Siguiente Paso¶

Continua con Comandos Frecuentes para aprender los comandos del dia a dia.