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:
LarsandCursor committed 2026-09-16 14:17:25 +02:00
1 parent 234f87d408
commit d894c3c8e4
91 files changed
+7196 -2134

No files matched your search

+34
View File
@@ -0,0 +1,34 @@
/**
* Spielt docs/starter/starter-structure.json in die V2-Dev-DB ein (voller Wipe).
* Usage: npm run bootstrap -- --yes
* Ohne --yes / CONFIRM=1: Abbruch (Schutz vor versehentlichem Löschen).
* Produktiv-Ports/DB-Namen werden blockiert.
*/
const args = new Set(process.argv.slice(2))
const confirmed = args.has('--yes') || args.has('-y') || process.env.CONFIRM === '1'
if (!confirmed) {
console.error('[bootstrap] Abbruch: würde die V2-Dev-DB komplett ersetzen.')
console.error('[bootstrap] Zum Bestätigen: npm run bootstrap -- --yes')
console.error('[bootstrap] Quelle: docs/starter/starter-structure.json')
process.exit(1)
}
const {
readStarterPackage,
importStarterPackage,
summarizeStarter,
STARTER_FILE,
} = await import('../db/starterPackage')
const pkg = readStarterPackage()
const counts = summarizeStarter(pkg)
const { structureRows } = importStarterPackage(pkg)
console.log(`[bootstrap] Starter eingespielt (${structureRows} Struktur-Zeilen).`)
console.log(`[bootstrap] Quelle: ${STARTER_FILE} (${pkg.exportedAt})`)
for (const [table, n] of Object.entries(counts)) {
if (n > 0) console.log(` ${table}: ${n}`)
}
console.log('[bootstrap] Keine Personen-/Meeting-Daten. API-Key lokal unter Config → KI setzen.')
console.log('[bootstrap] Start: npm run dev:all → http://localhost:5174')
+22
View File
@@ -0,0 +1,22 @@
/**
* Exportiert Struktur/Config aus der V2-Dev-DB nach docs/starter/starter-structure.json.
* Usage: npm run starter:export
* Produktiv wird per Guard blockiert.
*/
import {
buildStarterPackageFromDb,
writeStarterPackage,
summarizeStarter,
STARTER_FILE,
} from '../db/starterPackage'
const pkg = buildStarterPackageFromDb()
const path = writeStarterPackage(pkg)
const counts = summarizeStarter(pkg)
console.log(`[starter:export] geschrieben: ${path}`)
console.log(`[starter:export] Stand: ${pkg.exportedAt}`)
for (const [table, n] of Object.entries(counts)) {
if (n > 0) console.log(` ${table}: ${n}`)
}
console.log(`[starter:export] Ziel: ${STARTER_FILE}`)
+158
View File
@@ -0,0 +1,158 @@
/**
* Laptop-Umzug: Code + komplette V2-Dev-SQLite (ohne node_modules, .env).
* Enthält personenbezogene Daten — nur an sich selbst / den Ziel-Laptop schicken.
*
* Usage: npm run pack:laptop
*/
import { mkdirSync, existsSync, rmSync, readFileSync, copyFileSync, writeFileSync } from 'node:fs'
import { dirname, join, resolve, relative } from 'node:path'
import { fileURLToPath } from 'node:url'
import { execFileSync } from 'node:child_process'
const __dirname = dirname(fileURLToPath(import.meta.url))
const projectRoot = resolve(join(__dirname, '../..'))
const outDir = join(projectRoot, 'dist-release')
const stamp = new Date().toISOString().slice(0, 10)
const zipName = `AssignmentMonitor-Umzug-${stamp}.zip`
const zipPath = join(outDir, zipName)
const stageName = 'AssigmentMonitorV2'
const stageRoot = join(outDir, '_stage-laptop', stageName)
const rootNorm = projectRoot.toLowerCase()
if (!rootNorm.includes('assigmentmonitorv2')) {
throw new Error('[pack:laptop] SAFETY: Skript nur innerhalb AssigmentMonitorV2 ausführen.')
}
const sqliteFilename = process.env.SQLITE_FILENAME?.trim() || 'assignment-monitor-v2-dev.sqlite3'
if (sqliteFilename.includes('/') || sqliteFilename.includes('\\') || sqliteFilename.includes('..')) {
throw new Error(`[pack:laptop] SAFETY: SQLITE_FILENAME ungültig: "${sqliteFilename}"`)
}
if (sqliteFilename === 'assignment-monitor.sqlite3') {
throw new Error('[pack:laptop] SAFETY: Produktiv-DB-Dateiname blockiert.')
}
const dbPath = join(projectRoot, 'server', 'data', sqliteFilename)
const EXCLUDE_DIR_NAMES = new Set([
'node_modules',
'dist',
'dist-release',
'dist-ssr',
'.vite',
'.claude',
'.vscode',
'_quarantine',
'_stage',
'_stage-laptop',
])
const EXCLUDE_FILE_NAMES = new Set([
'.env',
'.env.local',
'dist-release-log.txt',
])
function shouldSkip(absPath: string): boolean {
const rel = relative(projectRoot, absPath).split(/[/\\]/).join('/')
if (!rel || rel.startsWith('..')) return true
if (rel === 'server/data' || rel.startsWith('server/data/')) return true
if (rel === 'dist-release' || rel.startsWith('dist-release/')) return true
const parts = rel.split('/')
if (parts.some(p => EXCLUDE_DIR_NAMES.has(p) || p.startsWith('_quarantine'))) return true
const base = parts[parts.length - 1] ?? ''
if (EXCLUDE_FILE_NAMES.has(base)) return true
if (base.endsWith('.tsbuildinfo')) return true
if (base.startsWith('.env.') && base.endsWith('.local')) return true
if (base.endsWith('.bak')) return true
return false
}
async function copyTree(srcDir: string, destDir: string): Promise<number> {
const { readdirSync, statSync, mkdirSync: mkdir, copyFileSync: cp } = await import('node:fs')
let count = 0
mkdir(destDir, { recursive: true })
for (const name of readdirSync(srcDir)) {
const src = join(srcDir, name)
if (shouldSkip(src)) continue
const dest = join(destDir, name)
const st = statSync(src)
if (st.isDirectory()) {
count += await copyTree(src, dest)
} else if (st.isFile()) {
cp(src, dest)
count++
}
}
return count
}
function zipWithPowerShell(sourceFolder: string, targetZip: string): void {
const parent = dirname(sourceFolder)
const leaf = sourceFolder.split(/[/\\]/).pop()
const ps = `
$ErrorActionPreference = 'Stop'
if (Test-Path -LiteralPath '${targetZip.replace(/'/g, "''")}') { Remove-Item -LiteralPath '${targetZip.replace(/'/g, "''")}' -Force }
Compress-Archive -Path (Join-Path '${parent.replace(/'/g, "''")}' '${leaf}') -DestinationPath '${targetZip.replace(/'/g, "''")}' -CompressionLevel Optimal
`
execFileSync('powershell.exe', ['-NoProfile', '-Command', ps], { stdio: 'inherit' })
}
if (!existsSync(dbPath)) {
throw new Error(
`[pack:laptop] Datenbank fehlt: ${dbPath}\n` +
'Ohne SQLite wäre das nur ein Team-Paket — zuerst die App einmal starten oder pack:zip nutzen.',
)
}
mkdirSync(outDir, { recursive: true })
const stageParent = join(outDir, '_stage-laptop')
if (existsSync(stageParent)) rmSync(stageParent, { recursive: true, force: true })
mkdirSync(stageRoot, { recursive: true })
console.log('[pack:laptop] Kopiere Projektdateien (ohne node_modules, .env; inkl. .git) …')
const files = await copyTree(projectRoot, stageRoot)
console.log(`[pack:laptop] ${files} Dateien → Staging`)
const stageDataDir = join(stageRoot, 'server', 'data')
mkdirSync(stageDataDir, { recursive: true })
copyFileSync(dbPath, join(stageDataDir, sqliteFilename))
let extraDbFiles = 0
for (const suffix of ['-wal', '-shm']) {
const extra = `${dbPath}${suffix}`
if (existsSync(extra)) {
copyFileSync(extra, join(stageDataDir, `${sqliteFilename}${suffix}`))
extraDbFiles++
}
}
writeFileSync(
join(stageDataDir, 'README.txt'),
[
'Diese SQLite-Datei ist die vollständige lokale Datenbank (Personen, Assignments, Meetings).',
`Datei: ${sqliteFilename}`,
'Nach dem Entpacken NICHT npm run setup / bootstrap / db:reset ausführen.',
'',
].join('\n'),
'utf8',
)
console.log(`[pack:laptop] DB kopiert: ${sqliteFilename}${extraDbFiles ? ` (+${extraDbFiles} WAL/SHM)` : ''}`)
if (!existsSync(join(stageRoot, 'UMZUG.md'))) {
throw new Error('[pack:laptop] UMZUG.md fehlt im Staging — Abbruch.')
}
if (!existsSync(join(stageRoot, '.env.example'))) {
throw new Error('[pack:laptop] .env.example fehlt')
}
if (!existsSync(join(stageRoot, 'server', 'data', sqliteFilename))) {
throw new Error('[pack:laptop] DB landete nicht im Staging — Abbruch.')
}
console.log(`[pack:laptop] Erzeuge ${zipName} …`)
zipWithPowerShell(stageRoot, zipPath)
rmSync(stageParent, { recursive: true, force: true })
const sizeMb = (readFileSync(zipPath).byteLength / (1024 * 1024)).toFixed(2)
console.log(`[pack:laptop] Fertig: ${zipPath}`)
console.log(`[pack:laptop] Größe: ${sizeMb} MB (E-Mail-tauglich, solange unter dem Postfach-Limit)`)
console.log('[pack:laptop] Enthält personenbezogene Daten — nur an den Ziel-Laptop schicken.')
console.log('[pack:laptop] Am Ziel: UMZUG.md folgen. Nicht npm run setup.')
console.log('[pack:laptop] Produktiv (AssigmentMonitor) wurde nicht angefasst.')
+120
View File
@@ -0,0 +1,120 @@
/**
* Erzeugt ein versandfertiges ZIP der V2-Team-Version (ohne node_modules, .env, Dev-DB, .git).
* Schreibt nach dist-release/ — Ordner ist gitignored; Produktiv wird nicht angefasst.
*
* Usage: npm run pack:zip
*/
import { mkdirSync, existsSync, rmSync, readFileSync } from 'node:fs'
import { dirname, join, resolve, relative } from 'node:path'
import { fileURLToPath } from 'node:url'
import { execFileSync } from 'node:child_process'
const __dirname = dirname(fileURLToPath(import.meta.url))
const projectRoot = resolve(join(__dirname, '../..'))
const outDir = join(projectRoot, 'dist-release')
const stamp = new Date().toISOString().slice(0, 10)
const zipName = `AssignmentMonitor-Team-${stamp}.zip`
const zipPath = join(outDir, zipName)
const stageName = 'AssigmentMonitorV2'
const stageRoot = join(outDir, '_stage', stageName)
const rootNorm = projectRoot.toLowerCase()
if (!rootNorm.includes('assigmentmonitorv2')) {
throw new Error('[pack:zip] SAFETY: Skript nur innerhalb AssigmentMonitorV2 ausführen.')
}
const EXCLUDE_DIR_NAMES = new Set([
'node_modules',
'.git',
'dist',
'dist-release',
'dist-ssr',
'.vite',
'.claude',
'.vscode',
'server\\data',
'server/data',
'_quarantine',
'_stage',
])
const EXCLUDE_FILE_NAMES = new Set([
'.env',
'.env.local',
'dist-release-log.txt',
])
function shouldSkip(absPath: string): boolean {
const rel = relative(projectRoot, absPath).split(/[/\\]/).join('/')
if (!rel || rel.startsWith('..')) return true
if (rel === 'server/data' || rel.startsWith('server/data/')) return true
if (rel === 'dist-release' || rel.startsWith('dist-release/')) return true
const parts = rel.split('/')
if (parts.some(p => EXCLUDE_DIR_NAMES.has(p) || p.startsWith('_quarantine'))) return true
const base = parts[parts.length - 1] ?? ''
if (EXCLUDE_FILE_NAMES.has(base)) return true
if (base.endsWith('.tsbuildinfo')) return true
if (base.startsWith('.env.') && base.endsWith('.local')) return true
return false
}
async function copyTree(srcDir: string, destDir: string): Promise<number> {
const { readdirSync, statSync, mkdirSync: mkdir, copyFileSync: cp } = await import('node:fs')
let count = 0
mkdir(destDir, { recursive: true })
for (const name of readdirSync(srcDir)) {
const src = join(srcDir, name)
if (shouldSkip(src)) continue
const dest = join(destDir, name)
const st = statSync(src)
if (st.isDirectory()) {
count += await copyTree(src, dest)
} else if (st.isFile()) {
cp(src, dest)
count++
}
}
return count
}
function zipWithPowerShell(sourceFolder: string, targetZip: string): void {
// Compress-Archive braucht den Inhalt so, dass der Root-Ordner im ZIP liegt
const parent = dirname(sourceFolder)
const leaf = sourceFolder.split(/[/\\]/).pop()
const ps = `
$ErrorActionPreference = 'Stop'
if (Test-Path -LiteralPath '${targetZip.replace(/'/g, "''")}') { Remove-Item -LiteralPath '${targetZip.replace(/'/g, "''")}' -Force }
Compress-Archive -Path (Join-Path '${parent.replace(/'/g, "''")}' '${leaf}') -DestinationPath '${targetZip.replace(/'/g, "''")}' -CompressionLevel Optimal
`
execFileSync('powershell.exe', ['-NoProfile', '-Command', ps], { stdio: 'inherit' })
}
mkdirSync(outDir, { recursive: true })
const stageParent = join(outDir, '_stage')
if (existsSync(stageParent)) rmSync(stageParent, { recursive: true, force: true })
mkdirSync(stageRoot, { recursive: true })
console.log('[pack:zip] Kopiere Projektdateien (ohne DB, .env, node_modules, .git) …')
const files = await copyTree(projectRoot, stageRoot)
console.log(`[pack:zip] ${files} Dateien → Staging`)
// Sicherstellen, dass Einrichtungsdateien im Root der ZIP liegen
if (!existsSync(join(stageRoot, 'EINRICHTUNG.md'))) {
throw new Error('[pack:zip] EINRICHTUNG.md fehlt im Staging — Abbruch.')
}
if (!existsSync(join(stageRoot, 'docs', 'starter', 'starter-structure.json'))) {
throw new Error('[pack:zip] starter-structure.json fehlt — zuerst npm run starter:export')
}
if (!existsSync(join(stageRoot, '.env.example'))) {
throw new Error('[pack:zip] .env.example fehlt')
}
console.log(`[pack:zip] Erzeuge ${zipName} …`)
zipWithPowerShell(stageRoot, zipPath)
rmSync(stageParent, { recursive: true, force: true })
const sizeMb = (readFileSync(zipPath).byteLength / (1024 * 1024)).toFixed(2)
console.log(`[pack:zip] Fertig: ${zipPath}`)
console.log(`[pack:zip] Größe: ${sizeMb} MB`)
console.log('[pack:zip] An Kollegen: ZIP schicken + auf EINRICHTUNG.md verweisen.')
console.log('[pack:zip] Produktiv (AssigmentMonitor) wurde nicht angefasst.')
+124
View File
@@ -0,0 +1,124 @@
/**
* Automatisierter Smoke für C0 (Skala/Farbbänder) + C6/C7-Hilfslogik (Batches, Prompt-Größe).
* Schreibt temporär Farbbänder in die V2-Dev-DB und stellt den vorherigen Stand wieder her.
*
* Aufruf: npm run smoke
* Voraussetzung: .env mit V2-Ports/DB (wie npm run setup / server).
*
* Nur server-kompatible Imports (kein DOM/JSX) — siehe tsconfig.server.json.
*/
import '../database'
import {
DEFAULT_RATING_COLOR_BANDS,
BAND_STYLES,
bandForScore,
normalizeRatingColorBands,
normalizeRatingScore,
resolveScoreStyle,
AI_CONFIG,
} from '../../src/config/constants'
import { getOrSeedRatingColorBands, saveRatingColorBands } from '../db/queries/appSettings'
import { buildCharAwareBatches, mergePatternHints } from '../../src/utils/charAwareBatches'
import { checkPromptSize } from '../../src/utils/promptSize'
let failed = 0
let passed = 0
function assert(cond: boolean, label: string, detail?: string) {
if (cond) {
console.log(`✅ ${label}`)
passed++
} else {
console.log(`❌ ${label}${detail ? ` — ${detail}` : ''}`)
failed++
}
}
console.log('=== Smoke: Skala 1–10 (C0) ===\n')
assert(normalizeRatingScore(7) === 7, 'normalizeRatingScore(7) → 7')
assert(normalizeRatingScore(0) === null, 'normalizeRatingScore(0) → null')
assert(normalizeRatingScore(11) === null, 'normalizeRatingScore(11) → null')
assert(normalizeRatingScore('5') === 5, 'normalizeRatingScore("5") → 5')
const bands = normalizeRatingColorBands(DEFAULT_RATING_COLOR_BANDS)
assert(bandForScore(1, bands).key === 'red', 'Score 1 → Band rot')
assert(bandForScore(2, bands).key === 'red', 'Score 2 → Band rot')
assert(bandForScore(3, bands).key === 'orange', 'Score 3 → Band orange')
assert(bandForScore(5, bands).key === 'orange', 'Score 5 → Band orange')
assert(bandForScore(6, bands).key === 'lightGreen', 'Score 6 → Band hellgrün')
assert(bandForScore(8, bands).key === 'lightGreen', 'Score 8 → Band hellgrün')
assert(bandForScore(9, bands).key === 'darkGreen', 'Score 9 → Band dunkelgrün')
assert(bandForScore(10, bands).key === 'darkGreen', 'Score 10 → Band dunkelgrün')
assert(
BAND_STYLES.lightGreen.color !== BAND_STYLES.darkGreen.color,
'Hellgrün und Dunkelgrün haben unterscheidbare CSS-Klassen',
)
assert(
BAND_STYLES.lightGreen.hex !== BAND_STYLES.darkGreen.hex,
'Hellgrün und Dunkelgrün haben unterscheidbare Hex-Farben',
)
const style6 = resolveScoreStyle(6, bands)
const style9 = resolveScoreStyle(9, bands)
assert(style6.color !== style9.color, 'resolveScoreStyle: 6 und 9 unterschiedliche Farben')
const previousBands = getOrSeedRatingColorBands()
const probeBands = [
{ max: 3, key: 'red' as const },
{ max: 6, key: 'orange' as const },
{ max: 8, key: 'lightGreen' as const },
{ max: 10, key: 'darkGreen' as const },
]
saveRatingColorBands(probeBands)
const reloaded = getOrSeedRatingColorBands()
assert(
JSON.stringify(reloaded) === JSON.stringify(normalizeRatingColorBands(probeBands)),
'Farbbänder speichern/laden Roundtrip (DB)',
`got ${JSON.stringify(reloaded)}`,
)
saveRatingColorBands(previousBands)
const restored = getOrSeedRatingColorBands()
assert(
JSON.stringify(restored) === JSON.stringify(normalizeRatingColorBands(previousBands)),
'Vorherige Farbbänder wiederhergestellt',
)
console.log('\n=== Smoke: Tagging-Batches (C6) ===\n')
const manyShort = Array.from({ length: 25 }, (_, i) => `Zeile ${i + 1} kurz`)
const byLines = buildCharAwareBatches(manyShort, s => s, 12, 50_000)
assert(byLines.length === 3, `25 Zeilen / max 12 → 3 Batches (ist ${byLines.length})`)
assert(byLines[0].length === 12 && byLines[1].length === 12 && byLines[2].length === 1, 'Batch-Größen 12+12+1')
const longA = 'a'.repeat(2000)
const longB = 'b'.repeat(2000)
const byChars = buildCharAwareBatches([longA, longB, 'kurz'], s => s, 12, 3500)
assert(byChars.length === 2, `Zeichen-Budget → 2 Batches (ist ${byChars.length})`)
assert(byChars[0].length === 1 && byChars[0][0] === longA, 'Erste lange Zeile allein im Batch')
assert(byChars[1][0] === longB && byChars[1].includes('kurz'), 'Zweite lange Zeile + Kurzzeile im Folgebatch')
const oneHuge = ['x'.repeat(5000)]
const alone = buildCharAwareBatches(oneHuge, s => s, 12, 3500)
assert(alone.length === 1 && alone[0].length === 1, 'Überlanges Einzelstück → 1 Batch mit 1 Zeile')
const patterns = new Map<number, string>()
mergePatternHints(patterns, new Map([[1, 'alt'], [2, 'zwei']]))
mergePatternHints(patterns, new Map([[1, 'neu']]))
assert(patterns.get(1) === 'neu' && patterns.get(2) === 'zwei', 'MUSTER-Merge: später überschreibt früher')
console.log('\n=== Smoke: Prompt-Größe (C7) ===\n')
const small = checkPromptSize('kurz')
assert(!small.softWarn && !small.overHardLimit, 'Kleiner Prompt: kein Soft/Hard')
const soft = checkPromptSize('y'.repeat(AI_CONFIG.promptSoftWarnChars))
assert(soft.softWarn && !soft.overHardLimit, 'Soft-Warn-Schwelle greift')
const hard = checkPromptSize('z'.repeat(AI_CONFIG.promptHardLimitChars))
assert(hard.overHardLimit, 'Hard-Limit-Schwelle greift')
console.log(`\n=== Ergebnis: ${passed} pass, ${failed} fail ===`)
if (failed > 0) process.exit(1)
console.log('\nHinweis: UI-Teile → manuell in docs/SMOKE_TESTS.md')
+18
View File
@@ -0,0 +1,18 @@
/**
* Einmal-Setup für Team-ZIP: Starter-Struktur in die V2-Dev-DB laden.
* Usage: npm run setup
*/
import { existsSync, copyFileSync } from 'node:fs'
import { dirname, join } from 'node:path'
import { fileURLToPath } from 'node:url'
const rootPath = join(dirname(fileURLToPath(import.meta.url)), '../..')
const envPath = join(rootPath, '.env')
const examplePath = join(rootPath, '.env.example')
if (!existsSync(envPath) && existsSync(examplePath)) {
copyFileSync(examplePath, envPath)
console.log('[setup] .env aus .env.example angelegt.')
}
process.env.CONFIRM = '1'
await import('./bootstrapFromStarter')