79 lines
2.6 KiB
Markdown
79 lines
2.6 KiB
Markdown
# 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*
|