# Feature Context: UX & Notification Improvements

## Current State
Starting implementation. All entity models already have `icon: str` fields. EventLog exists with basic fields. Immich client already has shared link CRUD methods. Frontend uses Svelte 5 + Tailwind v4 with inline form/card pattern on all CRUD pages.

## Temporary Workarounds
- None yet

## Cross-Phase Dependencies
- Phase 3 depends on Phase 2 (enriched event data from API)
- Phase 6 logically follows Phase 5 (link validation informs no-link handling)
- Phases 1, 4 are fully independent

## Implementation Notes
- All overlays MUST use `position: fixed` with inline styles and `z-index: 9999`
- SQLAlchemy async + aiohttp: eager load DB data before aiohttp context
- Jinja2 templates use SandboxedEnvironment
- Icons stored as MDI icon path names (e.g., `mdiCamera`) from `@mdi/js`
- Frontend uses MdiIcon component to render SVG icons