Plan de Maintenance

1.1Contexte

Le présent document définit le plan de maintenance de la plateforme REWAPP, application mobile de cashback nouvelle génération combinant cashback bancaire direct et cashback commerçant via QR code.

La maintenance constitue un pilier essentiel pour garantir :

• La disponibilité continue des services (objectif 99.9%)
• La performance optimale (temps de réponse API < 200ms)
• La sécurité des données et transactions
• La satisfaction des utilisateurs et partenaires

1.2Périmètre

Ce plan couvre l'ensemble des composantes de l'écosystème REWAPP :

• Application Mobile (iOS/Android - Angular + Ionic)
• Site Vitrine (Next.js + Tailwind CSS)
• Dashboard Admin (React + Ant Design/MUI)
• Dashboard Partenaire (React PWA + Vite)
• Backend API (Node.js + NestJS)
• Infrastructure Cloud (CapRover + Docker)
• Bases de données (PostgreSQL, Redis)
• Intégrations tierces (Budget Insight, SendGrid, FCM, Twilio)

1.3Audience

Ce document s'adresse aux :

• Équipe Ops et SRE
• Équipe Développement
• Équipe Support
• Management technique (CTO, Tech Lead)
• Partenaires et prestataires impliqués dans la maintenance

2.1Objectifs Principaux

2.2Principes Directeurs

La maintenance REWAPP suit les principes suivants :

3.1Maintenance Préventive

La maintenance préventive vise à prévenir les pannes et dégradations avant qu'elles ne surviennent.

3.1.1 Mises à Jour de Sécurité

3.1.2 Optimisation des Performances

3.1.3 Nettoyage des Données

3.1.4 Vérifications Système

3.2Maintenance Corrective

La maintenance corrective intervient suite à un incident ou une défaillance identifiée.

3.2.1 Classification des Incidents

3.2.2 Processus de Résolution

3.2.3 Procédure Hotfix (P1-P2)

1. 1

   Créer une branche hotfix depuis production

2. 2

   Implémenter le correctif minimal

3. 3

   Tests unitaires obligatoires

4. 4

   Revue de code accélérée (1 reviewer minimum)

5. 5

   Déploiement via pipeline CI/CD dédié hotfix

6. 6

   Monitoring renforcé post-déploiement (30 min)

7. 7

   Merge vers develop et main après stabilisation

3.2.4 Procédure de Rollback

En cas d'échec du correctif ou dégradation post-déploiement :

# 1. Identifier la version stable précédente
# 2. Exécuter le rollback via CapRover
caprover api --caproverUrl https://captain.rewapp.fr   --appName [SERVICE]   --task-definition rewapp-prod-[SERVICE]:[VERSION_PRECEDENTE]

# 3. Vérifier le retour à la normale via dashboards
# 4. Communiquer le rollback aux équipes
# 5. Analyser la cause de l'échec

3.3Maintenance Évolutive

La maintenance évolutive concerne l'ajout de nouvelles fonctionnalités et améliorations.

3.3.1 Types d'Évolutions

3.3.3 Roadmap Technique

3.4Maintenance Adaptative

La maintenance adaptative permet d'adapter le système aux évolutions de son environnement.

3.4.1 Évolutions Réglementaires

3.4.2 Évolutions Technologiques

4.1Calendrier des Interventions

4.1.1 Maintenances Quotidiennes (Automatisées)

4.1.2 Maintenances Hebdomadaires

4.1.3 Maintenances Mensuelles

4.1.4 Maintenances Trimestrielles

4.2Fenêtres de Maintenance

4.2.1 Fenêtres Standards

4.2.2 Périodes de Gel (No Deployment Zones)

4.3Procédure de Communication

4.3.1 Communication Préalable

4.3.2 Template de Communication

Objet : [REWAPP] Maintenance planifiée - [Date] - [Durée estimée]

Bonjour,

Une maintenance est planifiée sur la plateforme REWAPP :

