69 lines
4.9 KiB
Markdown
69 lines
4.9 KiB
Markdown
# TheCr3w-dev
|
|
## Kompleksowa platforma zarządzania aplikacjami, aktualizacjami, wdrożeniami, CI/CD i artefaktami
|
|
|
|
[](https://thecr3wnet.com)
|
|
[](https://dotnet.microsoft.com/)
|
|
[](https://www.postgresql.org/)
|
|
[-orange.svg)](https://www.cloudflare.com/products/r2/)
|
|
[](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)
|