Structure des données

Introduction

Cette documentation décrit la structure complète de la base de données PostgreSQL utilisée par l'application. Le schéma est géré via Doctrine ORM et comprend les entités pour la gestion des demandes de maintenance, des dépannages, des équipements, des offres et des contrats.

Vue d'ensemble

La base de données est organisée en plusieurs domaines métier :

• Maintenance : Demandes de maintenance, offres, équipements, contrats, prix, réductions
• Troubleshooting : Demandes de dépannage avec diagnostics
• Equipment : Catégories, types et marques d'équipements
• MaintenanceOffer : Offres de maintenance avec caractéristiques
• Référentiels : Civilités, codes postaux, paramètres, raisons de refus
• Authentification : Admins, tokens de rafraîchissement, réinitialisation de mot de passe

Schéma de la base de données

erDiagram
    ADMIN ||--o{ RESET_PASSWORD_REQUEST : has
    ADMIN ||--o{ REFRESH_TOKEN : has
    
    REQUEST ||--|| OFFER : has
    REQUEST ||--|| ADDRESS_CONTACT : has
    REQUEST ||--o| ADDRESS_BILLING : has
    REQUEST ||--o{ EQUIPMENT : contains
    REQUEST ||--o{ CONTRACT : generates
    REQUEST ||--o| REFUSAL : may_have
    REQUEST }o--|| DISCOUNT : may_have
    
    OFFER ||--|| PRICE : has
    OFFER }o--|| MAINTENANCE_OFFER : references
    
    MAINTENANCE_OFFER ||--o{ FEATURE : has
    
    EQUIPMENT }o--|| BRAND : references
    EQUIPMENT }o--|| TYPE : references
    
    TYPE }o--|| CATEGORY : belongs_to
    CATEGORY ||--o{ COEFFICIENT_RATE : has
    
    CONTRACT }o--|| REQUEST : belongs_to
    
    REFUSAL ||--o{ REFUSAL_REASON : has
    REFUSAL }o--|| REQUEST : belongs_to
    
    ADDRESS }o--|| CIVILITY : references
    
    TROUBLESHOOTING ||--|| ADDRESS : has
    TROUBLESHOOTING ||--o{ DIAGNOSIS : has
    
    ADMIN {
        int id PK
        string email UK
        array roles
        string password
    }
    
    REQUEST {
        uuid id PK
        datetime_immutable createdAt
        datetime_immutable updatedAt
        datetime_immutable expiredAt
        string status
        string paymentId
        string paymentStatus
        string paymentUrl
        boolean lessThanTwoYears
        datetime_immutable deletedAt
        datetime_immutable archivedAt
    }
    
    OFFER {
        uuid id PK
        uuid request_id FK
        int maintenanceOffer_id FK
        string paymentType
    }
    
    PRICE {
        int id PK
        uuid offer_id FK
        int ht
        int htBase
        int ttc
        int ttcBase
        int htTotal
        int htTotalBase
        int ttcTotal
        int ttcTotalBase
        boolean discount
        array details
    }
    
    EQUIPMENT {
        int id PK
        uuid request_id FK
        int brand_id FK
        int type_id FK
        date_immutable installedAt
        int uiDuctable
        int uiNotDuctable
    }
    
    CONTRACT {
        uuid id PK
        uuid request_id FK
        string path
        string signId
        string signUrl
        string status
        datetime_immutable expiredAt
        datetime_immutable createdAt
        string savId
    }
    
    MAINTENANCE_OFFER {
        int id PK
        string name
        string savLabel
        int subscriptionDuration
        int subscriptionVisit
        text description
        int loyaltyDiscount
        float coefficient
        string type
        boolean best
        int position
    }
    
    FEATURE {
        int id PK
        string label
    }
    
    CATEGORY {
        int id PK
        string name
        string savLabel
    }
    
    TYPE {
        int id PK
        int category_id FK
        string name
        string savLabel
        string section
        float hourlyPrice
        float hourRequire
        float supplyPrice
        float individualVAT
        float professionalVAT
    }
    
    BRAND {
        int id PK
        string name
        string savLabel
    }
    
    COEFFICIENT_RATE {
        int id PK
        int category_id FK
        int minEquipment
        float coefficient
    }
    
    ADDRESS {
        int id PK
        int civility_id FK
        string name
        string lastname
        boolean isPro
        string companyName
        string siret
        string vatNumber
        string street
        string additionalInfo
        string postalCode
        string city
        string email
        string phone
    }
    
    DISCOUNT {
        int id PK
        uuid request_id FK
        string name
        string code UK
        string type
        int amount
        boolean enabled
        datetime_immutable startAt
        datetime_immutable endAt
    }
    
    REFUSAL {
        uuid id PK
        uuid request_id FK
        text comment
        datetime_immutable createdAt
    }
    
    REFUSAL_REASON {
        int id PK
        string name
    }
    
    TROUBLESHOOTING {
        uuid id PK
        int address_id FK
        boolean hasContract
        text details
        array availability
        text availabilityDetails
        string status
        text comments
        datetime_immutable createdAt
        datetime_immutable updatedAt
    }
    
    DIAGNOSIS {
        int id PK
        string name
    }
    
    CIVILITY {
        int id PK
        string name
        string savLabel
    }
    
    POSTAL_CODE {
        int id PK
        string code UK
        string label
        float price
        float diagnosisPrice
    }
    
    PARAMETER {
        int id PK
        string code UK
        string label
        string value
    }

Tables principales

Maintenance

request (Maintenance\Request)

Table principale pour les demandes de maintenance.

Relations :

• OneToOne → offer (Maintenance\Offer)
• OneToOne → contact (Address)
• OneToOne → billing_info (Address)
• OneToMany → equipments (Maintenance\Equipment)
• OneToMany → contracts (Maintenance\Contract)
• OneToOne → refusal (Maintenance\Refusal)
• ManyToOne → discount (Maintenance\Discount)

request_offer (Maintenance\Offer)

Offres associées aux demandes.

Relations :

• ManyToOne → request (Maintenance\Request)
• ManyToOne → maintenanceOffer (MaintenanceOffer\MaintenanceOffer)
• OneToOne → price (Maintenance\Price)

request_equipment (Maintenance\Equipment)

Équipements associés à une demande.

Relations :

• ManyToOne → request (Maintenance\Request)
• ManyToOne → brand (Equipment\Brand)
• ManyToOne → type (Equipment\Type)

request_contract (Maintenance\Contract)

Contrats générés pour les demandes.

Relations :

• ManyToOne → request (Maintenance\Request)

price (Maintenance\Price)

Prix calculés pour les offres.

Relations :

• OneToOne → offer (Maintenance\Offer)

discount (Maintenance\Discount)

Codes de réduction.

Relations :

• OneToMany → requests (Maintenance\Request)

request_refusal (Maintenance\Refusal)

Refus de demandes.

Relations :

• OneToOne → request (Maintenance\Request)
• ManyToMany → reasons (RefusalReason) via table request_refusal_reason

Equipment

equipment_category (Equipment\Category)

Catégories d'équipements.

Relations :

• OneToMany → equipmentTypes (Equipment\Type)
• OneToMany → coefficientRates (CoefficientRate)

equipment_type (Equipment\Type)

Types d'équipements.

Relations :

• ManyToOne → category (Equipment\Category)

equipment_brand (Equipment\Brand)

Marques d'équipements.

MaintenanceOffer

maintenance_offer (MaintenanceOffer\MaintenanceOffer)

Offres de maintenance disponibles.

Relations :

• ManyToMany → features (MaintenanceOffer\Feature) via table maintenance_offer_feature

feature (MaintenanceOffer\Feature)

Caractéristiques des offres.

Troubleshooting

troubleshooting (Troubleshooting\Troubleshooting)

Demandes de dépannage.

Relations :

• OneToOne → address (Address)
• ManyToMany → diagnosis (Troubleshooting\Diagnosis) via table troubleshooting_diagnosis

diagnosis (Troubleshooting\Diagnosis)

Diagnostics possibles.

Référentiels

address (Address)

Adresses (contact et facturation).

Relations :

• ManyToOne → civility (Civility)

civility (Civility)

Civilités.

postal_code (PostalCode)

Codes postaux avec tarification.

parameter (Parameter)

Paramètres système.

refusal_reason (RefusalReason)

Raisons de refus.

coefficient_rate (CoefficientRate)

Coefficients de tarification par catégorie.

Relations :

• ManyToOne → category (Equipment\Category)

Authentification

admin (Admin)

Comptes administrateurs.

Relations :

• OneToMany → resetPasswordRequests (ResetPasswordRequest)
• OneToMany → refreshTokens (RefreshToken)

reset_password_request (ResetPasswordRequest)

Demandes de réinitialisation de mot de passe.

Relations :

• ManyToOne → user (Admin)

refresh_tokens (RefreshToken)

Tokens de rafraîchissement JWT.

Tables de jointure

maintenance_offer_feature

Table de jointure entre maintenance_offer et feature.

troubleshooting_diagnosis

Table de jointure entre troubleshooting et diagnosis.

request_refusal_reason

Table de jointure entre request_refusal et refusal_reason.

Index recommandés

-- Index sur les clés étrangères
CREATE INDEX idx_request_offer_request ON request_offer(request_id);
CREATE INDEX idx_request_equipment_request ON request_equipment(request_id);
CREATE INDEX idx_request_contract_request ON request_contract(request_id);
CREATE INDEX idx_price_offer ON price(offer_id);

-- Index sur les recherches fréquentes
CREATE INDEX idx_request_status ON request(status);
CREATE INDEX idx_request_deleted_at ON request(deleted_at);
CREATE INDEX idx_request_archived_at ON request(archived_at);
CREATE INDEX idx_discount_code ON discount(code);
CREATE INDEX idx_postal_code_code ON postal_code(code);
CREATE INDEX idx_parameter_code ON parameter(code);

-- Index sur les dates
CREATE INDEX idx_request_created_at ON request(created_at);
CREATE INDEX idx_contract_expired_at ON request_contract(expired_at);
CREATE INDEX idx_troubleshooting_status ON troubleshooting(status);

Contraintes et règles métier

Soft Delete

La table request utilise le soft delete via le champ deleted_at. Les enregistrements supprimés ne sont pas physiquement supprimés mais marqués comme supprimés.

Expiration automatique

• Les request expirent 4 mois après leur création (expired_at)
• Les contract expirent 90 jours après leur création (expired_at)

Statuts

RequestStatusEnum :

• PENDING : En attente
• WAITING_SIGNATURE : En attente de signature
• WAITING_PAYMENT : En attente de paiement
• COMPLETE : Complétée
• REJECTED : Rejetée

ContractStatusEnum :

• PENDING : En attente
• SIGNED : Signé
• EXPIRED : Expiré
• CANCELLED : Annulé

TroubleshootingStatusEnum :

• NEW : Nouveau
• IN_PROGRESS : En cours
• RESOLVED : Résolu
• CANCELLED : Annulé

Migrations

Les modifications de structure sont gérées via Doctrine Migrations :

# Créer une migration après modification des entités
php bin/console make:migration

# Exécuter les migrations
php bin/console doctrine:migrations:migrate

# Voir le statut des migrations
php bin/console doctrine:migrations:status

Fixtures

Les données de référence sont chargées via des fixtures :

# Charger les fixtures
php bin/console doctrine:fixtures:load

# Charger uniquement certaines fixtures
php bin/console doctrine:fixtures:load --group=equipment

Bonnes pratiques

1. UUID vs Integer
   • Utiliser UUID pour les entités exposées via API (Request, Offer, Contract, Troubleshooting)
   • Utiliser Integer pour les entités référentielles (Category, Type, Brand, etc.)
2. Soft Delete
   • Toujours vérifier deleted_at IS NULL dans les requêtes
   • Utiliser les filtres Doctrine pour exclure automatiquement les enregistrements supprimés
3. Timestamps
   • Utiliser datetime_immutable pour éviter les modifications accidentelles
   • Les timestamps sont automatiquement gérés via les lifecycle callbacks
4. Relations
   • Utiliser cascade: ['persist', 'remove'] avec précaution
   • Toujours définir orphanRemoval: true pour les relations OneToOne/OneToMany
5. Performance
   • Éviter le N+1 avec fetch: 'EAGER' ou des jointures explicites
   • Utiliser la pagination pour les listes
   • Indexer les colonnes fréquemment interrogées

Liens utiles

• Documentation Doctrine ORM
• Documentation Doctrine Migrations
• Documentation PostgreSQL

Résumé

• Base de données PostgreSQL avec Doctrine ORM
• Structure organisée en domaines métier (Maintenance, Troubleshooting, Equipment)
• Utilisation d'UUID pour les entités principales exposées via API
• Soft delete pour les demandes
• Système de statuts et d'expiration automatique
• Relations complexes avec tables de jointure
• Index optimisés pour les recherches fréquentes
• Gestion des migrations et fixtures pour le développement