Guia formativa SOS · Fes-te expert/a

El model d'aprenentatge del SOS és l'acció-formació: es fa, i el fet queda com a certificació. Aquesta pàgina és el repositori per preparar-te — 16 mòduls en dos blocs, itineraris per rol i per tipus d'organització, el programa de Gestor/a i les fonts per ampliar. La mentoria la fan els primers formats en la gestió del SOS.

🌀 El model: acció-formació

Aquí no s'estudia primer i es fa després. Es fa, i el fet queda com a certificació. Cada hora que aportes, cada mapa que dibuixes, cada decisió que signes queda al ledger — i aquest mateix registre és el que acredita el teu aprenentatge. No hi ha examen perquè no cal: l'evidència ja hi és.

🔁 El cicle

  • Fas una acció real al teu territori (no un exercici).
  • Queda registrada i signada criptogràficament.
  • La reflexiones amb un mentor que ja ha passat per allà.
  • Marxes amb un encàrrec concret per a la propera vegada.

👥 Qui mentora

Els primers formats en la gestió del SOS. Qui arriba a N2 (Gestor) pot acompanyar practicants; qui arriba a N3 (Mentor) forma gestors. La cadena es sosté sola: cada promoció forma la següent, i la mentoria rebuda i donada queda igualment registrada com a aportació de valor.

Els 4 nivells

N0
Explorador/a
Tens perfil i entens per a què serveix el SOS.
Evidència: perfil creat
N1
Practicant
Operes una dinàmica real: aportes, intercanvies, registres.
Evidència: aportacions signades + oferta o objecte publicat
N2
Gestor/a SOS
Sostens un node sencer: mapa, governança, comptabilitat i incubació.
Evidència: ≥20 h · ≥3 comunitats o 1 venture liderada
N3
Mentor/a
Formes altres gestors i certifiques la seva pràctica.
Evidència: ≥50 h · ≥3 comunitats · 2 ventures o 1 graduada

Al SOS, el launcher → 🎓 Prepara la meva mentoria llegeix el teu ledger i genera l'itinerari adaptat: què ja domines, què et falta, quins mòduls et toquen i el guió de la sessió de 60 minuts. Aquesta pàgina és el repositori on t'hi prepares.

🧭 Itineraris

Són 16 mòduls i ningú els fa tots. Hi ha dues maneres d'entrar: pel rol que tens dins del SOS, o pel tipus d'organització des d'on véns. Tria la que t'expliqui millor.

Per rol dins del SOS

RolCamí curt (ser útil ja)Amplia desprésFita
🏛 Guardian del territoriM1 · M3 · M5M9 · M11 · M14 · M2Signar decisions amb quòrum
🦸 Superheroi/naM1 · M4 · M7M10 · M3Primer intercanvi signat
👥 Coordinador/a de comunitatM1 · M3 · M4 · M9M10 · M11 · M6Onboarding de 5 persones
🌐 Agent territorialM1 · M3 · M8M12 · M14 · M5Ancorar un pack públic
💫 SimpatitzantM1 · M4M7 · M10Entendre on encaixes

Per tipus d'organització

D'on vénsItinerariFitaDurada
🏛 Ajuntament o consell comarcal
tècnic/a de participació o promoció
M1 · M3 · M9 · M4 · M5 · M14 · M12Un mapa validat per la comunitat i una decisió presa i registrada3–4 mesos
🤝 Entitat o associació
AVV, ateneu, banc de temps, casal
M1 · M4 · M9 · M11 · M10 · M148 socis actius, 15 intercanvis signats i un relleu identificat2 mesos
🚀 Projecte econòmic o cooperativa
SCCL en creació o consolidació
M1 · M3 · M6 · M13 · M12 · M14Una venture a validació amb equity repartit i ningú per sobre del 70%4–6 mesos
🌱 Grup promotor sense forma jurídica
comunitat energètica, grup de consum, habitatge
M1 · M3 · M13 · M12Forma jurídica decidida i primera convocatòria identificada4–6 setmanes
🎓 Professional o entitat d'acompanyament
Ateneu, consultoria ESS, dinamització
Les 6 competències + M16 · M9 · M11 · M15Dos casos acompanyats amb evidència, tutelats per un N36 mesos des de N2
💛 Fundació o finançador
obra social, convocatòries
M1 · M14 · M8Un informe d'impacte verificat amb Anchor Pack3 sessions

No saps quin et toca? El diagnòstic de 3 minuts te'l diu, amb els recursos que ja tens i els que et falten.

Índex de mòduls

  1. Fonaments SOS i codex Antigravity · filosofia + stack W3C + local-first
  2. Identitat descentralitzada i criptografia · did:sos, firma, cadena hash, carteres
  3. Value Network Analysis (Verna Allee) · rols funcionals + fluxos recíprocs
  4. Recursos comunitaris · banc de temps + biblioteca de les coses
  5. Governança i Guardians · sabiduria + quòrum + assemblea federativa Penrose
  6. MATRIU, Slicing Pie i intercooperació · ventures + equity dinàmic + Mondragón
  7. Comando Molekulon i reputació · superheroi + cromos + multivers narratiu
  8. Ancoratge públic i IA integrada · Nostr + IPFS/Arweave + AI adapter DRY

Bloc B · L'ofici comunitari

  1. Facilitació i dinamització de grups · portar la sala, no exposar-hi
  2. Comunicació i captació de persones · que la gent vingui i es quedi
  3. Conflictes, cures i relleu · el burnout mata més projectes que el mètode
  4. Finançament i subvencions a Catalunya · convocatòries + justificació
  5. Formes jurídiques i tràmits · associació · SCCL · SL · autònom
  6. Mesura d'impacte i justificació · demostrar, no llistar
  7. Dades, privadesa i RGPD · què és públic i què és irreversible
  8. Formació de formadors · l'ofici de mentorar · N3
  1. 🔧 Manual tècnic · Desenvolupament i administració · carteres permaweb · Nostr · Claude API · allotjament propi

Més enllà dels mòduls

MÒDUL 1 · 4-6 h

Fonaments SOS i codex Antigravity

Comprendre la filosofia, l'stack tècnic i les línies vermelles del sistema.

SOS no és una app més: és una manera d'entendre el desenvolupament comunitari com un sistema operatiu — capes, protocols, permisos, sobirania. Aquest mòdul et dóna el marc mental per tot el que vindrà després.

Objectius formatius

🛠 Skills que desenvolupes

  • Pensament sistèmic aplicat a comunitats
  • Lectura d'arquitectura W3C (HTML/CSS/JS mòduls natius)
  • Anàlisi crítica de dependències
  • Cultura Zero Redundancy (DRY radical)

🌱 Aptituds que creixen

  • Rigor amb la sobirania de dades
  • Respecte per estàndards oberts
  • Paciència amb la simplicitat
  • Sentit de servei procomú

🧰 Eines / conceptes SOS

SOS/index.html (fitxer únic autocontingut) · IndexedDB · WebRTC · SubtleCrypto · window.__SOS hook · Codex V11-V17 (SOS/knowledge/codex.md)

Stack tècnic: HTML5 · CSS custom properties · ES modules · IndexedDB · WebRTC · WebCrypto API · WebSocket · fetch · CompressionStream · BarcodeDetector. Sense frameworks, sense servidors.

🎓 Metodologia recomanada

Llegeix el codex sencer. Obre SOS/index.html a l'editor. Cerca "Zero Redundancy" i observa on es materialitza. Fes una llista de tots els mòduls funcionals que trobes.

