12 Commits

Author	SHA1	Message	Date
Marcel	d01b9a7508	docs(claude-md): replace hex values with CSS var refs, expand route trees ... Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-06 09:01:40 +02:00
Marcel	5c72364899	docs: fix stale CLAUDE.md content after design-system refactoring ... Brand colors, font name, dev port, route tree, and card pattern were all outdated relative to layout.css and the current route structure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-06 08:49:47 +02:00
Marcel	86c13a230c	docs(legibility): migrate CLAUDE.md rules into human docs — DOC-7 ... Processes all 7 CLAUDE.md files according to the 3-bucket classification. Migration targets (CONTRIBUTING.md, docs/ARCHITECTURE.md, docs/DEPLOYMENT.md, domain READMEs) are introduced by DOC-2/4/5/6 — this PR must merge last. ### scripts/CLAUDE.md → scripts/README.md New `scripts/README.md` with full script documentation (preserving the ⚠️ destructive-operation warning on reset-db.sh). `scripts/CLAUDE.md` reduced to a pointer + "document new scripts in README.md" reminder. ### .devcontainer/CLAUDE.md → .devcontainer/README.md New `.devcontainer/README.md` with all configuration, usage, and limitations. `devcontainer/CLAUDE.md` reduced to a single pointer line. ### docs/CLAUDE.md → docs/README.md New `docs/README.md` covering the folder structure, ADR guide, infrastructure docs, and specs folder. `docs/CLAUDE.md` reduced to pointer + ADR reminder. ### ocr-service/CLAUDE.md Reduced to pointer to `ocr-service/README.md` (content migrated in DOC-6). Kept LLM reminders: single-node constraint, ALLOWED_PDF_HOSTS SSRF risk. ### backend/CLAUDE.md - Layering Rules → pointer to docs/ARCHITECTURE.md - Error Handling → pointer to CONTRIBUTING.md + reminder - Security/Permissions → pointer to docs/ARCHITECTURE.md + reminder - Package Structure → tagged TODO post-REFACTOR-1 - Fixed errors.ts path to frontend/src/lib/shared/errors.ts - Added ANNOTATE_ALL + BLOG_WRITE to permission list - Key Entities, Entity Code Style, Services → kept (Bucket-2) ### root CLAUDE.md - Stack, Infrastructure, Dev Container → pointers - Layering Rules, Error Handling, Security, OpenAPI, API Client, Date Handling, UI Components, Frontend Error Handling → pointers + reminders - Package Structure → tagged TODO post-REFACTOR-1 - Domain Model, Entity Code Style, Form Actions, Styling → kept (Bucket-2) ### frontend/CLAUDE.md - API Client Pattern, Date Handling → pointers + reminders - Key UI Components → pointer to domain READMEs - Styling, Form Actions, How to Run, Vite Proxy, i18n → kept (Bucket-2) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-06 07:41:02 +02:00
Marcel	a9b8e19dea	docs(legibility): add README reference line to root CLAUDE.md — DOC-1 ... Single pointer line at the top: humans read README.md, LLMs read CLAUDE.md. No existing content removed — full migration is DOC-7's responsibility. Refs #395 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-06 07:01:16 +02:00
Marcel	c0d8704d6d	docs: remove stale ExcelService from CLAUDE.md ... ExcelService was deleted in fa60c5be. Both the root and backend CLAUDE.md still listed it under importing/ and in the services table. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-05 13:25:40 +02:00
Marcel	5f1c539fad	docs: update package structure docs to reflect domain-based layout ... Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-05 13:02:14 +02:00
Marcel	ae3bc3f246	docs(claude): update back link pattern to use BackButton component ... Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 10:50:35 +02:00
Marcel	4009781064	docs: add CODESTYLE.md with Clean Code, DRY/KISS, and SOLID principles ... Covers naming, function design, guard clauses, comment policy, command-query separation, DRY vs KISS trade-offs (KISS wins), and SOLID applied to the Java backend and TypeScript/Svelte frontend. Linked from CLAUDE.md and COLLABORATING.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-20 11:36:34 +01:00
Marcel	ed32e1728d	doc: add collab rules	2026-03-17 16:07:50 +00:00
Marcel	97e5255d7f	refactor: move createPerson logic into PersonService ... Controller was directly calling personRepository.save() for person creation. Extracted into PersonService.createPerson() to enforce Controller → Service → Repository layering. Also documented the layering rules in CLAUDE.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-17 08:28:30 +01:00
Marcel	09ec2103c8	fix: correct malformed @Value annotations in DataInitializer ... Missing closing braces caused Spring to inject the literal placeholder string instead of resolving the property, silently ignoring any app.admin.username / app.admin.password env-var overrides. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-15 12:16:00 +01:00
Marcel	e63adb964d	restructure: flatten workspace nesting, move devcontainer to root ... - backend/workspaces/backend/ → backend/ - backend/workspaces/frontend/ → frontend/ - backend/.devcontainer/ + .vscode/ → repo root (where VS Code expects them) - loose scripts/SQL files → scripts/ - replace nested git repo with single repo at project root - update docker-compose.yml build context and devcontainer.json path - add root .gitignore Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-15 11:47:58 +01:00