Retour à l'accueil

Documentation

Dernière mise à jour :

Bienvenue dans la documentation de SM Supports. Ce guide complet vous aide à comprendre notre processus de développement, notre stack technique, nos intégrations d'API et les bonnes pratiques pour travailler avec nos services.

Bien démarrer

Suivez ces étapes pour bien démarrer avec les services et les projets de SM Supports.

  1. Consultation initiale

    Planifiez un appel de consultation gratuit pour parler des besoins, des objectifs et des délais de votre projet.

    Planifier un appel

  2. Planification du projet

    Nous établissons un plan de projet détaillé : périmètre, jalons, livrables et calendrier. Vous recevez une proposition complète qui présente tous les aspects du projet.

  3. Développement et collaboration

    Notre équipe lance le développement, avec des points d'étape et des comptes rendus réguliers. Vous avez accès à des environnements de préproduction pour suivre l'avancement et nous faire part de vos retours tout au long du projet.

  4. Lancement et assistance

    Après des tests approfondis et votre validation, nous mettons votre projet en ligne. Nous fournissons ensuite assistance, maintenance et documentation en continu, pour assurer sa réussite sur le long terme.

Stack technologique

Nous utilisons des technologies modernes et de référence pour créer des applications évolutives et performantes.

Développement front-end

  • Next.js 15 – Framework React avec App Router
  • React 18 – Bibliothèque d'interfaces utilisateur à base de composants
  • TypeScript – JavaScript avec typage statique
  • Tailwind CSS – Framework CSS orienté classes utilitaires
  • Framer Motion – Bibliothèque d'animation

Back-end et API

  • Node.js – Environnement d'exécution JavaScript
  • Next.js API Routes – Fonctions serverless
  • API REST – Architecture RESTful
  • Cloudflare Workers – Calcul en périphérie (edge computing)
  • Resend – Service d'envoi d'e-mails

Bases de données et stockage

  • Cloudflare D1 – SQLite serverless
  • PostgreSQL – Base de données relationnelle
  • MongoDB – Base de données NoSQL
  • Redis – Cache en mémoire

Plateformes et outils

  • Wix – Plateforme de création de sites web
  • Velo (Wix Code) – Fonctionnalités sur mesure
  • Git & GitHub – Gestion de versions
  • Vercel – Plateforme de déploiement

Référence API

Documentation de nos points de terminaison d'API et de nos services d'intégration.

POST /api/contact

Envoyer une demande via le formulaire de contact

POST

Corps de la requête :

{
  "name": "string",
  "email": "string",
  "subject": "string",
  "message": "string"
}

Réponse (200) :

{
  "success": true,
  "message": "Message sent successfully"
}

POST /api/schedule

Réserver un rendez-vous de consultation

POST

Corps de la requête :

{
  "name": "string",
  "email": "string",
  "company": "string",
  "date": "string",
  "time": "string",
  "timezone": "string",
  "projectType": "string",
  "description": "string"
}

GET /api/timeslots

Obtenir les créneaux disponibles à la réservation

GET

Paramètres de requête :

?date=2025-10-02&timezone=America/New_York

Réponse (200) :

{
  "availableSlots": ["09:00", "10:00", "14:00"],
  "bookedSlots": ["11:00", "15:00"]
}

Déploiement et hébergement

Nous déployons les applications sur des plateformes de référence, pour des performances et une fiabilité optimales.

Vercel (plateforme principale)

Notre principale plateforme de déploiement pour les applications Next.js, avec CI/CD automatique, fonctions edge et CDN mondial.

  • Déploiements automatiques depuis Git
  • Déploiements de prévisualisation pour les pull requests
  • Réseau edge de plus de 100 points de présence
  • Outils d'analyse et de surveillance intégrés

Cloudflare Pages et Workers

Plateforme de calcul en périphérie pour les fonctions serverless, la base de données D1 et l'hébergement de sites statiques.

  • Base de données SQLite serverless D1
  • Workers pour le calcul en périphérie
  • Stockage d'objets R2
  • Protection DDoS et sécurité

Solutions d'hébergement sur mesure

Nous travaillons également avec divers hébergeurs, selon les besoins du projet.

  • AWS (EC2, S3, CloudFront, Lambda)
  • DigitalOcean (Droplets, App Platform)
  • Netlify (sites statiques, fonctions edge)
  • Heroku (déploiements de conteneurs)

Bonnes pratiques

Recommandations et lignes directrices pour travailler sur les projets SM Supports.

Qualité du code

  • Utilisez TypeScript pour la sûreté du typage et une meilleure expérience de développement
  • Respectez les configurations ESLint et Prettier pour un style de code cohérent
  • Rédigez des messages de commit explicites selon la convention Conventional Commits
  • Créez des composants petits, ciblés et réutilisables
  • Documentez la logique complexe et les interfaces d'API

Optimisation des performances

  • Optimisez les images avec le composant Image de Next.js
  • Mettez en place le chargement différé (lazy loading) pour le contenu situé sous la ligne de flottaison
  • Utilisez les React Server Components autant que possible
  • Réduisez la taille des bundles grâce au code splitting et au tree shaking
  • Mettez en cache les réponses d'API et les ressources statiques de manière appropriée

Sécurité

  • Ne commitez jamais de données sensibles ni de clés d'API dans votre système de gestion de versions
  • Utilisez des variables d'environnement pour la configuration
  • Mettez en place une validation et un assainissement rigoureux des entrées
  • Utilisez HTTPS pour tous les déploiements en production
  • Maintenez les dépendances à jour pour corriger les failles de sécurité

Accessibilité (A11y)

  • Utilisez des éléments HTML sémantiques (nav, main, article, etc.)
  • Fournissez un texte alternatif pour toutes les images
  • Veillez à respecter des rapports de contraste suffisants
  • Rendez les éléments interactifs accessibles au clavier
  • Testez avec des lecteurs d'écran et des outils d'accessibilité

Dépannage

Problèmes courants et leurs solutions.

Erreurs de build

Problème : Le build échoue avec des erreurs TypeScript ou ESLint

Solution :

  • Exécutez npm run lint pour identifier les problèmes
  • Recherchez les dépendances manquantes dans package.json
  • Vérifiez que tous les imports sont correctement typés
  • Supprimez le dossier .next et relancez le build

Problèmes de connexion à l'API

Problème : Les points de terminaison de l'API renvoient des erreurs ou dépassent le délai d'attente

Solution :

  • Vérifiez que les variables d'environnement sont correctement définies
  • Contrôlez les limites de débit et les quotas de l'API
  • Vérifiez les paramètres CORS pour les requêtes cross-origin
  • Surveillez l'onglet Réseau des outils de développement (DevTools) du navigateur

Problèmes de performances

Problème : Pages lentes à charger ou scores Lighthouse faibles

Solution :

  • Optimisez les images (format WebP, dimensions adaptées)
  • Activez le chargement différé pour les images et les composants
  • Réduisez la taille du bundle JavaScript
  • Utilisez la mise en cache en périphérie (edge) pour les réponses d'API
  • Prévoyez des états de chargement adaptés

Besoin d'aide supplémentaire ?

Vous ne trouvez pas ce que vous cherchez ? Notre équipe est là pour répondre à toutes vos questions et vous apporter une assistance technique.

E-mail :
[email protected]
Téléphone :
(+880) 13013-60818
Horaires :
Du lundi au vendredi, de 9 h à 18 h (heure du Bangladesh, BST)
Contacter l'assistancePlanifier un appel