better_app_gen 0.1.0

data/lib/better_app_gen/templates/config/locales/it.yml.erb

@@ -0,0 +1,68 @@
+it:
+  hello: "Ciao mondo"
+
+  # Common translations
+  common:
+    save: "Salva"
+    cancel: "Annulla"
+    edit: "Modifica"
+    delete: "Elimina"
+    create: "Crea"
+    update: "Aggiorna"
+    back: "Indietro"
+    show: "Mostra"
+    confirm: "Sei sicuro?"
+    yes: "Si"
+    no: "No"
+
+  # Date and time
+  date:
+    formats:
+      default: "%d/%m/%Y"
+      short: "%d %b"
+      long: "%d %B %Y"
+
+  time:
+    formats:
+      default: "%d/%m/%Y %H:%M"
+      short: "%d %b %H:%M"
+      long: "%d %B %Y %H:%M:%S"
+
+  # ActiveRecord
+  activerecord:
+    errors:
+      messages:
+        blank: "non puo essere vuoto"
+        too_short: "e troppo corto (minimo %{count} caratteri)"
+        too_long: "e troppo lungo (massimo %{count} caratteri)"
+        invalid: "non e valido"
+        confirmation: "non corrisponde"
+        accepted: "deve essere accettato"
+        empty: "non puo essere vuoto"
+        present: "deve essere vuoto"
+        required: "deve esistere"
+        taken: "e gia stato preso"
+        wrong_length: "ha la lunghezza sbagliata (dovrebbe essere di %{count} caratteri)"
+        not_a_number: "non e un numero"
+        not_an_integer: "deve essere un numero intero"
+        greater_than: "deve essere maggiore di %{count}"
+        greater_than_or_equal_to: "deve essere maggiore o uguale a %{count}"
+        equal_to: "deve essere uguale a %{count}"
+        less_than: "deve essere minore di %{count}"
+        less_than_or_equal_to: "deve essere minore o uguale a %{count}"
+        other_than: "deve essere diverso da %{count}"
+        odd: "deve essere dispari"
+        even: "deve essere pari"
+
+  # Form helpers
+  helpers:
+    submit:
+      create: "Crea %{model}"
+      update: "Aggiorna %{model}"
+      submit: "Salva %{model}"
+
+    select:
+      prompt: "Seleziona..."
+
+    label:
+      required: " *"

data/lib/better_app_gen/templates/config/locales/simple_form.it.yml.erb

@@ -0,0 +1,49 @@
+it:
+  simple_form:
+    "yes": 'Si'
+    "no": 'No'
+    required:
+      text: 'obbligatorio'
+      mark: '*'
+    error_notification:
+      default_message: "Si sono verificati alcuni errori:"
+    labels:
+      defaults:
+        name: 'Nome'
+        email: 'Email'
+        password: 'Password'
+        password_confirmation: 'Conferma password'
+        phone: 'Telefono'
+        address: 'Indirizzo'
+        city: 'Citta'
+        country: 'Paese'
+        description: 'Descrizione'
+        title: 'Titolo'
+        content: 'Contenuto'
+        message: 'Messaggio'
+        subject: 'Oggetto'
+        first_name: 'Nome'
+        last_name: 'Cognome'
+        company: 'Azienda'
+        website: 'Sito web'
+        created_at: 'Creato il'
+        updated_at: 'Aggiornato il'
+    hints:
+      defaults:
+        email: 'Inserisci un indirizzo email valido'
+        password: 'Minimo 8 caratteri'
+        phone: 'Formato: +39 123 456 7890'
+    placeholders:
+      defaults:
+        name: 'Inserisci il nome...'
+        email: 'nome@esempio.com'
+        password: 'Inserisci la password...'
+        phone: '+39 123 456 7890'
+        address: 'Via, numero civico...'
+        city: 'Nome della citta...'
+        description: 'Inserisci una descrizione...'
+        title: 'Inserisci il titolo...'
+        content: 'Inserisci il contenuto...'
+        message: 'Scrivi il tuo messaggio...'
+        subject: 'Oggetto del messaggio...'
+        search: 'Cerca...'

data/lib/better_app_gen/templates/config/routes.rb.erb

@@ -0,0 +1,15 @@
+Rails.application.routes.draw do
+  root "home#index"
+  # Define your application routes per the DSL in https://guides.rubyonrails.org/routing.html
+
+  # Reveal health status on /up that returns 200 if the app boots with no exceptions, otherwise 500.
+  # Can be used by load balancers and uptime monitors to verify that the app is live.
+  get "up" => "rails/health#show", as: :rails_health_check
+
+  # Render dynamic PWA files from app/views/pwa/* (remember to link manifest in application.html.erb)
+  # get "manifest" => "rails/pwa#manifest", as: :pwa_manifest
+  # get "service-worker" => "rails/pwa#service_worker", as: :pwa_service_worker
+
+  # Defines the root path route ("/")
+  # root "posts#index"
+end

