# Technical Changelog

> Chronological log of technical changes - what and why.

## 2026-05-05 - Phase 01 / Plan 01 Contact Attachments

**Co zrobiono / What changed:**
- Added persistent contact attachment handling for file-enabled contact forms.
- Added automatic `contact_messages.attachments` schema upgrade in `saveContactData()`.
- Added dedicated public upload storage under `uploads/contact-attachments/YYYY/mm/`.
- Updated contact and modal upload UI to show/enforce a 50 MB per-file limit and matching allowed extensions.

**Dlaczego / Why:**
- Contact attachments were previously stored only in `temp/` for email delivery, so they could disappear after automatic cleanup and were not recoverable from database records.

**BREAKING / Migration note:**
- First successful form save after deployment may run `ALTER TABLE contact_messages ADD attachments TEXT NULL AFTER consent_marketing`.

---

## 2026-05-05 - Codebase Mapping

**Co zrobiono / What changed:**
- Initial codebase map created in `.paul/codebase/` (9 documents)
- Analyzed stack, architecture, structure, conventions, integrations, concerns, DB schema

**Dlaczego / Why:**
- First-time PAUL project setup - baseline documentation for future planning

---