berichtsheftgenerator/web/README.md

Berichtsheft-Generator (Web)

Suggestions regenerieren

Aus den echten Heften unter ../1. Ausbildungsjahr und ../2. Ausbildungsjahr:

npm run generate:suggestions

Pipeline:

1. scripts/extract-phrases.mjs – .docx → Rohdaten
2. scripts/clean-phrases.mjs → scripts/clean-phrases.json
3. scripts/score-phrases.mjs → scripts/scored-phrases.json (category + weight)
4. scripts/build-real-suggestions.mjs → src/data/suggestions.ts (SUGGESTIONS, WEEK_THEMES nur echte Themen)
5. scripts/verify-suggestions.mjs – Qualitätstor: Müll-Regex, gültiger type, weight ≥ 1, keine Duplikate, ≥70 % exakte Betrieb-Originale gegen clean-phrases.json

Nur das Tor erneut prüfen:

npm run check:suggestions

---

React + TypeScript + Vite

This template provides a minimal setup to get React working in Vite with HMR and some Oxlint rules.

Currently, two official plugins are available:

• @vitejs/plugin-react uses Oxc
• @vitejs/plugin-react-swc uses SWC

React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see this documentation.

Expanding the Oxlint configuration

If you are developing a production application, we recommend enabling type-aware lint rules by installing oxlint-tsgolint and editing .oxlintrc.json:

{
  "$schema": "./node_modules/oxlint/configuration_schema.json",
  "plugins": ["react", "typescript", "oxc"],
  "options": {
    "typeAware": true
  },
  "rules": {
    "react/rules-of-hooks": "error",
    "react/only-export-components": ["warn", { "allowConstantExport": true }]
  }
}

See the Oxlint rules documentation for the full list of rules and categories.