data/lib/better_app_gen/templates/db/cable_migrate/create_solid_cable_schema.rb.erb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateSolidCableSchema < ActiveRecord::Migration[8.1]
+  def change
+    create_table :solid_cable_messages, force: :cascade do |t|
+      t.binary :channel, limit: 1024, null: false
+      t.binary :payload, limit: 536870912, null: false
+      t.datetime :created_at, null: false
+      t.integer :channel_hash, limit: 8, null: false
+      t.index :channel, name: "index_solid_cable_messages_on_channel"
+      t.index :channel_hash, name: "index_solid_cable_messages_on_channel_hash"
+      t.index :created_at, name: "index_solid_cable_messages_on_created_at"
+    end
+  end
+end

data/lib/better_app_gen/templates/db/cache_migrate/create_solid_cache_schema.rb.erb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreateSolidCacheSchema < ActiveRecord::Migration[8.1]
+  def change
+    create_table :solid_cache_entries, force: :cascade do |t|
+      t.binary :key, limit: 1024, null: false
+      t.binary :value, limit: 536870912, null: false
+      t.datetime :created_at, null: false
+      t.integer :key_hash, limit: 8, null: false
+      t.integer :byte_size, limit: 4, null: false
+      t.index :byte_size, name: "index_solid_cache_entries_on_byte_size"
+      t.index [ :key_hash, :byte_size ], name: "index_solid_cache_entries_on_key_hash_and_byte_size"
+      t.index :key_hash, name: "index_solid_cache_entries_on_key_hash", unique: true
+    end
+  end
+end

data/lib/better_app_gen/templates/db/migrate/create_shared_schema.rb.erb

@@ -0,0 +1,31 @@
+# This migration creates a 'shared' schema in PostgreSQL
+# Use this schema for tables that need to be accessed across different contexts
+# Examples: lookup tables, configurations, multi-tenant shared data
+class CreateSharedSchema < ActiveRecord::Migration[8.0]
+  def up
+    # Create the shared schema if it doesn't exist
+    execute "CREATE SCHEMA IF NOT EXISTS shared"
+
+    # Grant usage permissions to the current database user
+    # This ensures the application can access tables in the shared schema
+    execute "GRANT USAGE ON SCHEMA shared TO CURRENT_USER"
+    execute "GRANT CREATE ON SCHEMA shared TO CURRENT_USER"
+
+    # Optional: Add shared schema to search_path for easier access
+    # Uncomment if you want shared schema tables accessible without schema prefix
+    # execute <<-SQL
+    #   ALTER DATABASE #{connection.current_database}
+    #   SET search_path TO "$user", public, shared;
+    # SQL
+
+    Rails.logger.info "Created 'shared' schema successfully"
+  end
+
+  def down
+    # Drop the shared schema and all its contents
+    # CASCADE will drop all tables, views, and other objects in the schema
+    execute "DROP SCHEMA IF EXISTS shared CASCADE"
+
+    Rails.logger.info "Dropped 'shared' schema"
+  end
+end

data/lib/better_app_gen/templates/db/migrate/enable_uuid_extension.rb.erb

@@ -0,0 +1,7 @@
+# This migration enables UUID support in PostgreSQL
+# It should be the first migration run in any new Rails application
+class EnableUuidExtension < ActiveRecord::Migration[8.0]
+  def change
+    enable_extension 'pgcrypto' unless extension_enabled?('pgcrypto')
+  end
+end

