update

.paul/PROJECT.md

@@ -0,0 +1,78 @@
+# Project: vidok.com
+
+## What This Is
+
+Strona marketingowa firmy produkujacej okna. Zawiera formularz kontaktowy oraz galerie produktow.
+
+## Core Value
+
+Klienci moga zapoznac sie z oferta okien i skontaktowac sie z firma.
+
+## Current State
+
+| Attribute | Value |
+|-----------|-------|
+| Version | 0.1.0 |
+| Status | In Progress |
+| Last Updated | 2026-05-05 |
+
+## Requirements
+
+### Validated (Shipped)
+- [x] Podstawowa struktura strony
+- [x] Formularz kontaktowy
+- [x] Galeria produktow
+- [x] Zalaczniki z formularzy kontaktowych na `/kontakt/` i `modal-contact-form` sa zapisywane jako publiczne linki w bazie - Phase 1
+
+### Active (In Progress)
+- [ ] [Do zdefiniowania przy kolejnym planowaniu]
+
+### Planned (Next)
+- [ ] Ewentualne utrwalenie zalacznikow z `send-contact-landing`, jesli landing page ma miec ten sam mechanizm
+
+### Out of Scope
+- Budowa panelu administracyjnego do przegladania zalacznikow - poza Phase 1
+- Retroaktywne odzyskiwanie zalacznikow ze starych zgloszen - poza Phase 1
+
+## Target Users
+
+**Primary:** Potencjalni klienci szukajacy okien
+- Osoby poszukujace okien do domu lub firmy
+- Chca zobaczyc oferte i skontaktowac sie z producentem
+- Moga przeslac projekt, wizualizacje lub inne materialy do wyceny
+
+## Context
+
+**Business Context:**
+Strona marketingowa producenta okien - prezentacja produktow i pozyskiwanie kontaktow.
+
+**Technical Context:**
+PHP z customowym CMS. Brak frameworka (Laravel/Symfony). Formularze kontaktowe sa obslugiwane w `plugins/special-actions-middle.php`, a dane trafiaja do zewnetrznej tabeli `contact_messages`.
+
+## Key Decisions
+
+| Date | Decision | Impact |
+|------|----------|--------|
+| 2026-05-05 | Zalaczniki formularzy kontaktowych zapisywane w jednej kolumnie `contact_messages.attachments` jako JSON | Prosta automatyczna migracja bez osobnej tabeli |
+| 2026-05-05 | Pliki trafiaja do `/uploads/contact-attachments/YYYY/mm/`, nie do `temp/` | Zalaczniki nie znikaja po automatycznym czyszczeniu `temp/` |
+| 2026-05-05 | Limit uploadu: 50 MB na plik, tylko allowlista rozszerzen | Backend i UI egzekwuja spojne ograniczenia |
+
+## Constraints
+
+### Technical Constraints
+- PHP (custom CMS bez zewnetrznego frameworka)
+- Hosting zgodny z istniejaca infrastruktura
+- Baza formularzy `contact_messages` jest dostepna z serwera WWW jako host `mysql8`
+
+### Business Constraints
+- Strona w jezyku polskim
+
+## Success Criteria
+
+- Klienci moga zapoznac sie z oferta okien i skontaktowac sie z firma
+- Formularz kontaktowy dziala poprawnie
+- Zalaczniki z formularzy kontaktowych sa mozliwe do odzyskania z publicznych linkow zapisanych w bazie
+- Galeria produktow jest czytelna i atrakcyjna
+
+---
+*Last updated: 2026-05-05 after Phase 1*