V2-Stand: UX-Dashboard, Personen v2, Starter-Paket und Dexie-Legacy entfernt.
Sichert den lokalen Entwicklungsstand nach Gitea: Nav/Dashboard, Personen-Excel/Archiv, Team-Setup, Assignment-Übergabe und C6/C7/T2. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
234f87d408
commit
d894c3c8e4
91 files changed
+7196
-2134
No files matched your search
@@ -0,0 +1,114 @@
|
||||
# Team-Setup — Assignment Monitor V2
|
||||
|
||||
Verteilung an Teammitglieder **nur über dieses Repo** (`AssigmentMonitorV2`).
|
||||
Das Produktivsystem (`c:\dev\AssigmentMonitor`, Ports 5173/4000) wird **nicht** angefasst und darf nicht verändert werden.
|
||||
|
||||
## Was im Starter-Paket steckt
|
||||
|
||||
Datei: [`docs/starter/starter-structure.json`](./starter/starter-structure.json)
|
||||
|
||||
| Enthalten | Nicht enthalten |
|
||||
|---|---|
|
||||
| Feedback-Struktur (Dimensionen, Kategorien, Kriterien) | Personen / Groups / Consultants |
|
||||
| Dimension-Prompts, Tagging-Prompts, Farbbänder | Assignments, Meetings, Notizen |
|
||||
| Assignment-Typen, Phasen, Checklisten-Definitionen | Scores, Feedback-Entwürfe, Backups mit Echtdaten |
|
||||
|
||||
`learnedPatternHints` aus echten Protokollen werden beim Export entfernt.
|
||||
|
||||
## Neuinstallation per ZIP (ohne Git)
|
||||
|
||||
1. ZIP entpacken (z.B. nach `C:\dev\AssigmentMonitorV2`)
|
||||
2. Anleitung im Paket: **`EINRICHTUNG.md`** (Kurzfassung)
|
||||
|
||||
```powershell
|
||||
cd C:\dev\AssigmentMonitorV2
|
||||
copy .env.example .env
|
||||
npm install
|
||||
npm run setup
|
||||
npm run dev:all
|
||||
```
|
||||
|
||||
(`npm run setup` = Starter-Struktur; alternativ `npm run bootstrap -- --yes`)
|
||||
|
||||
Öffnen: **http://localhost:5174**
|
||||
|
||||
ZIP erzeugen (Maintainer, nur V2):
|
||||
|
||||
```powershell
|
||||
npm run pack:zip
|
||||
```
|
||||
|
||||
Die Datei liegt unter `dist-release/AssignmentMonitor-Team-YYYY-MM-DD.zip` (gitignored, enthält keine Dev-DB und kein `.env`).
|
||||
|
||||
### Laptop-Umzug (Code + komplette Datenbank)
|
||||
|
||||
Für den eigenen Rechnerwechsel, nicht für Kollegen:
|
||||
|
||||
```powershell
|
||||
npm run pack:laptop
|
||||
```
|
||||
|
||||
Datei: `dist-release/AssignmentMonitor-Umzug-YYYY-MM-DD.zip` — enthält die SQLite unter `server/data/` (personenbezogene Daten). Anleitung im Paket: **`UMZUG.md`**. Am Ziel **kein** `npm run setup` (sonst wird die mitgelieferte DB überschrieben).
|
||||
|
||||
### Assignment-Übergabe (Lead → Lead)
|
||||
|
||||
Nicht das Team-ZIP — sondern ein einzelnes Assignment inkl. Notizen/Checklisten/Beratern:
|
||||
|
||||
- **Export:** Assignment öffnen → **↔ Übergabe**
|
||||
- **Import:** Dashboard → **↔ Import**
|
||||
|
||||
Voraussetzung: gleiche Feedback-Struktur (Starter) auf beiden Rechnern. Details: `docs/HANDOVER.md`, RPC `assignmentTransfer`.
|
||||
|
||||
## Neuinstallation per Git
|
||||
|
||||
Voraussetzungen: **Node.js 25+** (wegen `node:sqlite`), Git.
|
||||
|
||||
```powershell
|
||||
git clone <URL-dieses-Repos>
|
||||
cd AssigmentMonitorV2
|
||||
copy .env.example .env
|
||||
npm install
|
||||
npm run setup
|
||||
npm run dev:all
|
||||
```
|
||||
|
||||
Öffnen: **http://localhost:5174** (nicht 5173).
|
||||
|
||||
Optional: OpenRouter-API-Key unter **Config → KI-Prompts / Feedback**.
|
||||
|
||||
## Starter aktualisieren (Maintainer, nur V2)
|
||||
|
||||
Nach Änderungen an Struktur/Typen/Checklisten/Prompts in der **eigenen V2-Dev-DB**:
|
||||
|
||||
```powershell
|
||||
cd C:\dev\AssigmentMonitorV2
|
||||
npm run starter:export
|
||||
git add docs/starter/starter-structure.json
|
||||
git commit -m "Starter-Paket: Struktur aktualisiert"
|
||||
```
|
||||
|
||||
Teammitglieder holen die Datei per `git pull` und spielen bei Bedarf neu ein:
|
||||
|
||||
```powershell
|
||||
npm run bootstrap -- --yes
|
||||
```
|
||||
|
||||
**Achtung:** `bootstrap` löscht die lokale V2-Dev-DB-Inhalte (Meetings etc.) und ersetzt sie durch das Starter-Paket.
|
||||
|
||||
## Sicherheitsregeln
|
||||
|
||||
- Nie Produktiv-Ordner, -Ports (5173/4000) oder Produktiv-SQLite verwenden — siehe [`DEV_ISOLATION.md`](./DEV_ISOLATION.md).
|
||||
- Starter-Skripte brechen ab bei `API_PORT=4000`, `PORT=5173` oder Dateiname `assignment-monitor.sqlite3`.
|
||||
- Kein Produktiv-Backup in V2 importieren, wenn ihr nur Struktur teilen wollt.
|
||||
|
||||
## npm-Scripts
|
||||
|
||||
| Script | Zweck |
|
||||
|---|---|
|
||||
| `npm run starter:export` | Struktur aus V2-Dev-DB → `docs/starter/starter-structure.json` |
|
||||
| `npm run bootstrap -- --yes` | Starter in V2-Dev-DB einspielen (Wipe) |
|
||||
| `npm run setup` | Wie bootstrap + legt `.env` an falls fehlend |
|
||||
| `npm run pack:zip` | Versandfertiges Team-ZIP nach `dist-release/` (ohne DB) |
|
||||
| `npm run pack:laptop` | Laptop-Umzug: Code + komplette Dev-DB nach `dist-release/` |
|
||||
| `npm run db:reset` | Nur Dev-DB-Datei löschen (leere DB beim nächsten Start) |
|
||||
| `npm run dev:all` | Frontend :5174 + API :4001 |
|
||||
Reference in new issue
Block a user