> For the complete documentation index, see [llms.txt](https://astroport-1.gitbook.io/astroport.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://astroport-1.gitbook.io/astroport.one/architecture.md).

# Architecture Astroport.ONE

## 📋 Table des Matières

1. [Vue d'ensemble](#-vue-densemble)
2. [Architecture Système](#-architecture-système)
3. [Composants Principaux](#-composants-principaux)
4. [Flux de Données](#-flux-de-données)
5. [Sécurité et Cryptographie](#-sécurité-et-cryptographie)
6. [Économie et Paiements](#-économie-et-paiements)
7. [Stockage et Cache](#-stockage-et-cache)
8. [APIs et Services](#-apis-et-services)
9. [Maintenance et Monitoring](#-maintenance-et-monitoring)
10. [Déploiement](#-déploiement)
11. [Intégration NOSTR](#-intégration-nostr)
12. [Système UPassport](#-système-upassport)

***

## 🌟 Vue d'ensemble

Astroport.ONE est une plateforme décentralisée qui combine **monnaie libre (Ğ1)**, **stockage IPFS**, **identité numérique NOSTR** et **automatisation intelligente** pour créer un écosystème Web3 complet.

### 🎯 Objectifs

* **Souveraineté Numérique** : Contrôle total des données utilisateur
* **Économie Libre** : Transactions sans intermédiaires via Ğ1
* **Identité Décentralisée** : Gestion d'identité basée sur NOSTR et IPFS
* **Résilience** : Architecture distribuée sans point de défaillance unique
* **Automatisation Intelligente** : Système AstroBot avec Vœux

### 🌍 Écosystème UPlanet

Astroport.ONE alimente l'écosystème **UPlanet** qui fonctionne sur deux niveaux :

#### 🌐 **UPlanet ORIGIN (Niveau X)**

* **Accès public** pour tous les utilisateurs
* **Sécurité standard** avec surveillance Ğ1
* **Token fixe** : 1 Ẑen = 0.1 Ğ1
* **Services** : MULTIPASS, ZENCARD de base

#### 🛡️ **UPlanet Ẑen (Niveau Y/Z)**

* **Réseau privé** avec clés SSH<->IPFS jumelles
* **Sécurité avancée** avec détection d'intrusion
* **Tokens personnalisables** : 1 Ẑen = valeur d'actif (€, m², kWh, etc.)
* **Services avancés** : DeFi, actifs réels, coopératives

***

## 🏗️ Architecture Système

### Diagramme d'Architecture Générale

```
┌─────────────────────────────────────────────────────────────────┐
│                        Astroport.ONE                           │
│                    Écosystème Décentralisé                     │
└─────────────────────────────────────────────────────────────────┘
                                │
                ┌───────────────┼───────────────┐
                │               │               │
        ┌───────▼──────┐ ┌──────▼──────┐ ┌─────▼─────┐
        │   Interface  │ │   Services  │ │ Stockage  │
        │     Web      │ │   Métier    │ │Décentralisé│
        └──────────────┘ └─────────────┘ └───────────┘
                │               │               │
        ┌───────▼──────┐ ┌──────▼──────┐ ┌─────▼─────┐
        │   Port 54321  │ │  RUNTIME/   │ │   IPFS    │
        │  API Gateway │ │  Services   │ │  Storage  │
        └──────────────┘ └─────────────┘ └───────────┘
                │               │               │
        ┌───────▼──────┐ ┌──────▼──────┐ ┌─────▼─────┐
        │   Port 12345 │ │  ASTROBOT/  │ │  ~/.zen/  │
        │ Station Map  │ │ Automation  │ │   Cache   │
        └──────────────┘ └─────────────┘ └───────────┘
```

### Architecture en Couches

| Couche           | Composants                | Description                       |
| ---------------- | ------------------------- | --------------------------------- |
| **Présentation** | Ports 12345, 54321        | Interfaces web et APIs            |
| **Application**  | API/, RUNTIME/, ASTROBOT/ | Services métier et automatisation |
| **Données**      | IPFS, \~/.zen/game/       | Stockage décentralisé et cache    |
| **Réseau**       | Ğ1, NOSTR, IPFS           | Protocoles de communication       |

***

## 🔧 Composants Principaux

### 1. Scripts de Gestion Principaux

| Script                 | Taille | Port  | Rôle                            |
| ---------------------- | ------ | ----- | ------------------------------- |
| `command.sh`           | 51KB   | -     | Interface principale de gestion |
| `12345.sh`             | 10KB   | 1234  | Launcher principal              |
| `_12345.sh`            | 23KB   | 12345 | Cartographie des stations       |
| `20h12.process.sh`     | 11KB   | -     | Maintenance quotidienne         |
| `NOSTRCARD.refresh.sh` | 34KB   | -     | Gestion des cartes NOSTR        |

### 2. Services et Ports

| Port                 | Service            | Description                    | Protocole      |
| -------------------- | ------------------ | ------------------------------ | -------------- |
| **1234**             | Twist API          | Twist BASH API (deprecated)    | HTTP           |
| **12345**            | Station Map        | Cartographie UPlanet           | HTTP           |
| **45780-90**         | Twist API Response | Ports de réponse twist uniques | HTTP           |
| **33101**            | G1Billet           | Service fabrication Ğ1 BILLETS | HTTP           |
| **54321**            | UPassport          | UPassport 'FastApi' API        | HTTP           |
| **8080, 4001, 5001** | IPFS Gateway       | Accès stockage décentralisé    | HTTP           |
| **7777**             | NOSTR Relay        | Réseau social décentralisé     | HTTP/WebSocket |
| **80, 443, 81**      | Proxy SSL          | Nginx Proxy Manager (NPM)      | HTTPS          |
| **8002, 8443**       | NextCloud AIO      | Administration NextCloud       | HTTPS          |

### 3. Structure des Répertoires

```
Astroport.ONE/
├── command.sh              # Interface principale
├── 12345.sh               # Serveur API
├── _12345.sh              # Cartographie stations
├── 20h12.process.sh       # Maintenance quotidienne
├── install.sh             # Installation (bare metal)
├── install/               # Scripts d'installation secondaires (build-time)
│   ├── install_system.sh  # Sudoers, systemd, SSH, symlinks
│   ├── install_upassport.sh
│   ├── install_gcli.sh
│   ├── install_deno.sh
│   └── setup/             # Configuration runtime
│       ├── setup.sh       # Hostname, IPFS init, .env, captain
│       ├── ipfs_setup.sh  # Initialisation noeud IPFS
│       └── setup_npm.sh   # Config auto Nginx Proxy Manager
├── docker/                # Déploiement Docker
│   ├── docker-compose.yml # Stack complète (Astroport + NPM + NextCloud)
│   └── astroport/         # Image container
│       ├── Dockerfile
│       └── astroport.sh   # Entrypoint container
├── tools/                 # Utilitaires système
│   ├── my.sh             # Bibliothèque de fonctions
│   ├── keygen            # Générateur de clés
│   └── heartbox_analysis.sh # Analyse système
├── API/                   # API Sandbox Examples
├── RUNTIME/               # Services en arrière-plan
├── ASTROBOT/              # Automatisation (Players Smart Contract)
├── templates/             # Templates HTML
└── _DOCKER/               # Services tiers (Duniter, PeerTube, etc.)
```

***

## 🔄 Flux de Données

### 1. Flux de Synchronisation Swarm

```mermaid
flowchart TD
    A[_12345.sh Start] --> B[Initialisation Clés]
    B --> C[Boucle de Synchronisation]
    C --> D{1 heure écoulée?}
    D -->|Non| E[Attente]
    E --> C
    D -->|Oui| F[Scan Bootstrap Nodes]
    F --> G[Récupération Données Distantes]
    G --> H{Données Modifiées?}
    H -->|Non| I[Cache Local]
    H -->|Oui| J[Mise à Jour Cache]
    J --> K[Publication IPNS]
    K --> L[Publication Swarm]
    L --> M[Attente Prochaine Cycle]
    M --> C
```

### 2. Flux de Maintenance Quotidienne

```mermaid
flowchart TD
    A[20h12.process.sh] --> B[Vérification IPFS]
    B --> C{IPFS OK?}
    C -->|Non| D[Redémarrage IPFS]
    C -->|Oui| E[Nettoyage Cache]
    D --> E
    E --> F[Sauvegarde Caches Critiques]
    F --> G[Suppression Cache Temp]
    G --> H[Mise à Jour Code]
    H --> I[Rafraîchissement Données]
    I --> J[Redémarrage Services]
    J --> K[Analyse Système]
    K --> L[Rapport Email]
```

### 3. Flux de Requête API Typique

cf. [Dépot de code /UPassport](https://github.com/papiche/Astroport.ONE/blob/master/papiche/UPassport/README.md)

***

## 🔐 Sécurité et Cryptographie

### 1. Gestion des Clés

| Type de Clé       | Format | Usage                     | Stockage                               |
| ----------------- | ------ | ------------------------- | -------------------------------------- |
| **Zen Card**      | Ẑen    | Paiements et transactions | `~/.zen/game/players/*/secret.dunikey` |
| **IPFS Key**      | IPFS   | Identité décentralisée    | `~/.ipfs/keystore/`                    |
| **MULTIPASS Key** | NOSTR  | Réseau social             | `~/.zen/game/nostr/*/.secret.nostr`    |
| **SSSS Keys**     | Shamir | Seed source               | `~/.zen/game/nostr/*/.secret.disco`    |

### 2. Validation des Transactions

```bash
# Vérification des transactions primaires
function validate_primal_transaction() {
    local transaction="$1"
    local primal_source="$2"
    
    # Vérification de la source primaire
    if [[ "$primal_source" == "UPlanet_ORIGIN" ]]; then
        # Accepte toute source primaire
        return 0
    elif [[ "$primal_source" == "UPlanet_ZEN" ]]; then
        # Vérification stricte avec détection d'intrusion
        check_intrusion_detection "$transaction"
        return $?
    fi
}
```

### 3. Système de Chiffrement

* **Clés Géographiques** : Génération basée sur coordonnées GPS (UMAP 1km, SECTOR 10km, REGION 100km)
* **Stargates** : Distribution des messages NOSTR (protocole N²)
* **Communs Cryptographiques** : Partage de ressources cryptographiques

***

## 💰 Économie et Paiements

### 1. Système Multi-Tokens

#### **Tokens Ẑen (MULTIPASS & ZENCARD)**

* **UPlanet ORIGIN** : 1 Ẑen = 0.1 Ğ1 (taux fixe)
* **UPlanet Ẑen** : 1 Ẑen = valeur personnalisable (€, terrain, énergie, etc.)

#### **Tokens NEẐ (uPASSPORT ZEROCARD)**

* **Valeur** : 1 NEẐ = 1 Ğ1 (équivalent direct Ğ1)
* **Usage** : Actions dans l'infrastructure coopérative

#### **Made In Zen Tokens**

* **Usage** : Gouvernance coopérative et propriété d'infrastructure
* **Accès** : Disponible aux détenteurs de ZENCARD et dépositaires uPASSPORT

### 2. G1PalPay.sh - Surveillance Ğ1/NOSTR (ZEN.ECONOMY.sh, NOSTRCARD.refresh.sh, PLAYER.refresh.sh)

```bash
# Surveillance des transactions Ğ1
function monitor_g1_transactions() {
    local player="$1"
    local g1pub="$2"
    
    # Surveillance continue des transactions
    while true; do
        # Récupération des nouvelles transactions
        local new_transactions=$(get_new_transactions "$g1pub")
        
        # Traitement des transactions
        for transaction in $new_transactions; do
            process_transaction "$transaction" "$player"
        done
        
        sleep 30
    done
}
```

### 3. Économie des Likes

* **Chaque like reçu** = 1 Ẑ automatiquement transféré
* **Système de gratitude** : Récompense directe pour les interactions
* **Capitalisation automatique** : Gestion des tokens en temps réel

***

## 💾 Stockage et Cache

### 1. Structure IPFS

```
~/.zen/game/
├── players/              # Données des joueurs
│   ├── .current/        # Capitaine actuel
│   └── */               # Données par joueur
│       ├── secret.dunikey
│       ├── ipfs/        # Stockage IPFS (legacy)
├── nostr/               # Données NOSTR
│   └── */               # Données par MULTIPASS (@, UMAP, ZCARD, ...)
└── tmp/                 # Cache temporaire
│   ├── coucou/          # Cache Metadonnées Profil : .COINS, .primal, .2nd, .cesium, .gchange, ...
│   ├── ${IPFSNODEID]/   # Balise IPNS de la Station
│   ├── swarm/           # Capture des balises des stations de l'essaim
```

### 2. Système de Cache

* **Cache Local** : `~/.zen/tmp/` pour les données temporaires
* **Cache IPFS** : Stockage local IPFS du TW de la ZenCard
* **Cache NOSTR** : Stockage local + synchro N² des événements NOSTR

### 3. Synchronisation

* **Synchronisation Swarm** : Partage des données entre stations UPlanet
* **Publication IPNS** : Mise à jour des références IPNS
* **Cache Invalidation** : Gestion automatique de l'expiration des caches

***

## 🔌 APIs et Services

### 1. API Gateway (Port 1234, deprecated) - UPassport 54321 pour l’auth

```bash
# Point d'entrée principal
GET /?cmd=action&param=value

# Redirection vers ports dynamiques (45780-90)
# Exécution des services API/
```

### 2. Station Map (Port 12345) - /12345 ssl mapping (Node Swarm Info)

```bash
# Cartographie des stations UPlanet
GET / - Interface de cartographie
Données JSON des stations
```

### 3. UPassport API (Port 54321) - u. ssl mapping - (Production API)

```bash
# API d'identité numérique
POST /api/upload - Upload de fichiers vers IPFS
POST /api/delete - Suppression de fichiers
GET /api/test-nostr - Test d'authentification NOSTR
```

***

## 🔧 Maintenance et Monitoring

### 1. Maintenance Quotidienne (20h12.process.sh) - evolutive

```bash
# Vérification IPFS
check_ipfs_status

# Nettoyage cache
cleanup_temp_files

# Sauvegarde caches critiques
backup_critical_caches

# Mise à jour code
update_code

# Redémarrage services
restart_services

# Analyse système
system_analysis

# Rapport email
send_maintenance_report
```

### 2. Monitoring Système - work in progress

* **heartbox\_analysis.sh** : Analyse complète du système
* **heartbox\_control.sh** : Contrôle et gestion du système
* **heartbox\_prometheus\_analysis.sh** : Métriques Prometheus

### 3. Logs et Debugging

* **Logs UPassport API** : `journalctl -fu upassport`
* **Logs NOSTR** : `~/.zen/tmp/nostr_*.log`
* **Logs UPlanet** : `~/.zen/tmp/uplanet_*.log`
* **Logs IA** : `~/.zen/tmp/IA.log`

***

## 🚀 Déploiement

### 1. Installation Automatique

```bash
# Installation complète
bash <(curl -sL https://install.astroport.com)

# Ou installation manuelle
git clone https://github.com/papiche/Astroport.ONE.git ~/.zen/Astroport.ONE
cd ~/.zen/Astroport.ONE
./install.sh
```

### 2. Configuration Système - automatiquemet réalisé par install -

```bash
# Configuration IPFS
~/.zen/Astroport.ONE/install/setup/ipfs_setup.sh

# Configuration RELAI NOSTR (strfry)
~/.zen/workspace/NIP-101/setup.sh

# Configuration UPassport
~/.zen/Astroport.ONE/install/install_upassport.sh
```

### 3. Services Systemd (bare metal)

```bash
# Service Astroport
sudo systemctl enable astroport
sudo systemctl start astroport

# Service UPassport
sudo systemctl enable upassport
sudo systemctl start upassport

# Service NOSTR Relay
sudo systemctl enable strfry
sudo systemctl start strfry
```

### 4. Déploiement Docker

```bash
cd ~/.zen/Astroport.ONE/docker/

# Astroport + Nginx Proxy Manager (SSL)
docker compose up -d

# + NextCloud AIO (stockage cloud pour ZenCard)
docker compose --profile full up -d

# Avec un domaine personnalisé
ASTRO_DOMAIN=mondomaine.fr docker compose up -d

# Logs
docker compose logs -f astroport
```

Architecture Docker (3 containers frères sur réseau `astronet`) :

* **astroport** : IPFS + API 12345 + NOSTR + UPassport + G1Billet
* **npm** : Nginx Proxy Manager (SSL Let's Encrypt ou auto-signé)
* **nextcloud** : NextCloud AIO (optionnel, `--profile full`)

Sous-domaines configurés automatiquement par NPM :

* `astroport.DOMAIN` → :12345
* `ipfs.DOMAIN` → :8080
* `relay.DOMAIN` → :7777 (WebSocket)
* `u.DOMAIN` → :54321
* `cloud.DOMAIN` → :8001 (NextCloud)

Documentation NextCloud :

* <https://pad.p2p.legal/NextCloud#>
* <https://pad.p2p.legal/Smartphone2NextCloud#>

***

## 🤖 Intégration NOSTR

### 1. Relay NOSTR (Port 7777)

Astroport.ONE utilise un relay NOSTR dédié avec des filtres personnalisés pour :

* **Authentification NIP-42** : Vérification des identités
* **IA Contextuelle** : Réponses automatiques avec #BRO
* **Géolocalisation** : Messages liés aux coordonnées GPS
* **Mémoire Privée** : Stockage contrôlé avec #rec
* **Événements Vidéo (NIP-71)** : Support pour kind 21/22 (vidéos normales/courtes)

### 2. Nostr Tube - Plateforme Vidéo Décentralisée

Astroport.ONE intègre **Nostr Tube**, une alternative décentralisée à YouTube utilisant :

* **NIP-71** : Événements vidéo (kind 21/22) avec métadonnées complètes
* **IPFS** : Stockage décentralisé des vidéos et miniatures
* **NIP-51** : Playlists (kind 10001) pour les collections vidéo
* **NIP-25** : Réactions (kind 7) pour les likes et commentaires
* **UMAP** : Ancrage géographique des vidéos (tags `g`, `latitude`, `longitude`)

**Composants** :

* Route `/youtube` : Interface de découverte et lecture
* Route `/theater` : Mode théâtre immersif avec commentaires en direct
* Route `/playlist` : Gestionnaire de playlists
* Scripts IA : Synchronisation YouTube (`youtube.com.sh`), traitement vidéo (`process_youtube.sh`)

Voir [**docs/explanation/README.NostrTube.md**](/astroport.one/docs/explanation/readme.nostrtube.md) pour la documentation complète.

### 3. Filtres Personnalisés

```bash
# Filtre principal (all_but_blacklist.sh)
# Accepte tous les événements sauf ceux de la blacklist

# Filtre kind 1 (filter/1.sh)
# Gestion des messages texte avec IA et mémoire

# Filtre kind 21/22 (vidéos)
# Support pour les événements vidéo NIP-71
```

### 4. Système de Mémoire

* **Mémoire Utilisateur** : `~/.zen/flashmem/uplanet_memory/pubkey/{pubkey}.json`
* **Mémoire UMAP** : `~/.zen/flashmem/uplanet_memory/{latitude}_{longitude}.json`
* **Contrôle Privé** : Tag #rec requis pour stockage

***

## 🛡️ Système UPassport

### 1. API d'Identité Numérique (Port 54321)

UPassport fournit une API complète pour :

* **Gestion d'Identité** : Création et gestion des UPassports
* **Stockage IPFS** : Upload et gestion de fichiers décentralisés
* **Intégration NOSTR** : Authentification et gestion des cartes NOSTR
* **Intégration Ğ1** : Vérification de solde et transactions

### 2. Authentification NIP-42

```bash
# Test d'authentification
curl -X POST http://localhost:54321/api/test-nostr \
  -F "npub=npub1..."

# Upload avec authentification
curl -F "file=@photo.jpg" \
     -F "npub=npub1..." \
     http://localhost:54321/api/upload
```

***

## 🔗 Liens et Ressources

### Documentation

* [**README.md**](/astroport.one/readme.md) - Introduction principale
* [**WELCOME.md**](/astroport.one/welcome.md) - Guide écosystème UPlanet
* [**UPASSPORT\_API.md**](/astroport.one/upassport_api.md) - Documentation API UPassport
* [**API.NOSTRAuth.readme.md**](https://github.com/papiche/Astroport.ONE/blob/master/API.NOSTRAuth.readme.md) - Documentation NOSTR
* [**docs/explanation/README.NostrTube.md**](/astroport.one/docs/explanation/readme.nostrtube.md) - Documentation Nostr Tube (plateforme vidéo décentralisée)

### Ressources Externes

* [**GitHub Repository**](https://github.com/papiche/Astroport.ONE) - Code source
* [**Open Collective**](https://opencollective.com/monnaie-libre) - Support financier
* [**Documentation GitBook**](https://astroport-1.gitbook.io/astroport.one/) - Guide utilisateur

### Contact

* **Email** : <support@qo-op.com>
* **Site Web** : <https://astroport.com>
* **Communauté** : <https://copylaradio.com>

***

**Astroport.ONE : L'architecture décentralisée pour un Internet libre et souverain** 🌍✨