3omar est un simulateur pedagogique qui aide a comprendre les principaux calculs d'un salaire marocain. Chaque simulation affiche les taux, assiettes et references reglementaires utilises. Aucune donnee personnelle n'est collectee.
Pourquoi « 3omar » ? En darija marocaine, عمر (Omar) s'ecrit « 3omar », le chiffre 3 dessine le ع.
3omar reste une simulation de bulletin de paie pedagogique. Pour un bulletin de paie officiel ou une situation particuliere, consultez votre employeur ou un professionnel.
- Brut → Net : CNSS, AMO, CIMR, IR progressif, frais professionnels, charges de famille, retraite complementaire, prime d'anciennete, heures supplementaires, indemnites exonerees.
- Net → Brut : reconstitution du salaire de base a partir d'un net a payer cible, memes hypotheses disponibles que le mode direct.
- API REST : endpoints JSON publics pour integrer la simulation dans des applications tierces (
/api/v1/). - Parcours guide : progression visuelle par etapes avec recapitulatif en temps reel des saisies.
- Mode sombre : detection automatique de la preference systeme, toggle dans la navbar, persistance du choix.
- Cout total employeur, detail complet des retenues, affichage des references reglementaires.
- Interface disponible en francais, anglais, arabe (RTL) et espagnol.
La feuille de route est geree dans les issues GitHub.
Developpement :
cp .env.example .env && docker compose up -d --build
docker run --rm -v "$PWD":/app -v paie_maroc_vendor:/app/vendor \
-w /app composer:2.10 composer install
docker compose exec app php artisan key:generate
# → http://localhost:49173Production :
docker run -d -p 80:80 \
-e APP_KEY="$(docker run --rm ghcr.io/zakmaf/3omar:latest php artisan key:generate --show)" \
-e APP_URL=https://votre-domaine.com \
ghcr.io/zakmaf/3omar:latest→ Voir docs/DEPLOIEMENT.md pour les variables, tags et reverse proxy.
| Document | Audience |
|---|---|
| Developpement | Developpeurs : setup local, architecture, tests |
| Deploiement | Ops : image Docker, variables, reverse proxy |
| Regles de calcul | Developpeurs & RH : formules, solver net→brut |
| API REST | Developpeurs : endpoints, requetes, reponses |
| Internationalisation | Developpeurs : conventions de traduction |
| UX & accessibilite | Product & design : principes, suivi recommande |
| Historique des versions | Tous : changelog par release |
Voir CONTRIBUTING.md pour les conventions de contribution, le format des commits et des release notes.
Les corrections de calcul doivent inclure un scenario de test reproductible (voir docs/CALCUL.md). Les changements visuels doivent respecter la charte de marque. Pour signaler une vulnerabilite, suivre la procedure decrite dans SECURITY.md.
Le code est distribue sous licence MIT. Le nom « 3omar », les logos et la charte graphique sont soumis a des conditions distinctes : voir LICENSE-ASSETS.md.