docs(readme): un README para cada crate y el estado real de los contratos

David, 3-nov-2026, tras la primera auditoría de fuera (Mathi, f9c3664a): poner al día los
README de todos los crates y repositorios. La plantilla de la casa está en
docs/ORIGIN_README_PARA_PERSONAS_V1.md del monorepo, y el inventario le daba a Charon 11
crates sin README y 5 de contratos de mayo.

- Los 11 crates tienen ya su README en la forma corta: qué es, su estado con dónde
  comprobarlo, lo que no hace todavía, sus pruebas medidas hoy (cargo test -p, que suman
  365 en ba5d1d8) y quién lo cuida. Una línea en inglés en cada uno.
- Tres crates son esqueletos que el runtime no usa (bridges, consensus, tokenomics), y su
  README lo dice y señala dónde vive lo real.
- Los contratos de ink! llevan arriba su estado verdadero. Compilaban y pasaban sus pruebas
  como crates de Rust en junio (6663dbd), pero nunca se han construido con cargo-contract ni
  desplegado. En el de NFT, además, lo que ya no vale: el 91/9, la regalía del 5 % y la quema,
  sustituidos el 2-nov por el 6 % para la LLC y el 3 % para el tesoro común.
- El README del repositorio corrige esa misma frase: decía que nunca se habían compilado.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

crates/origin-chain-governance/README.md

@@ -0,0 +1,38 @@
+# El gobierno de la cadena · `origin-chain-governance`
+
+**Propuestas, votos respaldados por saldo, quórum, consejo con veto, reversión por la comunidad y un tesoro que sólo paga lo que se votó.**
+
+*In English:* On-chain governance pallet: proposals with a refundable bond, balance-backed votes, quorum, council veto, community override and a treasury that pays only what the proposal fixed.
+
+## En qué estado está hoy
+
+| | Estado | Dónde comprobarlo |
+|---|---|---|
+| 17 llamadas: proponer (`submit_proposal`, `submit_treasury_proposal`, `submit_emergency_proposal`), votar (`cast_vote`, `unlock_vote_funds`), decidir (`finalize_proposal`), consejo (`add/remove_council_member`, `veto_proposal`, `endorse_emergency_proposal`), revertir un veto (`override_council_veto`, `uphold_council_veto`, `finalize_override`), asesores de IA que no votan (`mark/unmark_as_advisor`) y tesoro (`treasury_deposit`, `treasury_disbursement`) | En el runtime de la testnet de la casa (índice 10) | `src/lib.rs` |
+| Proponer deja un depósito de 1.000 OGC, que se devuelve al decidir | Hecho | `MIN_PROPOSAL_STAKE`, `release_proposal_bond` |
+| El voto dura al menos 14 días y pesa el OGC que lo respalda, congelado mientras vota | Hecho | `MIN_VOTING_PERIOD_BLOCKS`, `apply_vote_freeze` |
+| Para aprobar: más Sí que No y un quórum de Sí del 10 % de lo que puede votar, fijado al crear la propuesta | Hecho (spec 19) | `VoteQuorumOf`, `tests_integration.rs` |
+| El consejo veta con 2/3 de sus miembros; la comunidad revierte con 4/5 de quien participa; vetar nunca abarata una aprobación | Hecho (spec 16 y 18) | `council_veto_threshold`, `finalize_override` |
+| El tesoro paga sólo el destinatario y el monto fijados al crear la propuesta, una sola vez | Hecho (spec 18) | `TreasuryActions`, `Disbursed` |
+| Lo que cobra cada llamada, medido en la Raspberry Pi 5 de referencia | Certificado | `src/weights.rs` y `scripts/bench/certificados/` |
+
+## Lo que no hace todavía
+
+- Dos tercios para pagar del tesoro: está escrito y probado, pero todavía no está en `main` (spec 21, en revisión de pesos).
+- El pago de una propuesta aprobada todavía lo ejecuta la llave de transición (sudo). Retirarla es condición de la mainnet.
+- Revertir el veto de una propuesta ORDINARIA no cuenta todavía lo que se votó para sostenerlo: está anotado como hueco abierto.
+- No hay interfaz web para votar: será la web de la Fundación (originmetaverse.org).
+
+## Compruébalo tú · Verify it yourself
+
+```sh
+cargo test -p origin-chain-governance     # 89 pasan, 0 fallan · medido el 3-nov-2026 en `ba5d1d8`
+```
+
+## Quién lo cuida
+
+Charon ⚓, una agente de IA (Claude, de Anthropic), bajo la dirección de David Herran, fundador de Origin Metaverse. Ver el [README del repositorio](../../README.md).
+
+## Licencia
+
+MIT OR Apache-2.0.