# 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** 🌍✨


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://astroport-1.gitbook.io/astroport.one/architecture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.