Zum Inhalt

Entwicklung

Soll ist ein Monorepo mit Bun-Workspaces. Was ein Agent oder Mitwirkender beachten muss, steht in CLAUDE.md, was als Nächstes gebaut wird, in der Bauliste.

Aufbau

Pfad Inhalt
packages/arbeitszeit Prüfregeln, Feiertage, Soll und Ist, Konten, Zuschläge; reine Funktionen
packages/import Parser für die Exporte anderer Tools und die Mitarbeiterliste als CSV (Einrichtung)
packages/export DATEV, CSV, PDF
packages/ui Komponenten und Farben nach DESIGN.md, cn() und variants(); Musterseite unter /muster.html im Entwicklungsserver
apps/server Hono-Server mit /health; wird mit bun build --compile zu einer Datei
apps/web Solid-2-App als statische SPA/PWA mit Service Worker, Routen mit TanStack Router
e2e/ Playwright mit den Projekten desktop, phone und terminal
messages/ Texte der App in de, en, tr, pl, uk und ar (Paraglide)

Befehle

bun install
SOLL_SECRET_KEY=$(openssl rand -base64 32) bun run dev:server   # Server auf Port 18200
bun run dev:web      # App auf Port 5177, leitet /api an den Server auf 18200 weiter
bun run check        # Typen, Lint, Tests, Build
bun run e2e          # Playwright (App auf Port 5178, gebaute App mit Service Worker auf 5179)

Die App ruft die API unter ihrer eigenen Adresse auf; Vite leitet /api an den Server weiter (SOLL_API_PORT, Standard 18200), so sehen Sitzungs-Cookie und die Herkunftsprüfung von Better Auth eine einzige Adresse. Für Playwright startet scripts/e2e-server.ts den Server auf Port 28200 mit einer leeren Datenbank in einem temporären Verzeichnis und einem Schlüssel nur für diesen Lauf; e2e/betrieb.ts legt je Test ein eigenes Konto mit Betrieb an.

bun run check muss vor jedem Push grün sein. Die gemeinsamen Checks aus firsttris/workflows (Dateigröße, Funktionslänge, Importringe, Übersetzungen, Seiten im Barrierefreiheitstest) laufen in der CI.

Komponenten

packages/ui baut auf nativen Elementen: Button, Badge, Input, Dialog (<dialog>), Popover, Menü und Tooltip (Popover-API mit CSS Anchor Positioning), Combobox, Tabs, Toast, Tabelle und Icon. Jede Komponente nimmt ihre Texte über Props; die Tastaturbedienung folgt den ARIA Authoring Practices, Pfeile spiegeln sich bei Arabisch. Die Musterseite apps/web/muster.html zeigt alle, nur im Entwicklungsserver (?theme=dark, ?dir=rtl); Playwright prüft dort Tastatur und axe.

App

Die App fragt beim Start den Server, wer angemeldet ist (GET /api/v1/betrieb), und führt ohne Sitzung zur Anmeldung, ein Konto ohne Betrieb und einen Inhaber vor dem Abschluss in die Einrichtung und von einem abgeschalteten Modul zurück zu Heute (apps/web/src/sitzung/ziel.ts). Ist der Server nicht erreichbar, öffnet sie sich mit dem zuletzt gesehenen Betrieb, damit sie offline startet. Sie hat am Desktop eine Seitenleiste mit den Bereichen Heute, Zeiten, Abwesenheiten, Dienstplan, Projekte, Auswertungen und Einstellungen, am Handy eine Tab-Leiste mit Heute, Plan, Abwesenheit und Mehr; beide zeigen nur die Bereiche der Module des Betriebs. Unter „Mehr“ und in den Einstellungen stehen Farben (hell, dunkel, wie das Gerät) und Sprache; beides merkt sich der Browser. Die Routen liegen in apps/web/src/routes/, der Routenbaum routeTree.gen.ts entsteht beim Build oder im Entwicklungsserver neu und ist eingecheckt, damit der Typcheck ihn kennt. Jede Seite steht in e2e/accessibility.spec.ts.

Server

Der Server liest seine Einstellungen aus der Umgebung:

Variable Standard Bedeutung
SOLL_PORT 8200 Port
SOLL_HOST 0.0.0.0 Adresse
SOLL_VERSION 0.0.0 Version, die /health meldet
SOLL_DATA_DIR data Datenverzeichnis mit der Datenbank soll.db
SOLL_SECRET_KEY – (Pflicht) 32 Bytes in Base64; ohne startet der Server nicht
SOLL_URL http://localhost:8200 Adresse der Instanz, für Einladungslinks

Jede Anfrage schreibt eine Zeile JSON ins Log, mit Methode, Pfad, Status und Dauer. Die Query der Adresse (etwa der Token eines Kalender-Feeds) steht nur als ?… darin, Header und Inhalte nie.

Datenbank

Das Schema steht in apps/server/src/db/schema.ts. Nach einer Änderung erzeugt bun run db:generate die Migration und die Datei, die sie ins Programm einbettet; eine schon eingecheckte Migration wird nie geändert. Tests laufen gegen SQLite in einer temporären Datei.

Sprachen

Jeder Text steht in jeder Datei unter messages/; die App wählt die Sprache des Browsers, Arabisch von rechts nach links (dir="rtl"). Normen bleiben in jeder Sprache auf Deutsch.