554dc9f9e3
This commit establishes the new monorepo architecture for the KROW Workforce platform. Key changes include: - Reorganized project into `frontend-web`, `mobile-apps`, `firebase`, `scripts`, and `secrets` directories. - Updated `Makefile` to support the new monorepo layout and automate Base44 export integration. - Fixed `scripts/prepare-export.js` for ES module compatibility and global component import resolution. - Created and updated `CONTRIBUTING.md` for developer onboarding. - Restructured, renamed, and translated all `docs/` files for clarity and consistency. - Implemented an interactive internal launchpad with diagram viewing capabilities. - Configured base Firebase project files (`firebase.json`, security rules). - Updated `README.md` to reflect the new project structure and documentation overview.
KROW Workforce - Frontend
Ce projet contient le code du frontend pour la plateforme KROW Workforce. Il a été initialement prototypé sur la plateforme low-code Base44 et est en cours de migration vers une infrastructure backend personnalisée sur Google Cloud Platform (GCP).
Ce README.md est le guide officiel pour l'équipe de développement. NE PAS REMPLACER ce fichier par celui fourni dans les exports de Base44.
🚀 Démarrage Rapide
Ce projet utilise un Makefile comme point d'entrée principal pour toutes les commandes courantes.
Prérequis
- Node.js (version LTS recommandée)
- npm
make(généralement pré-installé sur Linux et macOS)
Installation et Lancement
-
Installer les dépendances :
make install -
Lancer le serveur de développement :
make devL'application sera disponible sur
http://localhost:5173.
🔄 Workflow d'Intégration des Mises à Jour de Base44
Pour intégrer les nouvelles modifications de l'UI faites par la cliente sur la plateforme Base44, suivez ce processus rigoureux :
1. Valider les Changements d'API
Avant d'intégrer le nouveau code, il est impératif de mettre à jour notre documentation API et notre spécification technique. Suivez rigoureusement la procédure détaillée dans le fichier docs/MAINTENANCE_GUIDE.md.
2. Intégrer le Nouveau Frontend
- Créez une branche dédiée dans Git :
git checkout -b integration/base44-update-YYYY-MM-DD - Placez l'export de Base44 dans un dossier nommé
krow-workforce-web-export-latestà côté du dossier de ce projet. La structure attendue est :- /krow-workforce-web/ (ce projet) - /krow-workforce-web-export-latest/ (le nouvel export) - Exécutez la commande d'intégration pour copier automatiquement les fichiers
srcetindex.html:make integrate-export - Exécutez le script de préparation pour neutraliser le SDK Base44 et appliquer nos patchs :
make prepare-export - Analysez les différences avec
git diff. Intégrez les nouveaux composants et les modifications de l'UI, mais rejetez les changements sur les fichiers que nous avons patchés (src/api/base44Client.js,src/main.jsx,src/pages/Layout.jsx) pour conserver notre environnement local fonctionnel. Vérifiez égalementpackage.jsonpour toute nouvelle dépendance à ajouter manuellement. - Testez l'application en local avec
make devpour vous assurer que tout fonctionne comme prévu. - Commitez vos changements.
📂 Structure du Projet
scripts/prepare-export.js: Script de patching pour le workflow hybride.docs/: Contient la documentation du projet (spécification de l'API, guides...).src/: Code source de l'application.src/api/: Contient la configuration du client API (actuellement mocké).src/components/: Composants React réutilisables.src/pages/: Vues principales de l'application, correspondant aux routes.src/lib/: Utilitaires et bibliothèques partagées.
Makefile: Orchestrateur des commandes du projet.