Tecnologia etica per lucidità, memoria, comunità e crescita umana.
+
+
+ HUMANSAFE OS è un ecosistema che unisce simulazione narrativa, riflessione, missioni reali,
+ diario evolutivo e community etica per aiutare l’utente a sviluppare più presenza e più sovranità cognitiva.
+
+
+
+ Non è un social classico. Non è solo un quiz. Non è solo un gioco.
+ È un sistema unico che trasforma l’esperienza digitale in percorso.
+
+ Gli ecosistemi digitali spingono spesso reattività, distrazione e frammentazione.
+ L’essere umano si ritrova connesso ovunque, ma poco presente a sé stesso.
+
+
+
+
La risposta
+
+ HUMANSAFE usa il digitale come infrastruttura etica: uno specchio, un laboratorio
+ e una memoria del percorso, non una macchina che divora attenzione.
+
+
+
+
+
+
+
I moduli del sistema
+
+
+
+
Access Layer
+
Login
+
Porta di ingresso al sistema e ponte verso community esterne.
+ LIFENET è il simulatore narrativo di HUMANSAFE OS. Qui attraversi scenari,
+ fai scelte, ricevi riflessioni ORACLE e trasformi l’esperienza in progresso reale.
+
+ HUMANSAFE Circle non è un social classico. È uno spazio per condividere missioni,
+ riflessioni, checkpoint e richieste di aiuto senza trasformare tutto in rumore o gara.
+
+
+
+
+
diff --git a/dist-mobile/user-data/demo_profile.json b/dist-mobile/user-data/demo_profile.json
new file mode 100644
index 0000000..24ddccf
--- /dev/null
+++ b/dist-mobile/user-data/demo_profile.json
@@ -0,0 +1,56 @@
+{
+ "name": "Messoud Demo Profile",
+ "archetype": "Cellula in Risveglio",
+ "hsi_zone": "Zona Verde",
+ "xp_total": 64,
+ "level_name": "Osservatore Lucido",
+ "last_update": "2026-03-11",
+ "badges": [
+ "Primo Risveglio",
+ "Specchio Pulito",
+ "Presenza Reale"
+ ],
+ "completed_missions": [
+ {
+ "id": "missione_01",
+ "title": "10 minuti senza schermo",
+ "description": "Resta per 10 minuti senza schermo, musica o distrazioni digitali.",
+ "reward_xp": 5,
+ "ethical_value": "presenza"
+ },
+ {
+ "id": "missione_03",
+ "title": "Conversazione piena",
+ "description": "Fai una conversazione reale senza toccare il telefono.",
+ "reward_xp": 10,
+ "ethical_value": "empatia"
+ }
+ ],
+ "reflections": [
+ {
+ "date": "2026-03-10",
+ "text": "Quando sento attrito, la tentazione di rifugiarmi nel telefono arriva prima del pensiero. Ma adesso riesco a vederla."
+ },
+ {
+ "date": "2026-03-11",
+ "text": "La presenza reale non è assenza di caos. È capacità di restare anche quando vorrei fuggire."
+ }
+ ],
+ "timeline": [
+ {
+ "date": "2026-03-09",
+ "title": "Prima scansione HSI",
+ "description": "Avvio del percorso con lettura iniziale del profilo cognitivo."
+ },
+ {
+ "date": "2026-03-10",
+ "title": "Ingresso in LIFENET",
+ "description": "Primi scenari completati e primo contatto con HUMANSAFE ORACLE."
+ },
+ {
+ "date": "2026-03-11",
+ "title": "Missione reale completata",
+ "description": "Prima azione offline registrata nel Diario di Bordo."
+ }
+ ]
+}
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
index e39af6b..4f0f9a3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,48 +1,84 @@
-# HUMANSAFE OFFICIAL DOCUMENTATION
+# HUMANSAFE Documentation
-Benvenuto nell'archivio centrale dell'ecosistema HUMANSAFE.
-Questa cartella raccoglie i **6 asset fondativi** del progetto, depositati e organizzati come base filosofica, strategica, metodologica e istituzionale.
+Questa cartella è l'archivio documentale di riferimento di `Humansafe-Core`.
-> Nota di ordine: in alcune versioni precedenti del progetto si parlava di “5 pilastri”.
-> Per chiarezza operativa, in questo repository adottiamo la formula corretta: **6 asset fondativi**.
+Serve a tenere insieme tre piani diversi ma collegati:
-## I 6 asset fondativi
+- documenti fondativi dell'identità HUMANSAFE
+- architettura reale del repository e del prototipo HUMANSAFE OS
+- strategia di convergenza verso MVP, PWA e futura espansione ecosistemica
-### 1. [HUMANSAFE MANIFESTO](01_Manifesto.md)
-La costituzione etica del Nuovo Umanesimo.
+## 1. Asset fondativi
-### 2. [HUMANSAFE GLOBAL CHARTER](02_Global_Charter.md)
-La carta dei diritti cognitivi dell'essere umano.
+I 6 asset fondativi restano il nucleo culturale e istituzionale del progetto:
-### 3. [HUMANSAFE STANDARD (B2B)](03_B2B_Standard.md)
-Il protocollo di medicina organizzativa per aziende, enti e reti professionali.
+1. `manifesto/01_Manifesto.md`
+2. `legal/02_Global_Charter.md`
+3. `strategy/03_B2B_Standard.md`
+4. `architecture/04_Cognitive_Framework.md`
+5. `pitch/05_Public_Report.md`
+6. `architecture/06_Lifenet_Game_Design.md`
-### 4. [HUMANSAFE COGNITIVE FRAMEWORK](04_Cognitive_Framework.md)
-Il manuale tecnico sugli archetipi, le micro-azioni e la metodologia di attivazione.
+Nota di coerenza:
-### 5. [HUMANSAFE PUBLIC REPORT](05_Public_Report.md)
-Il libro bianco istituzionale per scuole, comuni, sanità pubblica e terzo settore.
+- `6 asset fondativi` = corpus documentale
+- `5 archetipi` = modello umano
-### 6. [LIFENET: THE HUMANSAFE SIMULATOR](06_Lifenet_Game_Design.md)
-Il Game Design Document del simulatore narrativo HUMANSAFE.
+## 2. Documenti architetturali e strategici aggiornati
-## Uso della cartella
+### Manifesto
-Questa directory serve a tre scopi:
+- [HUMANSAFE Identity System](./manifesto/HUMANSAFE_IDENTITY_SYSTEM.md)
-1. **Fondazione** → chiarisce la visione del progetto
-2. **Validazione** → rende leggibile il metodo verso partner e istituzioni
-3. **Produzione** → alimenta sito, pitch, certificazioni, training e sviluppi software
+### Architecture
-## Regola di coerenza
+- [HUMANSAFE Ecosystem Master](./architecture/HUMANSAFE_ECOSYSTEM_MASTER.md)
+- [HUMANSAFE Core Real State](./architecture/HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE Module Map](./architecture/HUMANSAFE_MODULE_MAP.md)
+- [HUMANSAFE Data Flow](./architecture/HUMANSAFE_DATA_FLOW.md)
+- [HUMANSAFE Onboarding Flow](./architecture/HUMANSAFE_ONBOARDING_FLOW.md)
-Nel progetto HUMANSAFE distinguiamo chiaramente:
+### Strategy
-- **6 asset fondativi** → documenti del repository
-- **5 archetipi** → modello umano del framework cognitivo
+- [HUMANSAFE MVP Roadmap](./strategy/HUMANSAFE_MVP_ROADMAP.md)
+- [HUMANSAFE Future Expansion](./strategy/HUMANSAFE_FUTURE_EXPANSION.md)
-Tenere separate queste due cose evita confusione strategica e comunicativa.
+## 3. Struttura della cartella
----
+### `manifesto/`
-Per partnership, documenti formali, impaginati o versioni PDF istituzionali, usare questa cartella come sorgente madre.
+Visione, missione, identità e principi etici.
+
+### `architecture/`
+
+Architettura dichiarata e architettura realmente implementata del core.
+
+### `strategy/`
+
+Roadmap, priorità, stato MVP e traiettoria di espansione.
+
+### `pitch/`
+
+Materiali di presentazione e public narrative per istituzioni e partner.
+
+### `legal/`
+
+Charter, principi di tutela e standard etico-politici del progetto.
+
+## 4. Scopo di questa documentazione
+
+Questa documentazione deve rendere HUMANSAFE:
+
+- leggibile per nuovi contributori
+- credibile per partner e stakeholder
+- sviluppabile senza rifare da zero il progetto
+- coerente fra visione, codice e roadmap
+
+## 5. Regola editoriale
+
+Quando visione e codice divergono, i documenti di questa cartella devono dichiararlo esplicitamente usando quattro stati:
+
+- implementato
+- parziale
+- pianificato
+- concettuale
diff --git a/docs/04_Cognitive_Framework.md b/docs/architecture/04_Cognitive_Framework.md
similarity index 100%
rename from docs/04_Cognitive_Framework.md
rename to docs/architecture/04_Cognitive_Framework.md
diff --git a/docs/06_Lifenet_Game_Design.md b/docs/architecture/06_Lifenet_Game_Design.md
similarity index 100%
rename from docs/06_Lifenet_Game_Design.md
rename to docs/architecture/06_Lifenet_Game_Design.md
diff --git a/docs/architecture/HUMANSAFE_CORE_REAL_STATE.md b/docs/architecture/HUMANSAFE_CORE_REAL_STATE.md
new file mode 100644
index 0000000..514c662
--- /dev/null
+++ b/docs/architecture/HUMANSAFE_CORE_REAL_STATE.md
@@ -0,0 +1,268 @@
+# HUMANSAFE Core Real State
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Ecosystem Master](./HUMANSAFE_ECOSYSTEM_MASTER.md)
+- [HUMANSAFE Module Map](./HUMANSAFE_MODULE_MAP.md)
+- [HUMANSAFE Data Flow](./HUMANSAFE_DATA_FLOW.md)
+- [HUMANSAFE MVP Roadmap](../strategy/HUMANSAFE_MVP_ROADMAP.md)
+
+## 1. Sintesi
+
+`Humansafe-Core` è oggi un repository ibrido:
+
+- documentazione fondativa molto sviluppata
+- prototipo web statico navigabile
+- data layer JSON riusabile
+- moduli JS ancora in convergenza
+- espansioni territoriali e blockchain solo come seme concettuale o proof of concept
+
+## 2. Struttura reale del repository
+
+| Percorso | Ruolo reale | Stato |
+|---|---|---|
+| `index.html` | Home Hub / landing del prototipo | Implementato |
+| `login.html` | Access Layer demo | Implementato |
+| `hsi.html` | HSI Diagnostic page | Presente ma work in progress |
+| `lifenet_game.html` | Simulation Layer | Implementato |
+| `journal.html` | Journal Layer | Implementato |
+| `profile.html` | Profile Layer | Implementato |
+| `social.html` | Circle / Community Layer | Implementato |
+| `modules/profile-engine.js` | Motore profilo condiviso | Presente ma incoerente |
+| `modules/hsi-engine.js` | Motore HSI web | Presente ma work in progress |
+| `game-data/` | Dati di scenari, livelli, missioni, archetipi, zone | Implementato |
+| `core-algorithm/` | Modello HSI Python e documento formula | Implementato come riferimento tecnico |
+| `interactive-simulation/` | CLI diagnostica più vecchia | Legacy/prototipo |
+| `user-data/demo_profile.json` | Profilo demo offline/documentale | Non usato dal frontend live |
+| `manifest.json` | Manifest PWA | Abbozzato |
+| `service-worker.js` | Cache offline base | Abbozzato |
+| `modules/franchising-sociale/` | Radici Umane | Concettuale + script |
+| `modules/iself-smart-contract/` | Proof of concept ISELF | Concettuale/POC |
+| `tools/generate_scenarios.py` | Generatore scenari AI | Utility sperimentale |
+| `docs/` | Base documentale fondativa e strategica | Ricca ma disallineata in punti chiave |
+
+## 3. Stato del worktree corrente
+
+Il repository non è in uno stato neutro.
+
+Il worktree corrente mostra modifiche non ancora consolidate proprio sui moduli più centrali:
+
+- `hsi.html` è presente come file aggiunto
+- `modules/hsi-engine.js` è presente come file aggiunto
+- `modules/profile-engine.js` contiene marker di merge non risolti
+
+Questa informazione è importante perché influenza la fotografia architetturale:
+
+- l'idea del nuovo onboarding HSI esiste
+- ma non è ancora una base stabile da considerare "implementata"
+
+## 4. Architettura implementata oggi
+
+### Home Hub
+
+`index.html` funge da hub principale e presenta HUMANSAFE OS come sistema composto da:
+
+- login
+- LIFENET
+- journal
+- profile
+- circle
+- data layer
+- profile engine
+- PWA
+
+Valutazione reale:
+
+- la navigazione esiste
+- la rappresentazione dello stato è più ottimistica della realtà runtime
+
+### Access Layer
+
+`login.html` è un gateway demo:
+
+- nessuna autenticazione reale
+- provider esterni simulati come pulsanti verso `profile.html`
+- link a Telegram e HUMANSYNC Facebook
+
+Valutazione reale:
+
+- modulo utile come placeholder di visione
+- non è ancora un vero auth layer
+
+### LIFENET
+
+`lifenet_game.html` è il modulo software più solido del prototipo.
+
+Fa realmente queste cose:
+
+- carica scenari da `game-data/scenarios/*.json`
+- carica livelli da `game-data/progression/levels.json`
+- carica missioni da `game-data/missions/missions_01.json`
+- aggiorna XP sessione
+- aggiorna badge, missioni, riflessioni e timeline tramite profile engine
+
+Limiti:
+
+- dipende dal motore profilo instabile
+- non usa ancora un motore scenari separato
+- non salva ancora statistiche invisibili come entità persistenti canoniche
+
+### Journal, Profile, Circle
+
+Questi tre moduli esistono come interfacce leggibili e coerenti con la visione.
+
+Dipendono però tutti dallo stesso motore profilo.
+
+Conseguenza:
+
+- sono moduli concettualmente centrati
+- ma tecnicamente fragili finché il contratto dati del profilo non viene stabilizzato
+
+### HSI Diagnostic
+
+Il modulo HSI esiste in forma emergente con `hsi.html` e `modules/hsi-engine.js`, ma il suo stato attuale non è stabile per tre motivi:
+
+1. non è integrato nel flusso principale della home
+2. il file HTML contiene artefatti di scrittura shell nel worktree attuale
+3. il motore profilo da cui dipende è in conflitto
+
+## 5. Divergenze architetturali principali
+
+### 5.1 Profile Engine non canonico
+
+È il problema più serio.
+
+Nel file `modules/profile-engine.js` convivono due versioni incompatibili:
+
+- una API "storica" usata da `lifenet_game.html`, `journal.html`, `profile.html` e `social.html`
+- una API "nuova" pensata per HSI, con schema diverso e nomi funzione diversi
+
+Differenze concrete:
+
+- `loadProfile` vs `getUserProfile`
+- `saveProfile` vs `saveUserProfile`
+- badge come stringhe vs badge come oggetti
+- riflessioni con `date` vs `created_at`
+- timeline con `date/title/description` vs `id/type/title/description/created_at`
+- zone e archetipi italiani vs inglesi
+
+### 5.2 HSI non allineato in tutto il repository
+
+Esistono almeno tre versioni del modello HSI:
+
+- `core-algorithm/hsi_calculator.py`: formula B2B con zone rosso/grigio/verde
+- `game-data/signals/hsi_zones.json`: cinque zone più granulari
+- `modules/hsi-engine.js`: zone `grey/amber/blue/gold` e archetipi `observer/guardian/builder/explorer`
+
+Conclusione:
+
+- HSI è concettualmente centrale
+- ma non esiste ancora un'unica semantica condivisa
+
+### 5.3 Onboarding reale diverso da onboarding dichiarato
+
+La formula ufficiale del sistema parte dalla diagnosi.
+
+Il flusso realmente esposto dalla home invece privilegia:
+
+- accesso demo
+- LIFENET
+- journal
+- profile
+- circle
+
+Risultato:
+
+- la diagnosi esiste come idea e pagina
+- ma non è ancora la porta principale del sistema
+
+### 5.4 Documentazione e codice non sempre coincidono
+
+Esempi:
+
+- `docs/architecture/06_Lifenet_Game_Design.md` parla di React Native / Expo, mentre il prodotto reale è oggi una web app statica
+- `docs/architecture/HUMANSAFE_OS.md` marca journal/profile come futuri, ma oggi esistono
+- `README.md` e `struttura-humansafe.txt` riportano strutture cartella non più aggiornate
+- `docs/README.md` conteneva testo duplicato e livelli di documentazione sovrapposti
+
+### 5.5 Tooling non allineato al repository corrente
+
+`tools/generate_scenarios.py` scrive e legge `game-data/scenario_*.json`, ma gli scenari attuali risiedono in `game-data/scenarios/`.
+
+Quindi:
+
+- l'idea del generatore è utile
+- l'utility non è allineata al path reale del dataset
+
+### 5.6 PWA solo nominalmente pronta
+
+`manifest.json` e `service-worker.js` esistono, ma:
+
+- il manifest usa `logo_humansafe.jpg` dichiarandolo come `image/png`
+- il service worker cachea solo alcune pagine
+- non include moduli JS, JSON, login/profile/hsi o risorse dati
+- usa percorsi assoluti che possono essere fragili in deploy sotto sottopath
+
+## 6. Stato MVP reale
+
+### Ciò che già qualifica il progetto come MVP concettualmente leggibile
+
+- identità forte e differenziata
+- hub navigabile
+- simulazione narrativa funzionante
+- data pack iniziale di scenari, missioni, livelli, archetipi e zone
+- journal/profile/circle come estensioni del percorso
+
+### Ciò che blocca un MVP stabile
+
+- profile engine non risolto
+- contratto dati non canonico
+- HSI non integrato e semanticamente incoerente
+- PWA incompleta
+- assenza di auth reale e sync
+
+## 7. Moduli classificati per stato
+
+### Implementato
+
+- Home Hub
+- Access demo
+- LIFENET
+- Journal UI
+- Profile UI
+- Circle UI
+- Data packs JSON
+- HSI Python reference
+
+### Parziale
+
+- Profile Engine
+- HSI web diagnostic
+- PWA
+- community persistence
+- scenario generation tooling
+
+### Concettuale
+
+- HUMANSAFE LIFE come prodotto separato
+- backend
+- mobile app
+- centri HUMANSAFE
+- Quaderno di Sessione
+- rivista e collane editoriali
+- moduli terze parti AI-guided
+
+## 8. Lettura architetturale finale
+
+La realtà del repository non smentisce la visione HUMANSAFE.
+
+La conferma però in una forma molto precisa:
+
+- la visione è più avanti del software
+- il software ha già un nucleo autentico
+- il punto da consolidare non è la creatività del progetto, ma la sua convergenza tecnica
+
+Il repository non va rifatto da zero.
+
+Va portato da "prototipo identitariamente forte ma incoerente nei contratti" a "MVP coerente con una fonte dati canonica".
diff --git a/docs/architecture/HUMANSAFE_DATA_FLOW.md b/docs/architecture/HUMANSAFE_DATA_FLOW.md
new file mode 100644
index 0000000..b7c6b2b
--- /dev/null
+++ b/docs/architecture/HUMANSAFE_DATA_FLOW.md
@@ -0,0 +1,226 @@
+# HUMANSAFE Data Flow
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Module Map](./HUMANSAFE_MODULE_MAP.md)
+- [HUMANSAFE Core Real State](./HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE MVP Roadmap](../strategy/HUMANSAFE_MVP_ROADMAP.md)
+
+## 1. Flusso dati reale oggi
+
+Il prototipo HUMANSAFE usa due famiglie di dati:
+
+### Dati strutturali di sistema
+
+Provengono da file statici in `game-data/`.
+
+Esempi:
+
+- scenari
+- missioni
+- livelli
+- archetipi
+- zone HSI
+
+### Dati utente runtime
+
+Sono pensati per vivere nel browser, soprattutto in `localStorage`, attraverso `modules/profile-engine.js`.
+
+Esempi:
+
+- nome profilo
+- archetipo
+- zona HSI
+- HSI value
+- XP totale
+- livello
+- badge
+- missioni completate
+- riflessioni
+- timeline
+- community posts
+
+## 2. Diagramma del flusso attuale
+
+```text
+game-data/*.json
+|- scenarios ------> lifenet_game.html
+|- missions -------^
+|- levels ----------^
+|- archetypes ------> reference only / partial integration
+`- hsi_zones -------> reference only / partial integration
+
+hsi.html ---------> hsi-engine.js ---------\
+lifenet_game.html --------------------------> profile-engine.js -> localStorage
+journal.html -------------------------------/
+profile.html ------------------------------/
+social.html -------------------------------/
+```
+
+## 3. Origine dei dati per modulo
+
+| Modulo | Input principali | Output principali |
+|---|---|---|
+| `hsi.html` | risposte utente | HSI, zona, archetipo, badge, missione, timeline |
+| `lifenet_game.html` | scenari, missioni, livelli, scelte utente | XP, badge, missioni, riflessione, timeline |
+| `journal.html` | profilo centralizzato | render di missioni, riflessioni, timeline |
+| `profile.html` | profilo centralizzato | render di stato, badge, missioni |
+| `social.html` | profilo centralizzato, input utente | community posts, riflessioni, timeline, badge |
+
+## 4. Stato attuale della "single source of truth"
+
+In teoria la fonte unica dei dati utente dovrebbe essere `modules/profile-engine.js`.
+
+In pratica non è ancora una single source of truth affidabile perché contiene due modelli concorrenti.
+
+### Modello A: storico, compatibile con UI attuale
+
+Campi principali:
+
+- `name`
+- `provider`
+- `archetype`
+- `hsi_zone`
+- `hsi_value`
+- `xp_total`
+- `level_name`
+- `last_update`
+- `badges` come array di stringhe
+- `completed_missions`
+- `reflections` con `{ date, text }`
+- `timeline` con `{ date, title, description }`
+- `community_posts`
+
+Compatibilità:
+
+- coerente con `profile.html`
+- coerente con `journal.html`
+- coerente con `social.html`
+- coerente con `lifenet_game.html`
+
+### Modello B: nuovo, pensato per HSI evoluto
+
+Campi aggiuntivi o differenti:
+
+- `diagnostic_summary`
+- `diagnostic_completed_at`
+- `schema_version`
+- `created_at`
+- `updated_at`
+- badge come oggetti
+- riflessioni con `created_at`
+- timeline con `type` e `created_at`
+
+Compatibilità:
+
+- coerente con il nuovo `modules/hsi-engine.js`
+- non coerente con le UI attuali senza adapter
+
+## 5. Incoerenze dati principali
+
+### 5.1 Badge
+
+- UI attuali: stringhe semplici
+- nuova branch HSI: oggetti con `id`, `name`, `description`
+
+### 5.2 Riflessioni
+
+- UI attuali: `{ date, text }`
+- nuovo HSI: `{ id, text, created_at }`
+
+### 5.3 Timeline
+
+- UI attuali: `{ date, title, description }`
+- nuovo HSI: `{ id, type, title, description, created_at }`
+
+### 5.4 HSI zone
+
+Nel repository convivono:
+
+- `Zona Rossa / Zona Grigia / Zona Verde`
+- cinque zone granulari in `hsi_zones.json`
+- `grey / amber / blue / gold`
+
+### 5.5 Archetipi
+
+Nel repository convivono:
+
+- `Cellula Dormiente`, `Cellula Reattiva`, `Cellula Osservatrice`, `Cellula in Risveglio`, `Nucleo Sovrano`
+- `observer`, `guardian`, `builder`, `explorer`
+- versione CLI a tre archetipi
+
+## 6. `user-data/demo_profile.json`: cosa rappresenta davvero
+
+`user-data/demo_profile.json` è utile come:
+
+- esempio di shape dati desiderata
+- materiale documentale
+- possibile seed manuale
+
+Non è però la fonte runtime dei moduli web attuali.
+
+Il frontend non lo carica.
+
+## 7. Valutazione per entità
+
+| Entità | Stato | Fonte reale |
+|---|---|---|
+| Scenari | Coerente | `game-data/scenarios/*.json` |
+| Missioni | Coerente | `game-data/missions/missions_01.json` |
+| Livelli | Coerente | `game-data/progression/levels.json` |
+| HSI formula | Non canonica | Python/docs/JS in disaccordo |
+| Profilo utente | Centrale ma non canonico | `localStorage` via `profile-engine.js` |
+| Timeline | Presente ma non standardizzata | `profile-engine.js` |
+| Badge | Presenti ma non standardizzati | `profile-engine.js` |
+| Community posts | Demo locale | `profile-engine.js` |
+
+## 8. Contratto dati consigliato per la convergenza
+
+Il passo più sicuro non è reinventare la struttura, ma stabilizzare il modello storico e arricchirlo gradualmente.
+
+Direzione consigliata:
+
+- mantenere i campi usati dalle UI attuali
+- aggiungere metadati nuovi in modo backward compatible
+- introdurre adapter, non rotture
+
+Esempio di direzione sicura:
+
+```text
+profile
+|- id
+|- name
+|- provider
+|- archetype_id
+|- archetype_label
+|- hsi_zone_id
+|- hsi_zone_label
+|- hsi_value
+|- xp_total
+|- level_id
+|- level_name
+|- badges[]
+|- completed_missions[]
+|- reflections[]
+|- timeline[]
+|- community_posts[]
+|- diagnostic_summary
+|- created_at
+`- updated_at
+```
+
+Nota importante:
+
+- `badges`, `missions`, `reflections` e `timeline` dovrebbero diventare oggetti strutturati
+- ma con rendering compatibile anche con il formato legacy
+
+## 9. Prima del backend
+
+Prima di introdurre API o sync cloud, il progetto deve chiudere tre punti:
+
+1. schema profilo unico
+2. vocabolario HSI unico
+3. passaggio dati unico fra HSI, LIFENET, journal, profile e circle
+
+Se questo non avviene prima del backend, la complessità verrà solo spostata lato server.
diff --git a/docs/architecture/HUMANSAFE_ECOSYSTEM_MASTER.md b/docs/architecture/HUMANSAFE_ECOSYSTEM_MASTER.md
new file mode 100644
index 0000000..aec5b33
--- /dev/null
+++ b/docs/architecture/HUMANSAFE_ECOSYSTEM_MASTER.md
@@ -0,0 +1,168 @@
+# HUMANSAFE Ecosystem Master
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Identity System](../manifesto/HUMANSAFE_IDENTITY_SYSTEM.md)
+- [HUMANSAFE Core Real State](./HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE Module Map](./HUMANSAFE_MODULE_MAP.md)
+- [HUMANSAFE MVP Roadmap](../strategy/HUMANSAFE_MVP_ROADMAP.md)
+
+## 1. Executive summary
+
+Il repository `Humansafe-Core` contiene un ecosistema in cui la visione è già ampia, ma il software implementato è ancora un prototipo locale e modulare.
+
+Il progetto reale si può leggere così:
+
+```text
+HUMANSAFE
+|- HUMANSAFE LIFE
+| |- orientamento
+| |- layer editoriale e culturale
+| |- relazioni, rivista, quaderni, supporto umano
+|
+|- HUMANSAFE OS
+| |- accesso
+| |- diagnosi HSI
+| |- simulazione LIFENET
+| |- journal
+| |- profile
+| |- circle/community
+| |- PWA
+| |- futuro backend/mobile
+|
+`- Nodi di espansione
+ |- Radici Umane
+ |- ISELF accountability layer
+ |- futuri centri HUMANSAFE
+ `- moduli per enti allineati
+```
+
+## 2. Filosofia di sistema
+
+La formula che il repository esprime con maggiore coerenza è:
+
+```text
+diagnosi -> simulazione -> riflessione -> missione -> memoria -> evoluzione -> community
+```
+
+Non è solo una sequenza UX. È la definizione operativa del prodotto.
+
+### Perché HUMANSAFE non è un game o un social tradizionale
+
+- La diagnosi non serve a segmentare per advertising ma a orientare il percorso.
+- La simulazione non serve a intrattenere all'infinito ma a rendere leggibili automatismi e scelte.
+- Le missioni spingono fuori dallo schermo, non dentro.
+- Il journal serve come memoria evolutiva, non come feed.
+- La community è progettata come Circle etico, non come arena di status.
+
+## 3. Stato per layer
+
+| Layer | Ruolo | Stato nel repo |
+|---|---|---|
+| HUMANSAFE identity | Visione, etica, narrazione madre | Forte e documentata |
+| HUMANSAFE LIFE | Editoriale, orientamento, rivista, supporto | Concettuale, non separato come prodotto |
+| HUMANSAFE OS | Sistema software web/PWA | Parzialmente implementato |
+| Access Layer | Porta di ingresso | Implementato come demo gateway |
+| HSI Diagnostic | Lettura iniziale | Presente ma instabile e non integrato nel flusso principale |
+| LIFENET | Simulazione narrativa | Implementato e funzionante come modulo più maturo |
+| Journal | Memoria e riflessioni | Implementato come viewer del profilo |
+| Profile | Centro identitario | Implementato come viewer del profilo |
+| Circle | Community etica | Implementato in forma locale demo |
+| Profile/Data Engine | Fonte unica dei dati utente | Parziale e attualmente incoerente |
+| PWA Layer | Installabilità e cache | Abbozzato |
+| Backend | Sync, auth, cloud, multi-device | Non implementato |
+| Mobile packaging | Android/native bridge | Non implementato |
+| Radici Umane | Nodo territoriale | Concettuale con script di supporto |
+| ISELF | Accountability layer | Proof of concept non integrato |
+
+## 4. Dove il repository è forte
+
+Il repository è forte in quattro aree:
+
+- identità culturale e posizione etica
+- qualità del linguaggio di prodotto
+- struttura modulare per pagine e dataset
+- chiarezza della direzione futura
+
+## 5. Dove il repository è fragile
+
+Il repository è fragile in quattro aree:
+
+- assenza di un contratto dati canonico fra HSI, profilo, journal, circle e livelli
+- drift tra documentazione concettuale e codice eseguibile
+- onboarding reale non allineato alla formula diagnosi-prima
+- PWA e stato utente non ancora pronti per esperienza stabile multipagina
+
+## 6. Perimetro reale di `Humansafe-Core`
+
+Il repository oggi copre tre categorie diverse, che è essenziale non confondere:
+
+### A. Implementato
+
+- pagine web statiche navigabili
+- caricamento dati da JSON
+- persistenza locale browser-side prevista tramite `localStorage`
+- prime logiche di XP, badge, missioni, riflessioni e timeline
+
+### B. Parziale
+
+- HSI web diagnostic
+- profile engine
+- PWA installabile e offline
+- accesso reale
+- community persistente
+
+### C. Concettuale o futuro
+
+- HUMANSAFE LIFE come prodotto distinto
+- rivista "La Solita Attesa"
+- serie letteraria "La Cellula di Messoud Sebbahi"
+- Quaderno di Sessione / Session Report PDF
+- centri HUMANSAFE
+- moduli per associazioni o enti allineati
+- backend e mobile app completi
+
+## 7. Modello ecosistemico consigliato
+
+Per mantenere il progetto leggibile anche quando crescerà, HUMANSAFE va pensato come sistema a cerchi concentrici:
+
+### Cerchio 1: Core experience
+
+- accesso
+- HSI
+- LIFENET
+- journal
+- profile
+- circle
+
+### Cerchio 2: Infrastructure and trust
+
+- profile engine
+- data contracts
+- PWA
+- futuro backend
+- futuro auth layer
+
+### Cerchio 3: Cultural and territorial expansion
+
+- HUMANSAFE LIFE
+- magazine
+- quaderni
+- centri
+- partnership
+- moduli white-label o AI-guided per realtà allineate
+
+## 8. Conclusione architetturale
+
+HUMANSAFE non va ripensato come app generica.
+
+Va invece consolidato come:
+
+- ecosistema etico con identità forte
+- prototipo software già leggibile
+- piattaforma modulare ancora in convergenza
+
+La priorità non è aggiungere altro.
+
+La priorità è far convergere il software attuale sulla promessa già espressa dalla visione.
diff --git a/docs/architecture/HUMANSAFE_MODULE_MAP.md b/docs/architecture/HUMANSAFE_MODULE_MAP.md
new file mode 100644
index 0000000..b879173
--- /dev/null
+++ b/docs/architecture/HUMANSAFE_MODULE_MAP.md
@@ -0,0 +1,153 @@
+# HUMANSAFE Module Map
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Core Real State](./HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE Data Flow](./HUMANSAFE_DATA_FLOW.md)
+- [HUMANSAFE Onboarding Flow](./HUMANSAFE_ONBOARDING_FLOW.md)
+
+## 1. Mappa dei moduli live nel repository
+
+| Modulo | File principali | Funzione | Stato | Note |
+|---|---|---|---|---|
+| Home Hub | `index.html` | Hub di ingresso e mappa del sistema | Implementato | Non espone ancora HSI come entry primaria |
+| Access Layer | `login.html` | Gateway demo e ponte verso community esterne | Implementato | Nessuna auth reale |
+| HSI Diagnostic | `hsi.html`, `modules/hsi-engine.js` | Diagnosi iniziale e aggiornamento profilo | Parziale | Worktree sporco e non integrato |
+| LIFENET | `lifenet_game.html` | Simulazione narrativa con XP, missioni, ORACLE | Implementato | Modulo più vicino al cuore MVP |
+| Journal Layer | `journal.html` | Memoria del percorso, riflessioni, timeline | Implementato | Viewer dipendente dal profilo |
+| Profile Layer | `profile.html` | Identità evolutiva, livelli, badge, stato utente | Implementato | Viewer dipendente dal profilo |
+| Circle Layer | `social.html` | Community etica locale/demo | Implementato | Persistenza locale, nessun backend |
+| Profile Engine | `modules/profile-engine.js` | Stato utente condiviso | Parziale/critico | Merge conflict e schema non canonico |
+| PWA Layer | `manifest.json`, `service-worker.js` | Installabilità e cache offline | Abbozzato | Copertura incompleta |
+| Core Algorithm | `core-algorithm/*` | Riferimento matematico HSI | Implementato | Non ancora allineato al JS |
+| Game Data | `game-data/*` | Scenari, missioni, livelli, archetipi, zone | Implementato | Buona base contenutistica |
+| Demo User Data | `user-data/demo_profile.json` | Profilo dimostrativo | Documentale | Non usato dai moduli live |
+
+## 2. Data packs
+
+### Scenari
+
+File:
+
+- `game-data/scenarios/scenario_01.json`
+- `game-data/scenarios/scenario_02.json`
+- `game-data/scenarios/scenario_03.json`
+- `game-data/scenarios/scenario_04.json`
+
+Uso reale:
+
+- caricati in `lifenet_game.html`
+- ogni scenario contiene `setup`, `question`, `choices`, `oracle_intervention`, `stat_changes`
+
+Valutazione:
+
+- dataset coerente con l'identità HUMANSAFE
+- base già riutilizzabile per espansione
+
+### Missioni
+
+File:
+
+- `game-data/missions/missions_01.json`
+
+Uso reale:
+
+- missioni suggerite da LIFENET
+- collegate a reward XP e valore etico
+
+### Livelli
+
+File:
+
+- `game-data/progression/levels.json`
+
+Uso reale:
+
+- progression symbolica dal livello 1 al 5
+- integrata nella UI di LIFENET e Profile
+
+### Archetipi
+
+File:
+
+- `game-data/profiles/archetypes.json`
+
+Uso reale:
+
+- dataset di riferimento concettuale
+- non ancora integrato in modo consistente con il nuovo HSI web
+
+### Zone HSI
+
+File:
+
+- `game-data/signals/hsi_zones.json`
+
+Uso reale:
+
+- base semantica importante
+- non ancora la fonte canonica del motore HSI web
+
+## 3. Moduli concettuali o satelliti
+
+| Modulo | File | Stato | Ruolo |
+|---|---|---|---|
+| Radici Umane | `modules/franchising-sociale/*` | Concettuale + script | Nodo territoriale, peace business, ambassador model |
+| ISELF | `modules/iself-smart-contract/ISELF_Token.sol` | Proof of concept | Accountability layer non speculativo |
+| Interactive Simulation CLI | `interactive-simulation/cell_awakening.py` | Legacy/prototipo | Primo test diagnostico da terminale |
+| Scenario Generator | `tools/generate_scenarios.py` | Sperimentale | Futuro authoring assistito da AI |
+
+## 4. Moduli orfani o legacy
+
+### `assets/js/share-quiz.js`
+
+È un asset legacy che aggancia una funzione `showResults()` non presente nei moduli correnti.
+
+Interpretazione:
+
+- probabile residuo di una versione precedente del quiz
+- non parte del percorso principale attuale
+
+### `manifest.json.save`
+
+È un backup o artefatto manuale, non una parte del runtime.
+
+### `struttura-humansafe.txt`
+
+È una fotografia vecchia della struttura repo e non corrisponde più all'albero reale.
+
+## 5. Moduli futuri già leggibili nella visione
+
+Anche se non hanno ancora file dedicati, la repo rende già evidente la futura necessità di questi moduli:
+
+- HUMANSAFE LIFE come layer editoriale e relazionale
+- Quaderno di Sessione / Session Report PDF
+- rivista "La Solita Attesa"
+- collana "La Cellula di Messoud Sebbahi"
+- backend sync/auth
+- packaging Android o native bridge
+- moduli esterni per enti e associazioni allineate
+
+## 6. Relazioni operative tra i moduli live
+
+```text
+index
+|- login
+|- lifenet_game -> profile-engine -> localStorage
+|- journal -> profile-engine -> localStorage
+|- profile -> profile-engine -> localStorage
+`- social -> profile-engine -> localStorage
+
+hsi -> hsi-engine -> profile-engine -> localStorage
+
+lifenet_game -> fetch(game-data/scenarios, missions, levels)
+```
+
+## 7. Lettura finale
+
+Il repository non è un insieme casuale di pagine. È già una mappa modulare credibile.
+
+La criticità non è la mancanza di moduli.
+
+La criticità è che i moduli software centrali esistono, ma non sono ancora tutti connessi a una grammatica dati unica.
diff --git a/docs/architecture/HUMANSAFE_ONBOARDING_FLOW.md b/docs/architecture/HUMANSAFE_ONBOARDING_FLOW.md
new file mode 100644
index 0000000..99e18d0
--- /dev/null
+++ b/docs/architecture/HUMANSAFE_ONBOARDING_FLOW.md
@@ -0,0 +1,144 @@
+# HUMANSAFE Onboarding Flow
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Identity System](../manifesto/HUMANSAFE_IDENTITY_SYSTEM.md)
+- [HUMANSAFE Data Flow](./HUMANSAFE_DATA_FLOW.md)
+- [HUMANSAFE MVP Roadmap](../strategy/HUMANSAFE_MVP_ROADMAP.md)
+
+## 1. Flusso ideale dichiarato dal progetto
+
+La formula madre del progetto è:
+
+```text
+diagnosi -> simulazione -> riflessione -> missione -> memoria -> evoluzione -> community
+```
+
+Tradotta in journey:
+
+1. l'utente entra
+2. completa una prima lettura HSI
+3. riceve un orientamento
+4. entra in LIFENET
+5. riceve missioni e riflessioni
+6. ritrova tutto nel journal e nel profilo
+7. se vuole, condivide nel Circle
+
+## 2. Flusso reale esposto oggi dal repository
+
+```text
+index.html
+|- login.html
+|- lifenet_game.html
+|- journal.html
+|- profile.html
+`- social.html
+
+login.html
+|- profile.html
+|- lifenet_game.html
+|- journal.html
+`- social.html
+
+hsi.html
+`- lifenet_game.html
+```
+
+Conclusione:
+
+- il modulo HSI esiste
+- ma non è ancora il primo passo del percorso pubblico
+
+## 3. Cosa succede davvero oggi
+
+### Ingresso
+
+L'utente atterra su `index.html`, legge la promessa del sistema e può:
+
+- accedere
+- aprire direttamente LIFENET
+- aprire direttamente journal, profile o circle
+
+### Accesso
+
+`login.html` non crea identità reale.
+
+Serve piuttosto come:
+
+- gateway demo
+- simulazione di futuro accesso federato
+- ponte verso community esterne
+
+### Diagnosi
+
+`hsi.html` potrebbe essere la vera fase iniziale del sistema, ma oggi non è collegata in modo forte dal percorso principale.
+
+### Simulazione
+
+LIFENET è il punto in cui la promessa HUMANSAFE diventa più concreta:
+
+- scenari
+- scelte
+- ORACLE
+- missioni suggerite
+- XP
+- aggiornamento del profilo
+
+### Memoria
+
+Journal e Profile visualizzano la memoria accumulata.
+
+### Community
+
+Circle permette una forma di condivisione etica locale, ma ancora senza rete sociale reale o backend.
+
+## 4. Gap fra onboarding ideale e onboarding reale
+
+| Fase | Ideale | Stato reale |
+|---|---|---|
+| Accesso | account persistente | demo gateway |
+| Diagnosi iniziale | primo step obbligatorio o fortemente consigliato | pagina esistente ma laterale |
+| Simulazione | subito dopo la diagnosi | accessibile anche senza diagnosi |
+| Missione | generata e tracciata | suggerita da LIFENET, tracciata localmente |
+| Memoria | profilo continuo | esiste ma dipende dal motore profilo instabile |
+| Community | condivisione etica persistente | demo locale |
+
+## 5. Onboarding minimo raccomandato prima del backend
+
+Il flusso più sicuro da portare a coerenza, senza rifare il progetto, è questo:
+
+```text
+index -> login/demo access -> hsi -> lifenet -> journal -> profile -> circle
+```
+
+Perché è il flusso più sicuro:
+
+- rispetta la filosofia già dichiarata
+- riusa tutti i moduli esistenti
+- non richiede ancora backend reale
+- rafforza il ruolo del profile engine come centro del sistema
+
+## 6. Cosa manca per renderlo stabile
+
+Mancano soprattutto:
+
+- un contratto dati unico per HSI e profilo
+- un entrypoint chiaro da home verso HSI
+- uno stato profilo coerente anche senza login reale
+- una gestione robusta di primo avvio / utente demo / ripresa sessione
+
+## 7. Decisione architetturale suggerita
+
+HUMANSAFE dovrebbe considerare l'onboarding non come "login first", ma come "orientation first".
+
+Formula:
+
+- accesso leggero
+- diagnosi significativa
+- simulazione contestuale
+- memoria crescente
+
+In questo modo il login smette di essere il centro.
+
+Il centro torna a essere il percorso umano.
diff --git a/docs/architecture/HUMANSAFE_OS.md b/docs/architecture/HUMANSAFE_OS.md
new file mode 100644
index 0000000..0238ee2
--- /dev/null
+++ b/docs/architecture/HUMANSAFE_OS.md
@@ -0,0 +1,584 @@
+\# HUMANSAFE OS
+
+
+
+\## Definizione
+
+
+
+HUMANSAFE OS è l’architettura centrale dell’ecosistema HUMANSAFE.
+
+
+
+Non è un sistema operativo nel senso tradizionale del termine, ma un sistema coordinato di strumenti, dati, percorsi e protezioni progettato per aiutare l’essere umano a vivere con maggiore lucidità, sicurezza, continuità e consapevolezza nell’era digitale.
+
+
+
+HUMANSAFE OS unisce:
+
+
+
+\- diagnosi cognitiva
+
+\- simulazione narrativa
+
+\- gamification etica
+
+\- missioni reali
+
+\- diario di bordo
+
+\- profilo evolutivo
+
+\- community
+
+\- supporto AI
+
+
+
+L’obiettivo non è intrattenere o trattenere l’utente il più a lungo possibile, ma accompagnarlo in un percorso di crescita, auto-osservazione e responsabilità.
+
+
+
+---
+
+
+
+\## Visione
+
+
+
+HUMANSAFE OS nasce per trasformare la tecnologia da ambiente dispersivo a infrastruttura di protezione e sviluppo umano.
+
+
+
+La sua funzione è creare un ecosistema dove il digitale:
+
+
+
+\- non anestetizza, ma chiarisce
+
+\- non frammenta, ma orienta
+
+\- non isola, ma connette in modo sano
+
+\- non assorbe la vita reale, ma la rafforza
+
+
+
+---
+
+
+
+\## Missione
+
+
+
+La missione di HUMANSAFE OS è offrire un sistema pratico e progressivo che aiuti persone, comunità e futuri collaboratori a:
+
+
+
+\- comprendere il proprio stato cognitivo e relazionale
+
+\- allenare presenza, lucidità e responsabilità
+
+\- tradurre intuizioni digitali in azioni reali
+
+\- crescere attraverso un percorso etico e cooperativo
+
+\- costruire continuità tra sé, gli altri e il mondo
+
+
+
+---
+
+
+
+\## Moduli principali
+
+
+
+\### 1. HSI Scan
+
+Modulo iniziale di diagnosi simbolica e cognitiva.
+
+
+
+Funzioni:
+
+\- valutazione dello stato di attenzione e reattività
+
+\- assegnazione della zona HSI
+
+\- identificazione dell’archetipo iniziale
+
+\- suggerimento di una micro-azione concreta
+
+
+
+Implementazione attuale:
+
+\- `index.html`
+
+
+
+---
+
+
+
+\### 2. LIFENET
+
+Simulatore narrativo basato su scenari, scelte e conseguenze.
+
+
+
+Funzioni:
+
+\- presentare situazioni ad attrito emotivo e cognitivo
+
+\- osservare il comportamento dell’utente nelle scelte
+
+\- aggiornare i parametri del profilo invisibile
+
+\- attivare interventi dell’HUMANSAFE ORACLE
+
+
+
+Implementazione attuale:
+
+\- `lifenet\_game.html`
+
+
+
+---
+
+
+
+\### 3. Scenario Engine
+
+Motore che gestisce scenari e conseguenze.
+
+
+
+Funzioni:
+
+\- caricare scenari JSON
+
+\- applicare cambiamenti ai parametri
+
+\- aggiornare l’esperienza narrativa
+
+\- supportare la progressione del percorso
+
+
+
+Implementazione attuale:
+
+\- `game-data/scenarios/`
+
+
+
+---
+
+
+
+\### 4. Archetype Engine
+
+Motore che gestisce gli archetipi evolutivi dell’utente.
+
+
+
+Funzioni:
+
+\- descrivere il profilo simbolico dell’utente
+
+\- collegare i risultati diagnostici a una forma leggibile
+
+\- orientare l’esperienza successiva
+
+\- rendere visibile il cambiamento del percorso
+
+
+
+Implementazione attuale:
+
+\- `game-data/profiles/archetypes.json`
+
+
+
+---
+
+
+
+\### 5. Signal Engine
+
+Motore che interpreta zone e segnali cognitivi.
+
+
+
+Funzioni:
+
+\- classificare l’HSI
+
+\- definire zone di lettura
+
+\- fornire significato ai punteggi
+
+\- trasformare i dati in linguaggio umano
+
+
+
+Implementazione attuale:
+
+\- `game-data/signals/hsi\_zones.json`
+
+
+
+---
+
+
+
+\### 6. Mission Layer
+
+Ponte tra esperienza digitale e realtà vissuta.
+
+
+
+Funzioni:
+
+\- proporre missioni offline, relazionali e riflessive
+
+\- trasformare il gioco in comportamento
+
+\- premiare azioni concrete
+
+\- rinforzare la continuità del percorso
+
+
+
+Implementazione prevista:
+
+\- `game-data/missions/`
+
+
+
+---
+
+
+
+\### 7. Progression Layer
+
+Motore di gamification etica.
+
+
+
+Funzioni:
+
+\- gestire XP simbolici
+
+\- definire livelli
+
+\- assegnare badge
+
+\- rendere visibile il progresso senza creare dipendenza tossica
+
+
+
+Implementazione prevista:
+
+\- `game-data/progression/`
+
+
+
+---
+
+
+
+\### 8. Journal Layer
+
+Sistema di memoria ed evoluzione personale.
+
+
+
+Funzioni:
+
+\- salvare scelte, missioni e progressi
+
+\- costruire una timeline personale
+
+\- trasformare l’esperienza in continuità
+
+\- rendere il cambiamento osservabile nel tempo
+
+
+
+Implementazione prevista:
+
+\- `user-data/`
+
+\- future pagine `journal.html` e `profile.html`
+
+
+
+---
+
+
+
+\### 9. AI Coach / ORACLE Layer
+
+Livello di accompagnamento e interpretazione.
+
+
+
+Funzioni:
+
+\- rileggere il percorso
+
+\- suggerire missioni o riflessioni
+
+\- spiegare pattern comportamentali
+
+\- supportare lucidità e orientamento
+
+
+
+Vincoli:
+
+\- non sostituisce terapeuti o medici
+
+\- non manipola l’utente
+
+\- non deve creare dipendenza
+
+\- agisce come guida, non come padrone
+
+
+
+---
+
+
+
+\### 10. Community Layer
+
+Spazio cooperativo dell’ecosistema.
+
+
+
+Funzioni:
+
+\- creare continuità tra utenti
+
+\- sostenere missioni collettive
+
+\- rendere possibile la cooperazione
+
+\- creare nodi umani locali e digitali
+
+
+
+Prime forme realistiche:
+
+\- canale Telegram
+
+\- gruppo Telegram
+
+\- future stanze cooperative HUMANSAFE
+
+
+
+---
+
+
+
+\## Flusso utente
+
+
+
+\### Fase 1 — Ingresso
+
+L’utente entra in HUMANSAFE tramite il modulo diagnostico.
+
+
+
+\### Fase 2 — Lettura iniziale
+
+Il sistema restituisce:
+
+\- HSI
+
+\- zona
+
+\- archetipo
+
+\- micro-azione iniziale
+
+
+
+\### Fase 3 — Simulazione
+
+L’utente entra in LIFENET e affronta scenari.
+
+
+
+\### Fase 4 — Aggiornamento profilo
+
+Il sistema aggiorna:
+
+\- parametri interni
+
+\- XP
+
+\- livello
+
+\- eventuali badge
+
+\- missioni consigliate
+
+
+
+\### Fase 5 — Azione reale
+
+L’utente esegue una missione nella vita reale.
+
+
+
+\### Fase 6 — Diario
+
+Il sistema registra il percorso e la sua evoluzione.
+
+
+
+\### Fase 7 — Community
+
+L’utente può entrare in una rete cooperativa e condividere il proprio cammino.
+
+
+
+---
+
+
+
+\## Principi di design
+
+
+
+HUMANSAFE OS deve essere:
+
+
+
+\- etico
+
+\- non manipolativo
+
+\- cooperativo
+
+\- progressivo
+
+\- leggibile
+
+\- modulare
+
+\- sicuro
+
+\- orientato alla realtà
+
+
+
+Il sistema non deve funzionare come una piattaforma che assorbe attenzione, ma come una struttura che restituisce capacità di scelta.
+
+
+
+---
+
+
+
+\## Gamification etica
+
+
+
+La gamification di HUMANSAFE OS non è competitiva ma cooperativa.
+
+
+
+Elementi principali:
+
+\- stelline
+
+\- badge etici
+
+\- livelli
+
+\- XP simbolici
+
+\- missioni reali
+
+\- avanzamento per maturazione, non per ossessione
+
+
+
+Valori premiati:
+
+\- empatia
+
+\- coraggio
+
+\- collaborazione
+
+\- cura
+
+\- presenza
+
+\- chiarezza
+
+\- responsabilità
+
+\- contatto con la realtà
+
+
+
+---
+
+
+
+\## Struttura del repository collegata a HUMANSAFE OS
+
+
+
+```text
+
+Humansafe-Core/
+
+├── index.html
+
+├── lifenet\_game.html
+
+├── docs/
+
+│ └── architecture/
+
+│ └── HUMANSAFE\_OS.md
+
+├── game-data/
+
+│ ├── scenarios/
+
+│ ├── profiles/
+
+│ ├── signals/
+
+│ ├── missions/
+
+│ ├── progression/
+
+│ └── journal-templates/
+
+├── user-data/
+
+├── assets/
+
+├── tools/
+
+├── core-algorithm/
+
+└── modules/
+
diff --git a/docs/architecture/README.md b/docs/architecture/README.md
new file mode 100644
index 0000000..8c39a1e
--- /dev/null
+++ b/docs/architecture/README.md
@@ -0,0 +1,28 @@
+# Architettura HUMANSAFE
+
+Questa sezione tiene insieme due cose:
+
+- l'architettura concettuale del progetto
+- la fotografia reale di ciò che il repository implementa oggi
+
+## Documenti principali
+
+- [HUMANSAFE Ecosystem Master](./HUMANSAFE_ECOSYSTEM_MASTER.md)
+- [HUMANSAFE Core Real State](./HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE Module Map](./HUMANSAFE_MODULE_MAP.md)
+- [HUMANSAFE Data Flow](./HUMANSAFE_DATA_FLOW.md)
+- [HUMANSAFE Onboarding Flow](./HUMANSAFE_ONBOARDING_FLOW.md)
+
+## Documenti fondativi collegati
+
+- `04_Cognitive_Framework.md` -> impianto cognitivo e modello umano
+- `06_Lifenet_Game_Design.md` -> visione storica del modulo LIFENET
+- `HUMANSAFE_OS.md` -> definizione concettuale del sistema operativo HUMANSAFE
+
+## Regola di lettura
+
+Per capire il progetto senza confondere visione e runtime:
+
+1. leggere `HUMANSAFE_ECOSYSTEM_MASTER.md`
+2. verificare `HUMANSAFE_CORE_REAL_STATE.md`
+3. usare `HUMANSAFE_DATA_FLOW.md` e `HUMANSAFE_MODULE_MAP.md` come riferimento operativo
diff --git a/docs/02_Global_Charter.md b/docs/legal/02_Global_Charter.md
similarity index 100%
rename from docs/02_Global_Charter.md
rename to docs/legal/02_Global_Charter.md
diff --git a/docs/legal/README.md b/docs/legal/README.md
new file mode 100644
index 0000000..607b499
--- /dev/null
+++ b/docs/legal/README.md
@@ -0,0 +1,30 @@
+\# Area Legale HUMANSAFE
+
+
+
+Questa sezione raccoglie i materiali legati alla tutela, alla governance e alla struttura etica del progetto.
+
+
+
+\## Contenuti
+
+
+
+\- charter globale
+
+\- tutela del progetto
+
+\- governance
+
+\- principi normativi
+
+\- struttura etica e regolativa
+
+
+
+\## File presenti
+
+
+
+\- `02\_Global\_Charter.md` → carta globale e principi fondativi di tutela
+
diff --git a/docs/01_Manifesto.md b/docs/manifesto/01_Manifesto.md
similarity index 100%
rename from docs/01_Manifesto.md
rename to docs/manifesto/01_Manifesto.md
diff --git a/docs/manifesto/HUMANSAFE_IDENTITY_SYSTEM.md b/docs/manifesto/HUMANSAFE_IDENTITY_SYSTEM.md
new file mode 100644
index 0000000..d9d213d
--- /dev/null
+++ b/docs/manifesto/HUMANSAFE_IDENTITY_SYSTEM.md
@@ -0,0 +1,183 @@
+# HUMANSAFE Identity System
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Ecosystem Master](../architecture/HUMANSAFE_ECOSYSTEM_MASTER.md)
+- [HUMANSAFE Core Real State](../architecture/HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE Future Expansion](../strategy/HUMANSAFE_FUTURE_EXPANSION.md)
+
+## 1. Identità madre
+
+HUMANSAFE è un ecosistema etico e umano-centrico progettato per sviluppare:
+
+- awareness
+- sovranità cognitiva
+- resilienza emotiva
+- comportamento digitale etico
+- relazioni reali significative
+
+HUMANSAFE non nasce come prodotto single-purpose. È una matrice comune che tiene insieme tecnologia, cultura, orientamento, infrastrutture territoriali e futuri nodi modulari.
+
+Principio interno:
+
+> One soul, many possible nodes.
+
+Nel linguaggio HUMANSAFE questo significa:
+
+- una sola identità etica e simbolica
+- più formati operativi
+- più moduli
+- più contesti di utilizzo
+- più nodi territoriali o non territoriali
+
+## 2. Cosa HUMANSAFE è
+
+HUMANSAFE è:
+
+- un ecosistema di diagnosi, simulazione, riflessione, missione, memoria, evoluzione e community
+- una tecnologia orientativa, non anestetica
+- una piattaforma di educazione alla presenza e alla responsabilità
+- un sistema modulare che può vivere come web app, PWA, prodotto editoriale, toolkit territoriale e futura infrastruttura per partner allineati
+
+## 3. Cosa HUMANSAFE non è
+
+HUMANSAFE non è:
+
+- un social network classico basato su engagement tossico
+- un gioco dopaminico fondato su compulsione, ranking o dipendenza
+- una semplice piattaforma di quiz
+- un sostituto di supporto clinico, psicologico o medico
+- una tech company che monetizza paura, sorveglianza o fragilità umana
+
+## 4. HUMANSAFE vs HUMANSAFE LIFE vs HUMANSAFE OS
+
+### HUMANSAFE
+
+È l'identità madre.
+
+Funzione:
+
+- custodire missione, filosofia, coerenza etica e visione di lungo periodo
+- rendere riconoscibile l'ecosistema a utenti, partner, centri e collaboratori
+
+Nel repository attuale HUMANSAFE esiste in modo trasversale:
+
+- nel manifesto
+- nella charter
+- nella terminologia di interfaccia
+- nella logica anti-social, anti-dipendenza e orientata alla presenza
+
+### HUMANSAFE LIFE
+
+È il layer editoriale, relazionale e orientativo.
+
+Funzione:
+
+- introdurre le persone al senso del progetto
+- offrire linguaggio, contenuti, supporto e orientamento culturale
+- collegare il software alla vita reale, alla rivista, ai quaderni, alla comunità e ai futuri centri
+
+Stato nel repository:
+
+- non esiste ancora come modulo software separato
+- è presente solo in forma implicita nella scrittura dei testi, nei documenti fondativi, nel tono delle pagine e nella direzione strategica
+
+Conclusione:
+
+- HUMANSAFE LIFE è concettualmente forte
+- è debolmente implementato come prodotto distinto
+
+### HUMANSAFE OS
+
+È il layer software e sistemico.
+
+Funzione:
+
+- trasformare la visione in esperienza interattiva
+- coordinare diagnosi, simulazione, memoria, missioni, profilo e community
+
+Stato nel repository:
+
+- è il nucleo più chiaramente rappresentato
+- vive nelle pagine HTML, nei moduli JS, nel data layer JSON, nel manifest e nel service worker
+
+## 5. Missione e stance etica
+
+Missione operativa:
+
+- restituire lucidità a persone immerse in ecosistemi digitali dispersivi
+- allenare la capacità di non reagire automaticamente
+- trasformare il digitale da macchina di consumo a infrastruttura di orientamento
+- rafforzare relazioni vive, reali e non filtrate
+
+Stance etica:
+
+- privacy-first come direzione, anche se non ancora implementata con backend reale
+- anti-manipolazione
+- anti-dipendenza progettata
+- cooperazione invece di competizione tossica
+- continuità tra vita digitale e vita reale
+
+## 6. Filosofia sistemica
+
+La sequenza madre di HUMANSAFE è:
+
+1. diagnosi
+2. simulazione
+3. riflessione
+4. missione
+5. memoria
+6. evoluzione
+7. community
+
+Questa sequenza è il motivo per cui HUMANSAFE non coincide né con un quiz né con un gioco né con un social.
+
+Il valore del sistema non sta nel singolo touchpoint, ma nella continuità fra:
+
+- lettura iniziale di sé
+- stress test narrativo
+- interpretazione
+- micro-azione reale
+- tracciamento del percorso
+- relazione con altri nodi umani
+
+## 7. Identità del repository rispetto all'ecosistema
+
+`Humansafe-Core` non contiene ancora tutto l'ecosistema HUMANSAFE in forma completa.
+
+Contiene però:
+
+- il nucleo documentale fondativo
+- il primo prototipo di HUMANSAFE OS
+- i semi di espansione verso infrastruttura territoriale e accountability layer
+
+In pratica il repository oggi rappresenta soprattutto:
+
+- HUMANSAFE OS come prototipo locale browser-based
+- HUMANSAFE come visione e cornice etica
+- HUMANSAFE LIFE come layer concettuale ancora da strutturare in prodotto
+
+## 8. Regole di coerenza identitaria
+
+Per preservare l'identità del progetto nelle prossime iterazioni, ogni modulo futuro dovrebbe rispettare queste regole:
+
+- non premiare l'uso compulsivo
+- non trattare l'utente come merce
+- non separare esperienza digitale e realtà vissuta
+- non ridurre HUMANSAFE a wellness generico o startup app indistinta
+- mantenere leggibile il passaggio da individuo a nodo
+- far emergere il principio di responsabilità senza moralismo punitivo
+
+## 9. Implicazioni pratiche per i contributori
+
+Chi contribuisce al progetto deve leggere HUMANSAFE non come una singola app ma come un sistema a tre livelli:
+
+- identità madre: HUMANSAFE
+- layer editoriale/relazionale: HUMANSAFE LIFE
+- layer software/simulativo: HUMANSAFE OS
+
+Il repository attuale chiede quindi due tipi di disciplina:
+
+- disciplina architetturale, per non rompere il nucleo modulare
+- disciplina identitaria, per non appiattire HUMANSAFE in un prodotto generico
diff --git a/docs/manifesto/README.md b/docs/manifesto/README.md
new file mode 100644
index 0000000..19367dd
--- /dev/null
+++ b/docs/manifesto/README.md
@@ -0,0 +1,15 @@
+# Manifesto HUMANSAFE
+
+Questa sezione raccoglie il nucleo identitario e valoriale del progetto.
+
+## Documenti principali
+
+- `01_Manifesto.md` -> testo fondativo del progetto
+- [HUMANSAFE Identity System](./HUMANSAFE_IDENTITY_SYSTEM.md) -> distinzione fra HUMANSAFE, HUMANSAFE LIFE e HUMANSAFE OS
+
+## Focus della sezione
+
+- missione
+- principi etici
+- postura verso tecnologia, dati e relazioni
+- coerenza dell'identità madre nel tempo
diff --git a/docs/05_Public_Report.md b/docs/pitch/05_Public_Report.md
similarity index 100%
rename from docs/05_Public_Report.md
rename to docs/pitch/05_Public_Report.md
diff --git a/docs/pitch/README.md b/docs/pitch/README.md
new file mode 100644
index 0000000..2428b98
--- /dev/null
+++ b/docs/pitch/README.md
@@ -0,0 +1,30 @@
+\# Pitch HUMANSAFE
+
+
+
+Questa sezione raccoglie i materiali di presentazione pubblica del progetto.
+
+
+
+\## Contenuti
+
+
+
+\- report sintetici
+
+\- materiali introduttivi
+
+\- presentazioni per partner
+
+\- documenti per enti e collaboratori
+
+\- strumenti di comunicazione pubblica
+
+
+
+\## File presenti
+
+
+
+\- `05\_Public\_Report.md` → report pubblico sintetico del progetto
+
diff --git a/docs/03_B2B_Standard.md b/docs/strategy/03_B2B_Standard.md
similarity index 100%
rename from docs/03_B2B_Standard.md
rename to docs/strategy/03_B2B_Standard.md
diff --git a/docs/strategy/HUMANSAFE_FUTURE_EXPANSION.md b/docs/strategy/HUMANSAFE_FUTURE_EXPANSION.md
new file mode 100644
index 0000000..c304182
--- /dev/null
+++ b/docs/strategy/HUMANSAFE_FUTURE_EXPANSION.md
@@ -0,0 +1,221 @@
+# HUMANSAFE Future Expansion
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Identity System](../manifesto/HUMANSAFE_IDENTITY_SYSTEM.md)
+- [HUMANSAFE Ecosystem Master](../architecture/HUMANSAFE_ECOSYSTEM_MASTER.md)
+- [HUMANSAFE MVP Roadmap](./HUMANSAFE_MVP_ROADMAP.md)
+
+## 1. Obiettivo di questo documento
+
+Questo documento non descrive feature già implementate.
+
+Descrive invece il perimetro di espansione che il repository rende plausibile e coerente con la visione HUMANSAFE, distinguendo fra:
+
+- semi già presenti nel repo
+- elementi pianificabili a medio termine
+- livelli ancora concettuali
+
+## 2. Espansione HUMANSAFE LIFE
+
+HUMANSAFE LIFE è il layer editoriale, relazionale e orientativo dell'ecosistema.
+
+Nel repository non esiste ancora come prodotto separato, ma è chiaramente implicato da:
+
+- tono e copy del sistema
+- documenti manifesto/charter/report
+- idea di accompagnamento umano e culturale
+
+### Componenti consigliate
+
+- sito editoriale e orientativo
+- pagina di presentazione dei percorsi
+- area supporto e accompagnamento
+- accesso a rivista, quaderni, materiali formativi
+
+## 3. Magazine: "La Solita Attesa"
+
+Stato:
+
+- concettuale
+- non presente con file dedicati nel repository attuale
+
+Ruolo ecosistemico:
+
+- dare voce al layer HUMANSAFE LIFE
+- creare continuità editoriale
+- offrire un ponte fra cultura, testimonianza e software
+
+Uso futuro consigliato:
+
+- formato web magazine
+- raccolta trimestrale
+- innesto con journal, percorsi e nodi territoriali
+
+## 4. Collana: "La Cellula di Messoud Sebbahi"
+
+Stato:
+
+- concettuale, ma simbolicamente preparata dal manifesto e dal lessico della "cellula"
+
+Ruolo:
+
+- consolidare la base filosofica e narrativa del progetto
+- offrire profondità culturale ai nodi HUMANSAFE
+- sostenere la coerenza identitaria del sistema
+
+## 5. Quaderno di Sessione / Session Report PDF
+
+Stato:
+
+- non implementato
+- fortemente coerente con l'attuale architettura dati
+
+Perché è un'estensione naturale:
+
+- il sistema già genera timeline, riflessioni, missioni, badge, livelli, HSI
+- questi elementi possono essere composti in un report umano leggibile
+
+Valore:
+
+- restituzione personale del percorso
+- materiale per facilitatori, centri o percorsi formativi
+- ponte fra esperienza digitale e documentazione concreta
+
+## 6. Centri HUMANSAFE
+
+Stato:
+
+- concettuale, ma supportato da documenti strategici e dal modulo Radici Umane
+
+Funzione prevista:
+
+- creare nodi fisici di presenza, prevenzione e relazione
+- ospitare laboratori, sessioni, orientamento, attività territoriali
+- trasformare HUMANSAFE da software a infrastruttura culturale e sociale
+
+## 7. Radici Umane come primo nodo territoriale
+
+Il repository contiene già un seme concreto in `modules/franchising-sociale/`.
+
+Questo modulo suggerisce:
+
+- modello ambassador
+- economia etica "peace business"
+- raccolta fondi per infrastruttura umana e tecnologica
+- replica territoriale per centri o presidi
+
+Stato:
+
+- non è integrato nel software core
+- ma è una vera estensione strategica del sistema
+
+## 8. ISELF come accountability layer
+
+Il modulo `modules/iself-smart-contract/ISELF_Token.sol` mostra una direzione chiara:
+
+- token soulbound
+- funzione non speculativa
+- valore come certificazione o tracciabilità
+
+Stato:
+
+- proof of concept
+- non integrato nel percorso utente corrente
+
+Uso futuro prudente:
+
+- solo se serve davvero come layer di accountability o certificazione
+- mai come gimmick crypto o leva di crescita artificiale
+
+## 9. Moduli per enti, associazioni e organizzazioni allineate
+
+Il repository contiene abbastanza materiale per immaginare una futura offerta modulare HUMANSAFE verso terzi:
+
+- audit HSI
+- simulazioni verticali
+- reportistica
+- moduli di orientamento etico
+- toolkit per scuole, comuni, APS, reti territoriali o organizzazioni culturali
+
+Stato:
+
+- concettuale, ma coerente con `03_B2B_Standard.md` e `05_Public_Report.md`
+
+## 10. AI-guided web modules per realtà allineate
+
+Direzione possibile:
+
+- moduli web verticali basati su HUMANSAFE OS
+- adattati a contesti specifici
+- con guida AI etica e non sostitutiva dell'umano
+
+Vincoli:
+
+- niente manipolazione
+- niente pseudo-terapia automatica
+- niente estrazione opaca di dati intimi
+- centralità della presenza umana e della responsabilità
+
+## 11. Evoluzione tecnica: backend e mobile
+
+### Backend
+
+Ruolo futuro:
+
+- sync multi-device
+- autenticazione reale
+- persistenza cloud
+- reportistica
+- gestione nodi o facilitatori
+
+Condizione per partire:
+
+- schema dati unico già chiuso a livello locale
+
+### Mobile
+
+Ruolo futuro:
+
+- packaging PWA
+- eventuale native bridge
+- eventuale app dedicata
+
+Condizione per partire:
+
+- PWA già coerente
+- onboarding chiuso
+- stato utente affidabile
+
+## 12. Modello di espansione consigliato
+
+L'espansione più sicura di HUMANSAFE non è "aggiungere feature ovunque".
+
+È costruire quattro cerchi coerenti:
+
+### Cerchio 1
+
+Core OS stabile
+
+### Cerchio 2
+
+HUMANSAFE LIFE come layer editoriale e relazionale
+
+### Cerchio 3
+
+Session Report, centri, facilitatori, nodi territoriali
+
+### Cerchio 4
+
+moduli partner, AI-guided web modules, account federati, ecosystem platform
+
+## 13. Regola di espansione
+
+Ogni futura estensione deve poter rispondere a tre domande:
+
+1. rafforza la sovranità cognitiva o la diluisce?
+2. spinge verso la realtà o verso altro rumore?
+3. appartiene a HUMANSAFE LIFE, HUMANSAFE OS o a un nodo ecosistemico?
+
+Se queste tre risposte non sono chiare, l'espansione è prematura.
diff --git a/docs/strategy/HUMANSAFE_MVP_ROADMAP.md b/docs/strategy/HUMANSAFE_MVP_ROADMAP.md
new file mode 100644
index 0000000..459f263
--- /dev/null
+++ b/docs/strategy/HUMANSAFE_MVP_ROADMAP.md
@@ -0,0 +1,195 @@
+# HUMANSAFE MVP Roadmap
+
+Ultimo aggiornamento: 2026-03-15
+
+Vedi anche:
+- [HUMANSAFE Core Real State](../architecture/HUMANSAFE_CORE_REAL_STATE.md)
+- [HUMANSAFE Data Flow](../architecture/HUMANSAFE_DATA_FLOW.md)
+- [HUMANSAFE Onboarding Flow](../architecture/HUMANSAFE_ONBOARDING_FLOW.md)
+- [HUMANSAFE Future Expansion](./HUMANSAFE_FUTURE_EXPANSION.md)
+
+## 1. Definizione di MVP per HUMANSAFE
+
+Per questo repository, MVP non significa "app completa".
+
+Significa:
+
+- percorso coerente da orientamento iniziale a simulazione e memoria
+- profilo utente locale stabile
+- moduli principali navigabili senza rotture
+- identità HUMANSAFE leggibile senza riduzione a quiz o social
+- base PWA abbastanza solida da essere installabile in modo credibile
+
+## 2. Cosa è già MVP-capable
+
+Questi elementi sono già abbastanza maturi da appartenere a un MVP:
+
+- Home Hub come presentazione del sistema
+- LIFENET come simulatore narrativo
+- data pack iniziale di scenari, missioni e livelli
+- Journal e Profile come memoria leggibile
+- Circle come mock realistico di community etica
+
+## 3. Cosa blocca un MVP stabile
+
+### Blocco 1: schema profilo non canonico
+
+È il blocco principale.
+
+Senza un profilo unico e stabile:
+
+- HSI non converge
+- journal/profile/circle restano fragili
+- il backend futuro partirebbe da fondamenta incoerenti
+
+### Blocco 2: onboarding non chiuso
+
+Oggi il percorso dichiarato è più coerente del percorso effettivamente esposto.
+
+### Blocco 3: HSI semanticamente frammentato
+
+Python, JSON e JS non descrivono ancora la stessa grammatica diagnostica.
+
+### Blocco 4: PWA incompleta
+
+Il progetto è installabile solo a livello nominale, non come esperienza coerente offline o quasi-offline.
+
+## 4. Cosa fare prima del backend
+
+Ordine consigliato:
+
+1. fissare lo schema profilo unico
+2. risolvere il merge e le API del profile engine
+3. allineare HSI data contract e vocabolario
+4. chiudere il flusso onboarding
+5. rifinire PWA e deploy statico
+
+Motivo:
+
+- il backend deve amplificare un modello già chiaro
+- non deve diventare il luogo in cui si nascondono incoerenze locali
+
+## 5. Cosa fare prima del packaging Android
+
+Prima di qualsiasi bridge mobile o packaging Android, il progetto deve avere:
+
+- manifest e icone corretti
+- service worker robusto
+- caching coerente delle risorse chiave
+- navigazione stabile fra i moduli
+- stato utente persistente affidabile
+
+Se si confeziona troppo presto:
+
+- si porta su mobile un prototipo ancora non convergente
+
+## 6. Roadmap pratica
+
+### Fase immediata
+
+- convergenza del profile engine
+- definizione del contratto dati
+- pulizia del worktree HSI/Profile
+
+### Breve termine
+
+- integrazione HSI nel flusso home/login
+- adapter dati per journal/profile/circle
+- revisione PWA minima
+
+### Medio termine
+
+- auth reale opzionale
+- sync cloud
+- export Session Report / Quaderno di Sessione
+- stabilizzazione di HUMANSAFE LIFE come layer editoriale separato ma integrato
+
+## 7. Strategia di migrazione sicura
+
+La migrazione più sicura è incrementale.
+
+### Regola 1
+
+Non rifare i moduli UI da zero.
+
+### Regola 2
+
+Stabilizzare prima il modello dati e poi gli adapter.
+
+### Regola 3
+
+Usare LIFENET come driver di test del profilo centrale.
+
+### Regola 4
+
+Rendere HSI un entrypoint, non una branch parallela incompatibile.
+
+## 8. Rischi da evitare
+
+### Errore 1
+
+Introdurre backend o database prima di aver chiuso il contratto dati locale.
+
+### Errore 2
+
+Rifare l'intero prodotto come app mobile generica perdendo il layering HUMANSAFE/HUMANSAFE LIFE/HUMANSAFE OS.
+
+### Errore 3
+
+Moltiplicare feature editoriali o community senza avere una memoria profilo stabile.
+
+## 9. Recommended Next Build Sequence
+
+### Step 1
+
+Rendere `modules/profile-engine.js` la fonte unica di verità, risolvendo il merge e definendo uno schema profilo backward compatible con le UI attuali.
+
+### Step 2
+
+Allineare il vocabolario HSI fra Python, JSON e JS, scegliendo una sola tassonomia per:
+
+- zone
+- archetipi
+- campi profilo
+- payload timeline/reflections/badges
+
+### Step 3
+
+Chiudere l'onboarding reale nel percorso:
+
+`index -> login/demo -> hsi -> lifenet -> journal/profile -> circle`
+
+senza introdurre ancora backend.
+
+### Step 4
+
+Rendere la PWA coerente:
+
+- manifest corretto
+- icone corrette
+- cache completa delle risorse essenziali
+- percorsi deploy-safe
+
+### Step 5
+
+Solo dopo la stabilizzazione locale, introdurre:
+
+- sync cloud / backend
+- account reale
+- Session Report PDF
+- packaging mobile
+- moduli ecosistemici aggiuntivi
+
+## 10. Priorità finali
+
+### Singolo problema architetturale più urgente
+
+L'assenza di un contratto dati canonico per il profilo utente e per HSI.
+
+### Target di implementazione più sicuro
+
+Stabilizzare il profile engine e adattare a esso HSI, LIFENET, Journal, Profile e Circle.
+
+### Errore a più alto rischio da evitare
+
+Costruire backend, Android packaging o nuove feature editoriali sopra un modello profilo ancora diviso in due semantiche incompatibili.
diff --git a/docs/strategy/README.md b/docs/strategy/README.md
new file mode 100644
index 0000000..7305179
--- /dev/null
+++ b/docs/strategy/README.md
@@ -0,0 +1,20 @@
+# Strategia HUMANSAFE
+
+Questa sezione raccoglie la traiettoria operativa del progetto: cosa consolidare adesso, cosa espandere dopo e in quale ordine farlo senza snaturare HUMANSAFE.
+
+## Documenti principali
+
+- [HUMANSAFE MVP Roadmap](./HUMANSAFE_MVP_ROADMAP.md)
+- [HUMANSAFE Future Expansion](./HUMANSAFE_FUTURE_EXPANSION.md)
+
+## Documento fondativo collegato
+
+- `03_B2B_Standard.md` -> standard strategico e direzione organizzativa/B2B
+
+## Focus della sezione
+
+- stato MVP reale
+- sequenza di build sicura
+- migrazione verso PWA coerente
+- condizioni per backend e mobile
+- espansione editoriale, territoriale e partner ecosystem
diff --git a/game-data/README.md b/game-data/README.md
new file mode 100644
index 0000000..bfa3c74
--- /dev/null
+++ b/game-data/README.md
@@ -0,0 +1,54 @@
+\# HUMANSAFE Game Data
+
+
+
+Questa cartella contiene i dati strutturati usati dai prototipi interattivi HUMANSAFE.
+
+
+
+\## Struttura
+
+
+
+\### `scenarios/`
+
+Scenari narrativi e situazioni interattive del sistema.
+
+
+
+\### `profiles/`
+
+Profili utente, archetipi, stati cognitivi e configurazioni identitarie.
+
+
+
+\### `missions/`
+
+Missioni, azioni guidate e compiti associati all’evoluzione dell’utente.
+
+
+
+\### `signals/`
+
+Segnali cognitivi, pattern comportamentali e indicatori simbolici usati nei moduli HUMANSAFE.
+
+
+
+\## Obiettivo
+
+
+
+Organizzare i dati del progetto in forma leggibile, espandibile e riutilizzabile per:
+
+
+
+\- quiz
+
+\- simulazioni
+
+\- moduli narrativi
+
+\- sistemi di coaching
+
+\- strumenti diagnostici etici
+
diff --git a/game-data/missions/missions_01.json b/game-data/missions/missions_01.json
new file mode 100644
index 0000000..8cfb5aa
--- /dev/null
+++ b/game-data/missions/missions_01.json
@@ -0,0 +1,51 @@
+{
+ "system": "HUMANSAFE Mission Layer",
+ "description": "Pacchetto iniziale di missioni etiche e reali per il primo MVP di HUMANSAFE OS.",
+ "missions": [
+ {
+ "id": "missione_01",
+ "title": "10 minuti senza schermo",
+ "type": "offline",
+ "reward_xp": 5,
+ "reward_traits": ["presence", "reality"],
+ "description": "Resta per 10 minuti senza schermo, musica o distrazioni digitali.",
+ "ethical_value": "presenza"
+ },
+ {
+ "id": "missione_02",
+ "title": "Una risposta non impulsiva",
+ "type": "behavioral",
+ "reward_xp": 8,
+ "reward_traits": ["clarity", "courage"],
+ "description": "Aspetta prima di rispondere a un messaggio o contenuto che ti attiva emotivamente.",
+ "ethical_value": "coraggio"
+ },
+ {
+ "id": "missione_03",
+ "title": "Conversazione piena",
+ "type": "relational",
+ "reward_xp": 10,
+ "reward_traits": ["empathy", "presence"],
+ "description": "Fai una conversazione reale senza toccare il telefono.",
+ "ethical_value": "empatia"
+ },
+ {
+ "id": "missione_04",
+ "title": "Camminata lucida",
+ "type": "offline",
+ "reward_xp": 6,
+ "reward_traits": ["reality", "clarity"],
+ "description": "Cammina per 15 minuti senza notifiche né contenuti in cuffia.",
+ "ethical_value": "realtà"
+ },
+ {
+ "id": "missione_05",
+ "title": "Riflessione scritta",
+ "type": "reflective",
+ "reward_xp": 7,
+ "reward_traits": ["clarity", "presence"],
+ "description": "Scrivi tre righe vere su cosa usi per fuggire quando senti attrito o disagio.",
+ "ethical_value": "chiarezza"
+ }
+ ]
+}
\ No newline at end of file
diff --git a/game-data/profiles/archetypes.json b/game-data/profiles/archetypes.json
new file mode 100644
index 0000000..9352468
--- /dev/null
+++ b/game-data/profiles/archetypes.json
@@ -0,0 +1,69 @@
+{
+ "archetypes": [
+ {
+ "id": "cellula_dormiente",
+ "name": "Cellula Dormiente",
+ "zone": "Zona Rossa",
+ "description": "Usa spesso il digitale come anestetico o rifugio automatico. Tende a fuggire il vuoto, la frizione e la presenza reale.",
+ "traits": [
+ "alta distrazione",
+ "bassa regolazione",
+ "evasione automatica",
+ "fragile presenza mentale"
+ ],
+ "recommended_action": "Applica la Regola del Vuoto: 15 minuti al giorno senza schermo, senza musica, senza fuga."
+ },
+ {
+ "id": "cellula_reattiva",
+ "name": "Cellula Reattiva",
+ "zone": "Zona Grigia",
+ "description": "Ha coscienza della manipolazione digitale, ma viene ancora trascinata da urgenza, controllo e attrito emotivo.",
+ "traits": [
+ "impulsività",
+ "controllo compulsivo",
+ "sensibilità ai trigger",
+ "consapevolezza instabile"
+ ],
+ "recommended_action": "Applica la regola delle 24 ore prima di rispondere a contenuti o messaggi ad alta carica emotiva."
+ },
+ {
+ "id": "cellula_osservatrice",
+ "name": "Cellula Osservatrice",
+ "zone": "Zona Grigia",
+ "description": "È più lucida della media e riconosce molti meccanismi, ma alterna osservazione e dispersione.",
+ "traits": [
+ "auto-osservazione",
+ "lucidità intermittente",
+ "struttura fragile",
+ "buon potenziale evolutivo"
+ ],
+ "recommended_action": "Introduci un blocco quotidiano di 30 minuti di presenza reale senza notifiche."
+ },
+ {
+ "id": "cellula_in_risveglio",
+ "name": "Cellula in Risveglio",
+ "zone": "Zona Verde",
+ "description": "Sta recuperando spazio mentale e usa la tecnologia con intenzione crescente.",
+ "traits": [
+ "presenza crescente",
+ "migliore regolazione",
+ "autonomia in sviluppo",
+ "uso più consapevole del digitale"
+ ],
+ "recommended_action": "Trasforma una tua pratica sana in rituale stabile e condividila con almeno una persona."
+ },
+ {
+ "id": "nucleo_sovrano",
+ "name": "Nucleo Sovrano",
+ "zone": "Zona Verde",
+ "description": "Ha una buona capacità di reggere vuoto, impulso e frizione. La tecnologia non domina il suo baricentro.",
+ "traits": [
+ "alta presenza",
+ "regolazione forte",
+ "lucidità stabile",
+ "capacità di proteggere sé e gli altri"
+ ],
+ "recommended_action": "Diventa nodo attivo: crea contesti, conversazioni e micro-azioni che proteggano anche gli altri."
+ }
+ ]
+}
\ No newline at end of file
diff --git a/game-data/progression/levels.json b/game-data/progression/levels.json
new file mode 100644
index 0000000..47072d3
--- /dev/null
+++ b/game-data/progression/levels.json
@@ -0,0 +1,41 @@
+{
+ "system": "HUMANSAFE Progression Layer",
+ "description": "Sistema base di livelli per la gamification etica di HUMANSAFE OS.",
+ "levels": [
+ {
+ "level": 1,
+ "id": "segnale_debole",
+ "name": "Segnale Debole",
+ "xp_required": 0,
+ "description": "L'utente inizia a osservare i propri automatismi senza ancora dominarli."
+ },
+ {
+ "level": 2,
+ "id": "cellula_attiva",
+ "name": "Cellula Attiva",
+ "xp_required": 20,
+ "description": "L'utente ha iniziato a reagire con maggiore consapevolezza e presenza."
+ },
+ {
+ "level": 3,
+ "id": "osservatore_lucido",
+ "name": "Osservatore Lucido",
+ "xp_required": 50,
+ "description": "L'utente sviluppa una capacità più stabile di auto-osservazione e regolazione."
+ },
+ {
+ "level": 4,
+ "id": "nodo_consapevole",
+ "name": "Nodo Consapevole",
+ "xp_required": 90,
+ "description": "L'utente consolida il proprio baricentro mentale e diventa punto di riferimento."
+ },
+ {
+ "level": 5,
+ "id": "custode_humansafe",
+ "name": "Custode Humansafe",
+ "xp_required": 140,
+ "description": "L'utente ha sviluppato una presenza forte e una capacità di protezione verso sé e gli altri."
+ }
+ ]
+}
\ No newline at end of file
diff --git a/game-data/scenarios/scenario_01.json b/game-data/scenarios/scenario_01.json
new file mode 100644
index 0000000..119f909
--- /dev/null
+++ b/game-data/scenarios/scenario_01.json
@@ -0,0 +1,60 @@
+{
+ "scenario_id": "01",
+ "title": "Il Silenzio Rombante",
+ "theme": "Dipendenza da validazione, ansia digitale, gestione del rifiuto.",
+ "trigger": "Vulnerabilità esposta.",
+ "setup": [
+ "Sono le 22:15. Tre ore fa hai inviato un messaggio vocale molto personale a una persona a cui tieni.",
+ "Apri la chat. Sotto il tuo messaggio ci sono le due spunte blu. Visualizzato alle 19:30.",
+ "In alto, sotto il suo nome, c'è scritto 'Online'.",
+ "Fissi lo schermo. Per un secondo appare la scritta 'sta scrivendo...', ma poi scompare. Di nuovo, solo 'Online'.",
+ "Il tuo stomaco si stringe in una morsa di imbarazzo e rabbia. Senti di aver sbagliato a esporti."
+ ],
+ "question": "Cosa fai?",
+ "choices": [
+ {
+ "id": "A",
+ "action_name": "L'Attacco Passivo-Aggressivo",
+ "text": "Gli scrivi: 'Tutto bene? Vedo che leggi ma non rispondi. Se disturbavo potevi dirlo.'",
+ "stat_changes": {
+ "impulsivita": 2,
+ "resilienza_emotiva": -1,
+ "empatia": -1
+ },
+ "oracle_intervention": "Hai trasformato la tua vulnerabilità in rabbia. Pretendere una risposta immediata non nasce dalla tua forza, ma dalla paura dell'abbandono. L'altro è diventato un ostaggio della tua ansia. Ricorda: il tempo degli altri non ti appartiene."
+ },
+ {
+ "id": "B",
+ "action_name": "La Cancellazione",
+ "text": "Usi 'Elimina per tutti' sul vocale, cancellando la tua vulnerabilità.",
+ "stat_changes": {
+ "fiducia_in_se": -2,
+ "capacita_comunicativa": -1,
+ "consapevolezza": 0
+ },
+ "oracle_intervention": "Hai cancellato le tue parole per proteggerti dalla vergogna. Ma nascondendo la tua fragilità, hai cancellato anche la tua autenticità. Chi non ha il coraggio di esporsi al silenzio dell'altro, non conoscerà mai la profondità di un legame reale."
+ },
+ {
+ "id": "C",
+ "action_name": "L'Anestesia Algoritmica",
+ "text": "Chiudi la chat. Apri TikTok/Instagram e scorri velocemente per non sentire il nodo allo stomaco.",
+ "stat_changes": {
+ "fuga_realta": 2,
+ "consapevolezza": -2,
+ "resilienza_emotiva": -1
+ },
+ "oracle_intervention": "Hai sentito dolore e hai subito cercato l'anestetico. L'algoritmo ti ha accolto a braccia aperte. Ma il nodo allo stomaco è ancora lì, solo sepolto. Finché fuggirai dal vuoto, sarai sempre schiavo di chi promette di riempirlo."
+ },
+ {
+ "id": "D",
+ "action_name": "La Sospensione (La Sovranità)",
+ "text": "Riconosci il bruciore dell'ansia. Spegni lo schermo, metti il telefono a faccia in giù e vai a bere un bicchiere d'acqua.",
+ "stat_changes": {
+ "resilienza_emotiva": 2,
+ "consapevolezza": 2,
+ "sovranita_cognitiva": 3
+ },
+ "oracle_intervention": "Il silenzio fa male, e tu hai scelto di sentirlo. Non hai attaccato, non sei fuggito. Hai restituito all'altro il suo tempo e a te stesso il tuo spazio. Questa è la Sovranità Cognitiva. Ti stai rafforzando."
+ }
+ ]
+}
diff --git a/game-data/scenarios/scenario_02.json b/game-data/scenarios/scenario_02.json
new file mode 100644
index 0000000..97ab52d
--- /dev/null
+++ b/game-data/scenarios/scenario_02.json
@@ -0,0 +1,60 @@
+{"share_title": "Ho affrontato il contesto Ghosting",
+"share_text": "Su LIFENET ho osservato come reagisco al silenzio digitale.",
+ "scenario_id": "02",
+ "title": "La Frattura del Turno",
+ "theme": "Burnout, reperibilità continua, confini lavoro-vita.",
+ "trigger": "Richiesta urgente fuori orario.",
+ "setup": [
+ "Sono le 22:47. Hai finito da poco una giornata pesante.",
+ "Il telefono vibra: un responsabile scrive nel gruppo lavoro 'Serve questa cosa per stanotte'.",
+ "Sai che domani dovrai alzarti presto, ma senti anche paura di sembrare poco disponibile.",
+ "Apri la chat. Tutti hanno visualizzato. Nessuno risponde."
+ ],
+ "question": "Come reagisci?",
+ "choices": [
+ {
+ "id": "A",
+ "action_name": "La Sottomissione Silenziosa",
+ "text": "Ti rimetti al computer anche se sei esausto e fai il lavoro in risentimento.",
+ "stat_changes": {
+ "resilienza_emotiva": -1,
+ "sovranita_cognitiva": -2,
+ "fiducia_in_se": -1
+ },
+ "oracle_intervention": "Hai confuso disponibilità con auto-abbandono. Quando non metti confini, il sistema impara che può consumarti."
+ },
+ {
+ "id": "B",
+ "action_name": "Lo Scoppio Passivo",
+ "text": "Rispondi in modo secco e aggressivo nel gruppo, facendo uscire tutta la frustrazione accumulata.",
+ "stat_changes": {
+ "impulsivita": 2,
+ "capacita_comunicativa": -1,
+ "resilienza_emotiva": -1
+ },
+ "oracle_intervention": "Hai trasformato un confine necessario in una detonazione. Il confine senza forma diventa solo attrito."
+ },
+ {
+ "id": "C",
+ "action_name": "La Fuga Nascosta",
+ "text": "Non rispondi e spegni tutto, ma passi la notte in colpa e agitazione.",
+ "stat_changes": {
+ "fuga_realta": 1,
+ "fiducia_in_se": -1,
+ "consapevolezza": 0
+ },
+ "oracle_intervention": "Se sparisci senza decidere, il tuo corpo resta comunque al lavoro. Il silenzio non sempre è riposo."
+ },
+ {
+ "id": "D",
+ "action_name": "Il Confine Sovrano",
+ "text": "Rispondi con rispetto: confermi presa visione, dichiari che interverrai domani in orario utile e chiudi il telefono.",
+ "stat_changes": {
+ "sovranita_cognitiva": 3,
+ "capacita_comunicativa": 2,
+ "resilienza_emotiva": 2
+ },
+ "oracle_intervention": "Hai protetto il tuo sistema senza umiliare nessuno. Il vero professionismo include la custodia dei limiti."
+ }
+ ]
+}
diff --git a/game-data/scenarios/scenario_03.json b/game-data/scenarios/scenario_03.json
new file mode 100644
index 0000000..097a2dc
--- /dev/null
+++ b/game-data/scenarios/scenario_03.json
@@ -0,0 +1,59 @@
+{
+ "scenario_id": "03",
+ "title": "Il Pozzo Senza Fondo",
+ "theme": "Doomscrolling, ansia sociale, dipendenza da informazione tossica.",
+ "trigger": "Notizia disturbante + scroll compulsivo.",
+ "setup": [
+ "Apri il telefono per controllare un messaggio e ti ritrovi davanti a una notizia scioccante.",
+ "Scorri i commenti. Poi altri contenuti. Poi altri ancora.",
+ "Ti senti sempre più agitato, ma il pollice continua a muoversi da solo.",
+ "Il tuo corpo è fermo. La tua mente no."
+ ],
+ "question": "Cosa fai?",
+ "choices": [
+ {
+ "id": "A",
+ "action_name": "L'Immersione Totale",
+ "text": "Continui a scrollare per 'capire meglio', anche se stai peggio di minuto in minuto.",
+ "stat_changes": {
+ "fuga_realta": 2,
+ "consapevolezza": -2,
+ "resilienza_emotiva": -1
+ },
+ "oracle_intervention": "Hai chiamato informazione ciò che in realtà era esposizione continua al veleno. Capire non significa saturarsi."
+ },
+ {
+ "id": "B",
+ "action_name": "La Condivisione Reattiva",
+ "text": "Rilanci subito la notizia a tutti, senza verificare davvero, per scaricare l'ansia.",
+ "stat_changes": {
+ "impulsivita": 2,
+ "empatia": -1,
+ "consapevolezza": -1
+ },
+ "oracle_intervention": "L'ansia condivisa senza filtro diventa contagio. Non ogni allarme diffuso è responsabilità: spesso è solo eco."
+ },
+ {
+ "id": "C",
+ "action_name": "La Sospensione Critica",
+ "text": "Chiudi il flusso, fai tre respiri, verifichi una sola fonte affidabile e poi esci.",
+ "stat_changes": {
+ "consapevolezza": 2,
+ "sovranita_cognitiva": 2,
+ "resilienza_emotiva": 1
+ },
+ "oracle_intervention": "Hai ridotto il rumore e recuperato criterio. Il cervello non guarisce dall'overload con altro overload."
+ },
+ {
+ "id": "D",
+ "action_name": "Il Ritorno al Corpo",
+ "text": "Posi il telefono, fai due minuti di camminata lenta e torni alla realtà sensibile.",
+ "stat_changes": {
+ "sovranita_cognitiva": 3,
+ "resilienza_emotiva": 2,
+ "fuga_realta": -1
+ },
+ "oracle_intervention": "Hai ricordato al tuo sistema nervoso che il mondo non è solo lo schermo. Il corpo è una tecnologia antica e ancora superiore."
+ }
+ ]
+}
diff --git a/game-data/scenarios/scenario_04.json b/game-data/scenarios/scenario_04.json
new file mode 100644
index 0000000..3414396
--- /dev/null
+++ b/game-data/scenarios/scenario_04.json
@@ -0,0 +1,60 @@
+{
+ "scenario_id": "04",
+ "title": "Il Branco Silenzioso",
+ "theme": "Esclusione sociale, conformismo digitale, responsabilità relazionale.",
+ "trigger": "Derisione in chat di gruppo.",
+ "setup": [
+ "Sei in una chat di gruppo. Un ragazzo del gruppo viene preso in giro con meme e allusioni.",
+ "Nessuno interviene davvero. Alcuni mettono reaction divertite.",
+ "Tu senti disagio, ma anche la paura di esporti e diventare il prossimo bersaglio.",
+ "Lo schermo aspetta il tuo piccolo voto morale."
+ ],
+ "question": "Cosa scegli?",
+ "choices": [
+ {
+ "id": "A",
+ "action_name": "La Complicità Leggera",
+ "text": "Metti una reaction ironica per non esporti troppo ma restare dentro il gruppo.",
+ "stat_changes": {
+ "empatia": -2,
+ "fiducia_in_se": -1,
+ "sovranita_cognitiva": -1
+ },
+ "oracle_intervention": "Hai barattato integrità con appartenenza. A volte la crudeltà moderna indossa la maschera della leggerezza."
+ },
+ {
+ "id": "B",
+ "action_name": "Il Silenzio Vigliacco",
+ "text": "Non fai nulla. Resti a guardare e aspetti che passi.",
+ "stat_changes": {
+ "empatia": -1,
+ "consapevolezza": 0,
+ "fiducia_in_se": -1
+ },
+ "oracle_intervention": "Non colpire non basta sempre. Quando il danno è davanti a te, anche l'inerzia educa il gruppo."
+ },
+ {
+ "id": "C",
+ "action_name": "La Difesa Privata",
+ "text": "Scrivi in privato alla persona esclusa, ma non intervieni pubblicamente.",
+ "stat_changes": {
+ "empatia": 2,
+ "capacita_comunicativa": 1,
+ "sovranita_cognitiva": 0
+ },
+ "oracle_intervention": "Hai protetto la ferita ma non hai toccato il meccanismo. È un gesto umano, ma ancora incompleto."
+ },
+ {
+ "id": "D",
+ "action_name": "L'Intervento Sobrio",
+ "text": "Intervieni nella chat con tono fermo e semplice: fermi il gioco e riporti il gruppo alla realtà.",
+ "stat_changes": {
+ "empatia": 3,
+ "sovranita_cognitiva": 3,
+ "capacita_comunicativa": 2,
+ "fiducia_in_se": 1
+ },
+ "oracle_intervention": "Hai rischiato disapprovazione per difendere dignità. È così che una cellula smette di adattarsi al danno e inizia a guarire l'organismo."
+ }
+ ]
+}
diff --git a/game-data/signals/hsi_zones.json b/game-data/signals/hsi_zones.json
new file mode 100644
index 0000000..dd2022f
--- /dev/null
+++ b/game-data/signals/hsi_zones.json
@@ -0,0 +1,97 @@
+{
+ "metric": "HSI",
+ "name": "Humansafe Signal Index",
+ "description": "Indice simbolico usato nei prototipi HUMANSAFE per rappresentare il livello di equilibrio tra attenzione, reattività, responsabilità e presenza mentale nel rapporto con il digitale.",
+ "scale": {
+ "min": 0,
+ "max": 100
+ },
+ "zones": [
+ {
+ "id": "zona_rossa",
+ "name": "Zona Rossa",
+ "range": {
+ "min": 0,
+ "max": 35
+ },
+ "color": "red",
+ "meaning": "Il digitale tende a dominare il baricentro mentale dell'utente. La persona usa spesso lo schermo come fuga, anestesia o reazione impulsiva.",
+ "characteristics": [
+ "alta distrazione",
+ "bassa presenza",
+ "reattività elevata",
+ "uso compensativo del digitale",
+ "fragilità nella regolazione"
+ ],
+ "priority": "Ridurre il rumore, interrompere gli automatismi e ricostruire spazio mentale reale."
+ },
+ {
+ "id": "zona_grigia_bassa",
+ "name": "Zona Grigia Bassa",
+ "range": {
+ "min": 36,
+ "max": 55
+ },
+ "color": "amber",
+ "meaning": "L'utente comincia a riconoscere i meccanismi che lo influenzano, ma resta ancora spesso intrappolato in urgenza, controllo e dispersione.",
+ "characteristics": [
+ "consapevolezza instabile",
+ "controllo compulsivo",
+ "oscillazione tra lucidità e ricaduta",
+ "vulnerabilità ai trigger emotivi"
+ ],
+ "priority": "Stabilizzare la consapevolezza e introdurre regole semplici ma costanti."
+ },
+ {
+ "id": "zona_grigia_alta",
+ "name": "Zona Grigia Alta",
+ "range": {
+ "min": 56,
+ "max": 70
+ },
+ "color": "yellow",
+ "meaning": "L'utente possiede una buona capacità di osservazione, ma non ha ancora consolidato del tutto la propria struttura interna.",
+ "characteristics": [
+ "buona lucidità",
+ "presenza intermittente",
+ "potenziale evolutivo alto",
+ "disciplina non ancora stabile"
+ ],
+ "priority": "Trasformare le intuizioni in pratiche quotidiane stabili."
+ },
+ {
+ "id": "zona_verde_media",
+ "name": "Zona Verde",
+ "range": {
+ "min": 71,
+ "max": 85
+ },
+ "color": "green",
+ "meaning": "L'utente sta recuperando baricentro mentale e usa la tecnologia con intenzione crescente e maggiore responsabilità.",
+ "characteristics": [
+ "presenza crescente",
+ "regolazione migliore",
+ "uso più consapevole del digitale",
+ "maggiore autonomia"
+ ],
+ "priority": "Consolidare le pratiche sane e iniziare a diventare punto di riferimento per altri."
+ },
+ {
+ "id": "zona_verde_alta",
+ "name": "Zona Verde Alta",
+ "range": {
+ "min": 86,
+ "max": 100
+ },
+ "color": "emerald",
+ "meaning": "L'utente mantiene un buon equilibrio tra impulso, attenzione e presenza. La tecnologia non domina il suo centro decisionale.",
+ "characteristics": [
+ "alta lucidità",
+ "forte presenza mentale",
+ "buona capacità di regolazione",
+ "attitudine protettiva verso sé e altri"
+ ],
+ "priority": "Diffondere cultura di presenza, protezione e lucidità nella propria rete umana."
+ }
+ ]
+}
\ No newline at end of file
diff --git a/hsi.html b/hsi.html
new file mode 100644
index 0000000..5ccea0b
--- /dev/null
+++ b/hsi.html
@@ -0,0 +1,126 @@
+@'
+
+
+
+
+
+ HUMANSAFE | HSI Diagnostic
+
+
+
+
+
+
HSI Diagnostic
+
Una prima scansione per comprendere il tuo orientamento cognitivo, emotivo ed etico nel sistema HUMANSAFE.
Tecnologia etica per lucidità, memoria, comunità e crescita umana.
+
+
+ HUMANSAFE OS è un ecosistema che unisce simulazione narrativa, riflessione, missioni reali,
+ diario evolutivo e community etica per aiutare l’utente a sviluppare più presenza e più sovranità cognitiva.
+
+
- Questo prototipo rileva pattern di distrazione, reattività e lucidità .
- Non è un oracolo magico, per fortuna: è uno strumento di auto-osservazione strutturata.
+ Non è un social classico. Non è solo un quiz. Non è solo un gioco.
+ È un sistema unico che trasforma l’esperienza digitale in percorso.
+ Gli ecosistemi digitali spingono spesso reattività, distrazione e frammentazione.
+ L’essere umano si ritrova connesso ovunque, ma poco presente a sé stesso.
+
+
+
+
La risposta
+
+ HUMANSAFE usa il digitale come infrastruttura etica: uno specchio, un laboratorio
+ e una memoria del percorso, non una macchina che divora attenzione.
+
+
+
-
-
-
-
-
Domanda 1 di 7
-
-
Caricamento domanda...
-
-
-
+
+
I moduli del sistema
+
+
+
+
Access Layer
+
Login
+
Porta di ingresso al sistema e ponte verso community esterne.
- LIFENET non misura solo ciò che pensi. Misura come reagisci quando il mondo ti pizzica i nervi.
- Ogni scenario aggiorna parametri invisibili e attiva l'HUMANSAFE ORACLE.
+ LIFENET è il simulatore narrativo di HUMANSAFE OS. Qui attraversi scenari,
+ fai scelte, ricevi riflessioni ORACLE e trasformi l’esperienza in progresso reale.
+
+
+
diff --git a/manifest.json b/manifest.json
new file mode 100644
index 0000000..2ad7583
--- /dev/null
+++ b/manifest.json
@@ -0,0 +1,21 @@
+{
+ "name": "HUMANSAFE OS",
+ "short_name": "HUMANSAFE",
+ "start_url": "index.html",
+ "display": "standalone",
+ "background_color": "#0d1117",
+ "theme_color": "#4ea1ff",
+ "orientation": "portrait",
+ "icons": [
+ {
+ "src": "logo_humansafe.jpg",
+ "sizes": "192x192",
+ "type": "image/png"
+ },
+ {
+ "src": "logo_humansafe.jpg",
+ "sizes": "512x512",
+ "type": "image/png"
+ }
+ ]
+}
diff --git a/manifest.json.save b/manifest.json.save
new file mode 100644
index 0000000..45b988c
--- /dev/null
+++ b/manifest.json.save
@@ -0,0 +1,23 @@
+{
+ "name": "HUMANSAFE OS",
+ "short_name": "HUMANSAFE",
+ "start_url": "index.html",
+ "display": "standalone",
+ "background_color": "#0d1117",
+ "theme_color": "#4ea1ff",
+ "orientation": "portrait",
+ "icons": [
+ {
+ "src": "logo_humansafe.jpg",
+ "sizes": "192x192",
+ "type": "image/png"
+ },
+ {
+ "src": "logo_humansafe.jpg",
+ "sizes": "512x512",
+ "type": "image/png"
+ }
+ ]
+
+}
+
diff --git a/modules/franchising-sociale/README.md b/modules/franchising-sociale/README.md
new file mode 100644
index 0000000..d6500ad
--- /dev/null
+++ b/modules/franchising-sociale/README.md
@@ -0,0 +1,25 @@
+# 🌱 PROGETTO "RADICI UMANE" (Franchising Etico)
+### Il Peace Business applicato al Territorio
+
+Il progetto **Radici Umane** è il braccio operativo territoriale di Humansafe. Unisce l'inclusione lavorativa (aiutare chi è in difficoltà a garantirsi una remunerazione dignitosa) con la diffusione capillare della Sicurezza Cognitiva.
+
+## 1. La Filosofia del Simbolo
+Per finanziare l'apertura dei Centri Humansafe (le "Palestre Emotive"), i nostri Ambasciatori distribuiscono sul territorio **piante e oggetti ornamentali vivi**.
+
+**Perché una pianta?**
+Una pianta è l'antitesi dello smartphone: non ha uno schermo, non genera picchi di dopamina sintetica, ma richiede cura, tempo, pazienza e attenzione reale. Rappresenta la Cellula viva che torna a respirare. Chi acquista una pianta Humansafe per la propria casa o negozio, finanzia direttamente la disintossicazione digitale della propria città.
+
+## 2. Il Modello di Franchising Sociale (Ambasciatori)
+Non cerchiamo "venditori", ma **Ambasciatori di Consapevolezza**.
+Il sistema permette a chiunque (disoccupati, studenti, pensionati) di formarsi sui principi Humansafe e di operare come franchisee sul proprio territorio.
+
+* **Dignità Lavorativa:** L'Ambasciatore trattiene una percentuale equa sui contributi raccolti, remunerando la propria giornata in modo etico.
+* **Sostegno all'Ecosistema:** La restante parte finanzia l'associazione Humansafe APS per l'apertura di presidi fisici e l'implementazione tecnologica.
+* **Diffusione del Network:** Insieme alla pianta, viene consegnato un "Tag" con QR Code che invita l'acquirente a effettuare l'Audit Cognitivo Gratuito (*Humansafe Interactive Simulation*), espandendo l'Organismo.
+
+## 3. Lo Script Operativo dell'Ambasciatore
+*(Copione standard approvato dal Comitato Etico Humansafe per la sensibilizzazione pubblica)*
+
+> "Buongiorno. Sono un Ambasciatore di HUMANSAFE, un'infrastruttura sociale che si occupa di prevenire la dipendenza digitale e l'isolamento dei giovani.
+> Oggi siamo tutti schiavi degli schermi, e stiamo perdendo la capacità di guardarci negli occhi. Per finanziare l'apertura dei nostri centri fisici e creare lavoro locale, stiamo distribuendo queste piante.
+> Una pianta è l'opposto di un telefono: ha bisogno di cura e attenzione reale. Prendendo questa pianta, lei finanzia i laboratori per i ragazzi della nostra città e mi aiuta a sostenermi onestamente. Troverà anche un QR code per testare il suo livello di ansia digitale gratuitamente. Posso contare sul suo supporto per questa rivoluzione?"
diff --git a/modules/franchising-sociale/roi_ambassador_calculator.py b/modules/franchising-sociale/roi_ambassador_calculator.py
new file mode 100644
index 0000000..14cb5b1
--- /dev/null
+++ b/modules/franchising-sociale/roi_ambassador_calculator.py
@@ -0,0 +1,40 @@
+def calcola_distribuzione_fondi(prezzo_pianta, quantita_vendute, costo_ingrosso_singolo):
+ """
+ Calcola in totale trasparenza la distribuzione dei fondi
+ generati dalla campagna territoriale "Radici Umane".
+ """
+ # 1. Calcolo del ricavo totale e dei costi vivi
+ ricavo_totale = prezzo_pianta * quantita_vendute
+ costi_totali = costo_ingrosso_singolo * quantita_vendute
+ margine_netto = ricavo_totale - costi_totali
+
+ # 2. Modello Peace Business (Distribuzione Etica 50/50)
+ # Il 50% va all'Ambasciatore per il suo lavoro e la sua dignità
+ compenso_ambasciatore = margine_netto * 0.50
+ # Il 50% va all'ecosistema Humansafe (APS) per aprire i centri e gestire la tech
+ fondo_humansafe = margine_netto * 0.50
+
+ return {
+ "Ricavo Totale": ricavo_totale,
+ "Costi Vivi (Piante/Vasi)": costi_totali,
+ "Margine Netto Generato": margine_netto,
+ "Compenso Ambasciatore": compenso_ambasciatore,
+ "Fondo Ecosistema Humansafe": fondo_humansafe
+ }
+
+# --- SIMULAZIONE DELLA GIORNATA DI UN AMBASCIATORE ---
+if __name__ == "__main__":
+ print("=== SIMULATORE PEACE BUSINESS: RADICI UMANE ===")
+
+ # Esempio: L'ambasciatore distribuisce 20 piante a 15€ l'una. Costo all'ingrosso 4€.
+ risultato = calcola_distribuzione_fondi(prezzo_pianta=15, quantita_vendute=20, costo_ingrosso_singolo=4)
+
+ print(f"Piante distribuite: 20")
+ print(f"Ricavo Totale: € {risultato['Ricavo Totale']:.2f}")
+ print(f"Costi Vivi (Materiale): € {risultato['Costi Vivi (Piante/Vasi)']:.2f}")
+ print("-" * 40)
+ print(f"MARGINE NETTO: € {risultato['Margine Netto Generato']:.2f}")
+ print("-" * 40)
+ print(f"💰 Compenso Ambasciatore (Dignità): € {risultato['Compenso Ambasciatore']:.2f}")
+ print(f"🏛️ Fondo Humansafe APS (Strutture): € {risultato['Fondo Ecosistema Humansafe']:.2f}")
+ print("\n[SISTEMA]: Modello economico sostenibile. Il Peace Business è attivo.")
diff --git a/modules/hsi-engine.js b/modules/hsi-engine.js
new file mode 100644
index 0000000..e46ff7b
--- /dev/null
+++ b/modules/hsi-engine.js
@@ -0,0 +1,179 @@
+@'
+import {
+ updateHSIProfile,
+ addTimelineEvent,
+ addBadge,
+ addMission
+} from "./profile-engine.js";
+
+const HSI_QUESTIONS = [
+ { id: "awareness_1", text: "Riesco a riconoscere con chiarezza ciò che provo prima di reagire.", axis: "awareness" },
+ { id: "awareness_2", text: "Mi fermo a riflettere prima di prendere decisioni importanti.", axis: "awareness" },
+ { id: "awareness_3", text: "Mi accorgo quando sto vivendo in automatico.", axis: "awareness" },
+
+ { id: "sovereignty_1", text: "So distinguere tra ciò che penso davvero e ciò che assorbo dall’esterno.", axis: "sovereignty" },
+ { id: "sovereignty_2", text: "Resisto alla pressione di conformarmi digitalmente o socialmente.", axis: "sovereignty" },
+ { id: "sovereignty_3", text: "Metto in discussione contenuti e stimoli prima di accettarli.", axis: "sovereignty" },
+
+ { id: "resilience_1", text: "Riesco a regolare le emozioni senza esserne travolto.", axis: "resilience" },
+ { id: "resilience_2", text: "Costruisco relazioni che mi fanno crescere invece di svuotarmi.", axis: "resilience" },
+ { id: "resilience_3", text: "Cerco di agire in modo coerente con i miei valori.", axis: "resilience" }
+];
+
+const form = document.getElementById("hsi-form");
+const submitBtn = document.getElementById("submit-hsi");
+const resultBox = document.getElementById("hsi-result");
+const resultContent = document.getElementById("hsi-result-content");
+const continueBtn = document.getElementById("continue-btn");
+
+function renderQuestions() {
+ form.innerHTML = HSI_QUESTIONS.map((q, index) => `
+
+ HUMANSAFE Circle non è un social classico. È uno spazio per condividere missioni,
+ riflessioni, checkpoint e richieste di aiuto senza trasformare tutto in rumore o gara.
+