docs: align MinAn 2.0 repository documentation

Author: mickhornung-oss

.gitignore

@@ -41,6 +41,17 @@ Desktop.ini
 # Local assistant config
 .claude/
 
+# Local app/service scaffolding not used by this desktop project
+.funcignore
+host.json
+local.settings.json
+
+# Local scratch/output files
+generated-image.png
+plan.md
+
 # Generic temporary files
 *.log
 *.tmp
+
+.python_packages

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project are documented in this file.
 
+## [v2.0.0] - 2026-05-17
+
+### Added
+
+- new compact KPI strip and dedicated "Fehlwerte" tile on the overview dashboard
+- read-only column type-hint chips on the overview
+- "Typ-Assistent" dialog with per-column type suggestions and bulk apply
+- explicit, opt-in NaN normalization tool in the Edit tab (placeholders, whitespace-like cells, user-selected sentinels) with undo support
+- SQL `CREATE TABLE` schema preview and export (clipboard / `.sql` file) in the Export tab
+
+### Changed
+
+- visible product line bumped to `MinAn 2.0` across UI, packaging metadata, batch banners, and documentation
+- refined desktop theme with a calmer blue-gray palette and stronger contrast
+- detail tiles use a white surface with a 4 px accent bar instead of full pastel fills
+
+### Notes
+
+- internal `REPORT_TITLE` remains `MinAn 1.4 - Analysebericht` to preserve the existing report-service test contract
+- default `pd.read_csv` behavior is unchanged; NaN normalization is a post-import, user-triggered transformation
+- current repository test baseline: `167 passed`
+
 ## [v1.4.0] - 2026-04-17
 
 ### Added
@@ -17,12 +39,11 @@ All notable changes to this project are documented in this file.
 
 - root and repository framing hardened for public/product presentation
 - build pipeline hardened (`build_release.bat`) with fail-fast checks and deterministic cleanup
-- packaging/docs alignment fixed for one bundled release sample (`test_csv_deutsch_200x15.csv`)
-- status and guidance docs aligned to real build/test/CI behavior
+- status and guidance docs aligned to real build/test/CI behavior for the then-current release baseline
 
 ### Verified
 
-- baseline tests green: `pytest -q` (`155 passed` reference run)
+- baseline tests were green for the historical `v1.4.0` repository baseline
 - full local quality gate supports compile + tests + build + EXE smoke
 
 ### Not Included

README.md