✏ Exercici pràctic

Obre SOS al navegador. Al DevTools: escriu window.__SOS i explora quantes funcions exposa (>150). Escull-ne 5 i escriu què creus que fa cadascuna. Verifica després amb el codi.

MÒDUL 2 · 6-8 h

Identitat descentralitzada i criptografia

Sobirania criptogràfica: `did:sos`, firma, cadena hash, carteres, xifratge multi-membre.

Cada acció al SOS pot ser signada, encadenada i xifrada sense confiar en cap servidor. Aquest mòdul et dóna els fonaments per operar amb identitat auto-sobirana i comptabilitat verificable.

Objectius formatius

🛠 Skills que desenvolupes

  • WebCrypto API W3C (generateKey, sign, verify, digest)
  • Ed25519 · ECDSA-P256 · ECDH-P256 · AES-GCM · PBKDF2 · HKDF
  • base64url encoding / decoding
  • WebAuthn / passkeys
  • Merkle chains + hash-based integrity

🌱 Aptituds que creixen

  • Higiene de claus privades
  • Escepticisme sistemàtic (verify before trust)
  • Comprensió d'incentius d'atacants
  • Rigor documental (què firmes, què no)

🧰 Eines / conceptes SOS

getIdentity() · signRecord(rec) · verifyRecord(rec) · chainLedger(list) · verifyChain(list) · pushLedger() · bindPasskey() · generateNodeKey() · wrapNodeKeyForMember() · getMyNodeKey() · myExchangeCard()

🎓 Metodologia recomanada

Segueix el flux "primer boot → identitat automàtica → primera firma → primer envelope". Fes servir DevTools per veure les JWKs sense sortir del navegador. Utilitza el test-crypto.mjs com a guió d'aprenentatge.

✏ Exercici pràctic

1) Obre SOS en dos navegadors diferents (dues identitats did:sos). 2) A la Sabiduria del node, comparteix la clau de xifratge amb l'altre. 3) Verifica que l'altre pot llegir el contingut xifrat i un tercer navegador no.

MÒDUL 3 · 5-7 h

Value Network Analysis (Verna Allee)

Dissenyar xarxes de valor sostenibles: rols funcionals + fluxos tangibles/intangibles + reciprocitat.

La metodologia VNA de Verna Allee és la base del disseny de qualsevol xarxa de valor a SOS. Ni organigrama, ni cadena de valor lineal: mapes relacionals amb rols funcionals i intercanvis bidireccionals.

Objectius formatius

🛠 Skills que desenvolupes

  • Metodologia VNA (rols · fluxos · salut)
  • Facilitació de tallers de mapatge
  • Anàlisi de densitat, reciprocitat, diversitat
  • Ús de presets DYNAMICS (10+ dinàmiques comunitàries)

🌱 Aptituds que creixen

  • Sensibilitat als intangibles
  • Escolta activa (Barbamuda!)
  • Visió sistèmica en temps real
  • Facilitació neutra

🧰 Eines / conceptes SOS

DYNAMICS catalog (banc de temps, biblioteca, energia, habitatge, cures…) · seedFromDynamic() · buildHealth() · renderVNA() · aiSuggestMap() per IA · ARCHETYPES · knowledge/references/vna-verna-allee.md

🎓 Metodologia recomanada

Del general al concret: primer defineix la metaskill (missió/visió/objectius). Després els 5-8 rols funcionals. Després els 6-12 intercanvis, amb barreja tangibles/intangibles. Comprova buildHealth per rols aïllats i topologia estrella.

✏ Exercici pràctic

Instancia una Comunitat energètica al SOS. Mira el mapa VNA generat. Identifica quins fluxos falten. Afegeix 3 intercanvis intangibles nous que reforcin la reciprocitat.

MÒDUL 4 · 4-6 h

Recursos comunitaris — Banc de temps i Biblioteca de les coses

Els dos comuns més universals: hores i objectes. Gestionats amb pings i matching descentralitzat.

Cada minut donat i cada objecte compartit multiplica el valor de la comunitat sense multiplicar-ne el cost. Aquest mòdul t'ensenya a modelar i operar els dos comuns més accessibles.

Objectius formatius

🛠 Skills que desenvolupes

  • Economia solidària aplicada
  • Disseny de taxonomies (categoria/tipologia)
  • Gestió operativa d'un banc de temps
  • Onboarding de socis (superheroi flow)

🌱 Aptituds que creixen

  • Cura de la reciprocitat
  • Justícia distributiva
  • Atenció a les persones invisibilitzades
  • Prevenció del burnout dels ponents

🧰 Eines / conceptes SOS

membersOf() · offersOf() · objectsOf() · lendObject() · reserveObject() · exchangeHours() · memberBalance() · dueStatus() · findMatches() · openMatchesModal() · SKILL_TOP20 · OBJECT_TOP20 · openSuperheroiOnboarding()

🎓 Metodologia recomanada

Comença amb 3-5 socis. Registra ofertes reals (no simulades). Fes un intercanvi que quedi al ledger firmat. Explora els Pings ecosistema per veure matchings automàtics entre bancs de temps adjacents.

✏ Exercici pràctic

Crea 2 bancs de temps (pobles A i B). Registra a A un/a superheroi que ofereix informàtica; a B un/a que la demana. Obre 🔔 Pings ecosistema. Verifica que el matching cross-node apareix i que pots iniciar un intercanvi signat.

MÒDUL 5 · 6-8 h

Governança i Guardians — Sabiduria + Assemblea federativa

Presa de decisions signada + votació ponderada matemàticament equitativa (llei Penrose).

Sense governança clara, les xarxes de valor col·lapsen. SOS incorpora un sistema de propostes signades amb quòrum de guardians (stewards) i una assemblea federativa amb vot ponderat per √població amb correcció Gini.

Objectius formatius

🛠 Skills que desenvolupes

  • Disseny de governança democràtica
  • Facilitació assembleària
  • Càlcul de pesos federatius (√població × activitat)
  • Aplicació d'indicadors de concentració (Gini)

🌱 Aptituds que creixen

  • Sentit de la mesura entre eficàcia i deliberació
  • Cura de les minories
  • Delegació saludable
  • Transparència compulsiva

🧰 Eines / conceptes SOS

govOf() · claimNode() · roleOf() · canWrite() · proposeChange() · voteProposal() · applyIfQuorum() · openGovernanceModal() · federativeWeight() · giniOfWeights() · equityAdjust() · tallyFederation() · openFederationModal()

🎓 Metodologia recomanada

Configura una comarca amb 3 municipis de mides molt diferents. Simula una decisió a l'Assemblea federativa. Observa com √població reparteix pes just. Prova d'inflar la població d'un bloc: la correcció Gini el modula.

✏ Exercici pràctic

Reclama un node. Convida un altre navegador a l'ecosistema. Des d'observer sol·licita ser guardian. Des d'owner, aprova la petició. Verifica que el nou guardian pot votar propostes.

MÒDUL 6 · 7-9 h

MATRIU · Slicing Pie · Intercooperació Mondragón

Incubadora de projectes econòmics amb equity dinàmic i intercooperació entre ventures.

La MATRIU és el mecanisme més complex de SOS: incubar iniciatives crítiques del territori amb Slicing Pie (Mike Moyer) i deixar-les cooperar entre elles estil Mondragón — sense advocats, sense despatxos, tot al navegador.

Objectius formatius

