SamaMentor

Plateforme communautaire de mentorat pour jeunes stagiaires dans les métiers du numérique. SamaMentor connecte stagiaires et mentors professionnels, facilite le suivi pédagogique et prépare les soutenances finales.

Quick Start

git clone https://github.com/Pascal1812/sama-mentor.git
cd sama-mentor
cp .env.example .env
docker compose -f infra/docker-compose.yml --env-file .env up

L'application est disponible sur http://app.localhost:82.

app.localhost résout automatiquement vers 127.0.0.1 (RFC 6761) - aucune modification de /etc/hosts requise.

Services

Service	URL	Description
web (via Caddy)	http://app.localhost:82	Frontend Next.js 16
tinyauth	http://app.localhost:82/login	Authentification (via Caddy)
adminer	http://localhost:8082	Interface base de données (dev)
user-service	interne :8002	Profils stagiaires, mentors, comité
matching-service	interne :8003	Annuaire et mise en relation
stage-service	interne :8004	Sujets et suivi de stage
tracking-service	interne :8005	Logs journaliers, points hebdo
notification-service	interne :8006	Notifications in-app et email
community-service	interne :8007	Forum, bibliothèque, évaluations
admin-service	interne :8008	Dashboard admin et audit

Rôles

Rôle	Description
Stagiaire	Cherche un mentor, co-rédige un sujet, tient ses logs, prépare sa soutenance
Mentor	Guide 1-N stagiaires, commente les logs, note les points hebdo
Comité de Sage	Valide les candidatures mentors, supervise tous les stages
Admin	Gestion technique de la plateforme

Documentation

• CONTRIBUTING.md - Comment contribuer (setup, branches, commits, PR)
• docs/architecture.md - Architecture technique
• docs/add-a-service.md - Créer un nouveau service
• docs/gateway-contract.md - Enregistrer un service dans le gateway

Structure du monorepo

sama-mentor/
├── apps/web/          # Frontend Next.js 16
├── services/          # Microservices (gateway + 8 services)
├── packages/          # Types et contrats partagés
├── infra/             # Docker Compose, Caddy, MinIO
├── .github/           # Workflows CI/CD et templates
├── docs/              # Documentation
└── scripts/           # Scripts d'outillage

Licence

MIT - voir LICENSE.