Contribuer

TrocOS est open source et porté par sa communauté. Issues, merge requests et idées sont les bienvenus.

Dépôt : gitlab.com/cdlr75/trocos

Stack technique

• Rails 8 — framework web
• PostgreSQL — base de données
• Bulma — framework CSS
• Hotwire (Turbo + Stimulus) — UI réactive sans framework JS
• Solid Queue — jobs en arrière-plan
• OmniAuth — connexion GitHub, Discord, Slack
• Pundit — autorisation
• double_entry — registre de la banque de temps

Lancer en local

git clone https://gitlab.com/cdlr75/trocos.git
cd trocos
bin/setup

Démarrer PostgreSQL (Docker) :

docker run -d --name trocos_postgres \
  -e POSTGRES_USER=trocos \
  -e POSTGRES_PASSWORD=trocos \
  -e POSTGRES_DB=trocos_development \
  -p 5432:5432 postgres:16

bin/rails db:create db:migrate db:seed
bin/rails trocos:setup
bin/dev

Lancer les tests

bin/rails test

Contribuer

1. Forkez le dépôt sur GitLab
2. Créez une branche pour votre modification
3. Écrivez des tests pour les nouveaux comportements
4. Ouvrez une merge request avec une description claire

Pour les changements importants, ouvrez d'abord une issue pour discuter de l'approche.