# Genera automaticamente requirements.txt
pip freeze > requirements.txt

Flask==2.3.2
Flask-SQLAlchemy==3.0.5
Flask-Login==0.6.2
Flask-WTF==1.1.1
Flask-Bcrypt==1.0.1
SQLAlchemy==2.0.19
Werkzeug==2.3.6
python-dotenv==1.0.0
gunicorn==20.1.0
psycopg2-binary==2.9.7

# Ambiente
FLASK_ENV=production
FLASK_DEBUG=False

# Database
DATABASE_URL=postgresql://user:password@localhost/dbname
# O per SQLite
# DATABASE_URL=sqlite:///app.db

# Segreti
SECRET_KEY=la_tua_chiave_segreta_molto_lunga_e_complessa
JWT_SECRET_KEY=altra_chiave_segreta_per_jwt

# Email (se usi email)
MAIL_SERVER=smtp.gmail.com
MAIL_PORT=587
MAIL_USE_TLS=True
MAIL_USERNAME=tuamail@gmail.com
MAIL_PASSWORD=tua_password_app_specifica

import os
from flask import Flask
from dotenv import load_dotenv

# Carica variabili d'ambiente da .env
load_dotenv()

app = Flask(__name__)

# Configurazione da variabili d'ambiente
app.config['SECRET_KEY'] = os.getenv('SECRET_KEY', 'fallback-secret-key')
app.config['SQLALCHEMY_DATABASE_URI'] = os.getenv('DATABASE_URL')
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

# Debug mode solo in sviluppo
app.config['DEBUG'] = os.getenv('FLASK_DEBUG', 'False').lower() == 'true'

# Configurazione produzione
if not app.debug:
    app.config.update(
        SESSION_COOKIE_SECURE=True,
        SESSION_COOKIE_HTTPONLY=True,
        SESSION_COOKIE_SAMESITE='Lax',
        PERMANENT_SESSION_LIFETIME=3600
    )

pip install gunicorn

from app import app

if __name__ == "__main__":
    app.run()

# Semplice
gunicorn app:app

# Con 4 worker (processi)
gunicorn --workers 4 app:app

# Su porta specifica
gunicorn --bind 0.0.0.0:8000 app:app

# Con logging
gunicorn --access-logfile - --error-logfile - app:app

# Per applicazioni più complesse
gunicorn --workers 4 --bind unix:app.sock -m 007 wsgi:app

web: gunicorn app:app

# Se il file principale si chiama wsgi.py
web: gunicorn wsgi:app

# Con worker multipli
web: gunicorn --workers 4 app:app

# Se usi un'app factory
web: gunicorn "app:create_app()"

python-3.11.0

flask-app/
├── app.py              ← File principale
├── wsgi.py            ← Entry point WSGI
├── requirements.txt    ← Dipendenze
├── Procfile           ← Comando di avvio
├── runtime.txt        ← Versione Python (opzionale)
├── .env              ← Variabili locali (NON commitare!)
├── .gitignore        ← Esclude .env, __pycache__, etc.
├── static/
├── templates/
├── models.py
├── forms.py
└── README.md

services:
  - type: web
    name: flask-app
    env: python
    buildCommand: pip install -r requirements.txt
    startCommand: gunicorn app:app
    envVars:
      - key: SECRET_KEY
        generateValue: true
      - key: DATABASE_URL
        fromDatabase:
          name: flask-db
          property: connectionString
      - key: FLASK_ENV
        value: production

databases:
  - name: flask-db
    databaseName: flaskdb
    user: flaskuser

import os
from flask_sqlalchemy import SQLAlchemy
from urllib.parse import urlparse

app = Flask(__name__)

# Prendi URL database da variabile d'ambiente
database_url = os.getenv('DATABASE_URL')

# Railway/Render forniscono DATABASE_URL già formattata
if database_url:
    # Gestisci caso di Railway che usa postgres:// invece di postgresql://
    if database_url.startswith('postgres://'):
        database_url = database_url.replace('postgres://', 'postgresql://', 1)
    
    app.config['SQLALCHEMY_DATABASE_URI'] = database_url
else:
    # Fallback a SQLite per sviluppo
    app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///app.db'

app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)

# In produzione, prima del deploy
flask db upgrade

# O in Railway/Render, aggiungi build command
# buildCommand: "pip install -r requirements.txt && flask db upgrade"

# Se qualcosa va storto
flask db downgrade  # Torna indietro di una migrazione
flask db current    # Vedi migrazione corrente

1. Vai su Settings del tuo progetto
2. Click "Domains"
3. Aggiungi il tuo dominio (es: app.tuonome.com)
4. Railway mostrerà record DNS da aggiungere
5. Vai dal tuo registrar di dominio (es: GoDaddy, Namecheap)
6. Aggiungi i record CNAME/A forniti
7. Attendi propagazione DNS (fino a 48h)

import logging
from logging.handlers import RotatingFileHandler
import os

def setup_logging(app):
    if not app.debug:
        # Crea directory logs se non esiste
        if not os.path.exists('logs'):
            os.mkdir('logs')
        
        # File handler con rotazione
        file_handler = RotatingFileHandler(
            'logs/flask_app.log',
            maxBytes=10240,
            backupCount=10
        )
        file_handler.setFormatter(logging.Formatter(
            '%(asctime)s %(levelname)s: %(message)s [in %(pathname)s:%(lineno)d]'
        ))
        file_handler.setLevel(logging.INFO)
        
        app.logger.addHandler(file_handler)
        app.logger.setLevel(logging.INFO)
        app.logger.info('Flask app startup')

# Nel create_app()
setup_logging(app)

# Controlla logs su Railway/Render
Error: No module named 'flask'
→ requirements.txt mancante o incompleto

Error: Address already in use
→ Porta già occupata, cambia PORT in variabili

Error: ImportError
→ Controlla i percorsi degli import

Application error
→ Controlla logs per dettagli specifici

OperationalError: could not connect to server
→ DATABASE_URL non configurata o errata

ProgrammingError: relation does not exist
→ Migrazioni non applicate: flask db upgrade

InterfaceError: connection already closed
→ Timeout connessione, controlla pool size

psycopg2.OperationalError
→ Database non esiste o credenziali errate

# In produzione, Flask non serve static files
# Configura web server o usa CDN

# Soluzione 1: Usa whitenoise
pip install whitenoise

# In app.py
from whitenoise import WhiteNoise
app.wsgi_app = WhiteNoise(app.wsgi_app, root='static/')

# Soluzione 2: Configura nginx/apache
# Soluzione 3: Usa CDN (Cloudflare, AWS CloudFront)

# Modelli principali
User (id, username, email, password_hash, is_admin)
Post (id, title, content, created_at, user_id)
Comment (id, content, created_at, user_id, post_id)
Category (id, name)
Tag (id, name)

# Relazioni
User 1→N Post
User 1→N Comment
Post 1→N Comment
Post N→N Category
Post N→N Tag