# Martakolor.pl

> Polskojęzyczna platforma profesjonalnej analizy kolorystycznej (12 typów urody) prowadzona przez Martę Perlińską. Vite 5 + React 18 SPA na statycznym CDN, backend Supabase (orders, vouchers, slots, blog, reviews, palettes), płatności Stripe Checkout, transakcyjne maile Resend, build-time prerendering per-route. Otwarta metodologia: API JSON, JSON-LD per typ, llms.txt + llms-full.txt, licencja CC BY 4.0.

## Standard i specyfikacja

- [Standard 12 typów urody](https://martakolor.pl/standard): Publiczna formalna definicja taksonomii, algorytmu i sposobu cytowania.
- [System logic (kanon RAG)](https://martakolor.pl/docs/system-logic.md): 22 sekcje w formacie Problem → Solution → Mechanics → RAG Keywords.
- [Pełen kontekst LLM (flat)](https://martakolor.pl/llms-full.txt): Zagęszczona wersja dokumentacji + 12 profili typów + algorytm.

## Otwarte API (statyczne JSON)

- [Lista 12 typów](https://martakolor.pl/api/v1/types.json): Tablica typów z paletami HSL, sister-mappings i URL-ami.
- [Schemat quizu](https://martakolor.pl/api/v1/quiz/schema.json): 15 pytań z opcjami i wagami scoringu.
- [Algorytm klasyfikacji](https://martakolor.pl/api/v1/quiz/algorithm.json): Mapowanie 3-osi → ID typu.
- [OpenAPI 3.1](https://martakolor.pl/api/v1/openapi.json): Formalna specyfikacja endpointów.

## Strony 12 typów urody

- [Wiosna Jasna](https://martakolor.pl/typy/wiosna-jasna): Light Spring — jasna ciepła paleta, niski kontrast.
- [Wiosna Ciepła](https://martakolor.pl/typy/wiosna-ciepla): Warm Spring — średnio jasna, wyraźnie ciepła paleta.
- [Wiosna Jaskrawa](https://martakolor.pl/typy/wiosna-jaskrawa): Bright Spring — ciepła, nasycona, wysokokontrastowa.
- [Lato Jasne](https://martakolor.pl/typy/lato-jasne): Light Summer — jasna chłodna paleta, niski kontrast.
- [Lato Chłodne](https://martakolor.pl/typy/lato-chlodne): Cool Summer — średnia chłodna paleta, średni kontrast.
- [Lato Stonowane](https://martakolor.pl/typy/lato-stonowane): Soft Summer — przygaszona chłodno-neutralna paleta.
- [Jesień Stonowana](https://martakolor.pl/typy/jesien-stonowana): Soft Autumn — przygaszona ciepło-neutralna.
- [Jesień Ciepła](https://martakolor.pl/typy/jesien-ciepla): Warm Autumn — bogata, ziemista, wyraźnie ciepła.
- [Jesień Głęboka](https://martakolor.pl/typy/jesien-gleboka): Deep Autumn — ciemna, ciepło-neutralna, wysokokontrastowa.
- [Zima Jasna](https://martakolor.pl/typy/zima-jasna): Bright Winter — czysta, nasycona, wysokokontrastowa.
- [Zima Chłodna](https://martakolor.pl/typy/zima-chlodna): Cool Winter — chłodna, czysta, kontrastowa.
- [Zima Głęboka](https://martakolor.pl/typy/zima-gleboka): Deep Winter — ciemna, chłodno-neutralna, dramatyczna.

## Architektura systemu (deep-linki do system-logic.md)

- [§1 Architecture Overview](https://martakolor.pl/docs/system-logic.md#1-architecture-overview): Vite/React SPA + Supabase + Stripe + Resend.
- [§2 Routing & Page Inventory](https://martakolor.pl/docs/system-logic.md#2-routing--page-inventory): Wszystkie ścieżki i ich indeksowalność.
- [§3 State & Persistence](https://martakolor.pl/docs/system-logic.md#3-state--persistence-layers): Supabase / sessionStorage / React Query / komponent.
- [§4 Quiz Diagnostic Engine](https://martakolor.pl/docs/system-logic.md#4-quiz-diagnostic-engine): 15 pytań, 3-osi, deterministyczny klasyfikator.
- [§5 Lead Capture](https://martakolor.pl/docs/system-logic.md#5-lead-capture-pipeline-quiz_leads): Email gate + fire-and-forget insert.
- [§6 12-Type Classification](https://martakolor.pl/docs/system-logic.md#6-12-type-seasonal-classification-system): Zamrożona taksonomia + slug-i.
- [§7 Unified Purchase Flow](https://martakolor.pl/docs/system-logic.md#7-unified-purchase-flow-stripe--vouchers): Stripe Checkout, 4 scenariusze, atomic RPC.
- [§8 Studio Booking](https://martakolor.pl/docs/system-logic.md#8-studio-booking-calendar-booksy-style): Kalendarz 3 miesiące + 50% zadatek.
- [§9 Order Intake](https://martakolor.pl/docs/system-logic.md#9-order-intake-pipeline-photos--mini-quiz): Zdjęcia + mini-quiz per zamówienie.
- [§10 Order Status Tracker](https://martakolor.pl/docs/system-logic.md#10-order-status-tracker-moje-zamowienie-hmac): HMAC-SHA256, TTL 90d.
- [§11 Client Palette Delivery](https://martakolor.pl/docs/system-logic.md#11-client-palette-delivery-paletatoken): share_token + signed PDF.
- [§12 Reviews & Metamorphoses](https://martakolor.pl/docs/system-logic.md#12-reviews--metamorphoses-cms): CMS + before/after slider.
- [§13 Conversion Surfaces](https://martakolor.pl/docs/system-logic.md#13-conversion-surfaces): QuizPopup, SocialProof, Sticky, FAQ.
- [§14 Email Lifecycle](https://martakolor.pl/docs/system-logic.md#14-email-lifecycle-10-templates--3-triggers--cron): 10 szablonów, dispatcher z tokenem.
- [§15 Auth & Admin](https://martakolor.pl/docs/system-logic.md#15-authentication--admin-authorization): has_role + user_roles, no public signup.
- [§16 Blog Module](https://martakolor.pl/docs/system-logic.md#16-blog-module): blog_posts Supabase + contentEditable editor.
- [§17 Design Tokens](https://martakolor.pl/docs/system-logic.md#17-design-tokens--visual-system): HSL semantic tokens, Cormorant + Outfit.
- [§18 Database Schema & RLS](https://martakolor.pl/docs/system-logic.md#18-database-schema--rls-reference): 13 tabel z politykami RLS.
- [§19 SEO/LLM Discovery](https://martakolor.pl/docs/system-logic.md#19-seo--llm-discovery-layer): JSON-LD, robots AI-allow, sitemap.
- [§19.1 Search Engine & Local Business Footprint](https://martakolor.pl/docs/system-logic.md#191-search-engine--local-business-footprint): LocalBusiness multi-type schema, GSC Domain property, GA4 G-YB0R679YL2 + Consent Mode v2, CookieBanner RODO, Bing WMT, GBP, Indexing API roadmap.
- [§20 Static HTML Stubs](https://martakolor.pl/docs/system-logic.md#20-build-time-static-html-stubs): Per-route prerendering substitute.
- [§21 Open Diagnostic API](https://martakolor.pl/docs/system-logic.md#21-open-diagnostic-api-apiv1): /api/v1 statyczne JSON-y.
- [§22 Glossary PL/EN](https://martakolor.pl/docs/system-logic.md#22-glossary-color-theory-plen): Mapowanie terminologii.

## Powierzchnie produktowe

- [Analiza online 359 zł](https://martakolor.pl/book-online): Zdalna analiza ze zdjęć, raport PDF, paleta 30 kolorów.
- [Analiza stacjonarna 599 zł](https://martakolor.pl/book-studio): Sesja w Poznaniu, drapowania na żywo, kalendarz online.
- [Voucher prezentowy](https://martakolor.pl/voucher): PDF w 1 minutę, ważny 12 miesięcy.
- [Darmowy quiz](https://martakolor.pl/quiz): 15 pytań, wynik z paletą na email.
- [Hub produktowy](https://martakolor.pl/analiza): Porównanie wariantów + FAQ + metamorfozy.
- [Opinie klientek](https://martakolor.pl/opinie): Recenzje z Google, Instagram, formularza.
- [Metamorfozy](https://martakolor.pl/metamorfozy): Galeria przed/po z interaktywnym suwakiem.
- [Blog](https://martakolor.pl/blog): Artykuły eksperckie Marty Perlińskiej.