Files
Krow-workspace/frontend-web
bwnyasse 80cd49deb5 feat(Makefile): install frontend dependencies on dev command
feat(Makefile): patch Layout.jsx queryKey for local development
feat(frontend-web): mock base44 client for local development with role switching
feat(frontend-web): add event assignment modal with conflict detection and bulk assign
feat(frontend-web): add client dashboard with key metrics and quick actions
feat(frontend-web): add layout component with role-based navigation
feat(frontend-web): update various pages to use "@/components" alias
feat(frontend-web): update create event page with ai assistant toggle
feat(frontend-web): update dashboard page with new components
feat(frontend-web): update events page with quick assign popover
feat(frontend-web): update invite vendor page with hover card
feat(frontend-web): update messages page with conversation list and message thread
feat(frontend-web): update operator dashboard page with new components
feat(frontend-web): update partner management page with new components
feat(frontend-web): update permissions page with new components
feat(frontend-web): update procurement dashboard page with new components
feat(frontend-web): update smart vendor onboarding page with new components
feat(frontend-web): update staff directory page with new components
feat(frontend-web): update teams page with new components
feat(frontend-web): update user management page with new components
feat(frontend-web): update vendor compliance page with new components
feat(frontend-web): update main.jsx to include react query provider

feat: add vendor marketplace page
feat: add global import fix to prepare-export script
feat: add patch-layout-query-key script to fix query key
feat: update patch-base44-client script to use a more robust method
2025-11-13 14:56:31 -05:00
..

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

  1. Installer les dépendances :

    make install
    
  2. Lancer le serveur de développement :

    make dev
    

    L'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

  1. Créez une branche dédiée dans Git :
    git checkout -b integration/base44-update-YYYY-MM-DD
    
  2. 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)
    
  3. Exécutez la commande d'intégration pour copier automatiquement les fichiers src et index.html :
    make integrate-export
    
  4. Exécutez le script de préparation pour neutraliser le SDK Base44 et appliquer nos patchs :
    make prepare-export
    
  5. 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 également package.json pour toute nouvelle dépendance à ajouter manuellement.
  6. Testez l'application en local avec make dev pour vous assurer que tout fonctionne comme prévu.
  7. 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.