• Date : [JJ/MM/AAAA]
• Horaire : [HH:MM - HH:MM] (heure de Paris)
• Durée estimée : [Durée]
• Impact attendu : [Description de l'impact]

Services concernés :
• [Liste des services impactés]

Actions requises de votre part :
• [Actions si nécessaire, sinon "Aucune action requise"]

En cas de questions, contactez le support : support@rewapp.fr

Cordialement,
L'équipe technique REWAPP

5.1Rôles et Équipes

5.2Matrice RACI

5.3Contacts et Escalade

5.3.1 Matrice d'Escalade

5.3.2 Planning d'Astreinte

• Rotation : Hebdomadaire (lundi 9h00 → lundi suivant 9h00)
• Équipe : 4 ingénieurs Ops en rotation
• Backup : Un backup désigné par semaine
• Outils : PagerDuty, accès VPN, laptop de garde

5.3.3 Contacts Fournisseurs

6.1Procédure Générale

6.1.1 Checklist Pré-Maintenance

• Vérifier l'absence de période de gel
• Valider avec le Tech Lead (maintenance majeure)
• Communiquer aux parties prenantes selon délais
• Vérifier les backups récents
• Préparer le plan de rollback
• S'assurer de la disponibilité de l'équipe de garde
• Documenter les étapes prévues

6.1.2 Checklist Post-Maintenance

• Vérifier le bon fonctionnement via dashboards Grafana
• Exécuter les tests de smoke
• Vérifier l'absence d'alertes anormales
• Valider les métriques clés (latence, error rate)
• Communiquer la fin de maintenance
• Documenter les actions réalisées
• Créer un ticket de suivi si anomalie détectée

6.2Maintenance Base de Données

6.2.1 VACUUM et ANALYZE PostgreSQL

Exécution hebdomadaire automatique (dimanche 03:00 UTC) :

-- Vacuum et Analyze complet
VACUUM ANALYZE;

-- Pour tables volumineuses spécifiques
VACUUM FULL VERBOSE transactions;
VACUUM FULL VERBOSE points_history;

6.2.2 Optimisation des Index

Analyse mensuelle des index non utilisés :

-- Identifier les index non utilisés
SELECT schemaname, tablename, indexname, idx_scan
FROM pg_stat_user_indexes
WHERE idx_scan < 50
ORDER BY idx_scan;

-- Vérifier les tables avec trop de sequential scans
SELECT relname, seq_scan, idx_scan
FROM pg_stat_user_tables
WHERE seq_scan > idx_scan * 10;

6.2.3 Monitoring des Connexions

-- Vérifier les connexions actives
SELECT count(*) as total,
       state,
       usename
FROM pg_stat_activity
GROUP BY state, usename;

-- Tuer les connexions idle anciennes (> 10 min)
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE state = 'idle'
AND query_start < now() - interval '10 minutes';

6.3Maintenance Infrastructure Cloud

6.3.1 Scaling des Services ECS

# Augmenter le nombre de containers via CapRover
# Via Dashboard CapRover : Apps > [SERVICE] > App Configs > Instance Count

# Ou via CLI
caprover api --caproverUrl https://captain.rewapp.fr   --appName [SERVICE] --method updateInstanceCount --data '[N]'

6.3.2 Gestion des Certificats SSL

Les certificats sont gérés par CapRover/Let's Encrypt avec renouvellement automatique.

# Les certificats Let's Encrypt sont gérés automatiquement par CapRover
# Vérifier via Dashboard CapRover > SSL Certificates

# Vérifier manuellement la date d'expiration
openssl s_client -connect rewapp.fr:443 -servername rewapp.fr 2>/dev/null |   openssl x509 -noout -dates

6.4Maintenance Application

6.4.1 Mise à Jour des Dépendances

# Audit des vulnérabilités
npm audit

# Mise à jour des packages patch/minor
npm update

# Pour les mises à jour majeures (analyse requise)
npm outdated
npx npm-check-updates

6.4.2 Nettoyage du Cache Applicatif

# Invalider cache API spécifique
redis-cli KEYS "cache:api:merchants:*" | xargs redis-cli DEL

# Vérifier la mémoire après nettoyage
redis-cli INFO memory

6.5Maintenance Sécurité

6.5.1 Rotation des Secrets

Tous les 90 jours (automatisé via Secrets Manager) :

# Rotation manuelle via CapRover Dashboard
# Apps > [APP_NAME] > App Configs > Environmental Variables

# Ou via fichier .env sur le serveur
ssh user@server 'cd /captain/data && nano .env'

# Redémarrer l'application pour prendre en compte les nouveaux secrets
caprover api --caproverUrl https://captain.rewapp.fr   --appName [APP_NAME] --method restartApp

6.5.2 Audit des Accès

Revue trimestrielle :

• Audit des accès CapRover / SSH
• Revue des accès SSH/VPN
• Vérification des permissions dashboard admin
• Suppression des accès obsolètes

6.5.3 Scan de Vulnérabilités

Scan mensuel :

• Scan des containers avec Amazon ECR scanning
• Analyse des dépendances avec Snyk/npm audit
• Tests de pénétration annuels par prestataire externe

7.1Outils de Maintenance

7.2Environnements

8.1KPIs de Disponibilité

8.2KPIs de Performance

8.3KPIs de Qualité

9.1Risques Identifiés

9.2Plan de Continuité

En cas d'incident majeur, le plan de continuité prévoit :

• Backups horaires assurant un RPO d'1 heure
• Procédure de basculement DR documentée dans le document 10.4
• Tests de basculement trimestriels

10.1Documentation Obligatoire

Chaque intervention de maintenance doit être documentée :

• Pré-intervention : Ticket Jira avec description et plan
• Post-intervention : Mise à jour du ticket avec actions réalisées
• Incidents : Post-mortem obligatoire pour P1-P2 sous 48h

10.2Reporting

11.1Récapitulatif

Le plan de maintenance REWAPP définit une approche structurée pour garantir :

• Disponibilité 99.9% grâce à une maintenance préventive rigoureuse
• Réactivité optimale avec des procédures de maintenance corrective éprouvées
• Évolutivité maîtrisée par un processus de déploiement robuste
• Sécurité renforcée via des audits et mises à jour régulières

11.2Points Clés à Retenir

11.3Révision du Document

Ce document doit être révisé :

• Trimestriellement pour mise à jour des procédures
• Après chaque incident majeur (P1) pour intégration des leçons apprises
• Lors de tout changement significatif d'infrastructure

11.4Documents Connexes

• 10.1 Plan de Déploiement
• 10.2 Documentation Technique Ops
• 10.3 Procédures de Monitoring et Alerting
• 10.4 Plan de Sauvegarde et Disaster Recovery
• 10.5 CI/CD Pipeline
• 14.2 Procédures de Support
• 14.3 Plan de Montée de Version