Skip to content

architecture.md

Latest commit

 

History

History
68 lines (52 loc) · 2.93 KB

architecture.md

File metadata and controls

68 lines (52 loc) · 2.93 KB

Architecture de l'application

Structure MVC+

Le Circographe suit une architecture MVC étendue avec des services, des présentateurs et des jobs:

app/
├── models/               # Modèles ActiveRecord
├── views/                # Vues (ERB, Slim)
├── controllers/          # Contrôleurs
├── services/             # Services métier
├── presenters/           # Présentateurs pour les vues
├── jobs/                 # Jobs ActiveJob
├── mailers/              # Mailers pour les emails
├── helpers/              # Helpers pour les vues
├── assets/               # Assets (JS, CSS, images)
│   ├── javascripts/
│   ├── stylesheets/
│   └── images/
├── javascript/           # JavaScript moderne (Stimulus)
└── components/           # Composants View Component

Domaines métier

L'application est organisée autour de six domaines métier principaux:

  1. Adhésion - Gestion des adhérents et de leur statut
  2. Cotisation - Gestion des cotisations et des tarifs
  3. Paiement - Gestion des paiements et des factures
  4. Présence - Gestion des présences aux activités
  5. Rôles - Gestion des rôles et des permissions
  6. Notification - Gestion des notifications et des communications

Chaque domaine est implémenté avec ses propres modèles, contrôleurs, services et vues.

Stack technique

Backend

Composant Technologie Documentation
Framework Ruby on Rails 8.0.1 Documentation Rails
Base de données SQLite3 Documentation SQLite
Authentification Authentification native Rails 8 Documentation Rails Authentication
Autorisation Système d'autorisation personnalisé Spécifications Rôles
Jobs asynchrones ActiveJob Documentation ActiveJob
Planification Rufus-Scheduler Documentation Rufus
Tests RSpec, FactoryBot Documentation RSpec

Frontend

Composant Technologie Documentation
CSS Tailwind CSS Documentation Tailwind
Composants Flowbite Documentation Flowbite
JavaScript Hotwire (Turbo, Stimulus) Documentation Hotwire
Formulaires Simple Form Documentation Simple Form
Pagination Pagy Documentation Pagy

Diagrammes d'architecture

Les diagrammes d'architecture de l'application sont disponibles dans le dossier ../assets/diagrams/.

Dernière mise à jour: Mars 2023