{"id":48581592,"url":"https://github.com/devalade/mercato","last_synced_at":"2026-04-08T17:03:09.088Z","repository":{"id":343816878,"uuid":"1177977477","full_name":"devalade/mercato","owner":"devalade","description":"Jakarta EE Inventory Management Application","archived":false,"fork":false,"pushed_at":"2026-03-25T08:25:04.000Z","size":310,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-26T11:57:04.043Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devalade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-10T15:06:16.000Z","updated_at":"2026-03-25T08:25:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devalade/mercato","commit_stats":null,"previous_names":["devalade/mercato"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devalade/mercato","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devalade%2Fmercato","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devalade%2Fmercato/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devalade%2Fmercato/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devalade%2Fmercato/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devalade","download_url":"https://codeload.github.com/devalade/mercato/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devalade%2Fmercato/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31564915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-08T17:02:55.240Z","updated_at":"2026-04-08T17:03:09.070Z","avatar_url":"https://github.com/devalade.png","language":"Java","readme":"# Mercato - Système de Gestion d'Inventaire\n\nApplication de gestion d'inventaire matériel développée avec Jakarta EE 10, JPA, JAX-RS, JWT et DaisyUI.\n\n## 📋 Description\n\nMercato est une application web complète permettant de :\n- Gérer le stock de matériels (informatique, bureautique, mobilier, etc.)\n- Suivre les affectations de matériels aux employés\n- Gérer les mouvements de stock (entrées, sorties, retours)\n- Recevoir des alertes sur les matériels proches de l'expiration\n- Consulter l'historique complet des mouvements\n\n## 🚀 Prérequis\n\n- **Java 21** ou supérieur\n- **Maven 3.8+**\n- **GlassFish 7.0+** (ou tout serveur compatible Jakarta EE 10)\n- **PostgreSQL 14+**\n\n## 🛠️ Installation\n\n### 1. Cloner le projet\n\n```bash\ngit clone \u003crepository-url\u003e\ncd mercato\n```\n\n### 2. Configurer la base de données\n\nCréer une base de données PostgreSQL :\n\n```bash\ncreatedb mercato_db\n```\n\nModifier `src/conf/persistence.xml` avec vos informations de connexion :\n\n```xml\n\u003cproperty name=\"jakarta.persistence.jdbc.url\" value=\"jdbc:postgresql://localhost:5432/mercato_db\"/\u003e\n\u003cproperty name=\"jakarta.persistence.jdbc.user\" value=\"votre_user\"/\u003e\n\u003cproperty name=\"jakarta.persistence.jdbc.password\" value=\"votre_password\"/\u003e\n```\n\n### 3. Démarrer la base de données\n\n```bash\nmake db-start\n```\n\n### 4. Compiler et packager\n\n```bash\nmake build\n```\n\nOu avec Maven directement :\n\n```bash\nmvn clean package\n```\n\n### 5. Déployer sur GlassFish\n\n```bash\nmake server-start\nmake deploy\n```\n\nOu manuellement :\n\n1. Copier `target/mercato.war` dans `glassfish7/glassfish/domains/domain1/autodeploy/`\n2. Démarrer GlassFish : `glassfish7/glassfish/bin/asadmin start-domain`\n\n## 🌐 Accès à l'application\n\n- **Application Web:** http://localhost:8080/mercato/\n- **API REST:** http://localhost:8080/mercato/api/\n- **Console Admin GlassFish:** http://localhost:4848/\n\n### Identifiants par défaut\n\n- **Utilisateur:** `gestionnaire`\n- **Mot de passe:** `password123`\n- **Rôle:** `GESTIONNAIRE`\n\n## 📁 Structure du projet\n\n```\nmercato/\n├── src/\n│   ├── java/\n│   │   ├── entity/           # Entités JPA (Materiel, Employe, Mouvement, Utilisateur)\n│   │   ├── service/          # Logique métier (EJBs)\n│   │   ├── web/              # Contrôleurs MVC et API REST\n│   │   ├── security/         # JWT (JwtUtils, JwtFilter)\n│   │   └── resources/        # Scripts SQL\n│   └── conf/\n│       └── persistence.xml   # Configuration JPA\n├── web/\n│   ├── WEB-INF/views/        # Pages JSP\n│   │   ├── template.jsp      # Template principal DaisyUI\n│   │   ├── dashboard.jsp     # Tableau de bord\n│   │   ├── materiels/        # CRUD matériels\n│   │   ├── employes/         # CRUD employés\n│   │   └── mouvements/       # Gestion des mouvements\n│   ├── css/\n│   │   └── custom.css        # Styles personnalisés\n│   └── js/\n│       └── main.js           # Scripts JavaScript\n├── API_DOCUMENTATION.md      # Documentation API REST\n├── docker-compose.yaml       # Configuration Docker PostgreSQL\n├── Makefile                  # Commandes de build\n└── pom.xml                   # Configuration Maven\n```\n\n## 🎯 Fonctionnalités\n\n### Gestion des Matériels\n- ✅ CRUD complet (Créer, Lire, Modifier, Archiver)\n- ✅ Recherche et filtrage par catégorie/statut\n- ✅ Calcul automatique des dates d'expiration\n- ✅ Alertes sur les matériels expirant dans 60 jours\n\n### Gestion du Stock\n- ✅ Entrées de stock\n- ✅ Sorties de stock avec validation\n- ✅ Affectations aux employés\n- ✅ Retours de matériel\n\n### Gestion des Employés\n- ✅ CRUD employés\n- ✅ Consultation des matériels affectés\n- ✅ Historique par employé\n\n### Tableau de Bord\n- ✅ Statistiques en temps réel\n- ✅ Indicateurs visuels (DaisyUI)\n- ✅ Liste des alertes d'expiration\n- ✅ Mouvements récents\n\n### Sécurité\n- ✅ Authentification JWT\n- ✅ Sessions utilisateur\n- ✅ Protection des routes API\n\n### Notifications\n- ✅ @Schedule quotidien (8h00)\n- ✅ Badge d'alertes dans la navbar\n- ✅ Liste des notifications\n\n## 🛠️ Technologies utilisées\n\n| Technologie | Version | Usage |\n|------------|---------|-------|\n| Jakarta EE | 10.0 | Framework backend |\n| Java | 21 | Langage principal |\n| JPA (Hibernate) | 6.x | Persistance des données |\n| JAX-RS | 3.1 | API REST |\n| JWT (JJWT) | 0.12.3 | Authentification |\n| PostgreSQL | 16 | Base de données |\n| GlassFish | 7.1.0 | Serveur d'application |\n| Maven | 3.x | Build et gestion des dépendances |\n| JSP | 3.1 | Templates frontend |\n| DaisyUI | 4.x | Composants UI (Tailwind CSS) |\n| Font Awesome | 6.x | Icônes |\n\n## 📝 Commandes Make disponibles\n\n```bash\nmake build         # Compile et package l'application\nmake clean         # Nettoie les artefacts de build\nmake db-start      # Démarre PostgreSQL (Docker)\nmake db-stop       # Arrête PostgreSQL\nmake server-start  # Démarre GlassFish\nmake server-stop   # Arrête GlassFish\nmake deploy        # Déploie l'application\nmake undeploy      # Retire l'application\nmake run           # Démarre tout (DB + deploy)\nmake test          # Exécute les tests\n```\n\n## 📖 Documentation API\n\nLa documentation complète de l'API REST est disponible dans [API_DOCUMENTATION.md](API_DOCUMENTATION.md).\n\nPoints d'entrée principaux :\n\n- `POST /api/auth/login` - Authentification\n- `GET /api/materiels` - Liste des matériels (avec filtres optionnels: ?categorie=, ?statut=)\n- `POST /api/materiels` - Créer un matériel\n- `GET /api/materiels/{id}` - Détail d'un matériel\n- `POST /api/materiels/{id}/entree` - Entrée de stock\n- `POST /api/materiels/{id}/sortie` - Sortie de stock\n- `POST /api/materiels/{id}/affectation` - Affectation à un employé\n- `GET /api/materiels/{id}/historique` - Historique des mouvements\n- `GET /api/employes` - Liste des employés\n- `POST /api/employes` - Créer un employé\n\n## 🔧 Configuration\n\n### Configuration JPA (persistence.xml)\n\n```xml\n\u003cpersistence-unit name=\"mercatoPU\" transaction-type=\"JTA\"\u003e\n    \u003cjta-data-source\u003ejdbc/mercato\u003c/jta-data-source\u003e\n    \u003cclass\u003eentity.Materiel\u003c/class\u003e\n    \u003cclass\u003eentity.Employe\u003c/class\u003e\n    \u003cclass\u003eentity.Mouvement\u003c/class\u003e\n    \u003cclass\u003eentity.Utilisateur\u003c/class\u003e\n    \u003cproperties\u003e\n        \u003cproperty name=\"jakarta.persistence.schema-generation.database.action\" value=\"create\"/\u003e\n        \u003cproperty name=\"hibernate.show_sql\" value=\"true\"/\u003e\n    \u003c/properties\u003e\n\u003c/persistence-unit\u003e\n```\n\n### Configuration JWT\n\nLe token JWT est configuré avec :\n- **Secret:** Changez-le en production!\n- **Expiration:** 24 heures\n- **Algorithme:** HS256\n\nModifier dans `security/JwtUtils.java` :\n\n```java\nprivate static final String SECRET_KEY = \"votre-cle-secrete-tres-longue-et-securisee\";\nprivate static final long EXPIRATION_TIME = 86400000; // 24 heures\n```\n\n## 🧪 Tests\n\nExécuter les tests :\n\n```bash\nmake test\n```\n\nOu :\n\n```bash\nmvn test\n```\n\n## 🚀 Déploiement en production\n\n1. **Modifier la configuration JWT** avec une clé secrète forte\n2. **Configurer HTTPS** sur GlassFish\n3. **Changer les identifiants par défaut**\n4. **Configurer un pool de connexions** JNDI dans GlassFish\n5. **Désactiver** `hibernate.show_sql`\n6. **Utiliser** `schema-generation.database.action=none` après la première exécution\n\n## 👥 Auteurs\n\n- **Développeur:** M2 IRT AL 2026-2026\n- **Projet:** TP Jakarta EE - Gestion d'Inventaire\n\n## 📄 Licence\n\nCe projet est développé dans le cadre d'un TP universitaire.\n\n## 🐛 Dépannage\n\n### Problème: \"Persistence unit not found\"\n- Vérifier que le fichier `persistence.xml` est dans `src/conf/META-INF/`\n- Redémarrer GlassFish\n\n### Problème: \"Token invalide\"\n- Vérifier que le secret JWT est identique dans toute l'application\n- Supprimer les cookies de session\n\n### Problème: \"Database connection failed\"\n- Vérifier que PostgreSQL est démarré : `make db-start`\n- Vérifier les identifiants dans `persistence.xml`\n\n### Problème: \"404 Not Found\" sur les pages JSP\n- Vérifier que l'application est bien déployée\n- Vérifier l'URL de contexte dans `pom.xml`\n\n## 📞 Support\n\nPour toute question ou problème :\n1. Consulter la documentation API\n2. Vérifier les logs GlassFish dans `glassfish7/glassfish/domains/domain1/logs/`\n3. Vérifier les logs de l'application\n\n---\n\n**Version:** 1.0  \n**Date:** Mars 2026","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevalade%2Fmercato","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevalade%2Fmercato","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevalade%2Fmercato/lists"}