Files

Marius Mutu 6b13ffa183 Initial commit: ROA2WEB - FastAPI + Vue.js + Telegram Bot

Modern ERP Reports Application with microservices architecture

Tech Stack:
- Backend: FastAPI + python-oracledb (Oracle DB integration)
- Frontend: Vue.js 3 + PrimeVue + Vite
- Telegram Bot: python-telegram-bot + SQLite
- Infrastructure: Shared database pool, JWT authentication, SSH tunnel

Features:
- FastAPI backend with async Oracle connection pool
- Vue.js 3 responsive frontend with PrimeVue components
- Telegram bot alternative interface
- Microservices architecture with shared components
- Complete deployment support (Linux Docker + Windows IIS)
- Comprehensive testing (Playwright E2E + pytest)

Repository Structure:
- reports-app/ - Main application (backend, frontend, telegram-bot)
- shared/ - Shared components (database pool, auth, utils)
- deployment/ - Deployment scripts (Linux & Windows)
- docs/ - Project documentation
- security/ - Security scanning and git hooks

2025-10-25 14:55:08 +03:00

3.2 KiB

Raw Blame History

SSH Tunnel Docker Integration

SSH tunnel-ul pentru conexiunea la Oracle database este acum complet integrat în Docker setup.

🔧 Configurare Automată

Development Mode

SSH tunnel-ul pornește automat când rulezi:

docker-compose up

Servicii incluse:

roa-ssh-tunnel: Container dedicat pentru SSH tunnel
roa-backend: Conectat prin tunnel la Oracle
roa-frontend: Interface-ul web
roa-gateway: Nginx reverse proxy
roa-redis: Cache și sesiuni

📋 Cerințe

SSH Key

Asigură-te că ai cheia SSH în locația corectă:

~/.ssh/roa_oracle_server

Configurare Environment

Variabilele sunt setate automat din .env.development:

SSH_SERVER=83.103.197.79
SSH_PORT=22122
SSH_USER=roa2web
REMOTE_HOST=10.0.20.36
ORACLE_HOST=localhost  # Se conectează prin tunnel

🚀 Utilizare

Start complet cu SSH tunnel:

# Copiază environment-ul de development
cp .env.development .env

# Pornește toate serviciile (inclusiv SSH tunnel)
docker-compose up --build

Verificare SSH tunnel:

# Check tunnel health
docker-compose ps roa-ssh-tunnel

# Check tunnel logs
docker-compose logs -f roa-ssh-tunnel

# Test Oracle connection through tunnel
docker-compose exec roa-backend python -c "
from shared.database.oracle_pool import test_connection
test_connection()
"

🔍 Monitoring

SSH Tunnel Status:

Health check: Verifică portul 1521 la fiecare 30s
Auto-restart: Tunnel-ul se restartează automat dacă se întrerupe
Logs: Monitorizare în timp real cu docker-compose logs -f roa-ssh-tunnel

Service Dependencies:

roa-ssh-tunnel (first)
    ↓
roa-redis
    ↓
roa-backend (depends on tunnel + redis)
    ↓
roa-frontend
    ↓
roa-gateway (last)

🏭 Producție

În producție, SSH tunnel-ul este automat dezactivat:

# Production deployment (fără SSH tunnel)
docker-compose -f docker-compose.yml -f docker-compose.production.yml up -d

Backend-ul se conectează direct la Oracle server în producție.

🛠️ Troubleshooting

SSH Tunnel nu pornește:

# Verifică că ai cheia SSH
ls -la ~/.ssh/roa_oracle_server

# Verifică permissions
chmod 600 ~/.ssh/roa_oracle_server

# Restart tunnel container
docker-compose restart roa-ssh-tunnel

Backend nu se conectează la Oracle:

# Check tunnel status
docker-compose exec roa-ssh-tunnel nc -z localhost 1521

# Check backend logs
docker-compose logs -f roa-backend

# Test manual connection
docker-compose exec roa-ssh-tunnel nc -z 10.0.20.36 1521

Connection timeout:

# Verifică că serverul SSH rulează
ssh -p 22122 roa2web@83.103.197.79

# Restart toate serviciile
docker-compose down && docker-compose up --build

📊 Avantaje

✅ Automat: Nu mai trebuie să pornești manual SSH tunnel-ul
✅ Robust: Auto-restart dacă tunnel-ul se întrerupe
✅ Monitorizat: Health checks și logging complet
✅ Development-only: Exclus automat în producție
✅ Containerizat: Izolat în propriul container
✅ Dependencies: Backend așteaptă tunnel-ul să fie gata

Nu mai trebuie să rulezi ./ssh_tunnel.sh start manual - totul e automat în Docker! 🎉

3.2 KiB Raw Blame History