Vielen Dank für Ihr Interesse, zu diesem Projekt beizutragen.
- Bug melden: Erstellen Sie ein Issue mit einer klaren Reproduktion
- Feature vorschlagen: Beschreiben Sie den Ziel-Workflow und erwartete Ausgabe
- Code beitragen: Öffnen Sie einen Pull Request mit einer nachvollziehbaren Änderung
- Forken Sie das Repository
- Erstellen Sie einen Feature-Branch:
git checkout -b feature/mein-feature - Installieren Sie die Abhängigkeiten:
pip install -r requirements.txt - Führen Sie vorhandene Tests aus
- Committen Sie Ihre Änderungen mit präziser Nachricht
- Öffnen Sie einen Pull Request
- Keine echten Rechnungen, Anhänge oder Zugangsdaten committen
- Lokale Beispielausgaben aus
Outputbeispiele/bleiben außerhalb von Git - OCR-, LibreOffice- und Windows-COM-Fallbacks möglichst separat testen
- Neue Features sollten sowohl IMAP- als auch Gmail-Pfade berücksichtigen
- Python: PEP 8
- Encoding: UTF-8
- Keine hardcoded Secrets oder lokalen Benutzerpfade
- Dokumentation und README bei sichtbaren Workflow-Änderungen mitpflegen
Thank you for your interest in contributing to this project.
- Report bugs: Open an issue with a clear reproduction
- Suggest features: Describe the target workflow and expected output
- Contribute code: Open a pull request with a focused, explainable change
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-feature - Install dependencies:
pip install -r requirements.txt - Run the available tests
- Commit your changes with a precise message
- Open a pull request
- Do not commit real invoices, attachments, or credentials
- Keep local example outputs in
Outputbeispiele/out of Git - Test OCR, LibreOffice, and Windows COM fallbacks independently when possible
- New features should cover both IMAP and Gmail execution paths where relevant
- Python: PEP 8
- Encoding: UTF-8
- No hardcoded secrets or local user paths
- Keep README and documentation aligned with visible workflow changes