ROMFASTSQL/proxmox/lxc103-dokploy/docs/space-booking-app.md

space-booking — Deploy pe Dokploy LXC 103

Descriere

Aplicație de rezervare spații (săli de conferință, birouri), cu backend FastAPI și frontend Vue.js. Deployată pe Dokploy/LXC 103 ca serviciu Docker Compose.

• Domeniu: space.roa.romfast.ro
• Server: LXC 103 (10.0.20.167)
• Deployment: Dokploy → Docker Compose
• Repo: git@gitea.romfast.ro:romfast/space-booking.git

Arhitectură

Browser → VM 201 IIS (SSL) → LXC 103 Traefik → frontend (nginx:80)
                                                         ↓
                                                  backend (FastAPI:8000)
                                                         ↓
                                                  SQLite /data/space_booking.db

Servicii Docker Compose:

• frontend — Vue.js servit de nginx, expus prin Traefik
• backend — FastAPI pe port 8000, intern (fără expunere directă)

---

Deploy în Dokploy UI

1. Creare Service

1. Deschide https://dokploy.romfast.ro
2. Services → Create Service → Docker Compose
3. Name: space-booking
4. Server: LXC 103 (local)

2. Configurare Git Source

• Provider: Gitea (sau Custom Git)
• URL: http://gitea.romfast.ro/romfast/space-booking.git
• Branch: master

3. Domain Configuration

În Dokploy, secțiunea Domains:

• Domain: space.roa.romfast.ro
• HTTPS: enabled
• Certificate: managed by Traefik

4. Variabile de Mediu (Environment)

Setează în Dokploy → Environment tab:

Variabilă	Obligatoriu	Valoare exemplu	Descriere
SECRET_KEY	DA	<token hex 32>	JWT signing key
FRONTEND_URL	DA	https://space.roa.romfast.ro	URL frontend pentru CORS/redirect
SMTP_ENABLED	Nu	true	Activează trimitere email
SMTP_HOST	Nu*	smtp.example.com	Server SMTP
SMTP_PORT	Nu*	587	Port SMTP
SMTP_USER	Nu*	user@example.com	User autentificare SMTP
SMTP_PASSWORD	Nu*	parola	Parolă SMTP
SMTP_FROM_ADDRESS	Nu*	rezervari@romfast.ro	Adresă expeditor

*Necesare doar dacă SMTP_ENABLED=true

Generare SECRET_KEY:

python -c "import secrets; print(secrets.token_hex(32))"

5. Deploy

Click Deploy → monitorizează logs în Dokploy UI.

---

Conturi Demo Create Automat

La primul deploy, entrypoint.sh rulează automat seed_db.py (idempotent).

Email	Parolă	Rol
admin@example.com	adminpassword	Superadmin
manager@example.com	managerpassword	Manager
user@example.com	userpassword	User

Atenție: Schimbă parolele în producție după primul login!

Date demo create: 2 proprietăți ("Clădirea Centrală", "Biroul Privat"), 3 spații, 2 organizații.

---

Verificare Post-Deploy

# Health check backend (prin Traefik)
curl -s https://space.roa.romfast.ro/health
# Răspuns așteptat: {"status": "ok"}

# Health check direct (din LAN)
curl -s http://10.0.20.167/health -H "Host: space.roa.romfast.ro"

# Verificare logs backend (seed automat)
# În Dokploy UI → space-booking → Logs → backend
# Trebuie să apară:
# [entrypoint] Running database seed...
# Database already seeded. Skipping...   ← la redeploy-uri ulterioare
# [entrypoint] Starting application...

# Test autentificare
curl -s -X POST https://space.roa.romfast.ro/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com","password":"adminpassword"}' | jq .

---

Configurare SMTP

Cu SMTP (email de confirmare rezervare)

În Dokploy → Environment, setează:

SMTP_ENABLED=true
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=user@example.com
SMTP_PASSWORD=parola_smtp
SMTP_FROM_ADDRESS=rezervari@romfast.ro

Redeploy → verificare logs pentru mesaje email la rezervare.

Fără SMTP (implicit)

Aplicația funcționează normal fără SMTP. Rezervările se fac, dar nu se trimit emailuri de confirmare. Setare implicită: SMTP_ENABLED=false.

---

DNS

space.roa.romfast.ro    A    188.26.14.103

Domeniu sub *.roa.romfast.ro → wildcard DNS acoperă automat.

---

SSL Certificate (Win-ACME pe VM 201)

Dacă wildcardul *.roa.romfast.ro e deja configurat, SSL funcționează automat.

Dacă e nevoie de cert explicit:

cd C:\Tools\win-acme
Import-Module WebAdministration
Get-Website | Select-Object ID, Name

.\wacs.exe --source iis --siteid <ID_space> --accepttos --emailaddress admin@romfast.ro
iisreset

---

Troubleshooting

502 Bad Gateway

Cauze posibile:

1. dnsrr fix — Docker Swarm VIP issue (standard pe LXC 103)

   journalctl -u dokploy-dnsrr-fix -n 20
   # Trebuie să apară: OK - space-booking-... now uses dnsrr
   

2. Backend nu a pornit — verifică logs backend în Dokploy UI

Seed DB nu rulează

# Verificare logs în Dokploy UI → backend
# Dacă apare eroare la seed, verifică DATABASE_URL și permisiuni volum
docker volume ls | grep space-booking

SMTP nu trimite emailuri

1. Verifică SMTP_ENABLED=true în Dokploy → Environment
2. Verifică că SMTP_USER și SMTP_PASSWORD sunt setate (nu doar SMTP_HOST)
3. Redeploy după setarea variabilelor
4. Verifică logs backend pentru erori SMTP

Resetare bază de date (date demo)

# ATENȚIE: șterge toate datele!
docker volume rm space-booking_backend_data
# La redeploy următor, seed_db.py recreează datele demo