> 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/docs.md). # 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) ### 🚀 Par où commencer ? **→** [**🎟️ Créer son MULTIPASS UPlanet**](/astroport.one/docs/tutorials/multipass_inscription.md) Rejoindre l'écosystème en 5 à 10 minutes : identité NOSTR, portefeuille Ğ1, uDRIVE 10 Go, Kin Maya. Premier tutoriel recommandé pour tout nouvel utilisateur. | Fichier | Sujet | | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [MULTIPASS\_INSCRIPTION.md](/astroport.one/docs/tutorials/multipass_inscription.md) | **🎟️ Créer son MULTIPASS** — identité NOSTR, portefeuille Ğ1, Kin Maya (5–10 min) | | [WOTX2\_DEMO\_SCENARIO.md](/astroport.one/docs/tutorials/wotx2_demo_scenario.md) | **Scénario WoTx² complet** — 6 personas, crafting social, médiation, assurance mutualiste | | [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) | | [REPORT\_FRICTION.md](/astroport.one/docs/how-to/report_friction.md) | Déclarer une friction WoTx² et suivre la médiation N1/N2 | | [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 | | [A4L\_GEO\_TAGGING.md](/astroport.one/docs/reference/a4l_geo_tagging.md) | **Format `a4l:` propriétaire ATOM4LOVE** — adressage hexagonal Goldberg sur NOSTR | | [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, objets partagés, médiation, 6 personas | | [KIND\_30505\_OBJECTS.md](/astroport.one/docs/reference/kind_30505_objects.md) | Spec objets WoTx² — quantity model, durability, quorum, crafting social | | [KIND\_30506\_JUSTICE.md](/astroport.one/docs/reference/kind_30506_justice.md) | Spec médiation WoTx² — dossier 30506, actes 1506, assurance mutualiste | | [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" | | [WOTX2\_MEDIATION.md](/astroport.one/docs/explanation/wotx2_mediation.md) | Assurance mutualiste WoT — pourquoi la médiation pair-à-pair remplace l'assurance centralisée | *** ## 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 |