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.