# 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*