☂ Matilda - Project manager for better companies

Matilda è un'applicazione web per la gestione dei progetti, sviluppata in Ruby on Rails.

Matilda è un progetto open source e può essere utilizzata liberamente. È possibile contribuire al progetto segnalando bug, suggerendo nuove funzionalità o contribuendo con codice.

🧑‍💻 Installazione

L'applicazione può essere installata in locale o su un server cloud tramite Docker. L'applicazione non richiede specifiche dipendenze, ma è consigliato l'uso di PostgreSQL come database.

Requisiti

• Docker
• Docker Compose

Installazione

# Clona il repository
git clone
cd matilda
# Crea il docker-compose.yml (e modifica le variabili d'ambiente se necessario)
cp docker-compose.example.yml docker-compose.yml
# Builda l'immagine Docker
docker compose build
# Crea il database ed esegui le migrazioni
docker compose run matilda bin/rails db:migrate
# Crea un utente admin per l'accesso al pannello [OPZIONALE]
docker compose run matilda bin/rails create_default_admin
# Crea dati di default per iniziare a usare l'applicazione [OPZIONALE]
docker compose run matilda bin/rails create_default_data
# Avvia il container
docker compose up

Se non hai eseguito il comando per creare un utente admin, puoi registrare il primo utente amministratore tramite la pagina di registrazione. Altrimenti puoi accedere al pannello con l'email [email protected] e password Password1!.

Configurazione

Per eseguire l'applicazione correttamente è necessario configurare le seguenti variabili d'ambiente:

Impostazioni Rails

• RAILS_ENV: Ambiente di esecuzione dell'applicazione (default: development)
• RAILS_SERVE_STATIC_FILES: Serve i file statici (default: disabled, options: enabled/disabled)
• RAILS_LOG_TO_STDOUT: Invia i log a STDOUT (default: disabled, options: enabled/disabled)
• RAILS_LOG_LEVEL: Livello di log dell'applicazione (default: error)
• RAILS_SERVERLESS_MODE: Modalità serverless (default: disabled, options: enabled/disabled)

Impostazioni di sicurezza

• SECRET_KEY_BASE: Chiave segreta per la generazione dei token di autenticazione
• ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY: Chiave primaria per la crittografia dei dati sensibili (default: unsafe)
• ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY: Chiave deterministica per la crittografia dei dati sensibili (default: unsafe)
• ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT: Sale per la derivazione della chiave di crittografia (default: unsafe)

Configurazione del database

• DATABASE_URL: URL di connessione al database PostgreSQL (Se non specificato, l'applicazione utilizzerà SQLite3)

Configurazione SMTP per l'invio delle email

• SMTP_USER_NAME: Nome utente per l'invio delle email (se non specificato, l'applicazione non invierà email)
• SMTP_PASSWORD: Password per l'invio delle email (se non specificato, l'applicazione non invierà email)
• SMTP_ADDRESS: Indirizzo del server SMTP (se non specificato, l'applicazione non invierà email)
• SMTP_DOMAIN: Dominio del server SMTP (se non specificato, l'applicazione non invierà email)
• SMTP_PORT: Porta del server SMTP (se non specificato, l'applicazione non invierà email)

Configurazione del bucket S3 compatibile

• BUCKET_ACCESS_KEY: Chiave di accesso per il bucket S3 (se non specificato, l'applicazione utilizzerà il filesystem locale)
• BUCKET_ACCESS_KEY_SECRET: Chiave segreta per il bucket S3 (se non specificato, l'applicazione utilizzerà il filesystem locale)
• BUCKET_REGION: Regione del bucket S3 (se non specificato, l'applicazione utilizzerà il filesystem locale)
• BUCKET_NAME: Nome del bucket S3 (se non specificato, l'applicazione utilizzerà il filesystem locale)

Configurazione di Matilda

• MATILDA_MAIL_FROM: Indirizzo email del mittente (default Matilda <[email protected]>)
• MATILDA_HOST: Indirizzo host dell'applicazione (default matilda.local)

Configurazione tramite credentials

In alternativa, per mantenere lo standard di Ruby on Rails, è possibile utilizzare il file config/credentials.yml.enc per memorizzare la configurazione. Per farlo, eseguire il comando:

EDITOR="nano" rails credentials:edit

Di seguito è riportato un esempio di file credentials.yml.enc:

# config/credentials.yml.enc
secret_key_base: example_secret_key_base

active_record_encryption:
  primary_key: example_primary_key
  deterministic_key: example_deterministic_key
  key_derivation_salt: example_key_derivation_salt

smtp:
  user_name: [email protected]
  password: example_password
  domain: example.com
  address: mail.example.com
  port: 587

bucket:
  region: eu-central-1
  access_key_id: example_access_key_id
  access_key_secret: example_access_key_secret
  bucket: example_bucket

💬 Integrazioni

Slack

Matilda può essere integrata con Slack per creare automaticamente i canali dei progetti e inviare notifiche e aggiornamenti. Per configurare l'integrazione con Slack, è necessario creare un'app Slack e inserire i seguenti parametri di configurazione:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