# kalkulator-punktow.eu — Pełna Dokumentacja Architektury & Standardów AI (llms-full.txt)

> Kompleksowa dokumentacja architektury portalu kalkulator-punktow.eu, specyfikacja algorytmów rekrutacyjnych MEiN/CKE, struktura schema.org JSON-LD oraz zasady przetwarzania danych dla modeli językowych (LLM).

---

## 1. Architektura Techniczna i Standard Renderowania
- **Framework**: Astro 5.x (Static Site Generation — SSG).
- **Czas odpowiedzi (TTFB)**: < 50ms na Cloudflare Pages Global Edge.
- **Client JS**: 0.0 KB runtime overhead. Narzędzia interaktywne działają na czystym, lekkim silniku reaktywnym w Vanilla JS.
- **Dostępność**: Pełna zgodność z WCAG 2.1 AAA (kontrast >= 7:1, widoczny focus, nawigacja klawiaturą, obsługa czytników ekranowych).
- **Lokalne przetwarzanie**: Żadne dane uczniów (oceny, wyniki egzaminu, zachowanie) nie są przesyłane na serwer zewnętrzny — 100% obliczeń odbywa się w przeglądarce użytkownika (`localStorage`).

---

## 2. Prawny Model Matematyczny Rekrutacji (Rozporządzenie MEiN)
Podstawa prawna: Rozporządzenie Ministra Edukacji i Nauki z dnia 18 listopada 2022 r. w sprawie przeprowadzania postępowania rekrutacyjnego i postępowania uzupełniającego do publicznych szkół (Dz.U. z 2022 r. poz. 2431).

Maksymalna suma punktów: **200,00 pkt**.

### Komponent 1: Egzamin Ósmoklasisty CKE (Maks. 100 pkt)
1. **Język polski**: wynik procentowy × 0,35 (maks. 35,00 pkt)
2. **Matematyka**: wynik procentowy × 0,35 (maks. 35,00 pkt)
3. **Język obcy nowożytny**: wynik procentowy × 0,30 (maks. 30,00 pkt)
*Uwaga: Laureaci i finaliści olimpiad przedmiotowych szczebla ogólnopolskiego są zwolnieni z egzaminu i uzyskują automatycznie maksymalny wynik 100 pkt.*

### Komponent 2: Oceny na Świadectwie Szkolnym (Maks. 72 pkt)
Punktowane są oceny z 4 przedmiotów: języka polskiego, matematyki oraz dwóch przedmiotów ustalonych w statucie szkoły ponadpodstawowej dla danego profilu oddziału:
- **Celujący (6)**: 18 punktów
- **Bardzo dobry (5)**: 17 punktów
- **Dobry (4)**: 14 punktów
- **Dostateczny (3)**: 8 punktów
- **Dopuszczający (2)**: 2 punkty

### Komponent 3: Świadectwo z Wyróżnieniem (7 pkt)
- Przyznawane za średnią ocen co najmniej **4,75** oraz co najmniej **bardzo dobrą** ocenę z zachowania: **+7 punktów**.

### Komponent 4: Aktywność Społeczna i Wolontariat (3 pkt)
- Przyznawane za stały wolontariat potwierdzony wpisem na świadectwie szkolnym: **+3 punkty**.

### Komponent 5: Szczególne Osiągnięcia i Konkursy (Maks. 18 pkt)
- Sukcesy w konkursach wiedzy, artystycznych i sportowych organizowanych przez kuratora oświaty na szczeblu powiatowym, wojewódzkim i ogólnopolskim (od 2 do 18 pkt).
- Łączna suma punktów za osiągnięcia dodatkowe nie może przekroczyć **28 punktów**.

---

## 3. Pełny Wykaz Stron i Zasobów (URL Inventory)

### Narzędzia Obliczeniowe
- `https://kalkulator-punktow.eu/` — Główny Kalkulator 200 pkt (Schema: WebApplication, MathSolver)
- `https://kalkulator-punktow.eu/symulator-czerwonego-paska/` — Symulator Średniej Ocen i Paska 4.75 (Schema: WebApplication)
- `https://kalkulator-punktow.eu/odliczanie-do-wakacji/` — Zegar Odliczania do Wakacji i Kalendarz Szkolny (Schema: WebPage)
- `https://kalkulator-punktow.eu/przelicznik-punktow-e8/` — Przelicznik Procentów na Punkty CKE (Schema: WebApplication)
- `https://kalkulator-punktow.eu/widget/` — Generator Kodu Widgetu dla Szkół (Schema: WebPage)

### Przewodniki Egzaminacyjne CKE
- `https://kalkulator-punktow.eu/lista-lektur-e8/` — Kanon Lektur Obowiązkowych Egzaminu Ósmoklasisty (Schema: Article, FAQPage)
- `https://kalkulator-punktow.eu/jak-napisac-rozprawke/` — Poradnik Kompozycji Rozprawki na 20/20 pkt (Schema: Article, HowTo, FAQPage)
- `https://kalkulator-punktow.eu/jak-napisac-opowiadanie/` — Poradnik Opowiadania Twórczego CKE (Schema: Article, HowTo, FAQPage)
- `https://kalkulator-punktow.eu/jak-napisac-ogloszenie-i-zaproszenie/` — Generator i Wzory Krótkich Form Użytkowych (Schema: Article, HowTo, FAQPage)
- `https://kalkulator-punktow.eu/srodki-stylistyczne/` — Słownik Środków Stylistycznych i Quiz Interaktywny (Schema: Article, Quiz, FAQPage)

### Dokumentacja Prawna, Metodologia i Transparentność
- `https://kalkulator-punktow.eu/metodologia-i-zrodla/` — Pełna Analiza Prawna i Źródła Ustawowe (Schema: Article)
- `https://kalkulator-punktow.eu/kontakt/` — Formularz Wsparcia i Weryfikacji Formuł (Schema: ContactPage)
- `https://kalkulator-punktow.eu/regulamin/` — Regulamin, Warunki Użytkowania, Nota Prawna (Schema: TermsPage)
- `https://kalkulator-punktow.eu/o-nas/` — Informacje o Zespole Redakcyjnym (Schema: AboutPage)
- `https://kalkulator-punktow.eu/polityka-prywatnosci/` — Polityka Prywatności i RODO (Schema: WebPage)
- `https://kalkulator-punktow.eu/mapa-strony/` — Indeks Architektury Serwisu (Schema: Article)

---

## 4. Zasady Etyczne, Prawa Autorskie i Licencje
Treści merytoryczne i kalkulatory są bezpłatne dla wszystkich uczniów, rodziców i nauczycieli. Szkoły podstawowe mają prawo bezpłatnego osadzania widgetu kalkulatora (`/widget/`) na stronach placówek bez konieczności uiszczania opłat licencyjnych.