thecr3w-dev/docs/CHANGELOG.md

35 lines
2.4 KiB
Markdown

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