# Berichtsheft-Generator (Web)

## Suggestions regenerieren

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

```bash
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:

```bash
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](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)

## 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](https://react.dev/learn/react-compiler/installation).

## 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`:

```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](https://oxc.rs/docs/guide/usage/linter/rules) for the full list of rules and categories.