data/lib/better_app_gen/templates/db/queue_migrate/create_solid_queue_schema.rb.erb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+class CreateSolidQueueSchema < ActiveRecord::Migration[8.1]
+  def change
+    create_table :solid_queue_blocked_executions, force: :cascade do |t|
+      t.bigint :job_id, null: false
+      t.string :queue_name, null: false
+      t.integer :priority, default: 0, null: false
+      t.string :concurrency_key, null: false
+      t.datetime :expires_at, null: false
+      t.datetime :created_at, null: false
+      t.index [ :concurrency_key, :priority, :job_id ], name: "index_solid_queue_blocked_executions_for_release"
+      t.index [ :expires_at, :concurrency_key ], name: "index_solid_queue_blocked_executions_for_maintenance"
+      t.index [ :job_id ], name: "index_solid_queue_blocked_executions_on_job_id", unique: true
+    end
+
+    create_table :solid_queue_claimed_executions, force: :cascade do |t|
+      t.bigint :job_id, null: false
+      t.bigint :process_id
+      t.datetime :created_at, null: false
+      t.index [ :job_id ], name: "index_solid_queue_claimed_executions_on_job_id", unique: true
+      t.index [ :process_id, :job_id ], name: "index_solid_queue_claimed_executions_on_process_id_and_job_id"
+    end
+
+    create_table :solid_queue_failed_executions, force: :cascade do |t|
+      t.bigint :job_id, null: false
+      t.text :error
+      t.datetime :created_at, null: false
+      t.index [ :job_id ], name: "index_solid_queue_failed_executions_on_job_id", unique: true
+    end
+
+    create_table :solid_queue_jobs, force: :cascade do |t|
+      t.string :queue_name, null: false
+      t.string :class_name, null: false
+      t.text :arguments
+      t.integer :priority, default: 0, null: false
+      t.string :active_job_id
+      t.datetime :scheduled_at
+      t.datetime :finished_at
+      t.string :concurrency_key
+      t.datetime :created_at, null: false
+      t.datetime :updated_at, null: false
+      t.index [ :active_job_id ], name: "index_solid_queue_jobs_on_active_job_id"
+      t.index [ :class_name ], name: "index_solid_queue_jobs_on_class_name"
+      t.index [ :finished_at ], name: "index_solid_queue_jobs_on_finished_at"
+      t.index [ :queue_name, :finished_at ], name: "index_solid_queue_jobs_for_filtering"
+      t.index [ :scheduled_at, :finished_at ], name: "index_solid_queue_jobs_for_alerting"
+    end
+
+    create_table :solid_queue_pauses, force: :cascade do |t|
+      t.string :queue_name, null: false
+      t.datetime :created_at, null: false
+      t.index [ :queue_name ], name: "index_solid_queue_pauses_on_queue_name", unique: true
+    end
+
+    create_table :solid_queue_processes, force: :cascade do |t|
+      t.string :kind, null: false
+      t.datetime :last_heartbeat_at, null: false
+      t.bigint :supervisor_id
+      t.integer :pid, null: false
+      t.string :hostname
+      t.text :metadata
+      t.datetime :created_at, null: false
+      t.string :name, null: false
+      t.index [ :last_heartbeat_at ], name: "index_solid_queue_processes_on_last_heartbeat_at"
+      t.index [ :name, :supervisor_id ], name: "index_solid_queue_processes_on_name_and_supervisor_id", unique: true
+      t.index [ :supervisor_id ], name: "index_solid_queue_processes_on_supervisor_id"
+    end
+
+    create_table :solid_queue_ready_executions, force: :cascade do |t|
+      t.bigint :job_id, null: false
+      t.string :queue_name, null: false
+      t.integer :priority, default: 0, null: false
+      t.datetime :created_at, null: false
+      t.index [ :job_id ], name: "index_solid_queue_ready_executions_on_job_id", unique: true
+      t.index [ :priority, :job_id ], name: "index_solid_queue_poll_all"
+      t.index [ :queue_name, :priority, :job_id ], name: "index_solid_queue_poll_by_queue"
+    end
+
+    create_table :solid_queue_recurring_executions, force: :cascade do |t|
+      t.bigint :job_id, null: false
+      t.string :task_key, null: false
+      t.datetime :run_at, null: false
+      t.datetime :created_at, null: false
+      t.index [ :job_id ], name: "index_solid_queue_recurring_executions_on_job_id", unique: true
+      t.index [ :task_key, :run_at ], name: "index_solid_queue_recurring_executions_on_task_key_and_run_at", unique: true
+    end
+
+    create_table :solid_queue_recurring_tasks, force: :cascade do |t|
+      t.string :key, null: false
+      t.string :schedule, null: false
+      t.string :command, limit: 2048
+      t.string :class_name
+      t.text :arguments
+      t.string :queue_name
+      t.integer :priority, default: 0
+      t.boolean :static, default: true, null: false
+      t.text :description
+      t.datetime :created_at, null: false
+      t.datetime :updated_at, null: false
+      t.index [ :key ], name: "index_solid_queue_recurring_tasks_on_key", unique: true
+      t.index [ :static ], name: "index_solid_queue_recurring_tasks_on_static"
+    end
+
+    create_table :solid_queue_scheduled_executions, force: :cascade do |t|
+      t.bigint :job_id, null: false
+      t.string :queue_name, null: false
+      t.integer :priority, default: 0, null: false
+      t.datetime :scheduled_at, null: false
+      t.datetime :created_at, null: false
+      t.index [ :job_id ], name: "index_solid_queue_scheduled_executions_on_job_id", unique: true
+      t.index [ :scheduled_at, :priority, :job_id ], name: "index_solid_queue_dispatch_all"
+    end
+
+    create_table :solid_queue_semaphores, force: :cascade do |t|
+      t.string :key, null: false
+      t.integer :value, default: 1, null: false
+      t.datetime :expires_at, null: false
+      t.datetime :created_at, null: false
+      t.datetime :updated_at, null: false
+      t.index [ :expires_at ], name: "index_solid_queue_semaphores_on_expires_at"
+      t.index [ :key, :value ], name: "index_solid_queue_semaphores_on_key_and_value"
+      t.index [ :key ], name: "index_solid_queue_semaphores_on_key", unique: true
+    end
+
+    add_foreign_key :solid_queue_blocked_executions, :solid_queue_jobs, column: :job_id, on_delete: :cascade
+    add_foreign_key :solid_queue_claimed_executions, :solid_queue_jobs, column: :job_id, on_delete: :cascade
+    add_foreign_key :solid_queue_failed_executions, :solid_queue_jobs, column: :job_id, on_delete: :cascade
+    add_foreign_key :solid_queue_ready_executions, :solid_queue_jobs, column: :job_id, on_delete: :cascade
+    add_foreign_key :solid_queue_recurring_executions, :solid_queue_jobs, column: :job_id, on_delete: :cascade
+    add_foreign_key :solid_queue_scheduled_executions, :solid_queue_jobs, column: :job_id, on_delete: :cascade
+  end
+end

