TheCr3w-dev

Kompleksowa platforma zarządzania aplikacjami, aktualizacjami, wdrożeniami, CI/CD i artefaktami

---

1. O Projekcie

TheCr3w-dev to zintegrowany ekosystem programistyczno-operacyjny stworzony do zarządzania pełnym cyklem życia aplikacji mobilnych (Android), desktopowych (Windows) oraz usług serwerowych:

• Native Application Update System: Centralny system wersjonowania, podpisywania metadanych kluczem Ed25519, sprawdzania aktualizacji w tle oraz telemetrii instalacji.
• Cloud Artifact Storage: Prywatny magazyn artefaktów w Cloudflare R2 z bezpiecznym pobieraniem przez krótkotrwałe Pre-signed URLs.
• The Cr3w Download Center (download.thecr3wnet.com): Dedykowany, publiczny portal pobierania aplikacji natywnych dla użytkowników końcowych.
• TheCr3w Admin Panel: Nowoczesny interfejs administracyjny w React + TypeScript integrujący się z istniejącym Keycloak (login.thecr3wnet.com, realm master).
• Docker Deployment System & Agent: Kontrolowane wdrażanie obrazów OCI z Forgejo Registry po niezmiennych digestach (sha256:...) w oparciu o kryptograficznie podpisane manifesty wdrożeniowe.
• External Deployment Engine: Bezpieczna synchronizacja plików na serwery zewnętrzne z obsługą protokołów SFTP (z pinningiem klucza hosta) oraz FTPS (z walidacją certyfikatów).
• Forgejo CI/CD: Zintegrowane workflowy automatyzujące kompilację, testy, analizę statyczną, podpisywanie i publikację wydań.

Important

Zasada nadrzędna infrastruktury:
Domena thecr3wnet.com jest domeną czysto infrastrukturalną. Nie posiada i nie będzie posiadać żadnej strony WWW ani landing page. Publicznym portalem pobierania jest wyłącznie The Cr3w Download Center pod adresem download.thecr3wnet.com.

---

2. Struktura Repozytorium

thecr3w-dev/
├── backend/
│   ├── TheCr3w.Shared/             # Wspólne modele domenowe, walidacja, kryptografia Ed25519, audyt
│   ├── NativeUpdate.Api/           # API aktualizacji natywnych (app.thecr3wnet.com)
│   └── DeploymentControl.Api/      # API sterowania wdrożeniami i integracją zewnętrzną
├── frontend/
│   ├── admin-panel/                # Panel administracyjny (React + TypeScript + Vite + OIDC PKCE)
│   └── download-center/            # The Cr3w Download Center (download.thecr3wnet.com)
├── sdk/
│   ├── android/                    # TheCr3w Android Update SDK (Kotlin, WorkManager, Jetpack)
│   └── windows/                    # TheCr3w Windows Update SDK (.NET / C#, Background Updater)
├── deployment/
│   └── agent/                      # Kontrolowany TheCr3w Deployment Agent dla Dockera
├── contracts/
│   ├── openapi/                    # Pełne specyfikacje OpenAPI 3.1 dla API
│   └── schemas/                    # Schematy JSON (DeploymentManifest, UpdateMetadata)
├── infrastructure/
│   ├── docker/                     # Pliki Docker Compose dla środowisk TheCr3w-dev
│   ├── caddy/                      # Szablony i reguły dla reverse proxy Caddy
│   └── postgres/                   # Skrypty DDL i migracje bazy danych PostgreSQL
├── ci/
│   └── forgejo/                    # Definicje workflow Forgejo Actions (Android, Windows, Docker)
├── docs/                           # Kompletna dokumentacja architektoniczna, bezpieczeństwa i runbooki
├── scripts/                        # Skrypty narzędziowe i diagnostyczne (w tym diagnose_vps.sh)
└── tests/                          # Testy jednostkowe, integracyjne i weryfikacji kryptograficznej

---

3. Dokumentacja Szczegółowa

• Architektura Systemu
• Polityka Bezpieczeństwa i Model Zagrożeń
• Raport Audytu Infrastruktury (Stage 0)
• Specyfikacja OpenAPI Native Update
• Specyfikacja OpenAPI Deployment Control
• Schemat Bazy Danych PostgreSQL
• Schemat Manifestu Wdrożeniowego