🛠 Skills que desenvolupes

  • Model Slicing Pie de Mike Moyer
  • Anàlisi econòmica de fons cooperatius
  • Valoració FMV per skill i tipologia d'objecte
  • Disseny d'intercooperació entre projectes
  • Facilitació d'incubadores comunitàries

🌱 Aptituds que creixen

  • Visió econòmica cooperativa
  • Equitat dinàmica sense discussions
  • Paciència amb l'agregat lent
  • Ètica de la circulació (no extracció)

🧰 Eines / conceptes SOS

CRITICAL_ACTIVITIES · newVenture() · venturesOf() · allocationsOf() · ventureLedger() · equityCfg() · computeEquity() · computeVentureEquity() · buildEquityWrap() · ecosystemResources() · fundRollup() · fundValue() · ORACLE_FMV_DEFAULTS · ORACLE_OBJECT_DEFAULTS · transferBetweenVentures() · cooperationSummary() · graduateVenture() · openMatriuXXX modals

🎓 Metodologia recomanada

Comença per un fons petit (2-3 socis, 20-40 hores mobilitzades). Incuba 2 ventures des de CRITICAL_ACTIVITIES. Assigna recursos i observa el Fons cooperatiu rollup. Executa una intercooperació entre ventures i verifica la cadena hash del log.

✏ Exercici pràctic

Configura MATRIU + banc de temps + biblioteca vinculats. Simula 1 any: 5 socis, 200h aportades, 2 ventures actives, 1 intercooperació entre elles. Obre el panell 🔮 Valor del fons i valida el rang €-min/esperat/max.

MÒDUL 7 · 5-7 h

Comando Molekulon · Reputació · Multivers narratiu

La capa gamificada + narrativa transmedia: superherois, cromos, balanç entre obrir i tallar, i pel·lícula col·lectiva.

La reputació al SOS és verificable: surt del ledger signat. La narrativa és viva: cada intercanvi és una llavor de la pel·lícula del Comando. Aquest mòdul t'ensenya a activar el marc que fa que la gent torni.

Objectius formatius

🛠 Skills que desenvolupes

  • Gamification per procomú
  • Narrativa transmedia (còmic + música + performativa)
  • Disseny d'arquetips funcionals (vèdic/celta/andí/secular)
  • Càlcul de matching (molekulonAffinity)
  • Storytelling comunitari

🌱 Aptituds que creixen

  • Creativitat vibrant · obrir i sembrar
  • Rigor transformador · tallar i renovar
  • Sentit d'aventura col·lectiva
  • Humilitat davant l'ego perdut

🧰 Eines / conceptes SOS

reputationOf() · superheroCromo() · comandoRoster() · directorFilter() · openComandoView() · ARCHETYPES · ARCHETYPE_SETS (vèdic/celta/andí/secular) · SKILL_POLARITY · molekulonAffinity() · CANONICAL_HEROES · CROMO_TIERS · COMANDO_TARGET (150.000) · evaluateChallenges() · openNarrativeKit() · saveNarrative() · openMultiverse()

🎓 Metodologia recomanada

Dóna d'alta 5 superherois amb superpoders diferents. Obre el Comando Catalunya i observa els cromos rank-ordenats. Genera un Kit narratiu pel grup més complementari. Guarda al multivers. Repeteix amb un altre grup.

✏ Exercici pràctic

Al perfil transversal d'un superheroi, revisa els Reptes actius. Identifica quin repte cal completar per pujar a Bronze tier. Actua a SOS fins que el repte quedi ✓.

MÒDUL 8 · 6-8 h

Ancoratge públic i IA integrada

Sortir a l'obert: Nostr, Anchor Pack per IPFS/Arweave, AI adapter DRY i simuladors d'impacte.

Fins ara tot ha viscut al navegador. Ara aprens a projectar el sistema cap enfora amb proves públiques signades i amb IA integrada per generar mapes, valoracions i narrativa.

Objectius formatius

🛠 Skills que desenvolupes

  • Nostr protocol (NIP-33 replaceable events, NIP-07 signer)
  • Content addressing (CID SHA-256)
  • Prompt engineering + intent catalog
  • Oracles FMV editables
  • OAuth device flow (GitHub)
  • Anàlisi psicoeconòmica territorial

🌱 Aptituds que creixen

  • Cura de la traçabilitat pública
  • Cost-benefit d'utilitzar IA (Glass-Box)
  • Comunicació política amb dades reals
  • Dijitalizar simultàniament sense servidor propi

🧰 Eines / conceptes SOS