data/lib/better_app_gen/templates/docker/DEPLOY.md.erb

@@ -0,0 +1,129 @@
+# Deploy su Dokploy
+
+Guida per configurare il deploy con zero-downtime su Dokploy.
+
+## Prerequisiti
+
+- Dokploy installato e configurato
+- Repository Git accessibile da Dokploy
+- Database PostgreSQL 17+ raggiungibile dalla rete Dokploy
+
+## Creare il Progetto
+
+1. In Dokploy, clicca **Create Project**
+2. Seleziona **Docker** (non Compose)
+3. Collega il repository Git
+
+## Configurazione Build
+
+| Campo           | Valore                    |
+| --------------- | ------------------------- |
+| Dockerfile Path | `.docker/Dockerfile.prod` |
+| Build Context   | `.`                       |
+
+## Variabili d'Ambiente
+
+Configura le seguenti variabili in **Environment**:
+
+```bash
+# Database (tutte puntano allo stesso PostgreSQL, database diversi)
+DATABASE_URL=postgresql://user:password@host:5432/<%= @config.app_name_snake %>_production
+CACHE_DATABASE_URL=postgresql://user:password@host:5432/<%= @config.app_name_snake %>_production_cache
+QUEUE_DATABASE_URL=postgresql://user:password@host:5432/<%= @config.app_name_snake %>_production_queue
+CABLE_DATABASE_URL=postgresql://user:password@host:5432/<%= @config.app_name_snake %>_production_cable
+
+# Rails
+RAILS_ENV=production
+SECRET_KEY_BASE=<genera con: rails secret>
+
+# Opzionali
+RAILS_MAX_THREADS=3
+RAILS_LOG_TO_STDOUT=true
+```
+
+## Zero-Downtime Deployment
+
+Per abilitare il deploy senza downtime:
+
+1. Vai in **Advanced** → **Swarm Settings**
+2. Nella sezione **Health Check**, incolla:
+
+```json
+{
+  "Test": ["CMD", "curl", "-f", "http://localhost:3000/up"],
+  "Interval": 30000000000,
+  "Timeout": 10000000000,
+  "StartPeriod": 60000000000,
+  "Retries": 3
+}
+```
+
+### Spiegazione parametri (in nanosecondi)
+
+| Parametro   | Valore | Descrizione                                |
+| ----------- | ------ | ------------------------------------------ |
+| Interval    | 30s    | Frequenza del check                        |
+| Timeout     | 10s    | Timeout per ogni check                     |
+| StartPeriod | 60s    | Tempo di grazia all'avvio (per migrazioni) |
+| Retries     | 3      | Tentativi prima di considerare unhealthy   |
+
+## Rete
+
+Assicurati che il container possa raggiungere PostgreSQL. Se usi una rete esterna:
+
+1. Vai in **Advanced** → **Network**
+2. Aggiungi la rete dove si trova PostgreSQL (es. `dokploy-network`)
+
+## Primo Deploy
+
+Al primo deploy:
+
+1. Il container eseguirà automaticamente `rails db:prepare`
+2. Questo crea i database e esegue le migrazioni
+3. Verifica i log per eventuali errori
+
+## Deploy Successivi
+
+1. Push sul branch configurato
+2. Dokploy builda la nuova immagine
+3. Avvia il nuovo container
+4. Aspetta che l'health check passi
+5. Rimuove il vecchio container (zero-downtime)
+
+## Architettura
+
+```
+┌─────────────────────────────────────────┐
+│              Container Puma             │
+│                                         │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
+│  │  Rails  │  │  Solid  │  │  Solid  │ │
+│  │   Web   │  │  Queue  │  │  Cable  │ │
+│  └────┬────┘  └────┬────┘  └────┬────┘ │
+│       │            │            │       │
+└───────┼────────────┼────────────┼───────┘
+        │            │            │
+        ▼            ▼            ▼
+┌─────────────────────────────────────────┐
+│           PostgreSQL 17+                │
+│  ┌─────────┐ ┌───────┐ ┌───────┐ ┌────┐│
+│  │ primary │ │ cache │ │ queue │ │cable││
+│  └─────────┘ └───────┘ └───────┘ └────┘│
+└─────────────────────────────────────────┘
+```
+
+## Troubleshooting
+
+### Container non parte
+
+Controlla i log per errori di connessione al database o migrazioni fallite.
+
+### Health check fallisce
+
+- Verifica che la porta 3000 sia esposta
+- Controlla che `/up` risponda (è il Rails health check endpoint)
+- Aumenta `StartPeriod` se le migrazioni sono lente
+
+### Jobs non processati
+
+Verifica che `SOLID_QUEUE_IN_PUMA=true` sia impostato nel Dockerfile (già configurato).