@@ -1,118 +1,148 @@
-# MinAn V1
+# MinAn 2.0 - CSV-Schnellanalyse-App fuer Windows
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![Tests](https://github.com/mickhornung-oss/minan-csv-analyse/actions/workflows/python-tests.yml/badge.svg)](https://github.com/mickhornung-oss/minan-csv-analyse/actions/workflows/python-tests.yml)
 
-Stable release (`v1.4.0`) of a production-ready Windows desktop mini-tool for fast CSV analysis.
+MinAn 2.0 ist eine lokale Windows-Desktop-App fuer schnelle CSV-Analyse ohne Installation, ohne Adminrechte und ohne Serververbindung.
 
-## Product Overview
-
-MinAn loads CSV files, analyzes structure and data quality, and lets users filter/edit an active view before exporting CSV or HTML reports. The source CSV is never overwritten.
-
-Target users: analysts, QA teams, and developers who need fast local CSV sanity checks without cloud dependencies.
+Autor und GitHub-Owner: `Michael Hornung / mickhornung-oss`
 
 ![MinAn main analysis view](assets/screenshots/minan_v1_main.png)
 ![MinAn metrics analysis view](assets/screenshots/minan_v1_analysis.png)
 
-## Status and Scope
+## Produktueberblick
+
+MinAn laedt CSV-Dateien, analysiert Struktur und Datenqualitaet und stellt eine aktive Arbeitsansicht fuer Pruefung, Vergleich und Export bereit. Die Quelldatei wird dabei nie ueberschrieben.
+
+Der aktuelle Produktstand ist:
+
+- Produktlinie: `MinAn 2.0`
+- Release-Identitaet: `v2.0.0`
+- Zielplattform: Windows 10/11
+- Auslieferung: portable One-Folder-EXE unter `dist/MinAn_2_0/`
+- Teststand: `167 automatisierte Tests`
+- Belastungstest: `5.000 Zeilen x 19 Spalten`
+
+## Funktionsumfang
+
+- Lokale CSV-Schnellanalyse ohne Cloud, SaaS oder Serveranbindung
+- 6 Tabs: `Ueberblick`, `Daten`, `Kennzahlen`, `Diagramme`, `Vergleich`, `Export`
+- Datenqualitaetspruefung, Kennzahlen und Visualisierungen
+- 6 Diagrammtypen:
+  - Fehlwerte
+  - Histogramm
+  - Boxplot
+  - Top-Kategorien
+  - Streudiagramm
+  - Korrelation
+- SQL-Schema-Vorschau und Export fuer `SQLite`, `PostgreSQL` und `MySQL`
+- Aktive Arbeitsansicht mit Filtern, Quick-Views und Vergleich zum Original
+- Gebuendelter Beispieldatensatz fuer den Schnellstart
 
-- Product line: `MinAn 1.4`
-- Release identity: `v1.4.0`
-- Scope: local/offline desktop usage (Windows)
-- Delivery model: portable one-folder build (`dist/MinAn_1_4/`)
-- Public hosted demo: not provided
-- Reference test run (2026-04-17): `155 passed` via `pytest -q`
+## Exportformate
 
-## Core Features
+MinAn 2.0 unterstuetzt fuenf Export- bzw. Ausgabeformate:
 
-- CSV import with automatic encoding and separator detection
-- Dataset overview with profile, quality findings, and summary
-- Active-view workflow with filters and quick views (missing values, duplicates, outlier candidates)
-- Tab-based desktop UI (Overview, Table, Metrics, Charts, Edit, Export)
-- CSV export of the active view
-- HTML report export of the active view
-- Bundled sample dataset for quick local evaluation
+- `CSV`: aktive Sicht als neue CSV-Datei
+- `HTML-Bericht`: lokaler Analysebericht mit eingebetteten Diagrammen
+- `JSON-Metadaten`: strukturierter Export der Analyse- und View-Metadaten
+- `SQL-Schema`: `CREATE TABLE`-Statement als `.sql`
+- `PNG-Diagramme`: gespeicherte Diagramm-Snapshots aus dem Diagramm-Tab
+
+Nicht Teil des Produkts sind Excel-Import, KI-Funktionen, Cloud-Workflows oder automatische Datenbereinigung als stiller Hintergrundprozess.
 
 ## Tech Stack
 
 - Python 3.10+
-- PySide6 (desktop UI)
-- pandas + numpy (data processing)
-- matplotlib (charts/report snapshots)
-- pytest (automated tests)
-- PyInstaller (portable packaging)
+- PySide6
+- pandas
+- matplotlib
+- PyInstaller
+- Git / GitHub
 
-## Quickstart
+## Schnellstart
 
-### End user (portable build)
+### Endnutzer
 
-1. Build a release (or use an already built one):
+1. Release bauen oder vorhandenen Build verwenden:
    `build_release.bat`
-2. Run:
-   `dist\\MinAn_1_4\\MinAn.exe`
+2. Anwendung starten:
+   `dist\\MinAn_2_0\\MinAn.exe`
 
-### Developer mode
+### Entwicklung
 
-1. Install dependencies:
+1. Abhaengigkeiten installieren:
    `pip install -r requirements.txt`
-2. Start app:
+2. Anwendung starten:
    `run_dev.bat`
 
-## Testing and Quality Gates
+Alternativ direkt:
+
+`python src/minan_v1/main.py`
+
+## Tests und Qualitaet
 
-Baseline local gates (compile + tests):
+Lokale Baseline-Gates:
 
 `python scripts/quality_gates.py`
 
-Full local gates (compile + tests + release build + EXE smoke):
+Volle lokale Gates inklusive Build und EXE-Smoke:
 
 `python scripts/quality_gates.py --with-build --with-exe-smoke`
 
-## Packaging and Build
+Aktueller verifizierter Teststand in diesem Repository:
 
-Build command:
+- `167 passed` via `python -m pytest tests/ -q`
+
+## Packaging
+
+Build-Einstieg:
 
 `build_release.bat`
 
-Build source of truth:
+Massgebliche Packaging-Quellen:
+
+- `packaging/pyinstaller/minan_v1.spec`
+- `packaging/pyinstaller/windows_version_info.txt`
 
-- PyInstaller spec: `packaging/pyinstaller/minan_v1.spec`
-- Windows version metadata: `packaging/pyinstaller/windows_version_info.txt`
-- Bundled release sample: `_internal/sample_data/test_csv_deutsch_200x15.csv`
+Generierte Artefakte werden bewusst nicht versioniert:
 
-Generated artifacts are intentionally not versioned (`build/`, `dist/`, `output/`).
+- `build/`
+- `dist/`
+- `output/`
 
-## Documentation
+## Dokumentation
 
-Primary docs index: [`docs/README.md`](docs/README.md)
+Primarer Doku-Einstieg: [`docs/README.md`](docs/README.md)
 
-- Release notes: [`docs/release.md`](docs/release.md)
-- Change history: [`CHANGELOG.md`](CHANGELOG.md)
-- Project status: [`docs/status.md`](docs/status.md)
+- Release: [`docs/release.md`](docs/release.md)
+- Projektstatus: [`docs/status.md`](docs/status.md)
+- Packaging: [`docs/packaging.md`](docs/packaging.md)
+- Nutzung: [`docs/usage.md`](docs/usage.md)
+- Aenderungshistorie: [`CHANGELOG.md`](CHANGELOG.md)
 
-## Repository Structure
+## Repository-Struktur
 
 ```text
 .
-|- src/minan_v1/              # app core (domain/services/ui/utils)
-|- tests/                     # automated tests
-|- assets/                    # icons, sample CSV, screenshots
-|- packaging/pyinstaller/     # versioned build/packaging sources
-|- docs/                      # public + internal documentation
-|- scripts/                   # product-check helper scripts
-|- run_dev.bat                # local developer start
-|- build_release.bat          # release build entrypoint
+|- src/minan_v1/              # App-Kern (domain/services/ui/utils)
+|- tests/                     # automatisierte Tests
+|- assets/                    # Icons, Beispieldaten, Screenshots
+|- packaging/pyinstaller/     # versionierte Build-Konfiguration
+|- docs/                      # oeffentliche und interne Dokumentation
+|- scripts/                   # Qualitaets- und Produktcheck-Skripte
+|- run_dev.bat                # lokaler Entwicklungsstart
+|- build_release.bat          # Release-Build
 `- requirements.txt
 ```
 
-## Known Limitations
+## Grenzen
 
-- Windows-first desktop target (no cross-platform packaging support documented yet)
-- No hosted/web demo; evaluation is local only
-- CI remains intentionally minimal (Windows quality gates on push/PR, packaging smoke on manual dispatch)
-- No automated GitHub artifact publishing pipeline is defined yet
+- Windows-first; kein dokumentierter Cross-Platform-Releasepfad
+- Kein gehostetes Web-Frontend, kein Online-Demo-Deployment
+- Keine automatisierte GitHub-Release-Pipeline im aktuellen Stand
 
-## License
+## Lizenz
 
-Licensed under the MIT License. See [`LICENSE`](LICENSE).
+MIT-Lizenz, siehe [`LICENSE`](LICENSE).

docs/packaging.md

@@ -1,6 +1,6 @@
 # Packaging and Build
 
-Release identity: `v1.4.0`
+Release identity: `v2.0.0`
 
 ## Build Entry Point
 
@@ -11,11 +11,10 @@ build_release.bat
 The script is fail-fast and performs:
 
 1. precondition checks (PyInstaller, spec, version file, sample CSV)
-2. cleanup of previous generated `build/` and target `dist/MinAn_1_4/`
+2. cleanup of previous generated `build/` and target `dist/MinAn_2_0/`
 3. fresh PyInstaller build (`--clean --noconfirm`)
-4. post-build validation (`MinAn.exe` must exist)
-5. release-root preparation (`output/reports`, `output/csv`)
-6. copy of user-facing readme files into release root
+4. move of `MinAn.exe` into `dist/MinAn_2_0/`
+5. copy of release readme and license files
 
 ## Build Source of Truth
 
@@ -32,40 +31,39 @@ Spec entrypoint:
 
 - Windows 10/11
 - Python 3.10+
-- install dependencies with `pip install -r requirements.txt`
+- dependencies installed via `pip install -r requirements.txt`
 
 ## Expected Release Layout
 
 ```text
-dist/MinAn_1_4/
+dist/MinAn_2_0/
 |- MinAn.exe
-|- _internal/
-|  `- sample_data/
-|     `- test_csv_deutsch_200x15.csv
-|- output/
-|  |- reports/
-|  `- csv/
 |- README_Kurzstart.txt
-`- README.md
+`- LICENSE.txt
 ```
 
+Runtime output folders are created by the app relative to the release root as needed, for example:
+
+- `output/reports/`
+- `output/csv/`
+- `output/meta/`
+- `output/charts/`
+
 ## Release Start Path
 
 End-user start command:
 
-`dist\\MinAn_1_4\\MinAn.exe`
+`dist\\MinAn_2_0\\MinAn.exe`
 
 ## Release Include/Exclude Policy
 
 Included in release:
 
 - executable (`MinAn.exe`)
-- runtime payload (`_internal/`)
-- exactly one bundled sample dataset (`_internal/sample_data/test_csv_deutsch_200x15.csv`)
-- output folders (`output/reports`, `output/csv`)
-- release readmes
+- user-facing quickstart readme
+- license text
 
-Excluded from release repository tracking:
+Excluded from repository tracking:
 
 - `build/` (generated)
 - `dist/` (generated)
@@ -74,21 +72,19 @@ Excluded from release repository tracking:
 ## Artifact Policy
 
 - `build/`, `dist/`, and `output/` are generated and excluded from git.
-- Packaging source files are versioned under `packaging/pyinstaller/`.
+- Packaging source files remain versioned under `packaging/pyinstaller/`.
 
 ## Packaging Scope
 
 This repository documents Windows portable packaging only.
 Cross-platform packaging is currently out of scope.
 
-## Minimal Smoke Validation (after build)
-
-1. Verify `dist/MinAn_1_4/MinAn.exe` exists.
-2. Launch executable.
-3. Confirm app window opens.
-4. Confirm `output/reports` and `output/csv` exist under release root.
+## Minimal Smoke Validation
 
-For a formal acceptance gate list, use [`release_checklist.md`](release_checklist.md).
+1. Verify `dist/MinAn_2_0/MinAn.exe` exists.
+2. Launch the executable.
+3. Confirm the app window opens.
+4. Confirm runtime output folders are created when features are used.
 
 For one-command local execution of compile/test/build/smoke gates, use: