Organize markdown docs for RAG routing
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
# RAG Admin
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- Admin Bereich ist eigener Hauptmenuepunkt, nicht unter Finance.
|
||||
- Route: `/admin/sessions`.
|
||||
- Schutz: eigener App-interner Admin-Login ueber `AdminAccess`.
|
||||
- Admin-Login ist unabhaengig vom Finance-Cockpit-Passwort.
|
||||
- Admin Bereich darf nicht durch Finance-Cockpit-Login blockiert werden.
|
||||
|
||||
## Startseite
|
||||
|
||||
- Route `/` ist neutral und verlangt keinen Finance-Login.
|
||||
- Landing Page nutzt Trafag-nahe Schrift, Manometer und optionales Strichmaennchen.
|
||||
- Schalter fuer Strichmaennchen liegt im Admin Bereich.
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- Detaildoku: `docs/ADMIN_BEREICH_STARTSEITE_2026-05-21.md`
|
||||
|
||||
@@ -0,0 +1,15 @@
|
||||
# RAG Architecture
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- App sammelt Daten aus SAP OData, HANA/SAP B1, SharePoint und manuellen Excel-/CSV-Quellen.
|
||||
- Zentrale Persistenz ueber `CentralSalesRecords`.
|
||||
- Finance-Auswertung und zentrale Excel sollen dieselbe Regelengine verwenden.
|
||||
- Diagramme und Anwenderdokus existieren fuer Keyuser-Prozess und technische Architektur.
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- Diagramme: `docs/PROGRAMM_DIAGRAMME.md`
|
||||
- technischer Handoff und alter LLM-Systemkontext: `docs/raw_md_archive/HISTORY_CANONICAL.md.raw`
|
||||
@@ -0,0 +1,22 @@
|
||||
# RAG Deployment
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- `TrafagSalesExporter` wird als ASP.NET/IIS-Webanwendung im bisherigen `BiDashboard`-Schema publiziert.
|
||||
- Lokaler Uebergangsserver: `http://172.16.9.185:5000` im Trafag-Netz, IP kann wechseln.
|
||||
- Lokale URLs bleiben `https://localhost:55415` und `http://localhost:55416`.
|
||||
- Fuer andere PCs nutzt der Uebergang bewusst HTTP auf Port `5000`.
|
||||
|
||||
## Serverproblem
|
||||
|
||||
- IIS/HTTPS blockiert vor der App.
|
||||
- Dokumentierter Befund: TLS fordert Client-Zertifikat.
|
||||
- IT soll IIS SSL Settings pruefen: Client certificates `Ignore` oder hoechstens `Accept`, nicht `Require`.
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- IIS-Handoff: `docs/DEPLOYMENT_IIS_HANDOFF_2026-05-19.md`
|
||||
- lokaler Server: `docs/LOCAL_DEV_SERVER_UEBERGANG_2026-05-21.md`
|
||||
|
||||
@@ -0,0 +1,45 @@
|
||||
# RAG Finance
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- Fuehrende Sicht: `Finance Summary`.
|
||||
- `Finance Summary` nutzt dieselbe `FinanceRuleEngine` wie das zentrale Excel.
|
||||
- `Management Analyse` bleibt Diagnose-/Plausibilitaetssicht, nicht fuehrende Finance-Zahl.
|
||||
- Filter fuer Jahr, Land und Waehrung wirken auf das Finance-Endergebnis.
|
||||
- Standard-Ist bleibt inklusive Positionen; Intercompany/2nd-party wird separat ausgewiesen.
|
||||
|
||||
## Wichtige Regeln
|
||||
|
||||
- Hauswaehrung des Landessystems ist fuehrend.
|
||||
- Wertbasis ist Nettofakturawert pro Position.
|
||||
- Jahresabgrenzung ueber `PostingDate`, Fallback `InvoiceDate`, danach `ExtractionDate`.
|
||||
- Gutschriften/Storno laufen als negative Beleg-/Positionszeilen.
|
||||
- Budget-CHF ist Kontroll-/Reporting-Kandidat, nicht Standardabgleich.
|
||||
|
||||
## Offene Fachpunkte
|
||||
|
||||
- DE: Finance/Munir muss bestaetigen, welche Kundenlaender/Filter zum offiziellen DE-Ist gehoeren.
|
||||
- IT: Nach neuem IT-Export pruefen, ob die vollstaendige `Trafag Italia`-Summe sichtbar wird.
|
||||
- ES: Differenz zu Rhino/check.xlsx bleibt fachlich zu klaeren.
|
||||
|
||||
## Land-Kurzindex
|
||||
|
||||
| Land | Kurzregel |
|
||||
| --- | --- |
|
||||
| CH/AT | SAP OData `ZSCHWEIZ`, Trennung ueber Buchungskreis/Reporting-Land |
|
||||
| DE | Alphaplan Excel, `NettoPreisGesamtX`, 2025-Zwang |
|
||||
| ES | Sage CSV, `ImporteNeto`, REC/Credit negativ |
|
||||
| IT | Hauswaehrung, `Trafag Italia` ausgeschlossen, Duplikatlogik fuer leeres Supplier country |
|
||||
| UK | Sage/Manual Excel, GBP, `[Sales Price/Value] * [Quantity]`, Credit Notes negativ |
|
||||
| IN | INR als Hauswaehrung |
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- Entscheide: `docs/FINANCE_ENTSCHEIDE.md`, `entscheide.md`
|
||||
- Formeln je Land: `docs/FINANCE_BERECHNUNGSFORMELN_LAENDER_2026-05-19.md`
|
||||
- IT Detail: `docs/FINANCE_IT_VORGEHEN_2026-05-18.md`
|
||||
- UK Korrektur: `docs/FINANCE_UK_QUELLE_KORREKTUR_2026-05-18.md`
|
||||
- ES Detail: `SAGE_SPAIN_EXPORT_2026-05-05.md`
|
||||
- alter Finance-Handoff: `docs/raw_md_archive/HISTORY_CANONICAL.md.raw`
|
||||
@@ -0,0 +1,21 @@
|
||||
# RAG HR KPI
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- HR KPI Cockpit wurde um produktive Cockpit-Funktionen erweitert.
|
||||
- Enthalten sind Anleitung, Datenordner, Dateifrische, Datenstatus, Ampeln, Periodenvergleich, Datenqualitaet, Austritte, Absenzen, Managementsicht und Drucken/PDF.
|
||||
- Managementsicht anonymisiert Personennamen in Detailtabellen.
|
||||
|
||||
## Datenquellen
|
||||
|
||||
- Rexx-/SAP-Dateien aus konfiguriertem Datenordner.
|
||||
- Datenordner im Cockpit je Lauf anpassbar und dauerhaft ueber `HrKpi:DataFolder`.
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- Nachdoku: `docs/HR_KPI_NACHDOKU_2026-05-13.md`
|
||||
- Fachpruefung: `docs/HR_KPI_PRUEFUNG_SWISS_BEST_PRACTICES.md`
|
||||
- Anwenderdoku: `docs/HR_KPI_ANLEITUNG_HR_2026-05-20.docx`
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# RAG Manual Import
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- Manual-Importe ersetzen pro Standort den aktuellen Stand in `CentralSalesRecords`.
|
||||
- Delta-Dateien muessen zusammen mit der passenden Basisdatei gelesen werden.
|
||||
- Das ist aktuell nur fuer UK vorgesehen.
|
||||
- ES und DE muessen Vollfiles liefern.
|
||||
|
||||
## Laender
|
||||
|
||||
| Standort | Quelle | Delta | Finance-Wert |
|
||||
| --- | --- | --- | --- |
|
||||
| UK / `TRUK` | SharePoint `Import/Finance/UK_B1`, Sage Excel | ja | `[Sales Price/Value] * [Quantity]`, Credit Notes negativ, GBP |
|
||||
| ES / `TRSE`/`TRES` | Sage CSV | nein | `ImporteNeto`, REC/Credit negativ, EUR |
|
||||
| DE / `TRDE` | Alphaplan Excel | nein | `NettoPreisGesamtX`, GS negativ, Ausschlussregeln |
|
||||
|
||||
## Bedienreihenfolge
|
||||
|
||||
1. Datei oder Delta im richtigen Ordner bereitstellen.
|
||||
2. In `Manuelle Importe` Pfad/Standort pruefen.
|
||||
3. Standortexport ausfuehren.
|
||||
4. Zentrale Datei neu erzeugen.
|
||||
5. `Finance Summary` und `Finance Details` pruefen.
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- Detailstand: `docs/MANUAL_IMPORT_DELTA_STAND_2026-05-21.md`
|
||||
- Workflow-Historie: `NEXT_STEPS_2026-04-15.md`
|
||||
|
||||
@@ -0,0 +1,24 @@
|
||||
# RAG Project
|
||||
|
||||
Stand: 2026-05-27
|
||||
|
||||
## Kurzstand
|
||||
|
||||
- Fuehrende App: `TrafagSalesExporter`, publiziert als `BiDashboard`.
|
||||
- Letzter dokumentierter Stand: Rebase/Push synchron mit `origin/main`, Head `d853f53 Add published HR KPI workflow fixes`.
|
||||
- Validierung laut Doku: Build erfolgreich, Tests zuletzt `78/78` gruen.
|
||||
- Fuer normale Weiterarbeit diese Datei plus den passenden Themen-RAG laden.
|
||||
|
||||
## Aktive Themen
|
||||
|
||||
- Finance Cockpit: `docs/rag/FINANCE.md`
|
||||
- Manual Import: `docs/rag/MANUAL_IMPORT.md`
|
||||
- HR KPI: `docs/rag/HR_KPI.md`
|
||||
- Deployment/IIS: `docs/rag/DEPLOYMENT.md`
|
||||
- Admin/Startseite: `docs/rag/ADMIN.md`
|
||||
|
||||
## Rohquellen Nur Bei Bedarf
|
||||
|
||||
- kanonische Detailhistorie: `docs/raw_md_archive/HISTORY_CANONICAL.md.raw`
|
||||
- exakte Originaldateien zur Wiederherstellung: `docs/raw_md_archive/original_history_raws.zip`
|
||||
- Dokumentstatus: `docs/MD_DOKUMENTENSTATUS_2026-05-20.md`
|
||||
Reference in New Issue
Block a user