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

[![Platform Status](https://img.shields.io/badge/Status-Active%20Development-blue.svg)](https://thecr3wnet.com)
[![Backend](https://img.shields.io/badge/.NET-9.0%20ASP.NET%20Core-purple.svg)](https://dotnet.microsoft.com/)
[![Database](https://img.shields.io/badge/PostgreSQL-16%20Alpine-336791.svg)](https://www.postgresql.org/)
[![Storage](https://img.shields.io/badge/Storage-Cloudflare%20R2%20(S3)-orange.svg)](https://www.cloudflare.com/products/r2/)
[![IAM](https://img.shields.io/badge/IAM-Keycloak%20OIDC-red.svg)](https://login.thecr3wnet.com)

---

## 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](file:///d:/cr3w_dev/docs/ARCHITECTURE.md)
- [Polityka Bezpieczeństwa i Model Zagrożeń](file:///d:/cr3w_dev/docs/SECURITY.md)
- [Raport Audytu Infrastruktury (Stage 0)](file:///d:/cr3w_dev/docs/STAGE_0_INFRASTRUCTURE_DISCOVERY.md)
- [Specyfikacja OpenAPI Native Update](file:///d:/cr3w_dev/contracts/openapi/native-update-api.yaml)
- [Specyfikacja OpenAPI Deployment Control](file:///d:/cr3w_dev/contracts/openapi/deployment-control-api.yaml)
- [Schemat Bazy Danych PostgreSQL](file:///d:/cr3w_dev/infrastructure/postgres/init/01-init-schema.sql)
- [Schemat Manifestu Wdrożeniowego](file:///d:/cr3w_dev/contracts/schemas/deployment-manifest.schema.json)