Doku erstellt

ChangeLog.md

@@ -1,5 +1,56 @@
-# CHANGELOG MODULE STEUER FOR [DOLIBARR ERP CRM](https://www.dolibarr.org)
+# Changelog - EÜR Deutschland Modul
 
-## 1.0
+## Version 1.0.0 (2026-02)
 
-Initial version
+### Neu
+- **EÜR Übersicht** (`steuerindex.php`)
+  - Dashboard mit Einnahmen/Ausgaben/Gewinn
+  - Jahres- und Monatsfilter
+  - Schnellzugriff auf alle Funktionen
+
+- **Buchungsverwaltung** (`buchung_list.php`, `buchung_card.php`)
+  - Liste aller Buchungen (automatisch + manuell)
+  - Manuelle Buchungen erstellen/bearbeiten/löschen
+  - Integration mit Dolibarr Rechnungen
+
+- **Anlage EÜR** (`euer_bericht.php`)
+  - Offizielles EÜR-Format
+  - Alle Zeilen 10-87
+  - Automatische Berechnung
+
+- **USt-Voranmeldung** (`ustva.php`)
+  - ELSTER-Kennzahlen (Kz 81, 86, 66, 83, etc.)
+  - WISO Steuer Zeilenzuordnung
+  - Monats-/Quartalsansicht
+  - Jahresübersicht
+
+- **Gewerbesteuer** (`gewerbesteuer.php`)
+  - Vollständige Berechnung
+  - Konfigurierbarer Hebesatz
+  - Hinzurechnungen/Kürzungen
+  - ESt-Anrechnung (§ 35 EStG)
+
+- **WISO Export** (`export_wiso.php`)
+  - WISO EÜR Format (CSV)
+  - DATEV Format (CSV)
+  - UStVA Werte (CSV)
+  - Datenvorschau
+
+- **Kontenplan** (`konten.php`)
+  - SKR03-Kontenrahmen
+  - EÜR-Zeilen-Zuordnung
+  - USt-Kennzahlen
+
+- **Sprachdateien**
+  - Deutsch (de_DE)
+  - Englisch (en_US)
+
+- **Datenbank**
+  - Automatische Tabellenerstellung bei Modulaktivierung
+  - SKR03-Konten werden automatisch eingefügt
+
+### Technisch
+- PHP 7.4+ kompatibel
+- Dolibarr 14.0+ kompatibel
+- Zufluss-/Abflussprinzip implementiert
+- Zurück-Buttons auf allen Seiten

README.md

@@ -1,96 +1,124 @@
-# STEUER FOR [DOLIBARR ERP & CRM](https://www.dolibarr.org)
+# EÜR Deutschland - Dolibarr Modul
 
-## Features
+Einnahmen-Überschuss-Rechnung (EÜR) Modul für Dolibarr ERP & CRM.
 
-Description of the module...
+## Funktionen
 
-<!--
+Dieses Modul bietet eine vollständige EÜR-Lösung für deutsche Kleinunternehmer, Freiberufler und Selbständige:
-![Screenshot steuer](img/screenshot_steuer.png?raw=true "Steuer"){imgmd}
--->
 
