Développeurs

Construire Oxlum avec une base technique propre.

Cette page présente les principes techniques d’Oxlum Group : structure des fichiers, sécurité, PWA, formulaires, authentification future, backend, intégrations et bonnes pratiques pour les développeurs ou partenaires techniques.

💻 HTML / CSS / JS
📱 PWA
🔐 Sécurité
🧩 Intégrations
Principes techniques

Une base simple, évolutive et sécurisée.

Oxlum Group doit rester propre techniquement pour éviter les erreurs, les doublons, les conflits JavaScript, les problèmes de cache et les risques de sécurité.

🧱

Structure claire

Chaque fichier doit avoir un rôle précis : design, responsive, scripts généraux, langue, notifications, PWA ou authentification.

🔐

Zéro secret côté public

Aucun mot de passe, token privé, clé API secrète ou accès administrateur ne doit être placé dans HTML, CSS ou JavaScript public.

📱

Mobile d’abord

Les pages doivent être propres sur téléphone, tablette et ordinateur, avec des menus simples et des boutons faciles à utiliser.

⚡

Performance

Réduire les doublons, garder les fichiers propres, éviter les scripts inutiles et surveiller le cache du service worker.

🛡️

Sécurité progressive

Les fonctions sensibles comme comptes, paiements et données clients doivent passer par un backend sécurisé.

🧪

Tests avant lancement

Tester chaque page, formulaire, bouton, lien, langue et affichage mobile avant publication.

Architecture actuelle

Le site Oxlum Group utilise principalement des fichiers statiques. Cette approche est simple, rapide à héberger et pratique pour lancer une première version publique.

Fichiers principaux

index.html Page d’accueil principale.
style.css Design global du site.
responsive.css Corrections téléphone/tablette.
pages.css Styles des pages internes.
oxlum-fix.css Correctifs logo, services, FAQ et compatibilité.
script.js Menu, PWA, animations et interactions générales.
language.js Gestion des langues.
notifications.js Notifications internes du site.
service-worker.js Cache PWA et expérience hors ligne limitée.
Règle : ne mélangez pas tout dans un seul fichier. Chaque fichier doit garder sa responsabilité pour éviter les conflits.

Bonnes pratiques de code

Pour éviter de casser le site, les modifications doivent rester simples, testées et faciles à comprendre.

  • Ne pas ajouter plusieurs scripts qui font la même chose.
  • Ne pas créer plusieurs systèmes de langue différents.
  • Ne pas créer plusieurs menus mobiles concurrents.
  • Ne pas cacher de mot de passe dans le code public.
  • Ne pas ajouter de service worker sans changer la version du cache.
  • Tester après chaque changement important.
// Exemple de règle propre
// 1. script.js : menu, PWA, animations
// 2. language.js : langues seulement
// 3. auth.js : pages login/signup/forgot seulement
// 4. service-worker.js : cache seulement
// 5. config.js : informations publiques seulement
À ne jamais faire : mettre un mot de passe administrateur, une clé API privée, un token Supabase secret ou un accès bancaire dans un fichier public.
Intégrations

APIs et services techniques.

Oxlum Group peut évoluer vers des intégrations plus avancées, mais chaque intégration doit être sécurisée.

Formulaires

Les formulaires publics peuvent utiliser Formspree pour envoyer les messages vers l’e-mail officiel. Cela convient pour contact, devis, support, signalement, carrière et partenariat.

✅ Usage : contact, devis, support, signalement.
⚠️ Limite : ne pas envoyer de données sensibles.
🛡️ À ajouter plus tard : anti-spam, captcha ou validation avancée.

Authentification

Oxlum ID doit utiliser un backend sécurisé comme Supabase ou une solution équivalente. Les pages visuelles login/signup ne suffisent pas pour gérer de vrais comptes.

🔐 Mot de passe : jamais stocké en clair.
📩 Vérification : e-mail ou téléphone recommandé.
🚫 Interdit : stocker un vrai mot de passe dans localStorage.

Paiements

Oxlum Pay n’est pas encore lancé comme système réel. Les paiements automatisés doivent être construits avec conformité, backend, vérification, anti-fraude et traçabilité.

🔴 État : non lancé comme service public.
🛡️ Besoin : backend, sécurité, logs et vérification.
⚠️ Règle : ne jamais demander de code secret au client.

PWA & cache

Le service worker améliore l’expérience, mais peut garder une ancienne version si la stratégie de cache n’est pas contrôlée correctement.

📱 Fichiers : manifest, splash, service-worker.
🔄 Mise à jour : changer la version de cache après grosses modifications.
🧪 Test : vérifier en navigation privée après déploiement.

Sécurité développeur

Un développeur qui travaille sur Oxlum doit protéger le projet contre les erreurs courantes. La sécurité commence par de bons réflexes simples.

  • Utiliser des variables d’environnement pour les secrets côté serveur.
  • Ne pas exposer de clé privée dans GitHub ou Netlify public.
  • Valider les formulaires côté client et côté serveur si backend.
  • Limiter les accès administrateur.
  • Créer des sauvegardes avant grande modification.
  • Documenter les changements importants.
Bon réflexe : avant de publier, vérifier les liens, formulaires, scripts, erreurs console, affichage mobile et cache PWA.

État développeur actuel

Cette page est une documentation publique. Elle ne donne pas encore accès à une API publique, ni à un portail développeur avec clés d’accès.

Disponible maintenant

  • Pages publiques HTML/CSS/JS.
  • Formulaires via Formspree.
  • PWA avec manifest et service worker.
  • Pages support, sécurité, FAQ et signalement.

À venir plus tard

  • Backend sécurisé.
  • Oxlum ID réel.
  • Tableau de bord administrateur connecté.
  • API interne ou publique documentée.
  • Journalisation et monitoring.
Important : tant qu’il n’y a pas de backend sécurisé, les fonctions sensibles doivent rester limitées ou en démonstration.

Contact technique

Vous êtes développeur, intégrateur, designer technique, expert sécurité ou partenaire backend ? Vous pouvez proposer une aide, signaler un bug ou proposer une amélioration.

E-mail officiel oxlumgroup.official@gmail.com
WhatsApp officiel +224 620 91 95 24
Localisation Conakry, Guinée
Conseil : décrivez clairement le problème, la page concernée, le fichier touché et la solution proposée.

Proposer une contribution technique

Envoyez une proposition, un bug, une amélioration ou une demande de collaboration technique.

Sécurité : les secrets techniques ne doivent jamais être envoyés dans un formulaire public. Pour les accès sensibles, utilisez un canal sécurisé et vérifié.
WhatsApp officiel

💬