PraxisConexus

PraxisConexus est une plateforme web de collaboration et d'apprentissage orientée pratique, conçue pour centraliser l'expérience utilisateur, la progression pédagogique et les échanges en temps réel.

Le projet est organisé en monorepo avec:

• un backend API en NestJS
• un frontend SPA en React + Vite

Pourquoi PraxisConexus

PraxisConexus répond à un besoin simple: proposer une expérience fluide entre apprentissage, collaboration et suivi de progression, dans une seule plateforme moderne.

Points forts:

• Expérience utilisateur complète: authentification, navigation métier, interactions en temps réel
• Backend robuste: architecture modulaire, API documentée, logique métier centralisée
• Frontend moderne: React + TypeScript, architecture claire, composants réutilisables
• Qualité projet: structure monorepo, conventions de configuration, documentation prête pour publication

À quoi sert ce projet

PraxisConexus centralise des fonctionnalités de gestion utilisateur, progression, communication et contenus pédagogiques. L'objectif est de proposer une expérience unifiée entre:

• authentification et gestion de comptes
• parcours et suivi de progression
• interactions temps réel et notifications
• espace frontend moderne connecté à une API documentée

Structure du monorepo

• backend/: API NestJS, Prisma, PostgreSQL, WebSocket, documentation Swagger
• frontend/: application React, TypeScript, Vite, intégration API et Auth

Stack technique

• Backend: NestJS, Prisma, PostgreSQL, WebSocket, Swagger/OpenAPI
• Frontend: React, TypeScript, Vite, TanStack Query, Tailwind CSS
• Déploiement: Azure App Service (API) + Vercel (frontend)
• Qualité: ESLint, tests unitaires/e2e selon les modules

Prérequis

• Node.js LTS (recommandé: version récente)
• npm
• un accès à une base PostgreSQL
• des comptes/services externes selon votre environnement (auth, email, stockage)

Installation rapide

1. Cloner le dépôt puis installer les dépendances de chaque application.
2. Initialiser les fichiers d'environnement à partir des exemples fournis.
3. Compléter les variables requises dans vos fichiers locaux, sans jamais versionner de secrets.

Backend

cd backend
npm install
cp .env.example .env
npm run start:dev

Frontend

cd frontend
npm install
cp .env.example .env.local
npm run dev

Utilisation

• Frontend local: http://localhost:5173
• API backend locale: http://localhost:3000
• Documentation API: http://localhost:3000/api

Bonnes pratiques de configuration

• Garder les valeurs réelles dans des fichiers locaux non versionnés.
• Vérifier les secrets avant chaque publication (CI, variables d'environnement, historique git).
• Injecter les variables sensibles via votre plateforme de déploiement.

Documentation par application

• Guide backend: backend/README.md
• Guide frontend: frontend/README.md

Contributeurs

• Mohammed FRIOUICHEN
• Mamadou BARRY
• Aly HAIDARA
• Borice NOUMEDEM

Licence

Projet distribué sous licence MIT. Voir LICENSE à la racine ainsi que les licences dans backend/ et frontend/.