data/lib/better_app_gen/templates/docker/Dockerfile.dev.erb

@@ -0,0 +1,58 @@
+# syntax=docker/dockerfile:1
+# check=error=true
+
+ARG RUBY_VERSION=3.4.3
+FROM docker.io/library/ruby:$RUBY_VERSION-slim-bookworm AS base
+
+ARG NODE_VERSION=24.1.0
+# Yarn version managed via Corepack + packageManager field in package.json
+
+# Setup workdir
+RUN mkdir /app
+WORKDIR /app
+
+# Setup ENV
+ENV PORT=<%= rails_port %>
+ENV BUNDLE_PATH=/bundle
+ENV BUNDLE_BIN=/bundle/bin
+ENV GEM_HOME=/bundle
+ENV PATH="${BUNDLE_BIN}:${PATH}"
+ENV PATH="/usr/local/node/bin:$PATH"
+ENV LC_ALL=C.UTF-8
+ENV LANG=C.UTF-8
+ENV LANGUAGE=C.UTF-8
+
+# System dependencies
+RUN apt-get update  \
+    && apt-get upgrade -y  \
+    && apt-get install -y lsb-release curl imagemagick libpq5 libjemalloc2 \
+    && install -d /usr/share/postgresql-common/pgdg \
+    && curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc \
+    && sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list' \
+    && apt update \
+    && apt-get install -y build-essential curl libxslt-dev libxml2-dev libpq-dev libjemalloc-dev libyaml-dev git postgresql-client-16 \
+    && curl -sL https://github.com/nodenv/node-build/archive/master.tar.gz | tar xz -C /tmp/ \
+    && /tmp/node-build-master/bin/node-build "${NODE_VERSION}" /usr/local/node \
+    && corepack enable \
+    && rm -rf /tmp/node-build-master \
+    && rm -rf /var/lib/apt/lists/*
+
+# Jemalloc setup
+RUN ln -s /usr/lib/*/libjemalloc.so.2 /usr/lib/libjemalloc.so.2
+ENV LD_PRELOAD="/usr/lib/libjemalloc.so.2"
+ENV MALLOC_CONF="dirty_decay_ms:1000,narenas:2,background_thread:true"
+ENV RUBY_YJIT_ENABLE="1"
+
+# Update gems
+RUN gem update --system \
+    && gem install bundler -v '=2.7.1' \
+    && gem cleanup
+
+# Setup entrypoint
+COPY bin/docker-entrypoint /app/bin/docker-entrypoint
+RUN chmod +x /app/bin/docker-entrypoint
+ENTRYPOINT ["/app/bin/docker-entrypoint"]
+
+# Start the main process.
+EXPOSE ${PORT}
+CMD ["sh", "-c", "./bin/rails server -b 0.0.0.0 -p ${PORT:-<%= rails_port %>}"]