# MainTech-pro - PRD (Product Requirements Document)

## Original Problem Statement
Application de gestion d'effectif pour MainTech-pro chez la société Tecma Aries. Gestion du pointage des heures et des références machines pour l'équipe de maintenance.

## User Personas
1. **Gérant (Admin)** - Khattabi Ali
   - Accès complet à l'application
   - Gestion des employés (CRUD)
   - Consultation des rapports et statistiques
   
2. **Agents de maintenance**
   - OUABDELMOUMEN Omar
   - LAJDEL Amine
   - MALLOUK Abdelillah
   - Pointage personnel (heures + machine)
   - Consultation de leur historique

## Core Requirements (Static)
- Authentification JWT avec email/mot de passe
- Deux rôles: admin et agent
- Pointage journalier: heures travaillées + référence machine
- Rapports hebdomadaires et mensuels
- Interface mobile-friendly pour les agents sur terrain

## What's Been Implemented (Jan 2026)

### Backend (FastAPI + MongoDB)
- ✅ Authentification JWT complète
- ✅ CRUD utilisateurs (admin uniquement)
- ✅ CRUD pointages avec validation
- ✅ API rapports (hebdo/mensuel)
- ✅ Endpoint init-data pour créer les utilisateurs par défaut

### Frontend (React + Tailwind + Shadcn/UI)
- ✅ Page de connexion avec design industriel
- ✅ Dashboard Admin avec stats et résumé équipe
- ✅ Dashboard Agent avec formulaire de pointage
- ✅ Page gestion des employés
- ✅ Page rapports avec filtres
- ✅ Layout responsive avec sidebar

### Utilisateurs créés
| Email | Mot de passe | Rôle |
|-------|--------------|------|
| ali.khattabi@maintech-pro.com | admin123 | Admin |
| omar.ouabdelmoumen@maintech-pro.com | agent123 | Agent |
| amine.lajdel@maintech-pro.com | agent123 | Agent |
| abdelillah.mallouk@maintech-pro.com | agent123 | Agent |

## Prioritized Backlog

### P0 (Critical) - DONE
- [x] Authentification
- [x] Pointage heures/machine
- [x] Dashboard admin/agent

### P1 (High)
- [ ] Export PDF/Excel des rapports
- [ ] Notifications email de rappel pointage
- [ ] Validation gérant des pointages

### P2 (Medium)
- [ ] Gestion des machines (liste prédéfinie)
- [ ] Calcul automatique heures supplémentaires
- [ ] Historique des modifications

### P3 (Nice to have)
- [ ] Application mobile native
- [ ] Intégration calendrier
- [ ] Pointage par QR code

## Next Tasks
1. Ajouter export PDF/Excel des rapports
2. Améliorer le système de validation des pointages
3. Ajouter une liste de machines prédéfinies