-Other external modules are available on [Dolistore.com](https://www.dolistore.com).
+### EÜR Übersicht
+- Automatische Berechnung von Einnahmen und Ausgaben aus Dolibarr-Rechnungen
+- Zufluss-/Abflussprinzip (Ist-Versteuerung)
+- Jahres- und Monatsübersicht
+- Gewinn/Verlust-Anzeige
 
-## Translations
+### USt-Voranmeldung (UStVA)
+- Alle ELSTER-Kennzahlen (Kz 81, 86, 66, 83, etc.)
+- WISO Steuer Zeilenzuordnung
+- Monatliche und quartalsweise Ansicht
+- Jahresübersicht mit allen Perioden
 
-Translations can be completed manually by editing files in the module directories under `langs`.
+### Gewerbesteuer-Berechnung
+- Automatische Berechnung aus EÜR-Gewinn
+- Konfigurierbarer Hebesatz
+- Hinzurechnungen und Kürzungen
+- ESt-Anrechnung nach § 35 EStG
 
-<!--
+### Anlage EÜR
-This module contains also a sample configuration for Transifex, under the hidden directory [.tx](.tx), so it is possible to manage translation using this service.
+- Offizielles Format der Anlage EÜR
+- Alle relevanten Zeilen (10-87)
+- Export-Funktion
 
-For more information, see the [translator's documentation](https://wiki.dolibarr.org/index.php/Translator_documentation).
+### WISO Export
+- CSV-Export im WISO EÜR Format
+- DATEV-Format für Steuerberater
+- UStVA-Werte als CSV
 
-There is a [Transifex project](https://transifex.com/projects/p/dolibarr-module-template) for this module.
+### Kontenplan
--->
+- Vereinfachter SKR03-Kontenrahmen
+- EÜR-Zeilen-Zuordnung
+- USt-Kennzahlen-Mapping
 
+### Manuelle Buchungen
+- Zusätzliche Buchungen erfassen
+- Für Belege außerhalb von Dolibarr
+- Vollständige CRUD-Funktionalität
 
 ## Installation
 
-Prerequisites: You must have Dolibarr ERP & CRM software installed. You can download it from [Dolistore.org](https://www.dolibarr.org).
+### Voraussetzungen
-You can also get a ready-to-use instance in the cloud from https://saas.dolibarr.org
+- Dolibarr ERP & CRM >= 14.0
+- PHP >= 7.4
+- MySQL/MariaDB
 
+### Installation
+1. Modul in `/custom/steuer/` kopieren
+2. In Dolibarr als Admin anmelden
+3. Setup → Module → "EÜR Deutschland" aktivieren
+4. Die Datenbanktabellen werden automatisch erstellt
 
-### From the ZIP file and GUI interface
+### Nach der Installation
+Das Modul erscheint im Hauptmenü unter "EÜR" mit folgenden Untermenüs:
+- Übersicht
+- Buchungen
+- Anlage EÜR
+- USt-Voranmeldung
+- Gewerbesteuer
+- WISO Export
+- Kontenplan
 
-If the module is a ready-to-deploy zip file, so with a name `module_xxx-version.zip` (e.g., when downloading it from a marketplace like [Dolistore](https://www.dolistore.com)),
+## Verwendung
-go to menu `Home> Setup> Modules> Deploy external module` and upload the zip file.
 
-<!--
+### Datenquellen
+Das Modul liest automatisch aus:
+- **Kundenrechnungen** (llx_facture) → Einnahmen
+- **Lieferantenrechnungen** (llx_facture_fourn) → Ausgaben
+- **Zahlungen** für Zufluss-/Abflussprinzip
 
-Note: If this screen tells you that there is no "custom" directory, check that your setup is correct:
+### Zufluss-/Abflussprinzip
+- Einnahmen werden zum Zahlungseingang erfasst
+- Ausgaben werden zum Zahlungsausgang erfasst
+- Entspricht der Ist-Versteuerung für EÜR
 
-- In your Dolibarr installation directory, edit the `htdocs/conf/conf.php` file and check that following lines are not commented:
+### WISO Steuer Integration
+1. Gehe zu "WISO Export"
+2. Wähle Jahr und Format
+3. Exportiere CSV
+4. Importiere in WISO Steuer
 
-    ```php
+### UStVA übertragen
-    //$dolibarr_main_url_root_alt ...
+1. Gehe zu "USt-Voranmeldung"
-    //$dolibarr_main_document_root_alt ...
+2. Wähle Monat/Quartal
-    ```
+3. Übertrage die Kennzahlen in ELSTER oder WISO:
+   - Kz 81 → Umsätze 19%
+   - Kz 86 → Umsätze 7%
+   - Kz 66 → Vorsteuer
+   - Kz 83 → Zahllast/Erstattung
 
-- Uncomment them if necessary (delete the leading `//`) and assign the proper value according to your Dolibarr installation
+## Datenbanktabellen
 
-    For example :
+Das Modul erstellt folgende Tabellen:
+- `llx_steuer_konto` - SKR03 Kontenrahmen
+- `llx_steuer_buchung` - Manuelle Buchungen
+- `llx_steuer_ustva` - UStVA-Daten (optional)
+- `llx_steuer_gewerbe` - Gewerbesteuer-Daten (optional)
 
-    - UNIX:
+## Hinweise
-        ```php
-        $dolibarr_main_url_root_alt = '/custom';
-        $dolibarr_main_document_root_alt = '/var/www/Dolibarr/htdocs/custom';
-        ```
 
-    - Windows:
+- Dieses Modul ersetzt keine Steuerberatung
-        ```php
+- Alle Werte vor Abgabe prüfen
-        $dolibarr_main_url_root_alt = '/custom';
+- Für die offizielle Steuererklärung WISO Steuer oder ELSTER verwenden
-        $dolibarr_main_document_root_alt = 'C:/My Web Sites/Dolibarr/htdocs/custom';
-        ```
--->
 
-<!--
+## Lizenz
 
-### From a GIT repository
+GPLv3 oder (nach Wahl) jede spätere Version. Siehe COPYING für Details.
 
-Clone the repository in `$dolibarr_main_document_root_alt/steuer`
+## Autor
 
-```shell
+Eduard Wisch - 2026
-cd ....../custom
-git clone git@github.com:gitlogin/steuer.git steuer
-```
 
--->
+## Support
 
-### Final steps
+Bei Fragen oder Problemen:
-
+- GitHub Issues
-Using your browser:
+- Dolibarr Forum
-
-  - Log into Dolibarr as a super-administrator
-  - Go to "Setup"> "Modules"
-  - You should now be able to find and enable the module
-
-
-
-## Licenses
-
-### Main code
-
-GPLv3 or (at your option) any later version. See file COPYING for more information.
-
-### Documentation
-
-All texts and readme's are licensed under [GFDL](https://www.gnu.org/licenses/fdl-1.3.en.html).