thecr3w-dev/docs/CHANGELOG.md

2.4 KiB

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.