# Documentation Astroport.ONE

Organisée selon le standard [Diátaxis](https://diataxis.fr/) — quatre types de contenu, chacun à sa place.

***

## Quintette — Documentation transversale (tous modes Diataxis)

| Fichier                                          | Sujet                                                                                                                                                            |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [quintette.md](/astroport.one/docs/quintette.md) | **`feedback` · `issue` · `commit` · `cpscript` · `cpcode`** — De la panne terrain au correctif Git : tutorial, guides, référence et explication du cycle complet |

***

## Tutorials — Apprentissage

> Guides pas-à-pas pour apprendre en faisant. Destinés aux débutants. → [Voir le README complet du quadrant](/astroport.one/docs/tutorials.md)

| Fichier                                                                          | Sujet                                                                       |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [install\_baremetal.md](/astroport.one/docs/tutorials/install_baremetal.md)      | Installer sur Linux (Debian/Ubuntu/Mint) — métal nu                         |
| [install\_docker.md](/astroport.one/docs/tutorials/install_docker.md)            | Installer avec Docker — profils standard, cloud, ai                         |
| [setup\_learning\_hub.md](/astroport.one/docs/tutorials/setup_learning_hub.md)   | Transformer sa station en hub d'apprentissage IA (Nextcloud + Qdrant + BRO) |
| [PC\_GAMER\_HUB\_GUIDE.md](/astroport.one/docs/tutorials/pc_gamer_hub_guide.md)  | Convertir un PC gamer en station Astroport rentable (Linux Mint + IA)       |
| [README.NostrTube.DEV.md](/astroport.one/docs/tutorials/readme.nostrtube.dev.md) | Développer des applications sur la plateforme vidéo NostrTube               |
| [BASH\_BEST\_PRACTICES.md](/astroport.one/docs/tutorials/bash_best_practices.md) | Bonnes pratiques de sécurité et robustesse pour les scripts Bash            |

***

## How-To — Recettes

> Guides orientés tâche pour résoudre un problème précis. Supposent des connaissances de base. → [Voir le README complet du quadrant](/astroport.one/docs/how-to.md)

| Fichier                                                                                         | Sujet                                                                                           |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| [LOCAL\_BIN\_SYMLINKS.md](/astroport.one/docs/how-to/local_bin_symlinks.md)                     | Commandes du Capitaine : inventaire `~/.local/bin`, journal `~/.zen/.astro`, convention d'ajout |
| [ASTROSYSTEMCTL.md](/astroport.one/docs/how-to/astrosystemctl.md)                               | Télécommander des services P2P via tunnels IPFS                                                 |
| [SWARM\_WIREGUARD.md](/astroport.one/docs/how-to/swarm_wireguard.md)                            | VPN constellation WireGuard — rejoindre l'essaim, contourner CGNAT, abonnements services        |
| [DRAGONS\_and\_TUNNELS.md](/astroport.one/docs/how-to/dragons_and_tunnels.md)                   | Publier et découvrir des services IA entre stations (DRAGONS + modules.list)                    |
| [API.NOSTRAuth.readme.md](/astroport.one/docs/how-to/api.nostrauth.readme.md)                   | Authentification NOSTR NIP-42 côté serveur et client                                            |
| [NOSTR\_GET\_EVENTS.md](/astroport.one/docs/how-to/nostr_get_events.md)                         | Interroger la base de données du relay NOSTR local                                              |
| [README\_YOUTUBE.md](/astroport.one/docs/how-to/readme_youtube.md)                              | Gestion vidéo UPlanet : téléchargement manuel, sync auto, webcam                                |
| [VOCALS\_SYSTEM.md](/astroport.one/docs/how-to/vocals_system.md)                                | Messages vocaux chiffrés sur NOSTR avec géolocalisation                                         |
| [POWER\_MONITORING.md](/astroport.one/docs/how-to/power_monitoring.md)                          | Surveiller la consommation électrique des processus (PowerJoular)                               |
| [COLLABORATIVE\_COMMONS\_SYSTEM.md](/astroport.one/docs/how-to/collaborative_commons_system.md) | Co-rédiger et valider des documents communs territoriaux                                        |
| [PLANTNET\_SYSTEM.md](/astroport.one/docs/how-to/plantnet_system.md)                            | Cataloguer la biodiversité et ressources locales                                                |
| [MINELIFE.md](/astroport.one/docs/how-to/minelife.md)                                           | Crafting décentralisé des compétences WoTx2 (interface Minecraft)                               |
| [CODEBASE\_EMBEDDINGS.md](/astroport.one/docs/how-to/codebase_embeddings.md)                    | Mémoire vectorielle du code (Qdrant + nomic-embed-text + snapshot IPFS)                         |
| [KNOWLEDGE\_EMBEDDINGS.md](/astroport.one/docs/how-to/knowledge_embeddings.md)                  | Mémoire vectorielle des connaissances WoTx2 (.md/.pdf depuis Kind 30504, uDRIVE, Nextcloud)     |
| [GRIMOIRE\_LIVE.md](/astroport.one/docs/how-to/grimoire_live.md)                                | Vidéo WoTx2 : génération automatique + live streaming (vdo.ninja, NIP-53)                       |
| [config\_wireguard\_vpn.md](/astroport.one/docs/how-to/config_wireguard_vpn.md)                 | Configurer WireGuard pour la communication inter-stations                                       |
| [print\_multipass\_cards.md](/astroport.one/docs/how-to/print_multipass_cards.md)               | Générer et imprimer les QR codes MULTIPASS et ZenCards                                          |
| [publish\_nostrtube\_video.md](/astroport.one/docs/how-to/publish_nostrtube_video.md)           | Publier une vidéo sur NostrTube (IPFS + kind 21)                                                |
| [youtube\_archive\_open\_with.md](/astroport.one/docs/how-to/youtube_archive_open_with.md)      | Archiver YouTube dans son uDRIVE via l'extension Firefox "Open With"                            |

***

## Reference — Information brute

> Données techniques sèches : formats, specs, listes, endpoints. Source de vérité. → [Voir le README complet du quadrant](/astroport.one/docs/reference.md)

| Fichier                                                                                              | Sujet                                                                |
| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [NOSTR\_EVENTS\_REFERENCE.md](/astroport.one/docs/reference/nostr_events_reference.md)               | **Référence centrale** des kinds NOSTR utilisés dans UPlanet         |
| [IDENTITY\_MULTIPASS.md](/astroport.one/docs/reference/identity_multipass.md)                        | Identité niveau 1 — MULTIPASS : structure, champs, lifecycle         |
| [IDENTITY\_ZENCARD.md](/astroport.one/docs/reference/identity_zencard.md)                            | Identité niveau 2 — ZenCard : droits, ressources, propriété          |
| [INFO\_JSON\_FORMATS.md](/astroport.one/docs/reference/info_json_formats.md)                         | Format de métadonnées `info.json` v2.0 pour les fichiers IPFS        |
| [Analytics.README.md](/astroport.one/docs/reference/analytics.readme.md)                             | Système analytique `astro.js` — kind 10600 (HTTP, NOSTR, chiffré)    |
| [COOKIE\_SYSTEM.md](/astroport.one/docs/reference/cookie_system.md)                                  | Gestion universelle de cookies pour l'authentification scrapers      |
| [DOMAIN\_SCRAPERS.md](/astroport.one/docs/reference/domain_scrapers.md)                              | Architecture des scrapers automatiques basés sur les cookies         |
| [ZEN.INTRUSION.POLICY.md](/astroport.one/docs/reference/zen.intrusion.policy.md)                     | Politique de gestion des fonds externes — architecture portefeuilles |
| [ROAMING\_UDRIVE\_SYNC.md](/astroport.one/docs/reference/roaming_udrive_sync.md)                     | Protocole de synchronisation uDRIVE inter-stations                   |
| [JOURNAUX\_N2\_NOSTRCARD.md](/astroport.one/docs/reference/journaux_n2_nostrcard.md)                 | Journaux N² générés automatiquement par MULTIPASS                    |
| [WOTX2\_SYSTEM.md](/astroport.one/docs/reference/wotx2_system.md)                                    | Toiles de confiance duales Oracle + P2P                              |
| [UPlanet\_FILE\_CONTRACT.md](/astroport.one/docs/reference/uplanet_file_contract.md)                 | Protocole de gestion décentralisée des fichiers IPFS+NOSTR           |
| [UPlanet\_CROWDFUNDING\_CONTRACT.md](/astroport.one/docs/reference/uplanet_crowdfunding_contract.md) | Protocole de financement participatif décentralisé                   |
| [upassport\_api\_endpoints.md](/astroport.one/docs/reference/upassport_api_endpoints.md)             | Endpoints UPassport (port 54321) — routers FastAPI, route /qr        |
| [bash\_scripts\_roles.md](/astroport.one/docs/reference/bash_scripts_roles.md)                       | Rôle fonctionnel de chaque script Bash du projet                     |
| [cli\_keygen\_commands.md](/astroport.one/docs/reference/cli_keygen_commands.md)                     | Référence CLI `keygen` — dérivation déterministe G1/IPFS/NOSTR       |

***

## Explanation — Philosophie et contexte

> Discussions de fond : pourquoi, comment on en est arrivé là, les choix d'architecture. → [Voir le README complet du quadrant](/astroport.one/docs/explanation.md)

| Fichier                                                                                  | Sujet                                                                                                  |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| [ZEN.ECONOMY.v3.md](/astroport.one/docs/explanation/zen.economy.v3.md)                   | **Source canonique** — Économie ẐEN v3 : boucle Ğ1↔ẐEN↔❤️, TrocZen                                     |
| [ROLES.md](/astroport.one/docs/explanation/roles.md)                                     | Rôles Armateur / Capitaine — responsabilités et droits                                                 |
| [DID\_IMPLEMENTATION.md](/astroport.one/docs/explanation/did_implementation.md)          | Identités décentralisées W3C DID, UCAN, clés SSSS 3/2                                                  |
| [ORE\_SYSTEM.md](/astroport.one/docs/explanation/ore_system.md)                          | Cadastre écologique décentralisé — obligations environnementales NOSTR                                 |
| [ORACLE\_SYSTEM.md](/astroport.one/docs/explanation/oracle_system.md)                    | Certification de compétences WoT — attestations multi-signatures                                       |
| [N2\_MEMORY\_SYSTEM.md](/astroport.one/docs/explanation/n2_memory_system.md)             | Prise de décision collective N² — jeu de l'ange de Conway                                              |
| [CROWDFUNDING\_COMMUNS.md](/astroport.one/docs/explanation/crowdfunding_communs.md)      | Financement participatif des biens communs (terrains, équipements)                                     |
| [BRO\_RAG\_PERSONAL.md](/astroport.one/docs/explanation/bro_rag_personal.md)             | Architecture de l'assistant IA souverain #BRO (RAG personnel)                                          |
| [README.NostrTube.md](/astroport.one/docs/explanation/readme.nostrtube.md)               | NostrTube — vision de la plateforme vidéo décentralisée                                                |
| [architecture\_overview.md](/astroport.one/docs/explanation/architecture_overview.md)    | Vue synthétique : IPFS+NOSTR+Ğ1, flux de données, couches fondamentales                                |
| [minelife\_wikipedia\_wot.md](/astroport.one/docs/explanation/minelife_wikipedia_wot.md) | MineLife comme Wikipédia décentralisé — WoT relativiste, Capitaine bibliothécaire, effet constellation |
| [ANALYTICS.md](/astroport.one/docs/explanation/analytics.md)                             | Analytics décentralisé — Kind 10600 + NIP-44, zéro fuite vers les GAFAM                                |
| [ASYNC\_TASKS\_NOSTR.md](/astroport.one/docs/explanation/async_tasks_nostr.md)           | Tâches asynchrones inter-NODE via DMs NOSTR — le "RabbitMQ Web3"                                       |

***

## Archive

> Fichiers obsolètes, doublons, ou en cours de refonte. Ne pas utiliser comme référence.

| Fichier                                                                                    | Raison                                   |
| ------------------------------------------------------------------------------------------ | ---------------------------------------- |
| [ZEN.ECONOMY.v3.md](/astroport.one/docs/explanation/zen.economy.v3.md) ← **utiliser ceci** | —                                        |
| [ZEN.ECONOMY.readme.md](/astroport.one/docs/archive/zen.economy.readme.md)                 | Remplacé par v3                          |
| [ZEN.ECONOMY.v2.md](/astroport.one/docs/archive/zen.economy.v2.md)                         | Remplacé par v3                          |
| [uMARKET.md](/astroport.one/docs/archive/umarket.md)                                       | En refonte — migration vers contrats ORE |
| [uMARKET.todo.md](/astroport.one/docs/archive/umarket.todo.md)                             | Tâches de refonte uMARKET                |

***

## Contrats

| Fichier                                                                               | Sujet                                           |
| ------------------------------------------------------------------------------------- | ----------------------------------------------- |
| [contrats/COMMODAT\_ASTROPORT.md](/astroport.one/docs/contrats/commodat_astroport.md) | Contrat de commodat pour les stations Astroport |

***

## Dev Logs

> Notes de travail internes, plans de migration, systèmes en cours de refonte. Ne pas utiliser comme référence publique.

| Fichier                                                                                                | Sujet                                                            |
| ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| [TODO.md](https://github.com/papiche/Astroport.ONE/blob/master/docs/dev_logs/TODO.md)                  | TODO principal Astroport.ONE (système à refondre)                |
| [TODO\_SYSTEM.md](/astroport.one/docs/dev_logs/todo_system.md)                                         | Documentation du système TODO N² (déprécié — todo.sh en refonte) |
| [TODO\_MIGRATION\_RNOSTR\_SEMANTIC.md](/astroport.one/docs/dev_logs/todo_migration_rnostr_semantic.md) | Plan de migration strfry → rnostr + Qdrant sémantique            |


---

# 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/docs.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.