feat: suggest date, sender and title from structured filename (#69) #78

Merged

marcel merged 8 commits from feat/filename-parsing into main 2026-03-26 16:48:45 +01:00

Conversation 0 Commits 8 Files Changed 15 +444 -8

marcel commented 2026-03-26 15:20:26 +01:00

Owner

Copy Link

Summary

Closes #69

• New parseFilename() utility (src/lib/utils/filename.ts) — full-match-only regex for four patterns: YYYY-MM-DD_Lastname_Firstname, YYYYMMDD_Lastname_Firstname, and both reversed. Partial matches return {}, unstructured names fall through unchanged.
• New document form pre-fill — selecting a file triggers parsing; date, sender typeahead and title are suggested only while the respective field is still clean (never overwrites user input).
• DropZone hint — a concrete example (2024-03-15_Mueller_Hans.pdf) is shown below the accepted types line so users know the supported naming convention.
• Backend titleFromFilename() — mirrors the same four patterns in DocumentService; dropzone quick-uploads now land with a formatted title (Hans Mueller (12.03.1965)) instead of the raw stripped filename. No sender auto-assignment (requires person to exist).

Test plan

• 13 Vitest tests in filename.spec.ts — all patterns, umlaut names, non-matching filenames
• 6 new DocumentServiceTest cases for titleFromFilename() — all 4 patterns + null + fallback
• Manual: select 1965-03-12_Mueller_Hans.pdf on /documents/new → date shows 12.03.1965, sender shows Hans Mueller, title shows Hans Mueller (12.03.1965)
• Manual: type a title first, then select a file → title is NOT overwritten
• Manual: DropZone hint text is visible
• Manual: dropzone upload of 19650312_Mueller_Hans.pdf → document title is Hans Mueller (12.03.1965)

🤖 Generated with Claude Code

## Summary Closes #69 - **New `parseFilename()` utility** (`src/lib/utils/filename.ts`) — full-match-only regex for four patterns: `YYYY-MM-DD_Lastname_Firstname`, `YYYYMMDD_Lastname_Firstname`, and both reversed. Partial matches return `{}`, unstructured names fall through unchanged. - **New document form pre-fill** — selecting a file triggers parsing; date, sender typeahead and title are suggested only while the respective field is still clean (never overwrites user input). - **DropZone hint** — a concrete example (`2024-03-15_Mueller_Hans.pdf`) is shown below the accepted types line so users know the supported naming convention. - **Backend `titleFromFilename()`** — mirrors the same four patterns in `DocumentService`; dropzone quick-uploads now land with a formatted title (`Hans Mueller (12.03.1965)`) instead of the raw stripped filename. No sender auto-assignment (requires person to exist). ## Test plan - [ ] 13 Vitest tests in `filename.spec.ts` — all patterns, umlaut names, non-matching filenames - [ ] 6 new `DocumentServiceTest` cases for `titleFromFilename()` — all 4 patterns + null + fallback - [ ] Manual: select `1965-03-12_Mueller_Hans.pdf` on `/documents/new` → date shows `12.03.1965`, sender shows `Hans Mueller`, title shows `Hans Mueller (12.03.1965)` - [ ] Manual: type a title first, then select a file → title is NOT overwritten - [ ] Manual: DropZone hint text is visible - [ ] Manual: dropzone upload of `19650312_Mueller_Hans.pdf` → document title is `Hans Mueller (12.03.1965)` 🤖 Generated with [Claude Code](https://claude.com/claude-code)

marcel added 4 commits 2026-03-26 15:20:26 +01:00

feat(filename): add parseFilename utility with full-pattern-only matching ... 8555193a79

Supports four patterns: date_lastname_firstname and lastname_firstname_date,
both with ISO (YYYY-MM-DD) and compact (YYYYMMDD) date formats.
Returns dateIso, personName and a formatted suggestedTitle.
Partial matches are rejected — unrecognised filenames return {}.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(new-doc): pre-fill date, sender and title from parsed filename ... 078bc1c886

When a file is selected on the new document page, parseFilename runs
on the filename and suggests date, sender name and title via the new
suggestedDateIso / suggestedSenderName / suggestedTitle props. Each
suggestion is applied only while the respective field is still clean
(not dirty), so manual input is never overwritten.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(dropzone): add filename hint showing supported naming pattern ... 654e736f8a

Shows a concrete example (2024-03-15_Mueller_Hans.pdf) so users know
which filenames will be auto-parsed during bulk upload.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(quick-upload): generate better title from structured filename ... a302f96560

titleFromFilename() mirrors the same four patterns as the frontend
parseFilename() utility. Dropzone uploads to Mueller_Hans_19650312.pdf
now land with title "Hans Mueller (12.03.1965)" instead of the raw
stripped filename.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

marcel added 1 commit 2026-03-26 15:33:44 +01:00

feat(filename): support compound last names like de Gruyter ... f0940524e7

Replace the four fixed regexes with a split-based algorithm:
- first segment = date → last segment = firstName, rest = lastName parts
- last segment = date → second-to-last = firstName, rest = lastName parts

18881025_de_Gruyter_Walter.pdf now correctly yields "Walter de Gruyter".
Simple two-segment names behave identically to before.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

marcel added 1 commit 2026-03-26 15:43:58 +01:00

feat(quick-upload): pre-fill date and sender from structured filename ... 99e3163c0e

storeDocument() now uses the ParsedFilename record to also set
documentDate and sender on new quick-uploads. Sender lookup is
an exact case-insensitive first+last name match — no new persons
are created. Unmatched filenames behave as before.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

marcel added 1 commit 2026-03-26 15:51:28 +01:00

fix(enrich): restore fixed-position layout and done icon ... 648bdffe4f

Re-applies the scroll fix from 0d3c557 which was missing from this branch:
- measure header height at mount, use it as top offset instead of hardcoded 68px
- fix done page icon to Check-Double-LG

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

marcel added 1 commit 2026-03-26 15:52:49 +01:00

Revert "fix(enrich): restore fixed-position layout and done icon" ... 2efa790243

This reverts commit 648bdffe4f.

marcel merged commit 2efa790243 into main 2026-03-26 16:48:45 +01:00

marcel deleted branch feat/filename-parsing 2026-03-26 16:48:46 +01:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0-critical

Blocks a core user journey, causes data loss, or is a security/accessibility barrier. Work on this before P1+.

P1-high

Significant friction on a main user journey; workaround exists but is non-obvious. Next up after P0.

P2-medium

Noticeable improvement; doesn't block anything; schedule opportunistically.

P3-later

Cosmetic or parking-lot work; fine to stay open indefinitely.

audit

Read-only audit / assessment work; produces a report rather than changing code

bug

Something isn't working

cleanup

Removal of dead code, vague comments, naming violations, and scratch artifacts

collaboration

We want to extend the family archive to have more collaboration tools

conversation

descoped

We will do that later

devops

documentation

README, ARCHITECTURE, GLOSSARY, CONTRIBUTING, per-domain docs

epic

Marker for epic-level issues that group multiple child issues

feature

file-upload

legibility

Codebase Legibility Refactor — preparing the codebase for human evaluation and bus-factor reduction

notification

person

phase-1: security

Security hygiene — must be done first

phase-2: container-images

Production-ready multi-stage Docker images

phase-3: prod-compose

Production compose overlay + Caddy reverse proxy

phase-4: spring-prod-profile

Spring Boot production configuration profile

phase-5: backups

Database and object storage backup strategy

phase-6: deployment-docs

.env.example, DEPLOYMENT.md, runbook

phase-7: monitoring

Prometheus, Loki, Grafana, Alertmanager

refactor

Code restructuring without behaviour change

security

test

ui

UI/UX and accessibility issues

user

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

Jens marcel

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: marcel/familienarchiv#78