{"id":31807837,"url":"https://github.com/mariemekmr/inventaire-app","last_synced_at":"2026-04-09T02:01:44.187Z","repository":{"id":314960922,"uuid":"1057515064","full_name":"MariemeKmr/inventaire-app","owner":"MariemeKmr","description":"Application web d’inventaire développée avec Django et MariaDB/MySQL pour gérer les produits, ventes, dettes et statistiques d’un magasin, avec intégration Cloudinary et Remove.bg pour les images.","archived":false,"fork":false,"pushed_at":"2025-09-27T22:34:11.000Z","size":8697,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-11T04:38:18.574Z","etag":null,"topics":["application","bootstrap","cloudinary","django","gestion-boutique","inventaire","mariadb","mysql","removebg","sales","statistics"],"latest_commit_sha":null,"homepage":"","language":"Python","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/MariemeKmr.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":"2025-09-15T20:46:49.000Z","updated_at":"2025-09-27T22:34:14.000Z","dependencies_parsed_at":"2025-09-15T23:13:37.850Z","dependency_job_id":"bb9cd026-a2ef-45f9-98fd-bdced84c7dc8","html_url":"https://github.com/MariemeKmr/inventaire-app","commit_stats":null,"previous_names":["mariemekmr/inventaire-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MariemeKmr/inventaire-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MariemeKmr%2Finventaire-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MariemeKmr%2Finventaire-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MariemeKmr%2Finventaire-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MariemeKmr%2Finventaire-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MariemeKmr","download_url":"https://codeload.github.com/MariemeKmr/inventaire-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MariemeKmr%2Finventaire-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31581864,"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":"online","status_checked_at":"2026-04-09T02:00:06.848Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["application","bootstrap","cloudinary","django","gestion-boutique","inventaire","mariadb","mysql","removebg","sales","statistics"],"created_at":"2025-10-11T04:38:11.737Z","updated_at":"2026-04-09T02:01:44.183Z","avatar_url":"https://github.com/MariemeKmr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📦 Inventaire App\n\nApplication web d’inventaire pour gérer un magasin (produits, ventes, dettes, statistiques).  \nDéveloppée avec **Django**, **MariaDB/MySQL**, et intégration **Cloudinary + Remove.bg** pour les images.  \n\n👥 Projet développé par **Marieme KAMARA** et **Idrissa MASSALY**.\n\n---\n\n## 🚀 Fonctionnalités\n\n- **Produits** : ajout, modification, suppression, photos (fond supprimé via API Remove.bg).\n- **Ventes** : enregistrement rapide, décrémentation automatique du stock.\n- **Dettes** : suivi des dettes clients, remboursement total ou partiel.\n- **Statistiques** : chiffre d'affaires, top ventes, comparatifs achats/ventes.\n- **Historique** : traçabilité des actions (qui a fait quoi, quand).\n- **Alertes** : stock faible, messages d'information.\n\n---\n\n## 👥 Profils utilisateurs\n\n- **Admin (propriétaire)** : accès complet (produits, ventes, dettes, statistiques, historique).\n- **Vendeur** : enregistrement ventes et dettes, consultation des produits.  \n\n---\n\n## 🛠️ Technologies\n\n- **Backend** : Django (Python)  \n- **Frontend** : Django Templates (HTML/CSS/JS, Bootstrap)  \n- **Base de données** : MariaDB / MySQL  \n- **Stockage images** : Cloudinary  \n- **API** : Remove.bg (suppression de fond)  \n- **Déploiement** : VPS, PythonAnywhere ou Heroku  \n\n---\n\n## 📂 Structure du projet\n\n```bash\ninventaire-app/\n│── inventaire/ # App Django (produits, ventes, dettes…)\n│── inventaire_app/ # Config principale Django\n│── static/ # Fichiers CSS/JS\n│── templates/ # Vues HTML\n│── sql/ # Script SQL de création de la base\n│── .gitignore\n│── .gitattributes\n│── README.md\n│── requirements.txt\n```\n\n## ⚙️ Installation (local)\n\n### 1. Cloner le projet\n```bash\ngit clone https://github.com/MariemeKmr/inventaire-app.git\ncd inventaire-app\n```\n\n### 2. Créer un environnement virtuel\n```bash\npython -m venv .venv\n# Linux/Mac\nsource .venv/bin/activate\n# Windows\n.venv\\Scripts\\activate\n```\n\n### 3. Installer les dépendances\n```bash\npip install -r requirements.txt\n```\n\n### 4. Configurer la base de données\nImporter le script SQL **sql/inventaire.sql** dans MariaDB/MySQL.\nMettre à jour **inventaire_app/settings.py** → section **DATABASES**.\n\n### 5. Variables d’environnement\nCréer un fichier .env (non versionné).\n\n### 6. Migrations et superuser\n```bash\npython manage.py migrate\npython manage.py createsuperuser\n```\n\n### 7. Lancer le serveur\n```bash\npython manage.py runserver\n```\n\n## 🌱 Workflow Git (collaboration)\n- main → code stable\n- dev → intégration en cours\n- feature/… → une branche par tâche\n  \n```bash\ngit checkout -b feature/produits\n# coder…\ngit add .\ngit commit -m \"feat: page produits\"\ngit push -u origin feature/produits\n```\nPuis ouvrir une Pull Request vers dev.\n\n## 📜 Licence\nProjet privé – réservé à un usage interne.\nDéveloppé par Marieme KAMARA et Idrissa MASSALY.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariemekmr%2Finventaire-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmariemekmr%2Finventaire-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariemekmr%2Finventaire-app/lists"}