AI.call(intent, ctx) · 8+ intents versionats a SOS/prompts/*.md · NOSTR_RELAYS_DEFAULT · nostrBuildAnchor() · nostrPublishAnchor() · buildAnchorPack() · verifyAnchorPack() · downloadAnchorPack() · simulateImpact() · openImpactSimulator() · GH.deviceStart() · reviewPRWithAI() · openIdentityDashboard()

🎓 Metodologia recomanada

Un cop tens un node amb activitat real (Mòdul 6 completat), fes un cicle complet d'ancoratge: (a) genera Anchor Pack + CID · (b) puja'l a Arweave/IPFS · (c) publica el mainHash a Nostr. Cadascú pot verificar el pack sense confiar en TeamTowers.

✏ Exercici pràctic

Simula l'Impacte cas Catalunya per al teu municipi. Ajusta la penetració al 10%. Anota l'estalvi €/any + reducció solitud + tCO2. Fes captura i comparteix-la a xarxes amb link a SOS.

🧰 Bloc B · L'ofici comunitari

Els vuit mòduls anteriors ensenyen el sistema. Aquests vuit ensenyen l'ofici — i és per aquí per on moren els projectes: no per falta de mètode, sinó per falta de gent, per conflictes que ningú tracta i per no saber com finançar-se. Cap itinerari els fa tots: agafa els que et toquen.

MÒDUL 9 · 5-7 h · Bloc B

Facilitació i dinamització de grups

Portar una sala amb deu persones que no s'escolten, i sortir-ne amb un mapa que reconeixen com a seu.

Sabies fer el mapa VNA; ara has d'aconseguir que el faci la comunitat. Un mapa dibuixat per tu és una opinió; un mapa dibuixat per elles és un acord.

Objectius formatius

🛠 Skills que desenvolupes

  • Disseny de sessions participatives
  • Preguntes obertes i reformulació
  • Tècniques de torn i de grup petit
  • Registre en directe sense perdre el fil
  • Tancament amb acords verificables

🌱 Aptituds que creixen

  • Neutralitat activa
  • Tolerància al silenci
  • Detecció del que no es diu
  • Renúncia a tenir raó

🎓 Metodologia recomanada

Co-facilita abans de facilitar sol. Grava't (amb permís) i escolta quant parles: si passes del 20% del temps, no estàs facilitant, estàs exposant.

✏ Exercici pràctic

Facilita una sessió de mapatge real de 90 min. Mesura: quantes persones han parlat, quants intangibles han sortit sense que els proposessis tu, i si al final el grup ha reconegut el mapa com a seu.

MÒDUL 10 · 4-6 h · Bloc B

Comunicació i captació de persones

Els projectes comunitaris no moren per mal mètode. Moren perquè no hi va ningú.

Tenir el millor mapa de valor del món no serveix de res amb quatre persones esgotades. Aquest mòdul va de la feina menys glamurosa i més decisiva: que la gent vingui i es quedi.

Objectius formatius

🛠 Skills que desenvolupes

  • Proposta de valor en veu de comunitat
  • Demanda concreta i acotada
  • Onboarding de baixa fricció
  • Ús del cromo i dels reptes com a ganxo
  • Xarxes sense cremar-s'hi

🌱 Aptituds que creixen

  • Empatia amb qui encara no hi és
  • Concreció
  • Persistència sense insistència
  • Celebració pública del que fan altres

🎓 Metodologia recomanada

Prova la teva frase amb cinc persones alienes al projecte. Si l'han de repetir i no poden, la frase és teva, no seva. Reescriu fins que la puguin dir elles.

✏ Exercici pràctic

Fes una demanda concreta i acotada (una tasca, una data, dues hores) a deu persones. Compta quantes diuen que sí. Repeteix amb una demanda genèrica. Compara.

MÒDUL 11 · 5-7 h · Bloc B

Conflictes, cures i relleu

El burnout dels que sempre donen és la primera causa de mort d'un projecte comunitari.

Al SOS ho pots veure abans que passi: el mapa ensenya qui sosté què i el ledger ensenya qui aporta sempre. Aquest mòdul t'ensenya a llegir aquests senyals i a actuar-hi mentre encara es pot.

Objectius formatius

🛠 Skills que desenvolupes

  • Lectura de senyals d'esgotament al ledger
  • Mediació bàsica
  • Repartiment de càrrega invisible
  • Protocols de relleu i documentació
  • Converses difícils

🌱 Aptituds que creixen

  • Cura de si mateix i dels altres
  • Valentia per nomenar l'evident
  • Desapego del propi protagonisme
  • Paciència amb els ritmes

🎓 Metodologia recomanada

Revisa mensualment el balanç d'hores per persona. Si algú porta tres mesos donant molt més del que rep, això no és generositat: és una baixa que encara no s'ha produït.

✏ Exercici pràctic

Identifica la persona més sobrecarregada del teu node amb dades, no amb intuïció. Dissenya amb ella un pla de relleu de tres mesos i registra'l com a decisió pública.

MÒDUL 12 · 6-8 h · Bloc B

Finançament i subvencions a Catalunya

El mur real d'un projecte comunitari no és la idea: és el calendari de convocatòries i la justificació.

Saber fer un mapa de valor excel·lent i no saber d'on surten els diners per sostenir-lo és una manera elegant de fracassar. Aquest mòdul és el més prosaic i el que més projectes salva.

Objectius formatius

🛠 Skills que desenvolupes

  • Cerca i calendari de convocatòries
  • Pressupost de projecte realista
  • Justificació econòmica i tècnica
  • Ús del ledger SOS com a base justificativa
  • Finançament ètic (Coop57, Fiare)

🌱 Aptituds que creixen

  • Rigor administratiu
  • Anticipació
  • Honestedat en la imputació
  • Resistència a la burocràcia

🧰 Enllaç amb el SOS

Les hores del banc de temps i el fundValue amb el seu desglossament serveixen per acreditar aportació en espècie — sovint el cofinançament que falta per arribar al percentatge exigit.

✏ Exercici pràctic

Munta el calendari de convocatòries del teu territori per als propers 12 mesos. Tria'n una i prepara el pressupost complet, incloent-hi l'aportació en espècie treta del SOS.

MÒDUL 13 · 5-7 h · Bloc B

Formes jurídiques i tràmits

Associació, SCCL, SCP, SL, autònom col·laborador. Quina, quan i per què.

La MATRIU ja et suggereix formes jurídiques segons el tipus de projecte. Aquest mòdul t'ensenya què hi ha darrere de cada suggeriment i com fer el tràmit sense encallar-te.

Objectius formatius

🛠 Skills que desenvolupes

  • Comparativa de formes societàries
  • Estatuts bàsics i pactes de socis
  • Tràmits de constitució i registre
  • Obligacions comptables i fiscals
  • Relació entre Slicing Pie i participacions reals

🌱 Aptituds que creixen

  • Prudència jurídica
  • Saber quan derivar a un professional
  • Lectura de lletra petita

🎓 Metodologia recomanada

Treballa-ho amb l'Ateneu Cooperatiu del teu territori: l'acompanyament a la constitució és gratuït i ells coneixen les particularitats locals. Aquest mòdul et prepara per aprofitar-lo, no per substituir-lo.

✏ Exercici pràctic

Per a una venture real de la teva MATRIU, compara tres formes jurídiques amb cost, termini i implicacions. Argumenta la recomanació i registra-la com a decisió.

MÒDUL 14 · 5-7 h · Bloc B

Mesura d'impacte i justificació

Demostrar què has provocat, no llistar què has fet.

Comptar activitats i assistents no és mesurar impacte. El SOS et dona mètriques relacionals — reciprocitat, hores donades, persones actives, ventures de cura — sostingudes per un ledger signat. Aquest mòdul t'ensenya a defensar-les davant de qui paga.

Objectius formatius

🛠 Skills que desenvolupes

  • Teoria del canvi
  • Indicadors relacionals i no només de volum
  • Lectura de matriuPsychoImpact
  • Balanç social i marcs ESS
  • Redacció d'informes amb dades verificables

🌱 Aptituds que creixen

  • Honestedat amb els números
  • Resistència a inflar resultats
  • Claredat expositiva

🎓 Metodologia recomanada

Explica sempre la incertesa. Un rang honest (fundValue dona ±30%) genera més confiança que una xifra exacta que ningú pot comprovar.

✏ Exercici pràctic

Redacta un informe d'impacte d'una pàgina del teu node: què ha canviat, per a qui, amb quines dades i com es pot verificar. Que algú de fora el llegeixi i et digui si s'ho creu.

MÒDUL 15 · 4-5 h · Bloc B

Dades, privadesa i RGPD

Una comunitat que gestiona dades de persones té obligacions legals, encara que sigui voluntària.

El SOS és local-first i xifrat, cosa que et posa molt per davant de qualsevol full de càlcul compartit. Però local-first no vol dir exempt: si tractes dades de socis, has de saber què pots fer i què no.

Objectius formatius

🛠 Skills que desenvolupes

  • Inventari de tractaments
  • Consentiment informat real
  • Xifratge per node i distribució de claus
  • Criteri de publicació i pseudonimització
  • Resposta a exercicis de drets

🌱 Aptituds que creixen

  • Respecte per la intimitat aliena
  • Prudència amb l'irreversible
  • Transparència sense exhibicionisme

⚠️ Regla d'or de l'ancoratge

El que ancores a Arweave és per sempre. Abans de publicar, revisa el toPublicPack: ancora hashos i agregats, mai dades personals en clar. Un error aquí no té marxa enrere.

✏ Exercici pràctic

Fes l'inventari de dades personals del teu node. Per cadascuna: base legal, qui hi accedeix, quant temps es conserva. Després genera un Anchor Pack i verifica que no hi ha res personal en clar.

MÒDUL 16 · 8-10 h · Bloc B · nivell N3

Formació de formadors · l'ofici de mentorar

Com acompanyar altres perquè aprenguin fent, sense fer-los la feina.

Aquest mòdul és el que fa que el model se sostingui: cada promoció ha de poder formar la següent. Sense mentors, això és consultoria; amb mentors, és una xarxa.

Objectius formatius

🛠 Skills que desenvolupes

  • Ús de aiPrepareMentoring com a punt de partida, no com a guió tancat
  • Preguntes que desencallen
  • Disseny d'encàrrecs
  • Avaluació per evidència
  • Tutela de casos i supervisió entre mentors

🌱 Aptituds que creixen

  • Contenció: no prendre el teclat
  • Confiança en el ritme aliè
  • Generositat amb el mèrit
  • Rigor a l'hora de certificar

🎓 Metodologia recomanada

Acompanya els dos primers casos amb un mentor N3 al costat. Després de cada sessió, escriviu per separat què creieu que ha passat i compareu-ho: aquí és on s'aprèn a mentorar.

✏ Exercici pràctic

Acompanya una persona de N0 a N1 amb evidència al ledger. Registra cada sessió com a aportació de valor. Al final, escriu què faries diferent — i comparteix-ho amb els altres mentors.

🎖 Programa de Gestor/a SOS

Un gestor SOS no és qui sap fer servir l'app: és qui pot posar un territori en marxa i sostenir-lo. Aquest programa és el pont entre N1 (Practicant) i N2 (Gestor), i el requisit per després mentorar.

~45 h
dedicació total
6
competències
3–4 mesos
durada típica
1
territori real

Regla d'or: el programa es fa sobre una comunitat de veritat, no un cas d'estudi. Si no tens territori, el primer encàrrec és trobar-lo.

Les 6 competències

C1

Diagnosticar una comunitat

M3 · 8 h

Entrar en una comunitat que no coneixes i sortir-ne amb el seu mapa de valor dibuixat i validat pels seus membres.

Sabràs fer

  • Facilitar una sessió de mapatge VNA amb 6–10 persones
  • Distingir rols funcionals de càrrecs i noms propis
  • Detectar topologia estrella i rols aïllats
  • Nomenar els intangibles que ningú anomena

Evidència per superar-la

Un mapa de valor real, fet amb la comunitat (no per a ella), amb ≥5 rols i ≥8 fluxos, diversitat tangible/intangible i buildHealth sense rols aïllats. La comunitat l'ha de reconèixer com a seu.

C2

Obrir i sostenir una dinàmica

M4 · 8 h

Posar en marxa un banc de temps o una biblioteca de les coses i que segueixi viu tres mesos després.

Sabràs fer

  • Onboarding de socis sense fricció (flux superheroi)
  • Dissenyar el catàleg inicial amb els top-20 curats
  • Registrar intercanvis signats i gestionar venciments
  • Detectar i prevenir el burnout dels que sempre donen

Evidència per superar-la

Una dinàmica amb ≥8 socis actius i ≥15 intercanvis signats, amb saldos que no estiguin tots del mateix costat. El desequilibri crònic és el senyal que la dinàmica no és recíproca.

C3

Governar amb legitimitat

M5 · 8 h

Que les decisions es prenguin, quedin i es puguin defensar davant de qualsevol — inclosa una administració.

Sabràs fer

  • Reclamar node, configurar quòrum i repartir guardians
  • Portar una assemblea àgil des del mòbil
  • Explicar per què √població reparteix pes just entre municipis desiguals
  • Aplicar la correcció Gini quan un bloc concentra

Evidència per superar-la

≥5 propostes signades i votades, de les quals almenys una rebutjada (una governança on tot s'aprova no està decidint, està ratificant) i el registre públic de decisions ancorat.

C4

Incubar amb la MATRIU

M6 · 10 h

Acompanyar una iniciativa des de la idea fins que camina sola, amb la propietat repartida amb justícia.

Sabràs fer

  • Triar la via de creació correcta (activitat crítica · prototip · IA)
  • Sembrar el pla d'sprints des del mapa de valor
  • Sostenir les portes d'etapa quan algú té pressa per avançar
  • Explicar Slicing Pie a qui tem perdre-hi
  • Provocar intercooperació entre ventures germanes

Evidència per superar-la

Una venture que arriba a validació amb readiness ≥80%, o una graduada. Més una intercooperació signada entre dues ventures. Detall clau: cap membre amb >70% d'equity.

C5

Comptabilitzar el valor

M6 · M8 · 6 h

Poder respondre «i això quant val?» amb una xifra defensable i el seu desglossament.

Sabràs fer

  • Ajustar l'oracle FMV al teu territori (no val el mateix a Barcelona que a Torrelles)
  • Llegir fundValue amb el seu rang i explicar la incertesa
  • Defensar la valoració d'hores davant d'algú que només compta euros
  • Interpretar l'impacte psicosocial: reciprocitat, hores solidàries, persones actives

Evidència per superar-la

Un informe de valor del fons amb oracle calibrat al territori, i saber explicar per què la reciprocitat és una xifra tan important com el capital mobilitzat.

C6

Fer-ho verificable i transmissible

M2 · M8 · 5 h

Que el que has construït sobrevisqui a la teva marxa i qualsevol el pugui auditar.

Sabràs fer

  • Generar Anchor Packs i verificar-los sense confiar en ningú
  • Ancorar el mainHash a Nostr i explicar què demostra i què no
  • Sincronitzar entre dispositius i deixar rellevament
  • Documentar el node perquè el següent gestor l'entengui

Evidència per superar-la

Un Anchor Pack verificat per una tercera persona i un event Nostr públic. Prova final: algú altre agafa el teu node i el continua sense trucar-te.

Calendari suggerit

MesFocusCompetènciesMentoria
1Entrar i diagnosticarC1 · inici C22 sessions
2Fer circularC2 · C32 sessions
3IncubarC4 · C52 sessions
4Consolidar i transmetreC6 · revisió1 sessió + avaluació

🎖 Acreditació com a Gestor/a

Les 6 competències amb la seva evidència al ledger. No hi ha tribunal: hi ha un Anchor Pack signat amb el teu recorregut que qualsevol pot verificar, i un mentor N3 que hi posa la seva signatura. La teva acreditació és tan sòlida com les dades que la sostenen — i tan pública com vulguis.

👥 Equip gestor v1 · les 12 setmanes que posen un territori en marxa

El programa de dalt forma una persona. I això és exactament el defecte que denunciem als altres: el SOS diu a tot arreu que cap projecte pot dependre d'una sola persona —és el primer dels quatre valors, és la comprovació que fa saltar la governança, és la porta que impedeix graduar amb el 70% de l'equity a les mateixes mans— i tanmateix acreditava gestors solitaris. Si aquella persona plega, el territori es queda igual que estava.

Aquest programa és el mateix, repartit. Les sis competències no canvien: canvia que ningú les ha de tenir totes. L'acreditació és de l'equip, i l'entrega no és una persona formada sinó una comunitat que segueix sense nosaltres.

12 setm.
durada
5
rols
6–7
persones mínim
~34 h
de mentoria

On es fa el primer

No s'escull el segment que més paga ni el que més multiplica: s'escull el que produeix el cas d'èxit més ràpid i més defensable.

🎯 La recomanació

Una dinàmica comunitària que ja existeix i que s'està apagant —un banc de temps amb tres anys i la meitat de socis, una biblioteca de les coses que porta una persona sola amb una llibreta— en un municipi de menys de 20.000 habitants, amb l'ajuntament pagant l'acompanyament i l'entitat posant-hi les hores.

El dolor ja existeix i no cal convèncer ningú. El resultat es veu en setmanes, no en un pla estratègic. No es toca res que hagi de decidir un ple. I el cas que en surt —«passaven de 40 socis a 18 i ara en tenen 35 actius»— ven sol davant del següent ajuntament.

✅ Senyals de bon encaix

  • Hi ha almenys dues persones disposades a assumir un rol. Amb una de sola, es repeteix el problema que venim a arreglar.
  • Hi ha activitat real que no es registra enlloc. Si no passa res, el SOS no té què comptar.
  • Algú de l'ajuntament ho vol, no només ho autoritza.

⛔ Senyals d'alerta, i què fer

  • «Volem una app» → dir que no. L'eina és gratuïta; que se l'agafin.
  • Una persona ho sosté tot i no en vol deixar anar cap tros → el problema no és de mètode. M11 abans que res.
  • Ho impulsa un càrrec electe amb eleccions a menys d'un any → demanar que el titular sigui un tècnic.
  • Ni una hora setmanal per persona → no hi ha equip, hi ha bona voluntat. Ajornar.

Cinc rols, sis persones

Els dos rols crítics porten parella de relleu des del primer dia, no quan algú avisa que plega. Aquesta és la diferència pràctica entre predicar Força i practicar-la.

RolQui és a la vida realCompetènciesMòdulsh/setm.
🏛 Guardiana ×2Qui ja convoca les reunionsC3 · C6M5 · M9 · M23
⏳ Dinamitzadora ×2Qui té la llibreta de les horesC2M4 · M103
⬢ Comptable de valorQui porta els números o en té ganesC5M6 · M142
🎓 Mentora d'iniciativesQui acompanya els projectes que neixenC1 · C4M3 · M6 · M162
🌐 Enllaç institucionalEl tècnic o tècnica municipalM12 · M13 · M141

🧭 Qui fa què, sense argot

  • Guardiana — que les decisions es prenguin, quedin escrites i es puguin defensar. No decideix ella: fa que es decideixi.
  • Dinamitzadora — que la gent torni. És l'únic rol que es mesura pel que fan els altres, no pel que fa ella.
  • Comptable de valor — que el que es fa es compti, i que la xifra es pugui explicar a algú que només compta euros. La seva pantalla és #/fons, i la seva regla és una: no ajuntar mai el verificat amb l'estimat. Les hores signades es diuen en hores; convertir-les a euros és una estimació i porta el seu rang al costat. El dia que s'ajunten, la xifra deixa de ser defensable davant de qui la financi.
  • Mentora d'iniciatives — quan del banc de temps en surt un projecte, que no es perdi. Obre la MATRIU quan toca, i no abans.
  • Enllaç institucional — tradueix en les dues direccions entre l'entitat i l'ajuntament. Sovint és qui aconsegueix que això es pagui.

Les quatre fases

Regla que no es negocia: cada setmana ha de deixar evidència al ledger. Una setmana que acaba sense res registrat no ha passat — i és el senyal més primerenc que això s'està tornant un curs en comptes d'una posada en marxa.

FaseObjectiuEvidència acumuladaFita que no es salta
1 · Existir
setmanes 1–3
Que el que ja passa quedi registrat, i que l'equip existeixi6 perfils amb fitxa reclamada · node amb 2 guardians · mapa de ≥5 rols i ≥8 fluxos · ≥15 socisLa comunitat s'ha de reconèixer al mapa. Si algú diu «això no som nosaltres», es torna a la setmana 2
2 · Circular
setmanes 4–6
Que passin coses i quedin comptades≥8 intercanvis signats · ≥5 apunts confirmats per l'altra banda · ≥3 propostes votades amb ≥1 rebutjadaSaldos que no estiguin tots del mateix costat. Millor saber-ho la setmana 6 que el mes 12
3 · Comptar i defensar
setmanes 7–9
Poder respondre «i això quant val?» davant de qui ho pagaOracle calibrat amb el seu perquè · pantalla #/fons amb verificat i mobilitzat separats · Anchor Pack verificat per algú de foraL'enllaç presenta les xifres a l'ajuntament i les sosté. Aquesta sessió decideix si hi ha segon any
4 · Sostenir sense nosaltres
setmanes 10–12
Que sobrevisqui a la nostra marxa i a la d'ellsCòpia restaurada en un altre aparell · publicació versionada o decisió registrada de no publicar · acreditació d'equipLa prova del relleu: algú que no ha portat un rol agafa el node d'una altra i el continua una setmana sense trucar a ningú

Com se sap si hi ha tracció

La tracció no és que els agradi: és que segueixin sense nosaltres. Tot això surt de l'app; no cal cap enquesta.

IndicadorLlindar als 3 mesosOn es mira
Socis actius≥ els que tenien abans, i cap dinàmica per sota de 8Pestanya Socis
Intercanvis signats≥25 acumulats, ≥5 el darrer mesRegistre
Reciprocitat del mapa≥60%vnaAudit
Dies sense moure's<21Tauler d'atenció
Persones amb fitxa reclamada≥6Identitat
Rols amb relleu identificat5 de 5Comando del node
Decisions registrades≥5, amb ≥1 rebutjadaRegistre públic

🎯 El que decideix de veritat

No és cap dels anteriors: és que algú de l'equip convoqui una sessió que no hem convocat nosaltres. El dia que això passa, hi ha tracció. Fins llavors hi ha un servei ben valorat, que no és el mateix.

Senyals d'alerta, per ordre d'aparició: les hores es registren totes el mateix dia just abans de la sessió (s'està fent el deure) · tots els apunts els escriu la mateixa persona (hi ha un gestor, no un equip) · ningú ha rebutjat mai cap proposta (no s'està decidint, s'està ratificant) · la comunitat parla del SOS i no de la seva dinàmica (l'eina ha tapat el fons).

↗ Del primer equip al segon

L'entrega real de les dotze setmanes no és l'acreditació: és que dues persones de l'equip vulguin formar-ne un altre. Cada pas necessita la prova de l'anterior — anar a un Ateneu sense casos és vendre teoria, i anar a un consell comarcal sense un municipi funcionant és demanar un acte de fe.

Equip v1 → cas + 2 persones amb ruta cap a N3 → equip v2 (que ja no formem sols) → consell comarcal → formació de formadors. Si el primer equip no produeix cap futura mentora, el model no escala i ens quedem fent consultoria.

🚫 El que aquest pla no promet

  • Que la dinàmica es recuperi. Si el que la mata és que ningú vol el relleu, això no es resol amb mètode. Es diu a la setmana 3 i s'ajusta l'objectiu; no s'infla l'informe.
  • Segon any. Depèn d'un pressupost que sovint es decideix per raons alienes als resultats.
  • Substituir la dinamització. El SOS compta el que passa; que passi és feina de persones.
  • Servir per a un col·lectiu que encara no fa res. Sense activitat no hi ha res a comptabilitzar i el SOS es converteix en deures.

🤝 Preparar-se per a la mentoria

La sessió dura 60 minuts i no serveix per explicar teoria — per això hi ha aquesta pàgina. Serveix per desencallar el que t'has trobat fent.

📥 Si et mentoren · porta això

  • El teu perfil transversal obert (hores, superpoders, comunitats).
  • Una cosa concreta que t'ha encallat, no una pregunta general.
  • L'encàrrec anterior: fet, a mitges o no fet — les tres respostes són vàlides, amagar-ho no.
  • La pantalla del SOS on passa el problema, no una descripció.

📤 Si mentores · prepara això

  • Obre 🎓 Prepara la meva mentoria sobre el seu perfil: et dona nivell, punts forts, buits, mòduls i guió.
  • Repassa el seu registre d'activitat des de l'última sessió.
  • Decideix un buit a atacar. Un. Atacar-ne tres és no atacar-ne cap.
  • Pensa l'encàrrec abans: petit, verificable al ledger, fet en una setmana.

L'estructura de 60 minuts

10'
Reconèixer el que ja porta. Obrir el cromo i llegir-lo junts. Es comença pel que ja ha fet, mai per la llista del que falta — qui arriba sentint-se deutor no aprèn.
15'
El model en una frase. A N0, explicar acció-formació. A partir de N1, situar on és entre els 4 nivells i què separa el seu del següent.
20'
Mòdul de l'etapa, en pràctica. Obrint l'eina real. Si es fa teoria, la sessió ha fracassat: la teoria és aquesta pàgina i se la pot llegir sol.
10'
Desfer un buit concret. En directe, a la seva instància, amb les seves dades.
5'
Encàrrec i propera cita. Escrits. Sense encàrrec la sessió no compta — i el temps de mentoria es registra al ledger com el que és: aportació de valor.

⚖️ Tres regles del mentor SOS

  • No facis la feina. Si prens el teclat, has resolt un problema i n'has creat un de pitjor: dependència.
  • Les portes no es regalen. Si algú vol saltar una etapa sense evidència, la resposta és què li falta, no un permís.
  • Registra la sessió. El teu temps de mentoria és aportació de valor i genera slices. Que no quedi és regalar valor a un sistema que precisament existeix per no perdre'l.
MANUAL TÈCNIC · Desenvolupament i administració SOS

Configuració avançada — integracions externes

Guia pas a pas per connectar SOS amb carteres permaweb (Arweave), signadors Nostr, IA i identitat forta. Tot opcional: SOS funciona 100% offline sense res d'això.

SOS és local-first sense servidor per disseny. Aquestes integracions són opt-in: només s'activen si tu, com a admin d'una comunitat, vols publicar proves públiques, pagar registres al permaweb, delegar signatures a un signador extern o utilitzar IA per generar mapes. Res arriba a servidors de tercers sense la teva acció explícita.

A · Wallet Arweave (permaweb) per pagar registres core

🧰 Què cobreix

Un registre "core" a SOS (Anchor Pack d'un projecte fundador, backup d'estat cifrat, historial de decisions públic) es pot pinnar de manera permanent a Arweave. Cost típic: 0.0001–0.001 AR per pack (≈ pocs cèntims). Per fer-ho cal una cartera Arweave amb saldo mínim.

🛠 Opcions de cartera

  • ArConnect (extensió navegador · arconnect.io) — recomanat a desktop. Injecta window.arweaveWallet.
  • Wander (mobile/PWA) — successor d'ArConnect, funciona a iPad.
  • JWK paper wallet (JSON exportat) — la manera air-gapped, funciona a qualsevol navegador sense extensió.
  • othent / Beacon — login social (Google/Apple) sobre Arweave, útil per onboarding no-tècnic.

💰 Aconseguir AR

  • Exchange centralitzat (Kraken, Gate.io, MEXC).
  • Permaswap (DEX natiu Arweave, swap ETH→AR).
  • Saldo mínim recomanat: 0.05 AR (≈ 50 packs · pocs €).

✏ Setup a l'iPad

1) Instal·la Wander (App Store) o obre arweave.app (PWA). 2) Crea cartera nova → guarda la seed phrase i el JWK en 2 llocs offline (paper + gestor de contrasenyes). 3) Envia-hi 0.05 AR des d'exchange. 4) A SOS, obre Ancora un pack a Arweave → confirma amb la cartera.

🧰 Hooks SOS relacionats

buildAnchorPack(node) · downloadAnchorPack(pack) · uploadToArweave(pack, wallet) · arweaveEstimateFee(bytes) · verifyAnchorPack(pack). Si la cartera no està disponible el sistema segueix funcionant: sempre pots baixar el pack (JSON) i pinnar-lo manualment.

B · Signador Nostr (NIP-07) per ancorar decisions

🛠 Signadors compatibles NIP-07

  • Alby (extensió · getalby.com) — cartera Bitcoin/Lightning + signador Nostr integrat.
  • nos2x (extensió lleugera, només Nostr).
  • Amber (Android, aïllat).
  • nostr-connect / NIP-46 (remote signer, útil des d'iPad — la clau privada viu al mòbil).

🔑 Nsec vs npub

  • nsec1... — clau privada (mai la comparteixis, mai a un formulari web).
  • npub1... — clau pública (identificador, comparteix-la lliurement).
  • SOS mai demana la nsec: sempre delega al signador.

✏ Setup + primer ancoratge

1) Instal·la Alby. 2) Menú Alby → Nostr → generar / importar clau. 3) Autoritza *.teamtowershuma.com i file:// (per obrir SOS local). 4) A SOS, node amb mainHash calculat → 🛰 Ancora mainHash → confirma al popup Alby. 5) Verifica al relay públic: wss://relay.damus.io.

🧰 Relays configurables

NOSTR_RELAYS_DEFAULT = ['wss://relay.damus.io','wss://nos.lol','wss://relay.snort.social']. Pots editar-los des del launcher ⚙ Config Nostr per afegir relays privats o de la teva comarca.

C · Claude API key (IA integrada, BYO)

🧰 Model Glass-Box

SOS utilitza Claude API (claude-opus-4-8 per defecte) via AI.call(intent, ctx). La clau la portes tu (BYO key) i es guarda només a IndexedDB del teu navegador — mai surt cap enllà. Tots els prompts són versionats a SOS/prompts/*.md (Glass-Box: pots auditar què s'envia).

🔧 Setup

  • 1) Aconsegueix una API key a console.anthropic.com.
  • 2) SOS → launcher → 🤖 Config IA → enganxa la key.
  • 3) Escull model (opus-4-8 recomanat per mapes VNA; sonnet-5 per generar copy ràpid).
  • 4) Cost típic: 0.01–0.05 € per mapa VNA generat.

🛠 Intents disponibles

  • value_map — genera mapa VNA d'una dinàmica.
  • pr_review — revisa un pull request de GitHub.
  • narrative_kit — còmic + himne + escena performativa.
  • impact_report — informe psicoeconòmic territorial.
  • governance_summary · onboarding_hint · skill_suggest · equity_advisor.

D · WebAuthn / passkeys — login persistent amb Face/Touch ID

🧰 Què fa

Vincula la teva did:sos a un passkey W3C WebAuthn del sistema operatiu (Touch ID / Face ID / Windows Hello / clau FIDO2). A partir d'aquí, obrir SOS demana biometria en lloc de tenir la sessió sempre oberta.

✏ Setup

1) Obre SOS amb identitat ja creada (Mòdul 2). 2) Launcher → 🔐 Vincula passkey. 3) El sistema demana Face ID/Touch ID i registra la credencial al Secure Enclave / TPM. 4) Propera vegada: obrir SOS → biometria → sessió activa. La clau privada did:sos mai surt del dispositiu.

E · GitHub OAuth device flow (per desenvolupadores)

🧰 Què habilita

Vincular el teu compte GitHub permet: (a) revisar PRs del repo asolache/teamtowershuma amb IA des del propi SOS · (b) publicar issues signats · (c) contribuir a l'atles compartit.

🔧 Device flow (sense servidor OAuth)

1) Launcher → 🐙 Connecta GitHub. 2) SOS mostra un codi curt (ABCD-1234). 3) Obre github.com/login/device i enganxa'l. 4) Autoritza els scopes repo, read:user. 5) SOS emmagatzema el token a IndexedDB xifrat.

F · Sincronització P2P WebRTC entre navegadors

🧰 Com funciona

Sincronització directa entre 2 navegadors sense servidor via WebRTC + copia-enganxa de codis SDP. Ideal per compartir estat entre iPad ↔ desktop, o entre membres d'una assemblea al mateix espai. Ara mateix (v17): sync puntual d'una vegada. En backlog: patch en viu + room-code descentralitzat via trackers WSS.

✏ Aparellament manual

1) Navegador A → SyncIniciar → copia el codi (SDP offer). 2) Envia'l per Signal/telegrama/mà a navegador B. 3) B enganxa i genera un codi de resposta. 4) A l'enganxa. 5) Sync completada: tot l'estat de B es fusiona a A (LWW + tombstones).

G · Self-allotjament / deployment de la teva instància SOS

🛠 Opcions de allotjament

  • GitHub Pages — fork del repo, activa Pages a la branca main, ja tens SOS a usuari.github.io/teamtowershuma.
  • Netlify / Cloudflare Pages — drag & drop de la carpeta SOS/, 0 configuració.
  • IPFS pinning (Pinata, web3.storage, Filebase) — CID permanent, resistent a censura.
  • Arweave permanent — pug tota l'app com a Anchor Pack (~50 KB gzipped, cost ≈ 0.001 AR).
  • Local file:// — dobla-clic al index.html, funciona igual (sense sync WebRTC entre navegadors diferents).

🔒 Zero variables d'entorn

  • SOS no necessita .env, backend, base de dades ni build.
  • Tot el que és sensible (API keys, tokens OAuth, clau did:sos) viu a IndexedDB del navegador de cada usuari.
  • Pots servir la mateixa còpia de SOS a milers d'usuaris — cadascú tindrà el seu estat privat.

H · Dev workflow — treballar sobre el codi SOS

🛠 Stack de dev

  • Node 18+ per Playwright (només per tests).
  • Playwright + Chromium (pnpm i -D playwright).
  • Cap build step — edita SOS/index.html, recarrega, ja està.
  • Un servidor estàtic qualsevol (python -m http.server, npx serve) o directament file://.

🎓 Convencions del repo

  • Branca de desenvolupament: claude/teamtowershuma-landing-review-cl2ltc (per contribucions IA-assistides).
  • Codex Antigravity V11-V17 a SOS/knowledge/codex.md — cal llegir-lo abans de qualsevol PR.
  • Tots els helpers de SOS s'exposen a window.__SOS per testejar sense mocks.
  • Testejar amb Playwright, no amb frameworks pesants.

✏ El teu primer PR

1) Fork del repo asolache/teamtowershuma. 2) Llegeix el codex sencer. 3) Escull un veda que no es compleix del tot i escriu una prova Playwright que ho demostri (roig). 4) Fixa el bug al SOS/index.html fins que la prova sigui verda. 5) Obre PR mencionant el veda que resols.

I · Debugging & recovery

🧰 Snippets DevTools útils

// Veure tot l'estat
window.__SOS.state

// Exportar backup complet
JSON.stringify(await window.__SOS.dbGetAll())

// Reset total (compte!)
indexedDB.deleteDatabase('sos-v1'); location.reload();

// Forçar re-sembra d'una dinàmica
window.__SOS.seedFromDynamic(node, 'banc_temps')

// Veure la teva did:sos
(await window.__SOS.getIdentity()).did

// Comptar helpers exposats
Object.keys(window.__SOS).length

🎓 Problemes comuns

  • iPad no deixa seleccionar múltiples — comprova touch-action:manipulation al CSS del control.
  • Nostr no publica — el signador NIP-07 sovint bloqueja file://. Serveix SOS via http://localhost:PORT.
  • Sync WebRTC falla — CGNAT bloqueja P2P; toca fer servir un TURN server (fora d'abast per defecte).
  • Anchor Pack diferent en dos navegadors — verifica que el tombstones està sincronitzat abans de fer buildAnchorPack.

✏ Certificació developer/admin

Un cop hagis completat A→I amb la teva pròpia comunitat pilot (mínim 5 socis actius, 1 mapa VNA validat, 1 Anchor Pack ancorat a Arweave i publicat a Nostr, 1 PR merged al repo): ets Admin SOS certificat. La certificació és el propi ledger signat + npub Nostr amb els events publicats — no cal cap òrgan que la validi.

📚 Recursos i fonts

On ampliar. Ordenat per proximitat a la pràctica del SOS: primer el que fem servir cada dia, després el que hi ha darrere.

Documentació interna del SOS

Fonts metodològiques

FontQuè n'agafemComp.
Verna AlleeThe Future of Knowledge · Value Networks and the true nature of collaborationTot el mapatge VNA: rols funcionals, intercanvis tangibles i intangibles, anàlisi d'impacte i valor.C1
Mike MoyerSlicing Pie: Funding Your Company Without FundsL'equity dinàmic. El principi que el diner val més multiplicador que el temps perquè té risc de pèrdua total.C4 · C5
Pantheon.workExercici de reconeixement de competències i habilitats (CC BY)Els dotze arquetips com a dotze preguntes que tota organització ha de saber respondre. Les paraules clau com a «pack» i la idea que els talents són lliures d'escala: el mateix talent val per a una conversa de dos i per a un congrés de 3.000.C1 · C3
Elinor OstromGoverning the CommonsEls 8 principis de gestió de comuns. Per què les comunitats sí que poden autogovernar recursos compartits sense privatitzar ni estatalitzar.C3
Mondragón Corporación CooperativaIntercooperació entre cooperatives, fons de reserva comú, i la idea que el valor circuli entre germanes.C4
Lionel Penrose (1946) — The elementary statistics of majority votingLa llei de l'arrel quadrada: per què √població reparteix pes just en assemblees de territoris desiguals.C3
Edgar CahnNo More Throw-Away PeopleTime banking i co-producció. La idea que tothom té alguna cosa per aportar i que l'hora de tothom val igual.C2
Frédéric LalouxReinventing OrganizationsAutogestió, plenitud i propòsit evolutiu. Vocabulari per parlar d'organitzacions sense organigrama.C3
Donella MeadowsThinking in Systems · Leverage PointsPensament sistèmic. On intervenir en un sistema perquè el canvi es multipliqui.C1
Kate RaworthDoughnut EconomicsEl marc de sostre ecològic i terra social. Per situar l'impacte del que construïm.C5
Jason Fried & DHHShape UpCicles amb apetit fix i abast variable. Inspira els sprints de la MATRIU.C4

Estàndards i especificacions

Ecosistema català

🧭 Per on començar segons on ets

  • Acabes d'arribar → M1, després el teu itinerari de rol. Res més.
  • Vols muntar una dinàmica → M4 + Cahn + la guia de la MATRIU.
  • Et costa la governança → M5 + Ostrom + Penrose.
  • No et creus la valoració → M6 + Moyer, i calibra l'oracle al teu territori.
  • Vols mentorar → completa les 6 competències i llegeix la secció de mentoria dues vegades.

🎓 Expert/a SOS · llibre obert

Has completat els 8 mòduls. Domines:

Filosofia + codexCriptografia W3CVNA Verna AlleeRecursos comunitarisGovernança federativaSlicing Pie + MondragónComando + narrativaNostr + IPFS + IA

Estàs preparat/da per implementar SOS a qualsevol comunitat i per mentorar la següent promoció. La certificació no la dona ningú: surt del teu propi ledger signat. Cada hora, cada mapa, cada decisió votada és una prova que qualsevol pot verificar amb un Anchor Pack — sense confiar en TeamTowers ni en cap tribunal.

Al SOS: launcher → 🎓 Prepara la meva mentoria per veure el teu nivell, els teus buits i el guió de la propera sessió.

Obre SOS i comença →