{
  "markdown": "<div align=\"center\">\n\n# OpenLMNP\n\n**Logiciel open source de comptabilité LMNP (Location Meublée Non Professionnelle)**\n\nGérez vos biens en location meublée, calculez vos amortissements,\net produisez votre liasse fiscale au régime réel — sans abonnement, chez vous.\n\n[![Tests](https://github.com/manganate006/openlmnp/actions/workflows/tests.yml/badge.svg)](https://github.com/manganate006/openlmnp/actions/workflows/tests.yml)\n[![Release](https://img.shields.io/github/v/release/manganate006/openlmnp?label=Release&color=blue)](https://github.com/manganate006/openlmnp/releases)\n[![Licence](https://img.shields.io/github/license/manganate006/openlmnp?label=Licence&color=green)](LICENSE)\n![PHP](https://img.shields.io/badge/PHP-8.4-777BB4?logo=php&logoColor=white)\n![Laravel](https://img.shields.io/badge/Laravel-13-FF2D20?logo=laravel&logoColor=white)\n![Filament](https://img.shields.io/badge/Filament-5-FBBF24)\n![Docker Pulls](https://img.shields.io/docker/pulls/manganate06/openlmnp?logo=docker&logoColor=white&label=Docker%20pulls)\n\n**[🚀 Démo live](https://app.openlmnp.fr)** · **[📦 Installation](#installation-rapide-docker)** · **[📚 Documentation](#documentation)** · **[🇬🇧 English](README.en.md)**\n\n![Démonstration d'OpenLMNP : tableau de bord, simulateur, projection et télédéclaration](docs/screenshots/demo.gif)\n\n</div>\n\n> **🎯 Essayez sans rien installer** — la [démo en ligne](https://app.openlmnp.fr) crée un bac à sable\n> éphémère et isolé pour chaque visiteur, pré-rempli avec 4 années de comptabilité fictive.\n> Connexion : `demo@openlmnp.fr` / `demo2026`.\n\n## Sommaire\n\n- [Pourquoi OpenLMNP ?](#pourquoi-openlmnp-)\n- [Fonctionnalités](#fonctionnalités)\n- [Captures d'écran](#captures-décran)\n- [Documentation](#documentation)\n- [Installation rapide (Docker)](#installation-rapide-docker)\n- [Installation LXC Proxmox](#installation-lxc-proxmox-script-communautaire)\n- [Installation développement](#installation-développement)\n- [Configuration](#configuration)\n- [Tests](#tests)\n- [Contribution](#contribution)\n- [Comment nous soutenir ?](#comment-nous-soutenir-)\n- [Licence](#licence)\n\n## Pourquoi OpenLMNP ?\n\nLe régime réel LMNP est presque toujours plus avantageux que le micro-BIC pour un meublé,\nmais il exige des amortissements par composant, une liasse fiscale (2031, 2033) et un FEC\nconforme. Les options habituelles ont chacune leur défaut :\n\n| | **OpenLMNP** | Tableur maison | SaaS comptable | Expert-comptable |\n|---|---|---|---|---|\n| **Coût** | Gratuit (AGPLv3) | Gratuit | Abonnement annuel | Honoraires annuels |\n| **Vos données** | Chez vous (auto-hébergé) | Chez vous | Cloud d'un tiers | Chez un tiers |\n| **Amortissements par composant** | ✅ Automatiques | ⚠️ Formules à maintenir | ✅ | ✅ |\n| **Liasse fiscale + FEC** | ✅ Générés | ❌ | ✅ | ✅ |\n| **Calculs au centime (bcmath)** | ✅ | ⚠️ Arrondis flottants | ✅ | ✅ |\n\nOpenLMNP automatise le régime réel de bout en bout et reste un **outil d'aide** : pour les\nsituations complexes (indivision, TVA para-hôtelière, passage en LMP…), un expert-comptable\nreste recommandé.\n\n## Fonctionnalités\n\n### 🏠 Comptabilité & amortissements\n- **Amortissement par composant** — gros œuvre, toiture, plomberie, agencements (durées standards)\n- **Travaux & mobilier** — amortissement dédié ou au prorata, gestion neuf/occasion\n- **Emprunts** — tableau d'amortissement automatique, intérêts déductibles\n- **Écritures comptables** — génération automatique selon le plan comptable LMNP\n- **Multi-biens** — adresse, surfaces, quote-part résidence principale, valeur vénale\n\n### 📋 Fiscal & déclarations\n- **Exercices chaînés** — reports N−1, amortissements différés, plafonnement\n- **Simulateur micro-BIC vs régime réel** — avec verdict chiffré\n- **Projection pluriannuelle** — tableau sur 5 à 20 ans, année de bascule des régimes\n- **Télédéclaration interactive** — lignes Cerfa 2031, 2033-A/B/C/D, 2042-C-PRO avec boutons « Copier »\n- **Liasse fiscale PDF** — génération complète\n- **FEC conforme** — article A.47 A-1 du LPF, 18 colonnes, format légal\n\n### 🔌 Import & intégrations\n- **Import CSV Airbnb / Booking** — formats FR/EN, détection des doublons\n- **Export CSV** — recettes, charges, télédéclaration\n- **API MCP (45 outils)** — pilotez votre comptabilité depuis un assistant IA (Claude, etc.)\n- **Mises à jour automatiques** — notification et déploiement depuis GitHub\n\n### 🛡️ Confort & sécurité\n- **Multi-utilisateurs** — chaque propriétaire voit uniquement ses données\n- **Assistants guidés** — onboarding, création de bien, clôture fiscale, emprunt, import annuel\n- **Justificatifs** — pièces uploadées sur charges, travaux et mobilier\n- **Guide intégré & badges de progression** — mise en route, suivi régulier, déclaration annuelle\n- **Dark mode** — natif Filament\n- **234 tests automatisés** — Pest PHP, 629 assertions ([détail](docs/TESTS.md))\n\n## Captures d'écran\n\n| Simulateur | Projection | Télédéclaration |\n|---|---|---|\n| [![Simulateur micro-BIC vs réel](docs/screenshots/simulateur.png)](docs/screenshots/simulateur.png) | [![Projection pluriannuelle](docs/screenshots/projection.png)](docs/screenshots/projection.png) | [![Aide à la télédéclaration](docs/screenshots/teledeclaration.png)](docs/screenshots/teledeclaration.png) |\n\nD'autres captures : [tableau de bord](docs/screenshots/dashboard.png) · [charges](docs/screenshots/charges.png)\n\n## Documentation\n\n| Document | Contenu |\n|----------|---------|\n| [Installation](docs/INSTALLATION.md) | Auto-hébergement via Docker : build, run, volumes de persistance, variables d'environnement, mise à jour et sauvegarde |\n| [Fonctionnalités](docs/FONCTIONNALITES.md) | Amortissement par composant, FEC, liasse fiscale 2031/2033, import CSV, simulateur, multi-biens, emprunts, justificatifs |\n| [Mode démonstration](docs/DEMO.md) | Activer et utiliser le mode démo multi-utilisateurs (sandbox éphémère isolé par visiteur) |\n| [FAQ](docs/FAQ.md) | Questions courantes : gratuité, confidentialité des données, régime réel vs micro-BIC, sauvegardes… |\n| [Guide fiscal LMNP / Airbnb](docs/fiscalite-lmnp-airbnb.md) | Règles fiscales du régime réel : amortissements, abattements, plafonds, réforme 2026 |\n| [Couverture de tests](docs/TESTS.md) | Détail des 234 tests automatisés, suite par suite |\n| [Guide de conception UI](docs/ui-design-openlmnp.md) | Choix de design de l'interface Filament |\n\nPour contribuer au projet, voir [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Stack technique\n\n| Composant | Technologie |\n|-----------|-------------|\n| Framework | Laravel 13 |\n| Admin UI | Filament 5 |\n| Interactivité | Livewire 4 |\n| Base de données | SQLite (PostgreSQL en option) |\n| PDF | DomPDF |\n| Calculs financiers | PHP bcmath (précision décimale) |\n| Tests | Pest PHP |\n| Déploiement | Docker |\n\n## Installation rapide (Docker)\n\nAvec l'image officielle [`manganate06/openlmnp`](https://hub.docker.com/r/manganate06/openlmnp) :\n\n```bash\ndocker run -d --name openlmnp -p 8090:8000 \\\n  -v openlmnp-database:/var/www/html/database \\\n  -v openlmnp-storage:/var/www/html/storage \\\n  --restart unless-stopped manganate06/openlmnp:latest\n```\n\nOu en construisant l'image depuis les sources :\n\n```bash\ngit clone https://github.com/manganate006/openlmnp.git\ncd openlmnp\ndocker build -t openlmnp .\ndocker run -d --name openlmnp -p 8090:8000 --restart unless-stopped openlmnp\n```\n\nAccès : `http://localhost:8090`\nCompte démo : `demo@openlmnp.fr` / `demo2026`\n\n## Installation LXC Proxmox (script communautaire)\n\nSur un hôte Proxmox VE, crée un conteneur LXC prêt à l'emploi en une seule commande :\n\n```bash\nbash -c \"$(curl -fsSL https://raw.githubusercontent.com/manganate006/openlmnp/main/community-scripts/ct/openlmnp.sh)\"\n```\n\nDebian 13 · nginx + PHP 8.4-FPM · SQLite. Un mot de passe admin **aléatoire** est généré à\nl'installation et enregistré dans `/opt/openlmnp/admin_credentials.txt`.\n\n> ℹ️ Nécessite un dépôt public avec une *release* publiée (le script récupère la dernière release GitHub).\n\n## Installation développement\n\n```bash\ngit clone https://github.com/manganate006/openlmnp.git\ncd openlmnp\ncomposer install\ncp .env.docker .env\nphp artisan key:generate\ntouch database/database.sqlite\nphp artisan migrate:fresh --seed\nphp artisan serve\n```\n\n## Configuration\n\nÀ la première visite, créez votre compte sur `/register` : il devient\n**administrateur**, puis la page d'inscription **se referme automatiquement**\n(instance personnelle par défaut — réglable via `ALLOW_REGISTRATION`).\nAjoutez ensuite votre SIREN dans votre profil pour les documents fiscaux.\n\n| Variable | Description | Défaut |\n|----------|-------------|--------|\n| `DB_CONNECTION` | Base de données | `sqlite` |\n| `DB_DATABASE` | Chemin SQLite | `database/database.sqlite` |\n| `APP_LOCALE` | Langue | `fr` |\n| `ALLOW_REGISTRATION` | Inscription : `auto` (jusqu'au premier compte), `true` (toujours), `false` (jamais) | `auto` |\n| `FEEDBACK_ENABLED` | Invitation ponctuelle à donner son avis sur le logiciel (voir ci-dessous) | `true` |\n\n### Donner son avis (et comment l'éteindre)\n\nAprès un moment d'utilisation réelle, l'application propose **une fois** de dire ce que vous\npensez du logiciel : un pouce, et si vous le souhaitez un mot. C'est le seul retour que reçoit\nun projet développé sur du temps libre.\n\n**Rien ne quitte votre instance.** Sans `FEEDBACK_FORWARD_EMAIL`, votre retour est simplement\nenregistré dans votre propre base ; l'écran de confirmation vous propose alors de l'envoyer\nvous-même, par votre client mail, si vous en avez envie. Aucun envoi automatique, aucun appel\nsortant.\n\nPour la désactiver complètement :\n\n```bash\nFEEDBACK_ENABLED=false\n```\n\nLes seuils sont réglables sans toucher au code : `FEEDBACK_MIN_SECONDS` (240),\n`FEEDBACK_MIN_ACTIONS` (1), `FEEDBACK_COOLDOWN_DAYS` (30), `FEEDBACK_AUDIENCES`.\n\n### Emails (optionnel)\n\nAucun email ne part par défaut (`MAIL_MAILER=log`) — l'application fonctionne très\nbien sans. Pour activer le lien « Mot de passe oublié », branchez le SMTP de votre\nchoix via les variables `MAIL_*` (l'expéditeur est votre propre adresse ; SPF/DKIM\nsont gérés par votre fournisseur). Et en cas d'oubli sans SMTP, depuis le serveur :\n\n```bash\nphp artisan openlmnp:reset-password vous@exemple.fr\n```\n\n📖 **Référence complète** — toutes les variables, volumes de persistance, comptes,\nSMTP pas à pas, sauvegarde : [docs/INSTALLATION.md](docs/INSTALLATION.md)\n\n## Tests\n\n[![Tests](https://github.com/manganate006/openlmnp/actions/workflows/tests.yml/badge.svg)](https://github.com/manganate006/openlmnp/actions/workflows/tests.yml)\n\n**234 tests Pest PHP, 629 assertions** — services de calcul, pages Filament, isolation\nmulti-utilisateurs, mode démo. Détail suite par suite : [docs/TESTS.md](docs/TESTS.md).\n\n```bash\n# Lancer tous les tests\nvendor/bin/pest\n\n# Par catégorie\nvendor/bin/pest --filter=\"Depreciation\"\nvendor/bin/pest --filter=\"FiscalYear\"\nvendor/bin/pest --filter=\"Filament\"\n```\n\n## Contribution\n\nLes contributions sont les bienvenues ! Merci d'ouvrir une issue avant de soumettre une PR.\n\n```bash\n# Fork + clone\ngit checkout -b feature/ma-fonctionnalite\n# ... modifier ...\nvendor/bin/pest  # vérifier que les tests passent\ngit commit -m \"feat: description\"\ngit push origin feature/ma-fonctionnalite\n# Ouvrir une PR\n```\n\n## 💛 Comment nous soutenir ?\n\nOpenLMNP est développé sur mon temps libre. Si l'outil vous rend service, voici comment\nm'aider à continuer :\n\n- ⭐ **Mettez une étoile** sur le repo — ça aide d'autres loueurs meublés à découvrir le projet\n- 💛 **Devenez sponsor** via [GitHub Sponsors](https://github.com/sponsors/manganate006) — quelques euros par mois financent le temps de développement\n- 🐛 **Signalez un bug** ou proposez une fonctionnalité via les [issues](https://github.com/manganate006/openlmnp/issues)\n- 🔧 **Contribuez du code** — voir [CONTRIBUTING.md](CONTRIBUTING.md)\n\nMerci à toutes celles et ceux qui soutiennent le projet !\n\n## Licence\n\n[AGPLv3](LICENSE) — Logiciel libre. Vous pouvez l'utiliser, le modifier et le redistribuer\nà condition de partager les modifications sous la même licence.\n\n## Crédits\n\n- [Laravel](https://laravel.com) — Framework PHP\n- [Filament](https://filamentphp.com) — Admin panel\n- [Pest PHP](https://pestphp.com) — Framework de tests\n\n---\n\n<div align=\"center\">\n<sub>OpenLMNP est un outil d'aide à la comptabilité. Il ne remplace pas un expert-comptable pour les cas complexes.</sub>\n</div>\n",
  "bytes": 12326,
  "sha": "7a7df53de4f07f1feeae6a46637e893c4f4899508f1075ffeea42c28ec953022",
  "repo_slug": "manganate006/openlmnp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_manganate006_openlmnp_e2067d52/readme"
}