# THECR3W-DEV — CHANGELOG
Wszystkie istotne zmiany i wydania projektu są rejestrowane w tym dokumencie.

---

## [1.0.0] — 2026-10-31

### Zrealizowane Etapy
- **Stage 0 (Infrastructure Discovery):**
  - Wykonano pełny audyt środowiska Netcup VPS (Ubuntu 24.04.5 LTS, 15GB RAM, 476GB SSD wolnego miejsca, Docker 29.9.2, Compose v5.6.1).
  - Zweryfikowano działanie Caddy w sieci `proxy`, Keycloak OIDC pod `login.thecr3wnet.com` (realm `master`) oraz 5 rekordów DNS A wskazujących na IP `89.58.46.176`.
  - Zagwarantowano nienaruszalność domeny bazowej `thecr3wnet.com` (bezwzględny zakaz tworzenia strony WWW).
- **Stage 1 (Architecture & Contracts):**
  - Opracowano pełną specyfikację OpenAPI 3.1 dla Native Update API (`app.thecr3wnet.com`) oraz Deployment Control API.
  - Przygotowano schemat JSON dla Deployment Manifest oraz kanonicznych metadanych wydań.
  - Zaimplementowano DDL bazy danych PostgreSQL 16 (`01-init-schema.sql`).
- **Stage 2 (Keycloak IAM):**
  - Opracowano mapowanie ról klienta (Client Roles) w realm `master` w celu wyeliminowania ryzyka eskalacji uprawnień.
- **Stage 3 (Native Update System):**
  - Zaimplementowano Native Update API w .NET 10 ASP.NET Core z obsługą sprawdzania wersji, generowaniem Pre-signed URLs do Cloudflare R2 oraz telemetrią instalacji.
  - Zaimplementowano bibliotekę kryptograficzną Ed25519 (BouncyCastle) z kanoniczną serializacją JSON.
  - Zbudowano Windows Update SDK (.NET) oraz Android Update SDK (Kotlin).
- **Stage 4 (Docker Deployment):**
  - Zaimplementowano Deployment Control API z bramką zatwierdzania produkcji po skrócie SHA256 manifestu.
  - Zbudowano TheCr3w Deployment Agent z kontrolowaną białą listą operacji Docker Engine.
- **Stage 5 (External Deployment Engine):**
  - Zaimplementowano silnik synchronizacji SFTP/FTPS z porównywaniem sum kontrolnych plików i strict host-key pinning.
- **Stage 6 (Forgejo CI/CD):**
  - Przygotowano deklaratywne pipeline'y Forgejo Actions dla Androida, Windowsa, Dockera i wdrożeń zewnętrznych.
- **Stage 7 (Frontend Applications):**
  - Zbudowano The Cr3w Download Center (`download.thecr3wnet.com`) w React + TypeScript + Vite.
  - Zbudowano TheCr3w Admin Panel w React + TypeScript + Vite.
- **Stage 8 (Security & Production Readiness):**
  - Przeprowadzono testy kryptograficzne, integralnościowe i API (100% testów zaliczonych).
  - Przygotowano kompletną dokumentację architektoniczną, bezpieczeństwa, runbooki backupu i troubleshootingu.