18daf096fa
Echeancier - Webhooks DocuSeal:
- Webhook form.completed: telecharge PDF signe + audit, state SIGNED, prepare SEPA, notifie client + admin
- Webhook form.declined: state CANCELLED, notifie client + admin
- Reference EC_ECH_XXXXX affichee dans PDF, emails, pages client, admin
- Attestation fin de paiement auto via DocuSeal au completion
Echeancier - SEPA Direct Debit (remplace Subscriptions):
- Page /echeancier/setup-payment/{id}: formulaire IBAN Stripe Elements + mandat SEPA
- Confirmation SetupIntent -> stocke PaymentMethod -> state ACTIVE
- Commande cron app:echeancier:process-payments: preleve les echeances dues via PaymentIntent off_session
- Webhooks payment_intent.succeeded/failed: met a jour EcheancierLine, notifie client
- Regularisation CB via Stripe Checkout en cas d'echec prelevement
- Bouton "Forcer prelevement" par echeance dans admin
- Infos SEPA stockees (last4, bank_code, country) + affichees admin
- Page setup_payment_done quand SEPA deja configure
- Annulation auto apres 2 rejets + sync paiements vers Advert lie
Echeancier - Lien Advert:
- Champ advert (ManyToOne nullable) sur Echeancier
- Select "Avis lie" dans formulaire creation
- AdvertPayment cree a chaque echeance payee
- Advert passe en accepted quand echeancier completed
Comptabilite:
- Export echeanciers CSV/JSON/PDF/PDF signe dans /admin/comptabilite
- Colonnes: reference, client, creance, majoration, total, paye, restant, Stripe PI, avis lie
Stats:
- Case "Total impaye global" = factures impayees + echeances non payees
- Tableau echeanciers en cours avec restant du
Confiance client:
- Statut Confiant/Attention/Danger calcule dynamiquement
- Badge en haut a droite de la fiche client
- Integre warningLevel (1st=Attention, 2nd=Attention, last=Danger)
- Creation echeancier bloquee si Danger (template + controller)
Avertissements client (tab Controle, ROLE_ROOT):
- 3 niveaux: 1st, 2nd (procedure suspension preparee), last (48h)
- Motifs cochables: impayes, irrespect, hors horaires, services gratuits
- PDF signe DocuSeal pour chaque avertissement (ClientWarningPdf)
- PDF levee avertissement signe (ClientWarningResetPdf)
- Webhooks DocuSeal client_warning + client_warning_reset
- Barre progression 4 etapes dans admin
- Mentions legales: huis clos, contestation direction@e-cosplay.fr
Cloture compte:
- Bouton "Envoyer notification de cloture" apres dernier avertissement
- PDF signe DocuSeal (ClientClosurePdf): suppression 24h, recouvrement, commissaire justice, forces ordre
- Bouton "Suspendre le compte" (state suspended)
- Webhook DocuSeal client_closure: envoie PDF signe a client + admin + direction
Factures:
- Auto-generation PDF si absent lors de l'envoi
- Bouton "Envoyer" visible meme sans PDF pour factures payees
E-Flex (financement services):
- Entites EFlex + EFlexLine (reference E_FLEX_XXXXX)
- Methodes: SEPA, CB (Stripe Checkout), virement manuel
- PDF contrat avec 2 signatures DocuSeal (Company + Client)
- Controller admin CRUD + force payment + paiement manuel
- Pages client: verify, process, sign, signed, setup SEPA, paiement CB
- Webhook DocuSeal eflex: telecharge PDFs, prepare Stripe, notifie
- Webhooks Stripe payment_intent: gestion paiements E-Flex
- Cron traite aussi les E-Flex SEPA dans process-payments
- Tab E-Flex dans fiche client avec liste + modal creation
- Emails: signature, signed, verify_code, echeance_payee, echeance_echec
Attestations custom (ROLE_ROOT):
- Entite AttestationCustom avec items JSON + HMAC SHA-256
- Repeater dynamique pour ajouter elements a attester
- PDF avec phrase officielle "Je soussigne(e)..." + QR code verification
- Signature manuelle dans DocuSeal (redirection)
- Webhook attestation_custom: telecharge PDF signe + audit
- Page publique /attestation/verify/{id}/{hmac} avec validation HMAC
- Lien dans sidebar Super Admin
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
CRM E-Cosplay
CRM de gestion clients, facturation, devis et services numeriques pour l'Association E-Cosplay.
Stack technique
- Backend : Symfony 7 / PHP 8.4 / Doctrine ORM / PostgreSQL
- Frontend : Twig + Tailwind CSS (neo-brutalist) + Vanilla JS
- PDF : FPDF/FPDI + Dompdf (CGV)
- Paiement : Stripe (CB, SEPA, PayPal, Klarna) + Stripe Connect
- Signature : DocuSeal
- Recherche : Meilisearch
- Auth : Keycloak SSO + 2FA (email/TOTP)
- Infra : Docker + Caddy + PgBouncer
Tests
make run_test # PHP + JS
make test_coverage # PHP avec couverture HTML
make run_test_coverage_js # JS avec couverture
Qualite
make sonar # PHPStan + ESLint + Coverage + SonarQube
SonarQube - Exclusions et ignores
Exclusions d'analyse (sonar.exclusions)
| Fichier/Pattern | Raison |
|---|---|
vendor/**, var/**, node_modules/** |
Dependances tierces |
migrations/** |
Code genere par Doctrine |
src/Repository/** |
Repositories Doctrine auto-generes, pas de logique metier |
templates/email/**, templates/emails/** |
Templates email HTML (pas de logique testable) |
src/Service/AwsSesService.php |
Wrapper AWS SES (appels SDK externes) |
src/Service/CloudflareService.php |
Wrapper Cloudflare API (appels SDK externes) |
src/Service/DnsCheckService.php |
Appels systeme DNS (dig, whois) |
src/Service/DnsInfraHelper.php |
Helper DNS infra (appels systeme) |
src/Service/StripePriceService.php |
Wrapper Stripe Price API |
src/Service/StripeWebhookService.php |
Gestion secrets webhook Stripe |
src/Service/MailcowService.php |
Wrapper Mailcow API (service mail externe) |
src/Controller/WebhookDocuSealController.php |
Webhook DocuSeal (interactions externes) |
src/Controller/DnsReportController.php |
Rapport DNS (appels systeme) |
src/Command/CheckDnsCommand.php |
Commande DNS (appels systeme) |
src/Command/CloudflareDnsCleanCommand.php |
Commande Cloudflare (API externe) |
Exclusions de duplication CPD (sonar.cpd.exclusions)
| Fichier/Pattern | Raison |
|---|---|
src/Entity/** |
Entites Doctrine : getters/setters repetitifs par nature |
src/Repository/** |
Repositories : structure identique (ServiceEntityRepository) |
src/Service/Pdf/** |
Services PDF FPDF : Header/Footer/Body patterns similaires entre AdvertPdf, FacturePdf, DevisPdf |
src/Service/TarificationService.php |
Config prix avec structures repetitives |
src/Service/AdvertService.php, FactureService.php, DevisService.php |
Pattern TVA/totaux commun (isTvaEnabled, getTvaRate, computeTotals) |
src/Service/MeilisearchService.php |
DAL CRUD repetitif pour 9 index (index/remove/search x 9 entites) |
templates/admin/clients/show.html.twig |
Badges de statut HTML repetitifs (24 badges similaires pour differents etats) |
Ignores de regles (sonar.issue.ignore.multicriteria)
| Regle | Fichier | Raison |
|---|---|---|
php:S4144 (methodes identiques) |
**/*.php |
Faux positifs sur methodes avec meme structure mais contexte different |
php:S107 (trop de parametres) |
MailerService.php |
sendEmail() necessite 8 params (to, subject, content, from, replyTo, unsubscribe, attachments, priority) - tous utiles |
php:S1200 (couplage classe) |
MeilisearchService.php |
Service DAL centralise qui depend de 9 entites par design |
php:S1820 (trop de methodes) |
MeilisearchService.php |
44 methodes = 3 generiques + (index/remove/search) x 9 entites + setup/purge/stats + serializers. Splitter ajouterait de la complexite sans valeur |