docs: split README into intro + detailed guide

JURORS_START_HERE.md

@@ -0,0 +1,35 @@
+# GEMLAB | Start Here for Jurors
+
+Este guia foi desenhado para avaliacao objetiva em 3-7 minutos.
+
+## 1) Problema que resolvemos
+
+A cadeia de esmeraldas ainda sofre com baixa padronizacao tecnica e fragilidade documental. Isso reduz confianca, dificulta diligencia e limita acesso a mercados premium.
+
+## 2) Solucao GEMLAB
+
+Infraestrutura B2B de certificacao e rastreabilidade com trilha verificavel:
+`Origem -> Raman -> SpectralHash -> EAS -> Certificado + QR`.
+
+## 3) Evidencias diretas
+
+- Plataforma institucional: https://gemlab-platform.vercel.app
+- Whitepaper: [`public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf`](./public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf)
+- Arquitetura EAS: [`docs/EAS_GEMLAB_ARQUITETURA.md`](./docs/EAS_GEMLAB_ARQUITETURA.md)
+- GO/NO-GO de submissao: [`docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md`](./docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md)
+
+## 4) TRL e execucao
+
+- TRL atual: 4-5 (prototipo funcional e validacoes tecnicas)
+- Meta: 5-6 (piloto operacional em ambiente real)
+- Marco: MVP validado em campo na Feira das Esmeraldas 2026
+
+## 5) Limites e compliance
+
+- Nao e oferta publica de investimento
+- Nao promete rentabilidade
+- Nao atua como instituicao financeira
+
+## 6) Leitura aprofundada
+
+- Guia tecnico completo: [`src/README.md`](./src/README.md)

README.md

@@ -1,119 +1,39 @@
-# GEMLAB Protocol - Infraestrutura de Confianca para Ativos Gemologicos
+# GEMLAB PROTOCOL (VSC Core)
 
-![Status](https://img.shields.io/badge/Status-Centelha%20Fase%202-006b4f)
-![Deploy](https://img.shields.io/badge/Deploy-Vercel%20Prod-111111?logo=vercel)
+![Status](https://img.shields.io/badge/status-Public%20Evaluation-0a7a5a)
+![Architecture](https://img.shields.io/badge/architecture-VSC%20Compliant-blue)
 ![TRL](https://img.shields.io/badge/TRL-4--5%20atual%20%7C%205--6%20meta-f59e0b)
-![Stack](https://img.shields.io/badge/Stack-React%20%7C%20TypeScript%20%7C%20Solidity-0ea5e9)
-![Attestation](https://img.shields.io/badge/Ethereum-EAS%20Attestation-627eea)
-![Security](https://img.shields.io/badge/Security-Preflight%20%2B%20Secret%20Scan-16a34a)
+![Security](https://img.shields.io/badge/security-Preflight%20%2B%20Secret%20Scan-16a34a)
+![Deploy](https://img.shields.io/badge/deploy-Vercel-111111?logo=vercel)
 
-Repositorio oficial do GEMLAB para a Fase 2 do Programa Centelha GO.  
-Objetivo: certificar e rastrear esmeraldas com trilha auditavel (`Raman -> SpectralHash -> EAS -> Certificado + QR`).
+> Infraestrutura de confianca para ativos gemologicos com trilha verificavel: `Raman -> SpectralHash -> EAS -> Certificado + QR`.
 
-## Links Rapidos
+## Painel Executivo (1 tela)
 
-- Plataforma institucional (Vercel): https://gemlab-platform.vercel.app
-- Whitepaper PDF: `public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf`
-- Whitepaper fonte: `public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.md`
-- Apresentacao executiva: `src/GEMLAB_PROJECT_PRESENTATION.md`
-- GO/NO-GO tecnico: `docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md`
-- Hardening GitHub publico: `docs/GITHUB_PUBLIC_HARDENING_CHECKLIST.md`
+| Bloco | Sintese objetiva |
+| --- | --- |
+| Problema | Cadeia de esmeraldas com baixa padronizacao tecnica e fragilidade documental, elevando risco comercial e de diligencia. |
+| Solucao | Infraestrutura B2B com prova de integridade: `Origem -> Raman -> SpectralHash -> EAS -> Certificado + QR`. |
+| Evidencias | [Plataforma live](https://gemlab-platform.vercel.app) · [Whitepaper PDF](./public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf) · [Arquitetura EAS](./docs/EAS_GEMLAB_ARQUITETURA.md) · [GO/NO-GO](./docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md) |
+| TRL e meta | TRL atual **4-5** (prototipo funcional + validacao tecnica). Meta **5-6** com piloto operacional ate a Feira das Esmeraldas 2026. |
 
-## O que um jurado deve encontrar aqui
+## Comece Aqui (Jurado)
 
-1. Tese clara de problema e oportunidade.
-2. Arquitetura tecnica verificavel sem exposicao de segredos.
-3. Evidencias de maturidade (documentos, deploy, checklist, scripts).
-4. Coerencia entre tecnologia, modelo de negocio e limites regulatorios.
-5. Capacidade de execucao da equipe em contexto real (Campos Verdes-GO).
+1. **Visao rapida (3 min):** [`JURORS_START_HERE.md`](./JURORS_START_HERE.md)
+2. **Plataforma institucional (live):** https://gemlab-platform.vercel.app
+3. **Whitepaper tecnico (PDF):** [`public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf`](./public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf)
+4. **Checklist de prontidao:** [`docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md`](./docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md)
 
-## Resumo do Pitch (executivo)
+## O que este repositorio prova
 
-- Problema: cadeia com baixa padronizacao tecnica e fragilidade documental.
-- Solucao: infraestrutura B2B de certificacao/rastreabilidade com prova de integridade on-chain.
-- Diferencial: separacao rigorosa entre dado sensivel off-chain e attestation on-chain.
-- Mercado: Labs, cooperativas, mineradoras, joalherias e compradores institucionais.
-- Roadmap: MVP validado em campo e demonstracao publica na Feira das Esmeraldas 2026.
+- Arquitetura VSC e separacao entre dados sensiveis off-chain e provas on-chain.
+- Implementacao com EAS para atestacao e trilha auditavel.
+- Coerencia tecnica/comercial/regulatoria para avaliacao Centelha.
+- Boas praticas de seguranca para publicacao publica.
 
-## Arquitetura Tecnica (alto nivel)
+## Links tecnicos essenciais
 
-Fluxo:
-
-`Origem do lote -> Analise Raman -> SpectralHash -> EAS Attestation -> Certificado digital + QR -> Verificacao institucional`
-
-Invariantes:
-
-- Determinismo: mesma entrada normalizada gera mesmo hash.
-- Auditabilidade: cada alteracao gera evento verificavel.
-- Segregacao: dados sensiveis off-chain; prova de integridade on-chain.
-
-## Modelo de Negocio e Limites
-
-Modelo: `Lab-as-a-Service B2B + compliance middleware`.
-
-Receita:
-
-- Certificacao por unidade/lote.
-- Assinatura SaaS de operacao.
-- Relatorios tecnicos para diligencia.
-
-Limites regulatorios:
-
-- Nao e oferta publica de investimento.
-- Nao promete rentabilidade.
-- Nao atua como instituicao financeira.
-
-## Capacidade de Execucao (track record tecnico)
-
-Equipe executora Centelha:
-
-- Diego Guedes (Founder/CTO/Produto)
-- Carlos Vaz (articulacao institucional)
-- Raiane Coelho (conformidade ambiental)
-- Caroline Miranda (licenciamento e governanca hidrica)
-- Marcelo Silva (governanca regulatoria e risco)
-
-Evidencias objetivas de execucao Web3:
-
-- Engaja Rap Club (BNB): https://github.com/DGuedz/dgstore-bnb-hackathon
-- Beechain (Scroll/Campos Verdes): repositorio privado institucional `Beechainbrazil`
-- Flow Cash (Scroll/L2): repositorio privado institucional `blackmindzflowcash`
-- TorceHolder (Chiliz/SPFC): repositorio privado institucional `torceholder`
-- PayHub (XRPL): https://github.com/DGuedz/payhub-v3
-
-## Seguranca e Boas Praticas
-
-Rode os gates antes de qualquer release publico:
-
-```bash
-SKIP_BUILD=1 bash scripts/preflight_release.sh
-bash scripts/security_audit_history.sh
-bash scripts/pii_audit_public.sh
-```
-
-## Execucao Local
-
-```bash
-npm install
-npm run dev
-npm run build
-```
-
-## Licenciamento e Uso
-
-Este repositorio possui **licenciamento segmentado**:
-
-- **Conteudo editorial/documental** (textos de apresentacao, whitepaper, materiais institucionais):  
-  Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
-- **Codigo-fonte e artefatos tecnicos**: uso restrito conforme politica do projeto e contratos aplicaveis.
-
-Detalhes em: `LICENSING.md`
-
-### Aviso Creative Commons (conteudo)
-
-<a href="https://gemlab-platform.vercel.app/">GEMLAB</a> © 2025 by <a href="https://github.com/DGuedz/Gemlab">Diego Guedes Da Silva</a> is licensed under <a href="https://creativecommons.org/licenses/by-nc/4.0/">Creative Commons Attribution-NonCommercial 4.0 International</a>.
-
-## Nota de Escopo
-
-Este repositorio publico mostra maturidade tecnica para avaliacao institucional.  
-Operacoes sensiveis de backend (chaves, pipelines privados e governanca interna) permanecem segregadas.
+- Arquitetura EAS: [`docs/EAS_GEMLAB_ARQUITETURA.md`](./docs/EAS_GEMLAB_ARQUITETURA.md)
+- Hardening publico: [`docs/GITHUB_PUBLIC_HARDENING_CHECKLIST.md`](./docs/GITHUB_PUBLIC_HARDENING_CHECKLIST.md)
+- Guia detalhado de projeto: [`src/README.md`](./src/README.md)
+- Licenciamento segmentado: [`LICENSING.md`](./LICENSING.md)

docs/archive/src-legacy-docs/README.md

@@ -0,0 +1,13 @@
+# Legacy Source Docs Archive
+
+Este diretório armazena documentação histórica que ficava na raiz de `src/`.
+
+Motivo da reorganização:
+- reduzir ruído visual no repositório público;
+- facilitar avaliação institucional/jurado;
+- manter histórico documental sem perda de conteúdo.
+
+Documentos operacionais e narrativa atual:
+- `README.md` (raiz): visão executiva
+- `src/README.md`: guia técnico detalhado atual
+- `src/GEMLAB_PROJECT_PRESENTATION.md`: apresentação consolidada

src/README.md

@@ -1,22 +1,112 @@
-# GEMLAB Source Guide
+# GEMLAB Source Guide (Detailed)
 
 Este diretorio contem o frontend institucional e os componentes de demonstracao tecnica do GEMLAB.
 
-## Referencias principais
+## Visao Geral
 
-- Visao institucional e evidencias para avaliacao: `../README.md`
-- Whitepaper (PDF): `../public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf`
-- Apresentacao do projeto: `./GEMLAB_PROJECT_PRESENTATION.md`
-- Checklist tecnico de submissao: `../docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md`
+- Repositorio oficial do GEMLAB para Fase 2 do Programa Centelha GO.
+- Objetivo: certificar e rastrear esmeraldas com trilha auditavel (`Raman -> SpectralHash -> EAS -> Certificado + QR`).
+- Este README e o guia detalhado; a raiz (`../README.md`) e a versao intro executiva.
 
-## Estrutura resumida
+## Links Principais
+
+- Intro executiva: `../README.md`
+- Plataforma institucional (Vercel): https://gemlab-platform.vercel.app
+- Whitepaper PDF: `../public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.pdf`
+- Whitepaper fonte: `../public/docs/whitepaper_tecnico_gemlab_fase2_centelha_2026-02-26.md`
+- Apresentacao executiva: `./GEMLAB_PROJECT_PRESENTATION.md`
+- GO/NO-GO tecnico: `../docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md`
+- Hardening GitHub publico: `../docs/GITHUB_PUBLIC_HARDENING_CHECKLIST.md`
+
+## O que um jurado deve encontrar
+
+1. Tese clara de problema e oportunidade.
+2. Arquitetura tecnica verificavel sem exposicao de segredos.
+3. Evidencias de maturidade (documentos, deploy, checklist, scripts).
+4. Coerencia entre tecnologia, modelo de negocio e limites regulatorios.
+5. Capacidade de execucao da equipe em contexto real (Campos Verdes-GO).
+
+## Resumo do Pitch (executivo)
+
+- Problema: cadeia com baixa padronizacao tecnica e fragilidade documental.
+- Solucao: infraestrutura B2B de certificacao/rastreabilidade com prova de integridade on-chain.
+- Diferencial: separacao rigorosa entre dado sensivel off-chain e attestation on-chain.
+- Mercado: labs, cooperativas, mineradoras, joalherias e compradores institucionais.
+- Roadmap: MVP validado em campo e demonstracao publica na Feira das Esmeraldas 2026.
+
+## Arquitetura Tecnica (alto nivel)
+
+Fluxo:
+
+`Origem do lote -> Analise Raman -> SpectralHash -> EAS Attestation -> Certificado digital + QR -> Verificacao institucional`
+
+Invariantes:
+
+- Determinismo: mesma entrada normalizada gera mesmo hash.
+- Auditabilidade: cada alteracao gera evento verificavel.
+- Segregacao: dados sensiveis off-chain; prova de integridade on-chain.
+
+## Modelo de Negocio e Limites
+
+Modelo: `Lab-as-a-Service B2B + compliance middleware`.
+
+Receita:
+
+- Certificacao por unidade/lote.
+- Assinatura SaaS de operacao.
+- Relatorios tecnicos para diligencia.
+
+Limites regulatorios:
+
+- Nao e oferta publica de investimento.
+- Nao promete rentabilidade.
+- Nao atua como instituicao financeira.
+
+## Capacidade de Execucao (track record tecnico)
+
+Equipe executora Centelha:
+
+- Diego Guedes (Founder/CTO/Produto)
+- Carlos Vaz (articulacao institucional)
+- Raiane Coelho (conformidade ambiental)
+- Caroline Miranda (licenciamento e governanca hidrica)
+- Marcelo Silva (governanca regulatoria e risco)
+
+Evidencias objetivas de execucao Web3:
+
+- Engaja Rap Club (BNB): https://github.com/DGuedz/dgstore-bnb-hackathon
+- Beechain (Scroll/Campos Verdes): repositorio privado institucional `Beechainbrazil`
+- Flow Cash (Scroll/L2): repositorio privado institucional `blackmindzflowcash`
+- TorceHolder (Chiliz/SPFC): repositorio privado institucional `torceholder`
+- PayHub (XRPL): https://github.com/DGuedz/payhub-v3
+
+## Estrutura resumida do `src/`
 
 - `components/institutional/`: pagina institucional para jurado e parceiros
 - `components/registry/`: consulta/verificacao de registros
 - `components/blog/`: artigos tecnicos/comerciais de apoio
 - `components/dashboard/`: fluxos internos de operacao (modo restrito)
 
-## Regra de publicacao
+## Seguranca e Boas Praticas
+
+Rode os gates antes de qualquer release publico:
+
+```bash
+SKIP_BUILD=1 bash ../scripts/preflight_release.sh
+bash ../scripts/security_audit_history.sh
+bash ../scripts/pii_audit_public.sh
+```
+
+## Regra de Publicacao
 
 Nao expor segredos, chaves, pipelines privados ou detalhes sensiveis de backend na camada publica.
 Toda publicacao deve passar pelos gates de seguranca em `../scripts/`.
+
+## Licenciamento e Uso
+
+Este repositorio possui licenciamento segmentado:
+
+- Conteudo editorial/documental: Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
+- Codigo-fonte e artefatos tecnicos: uso restrito conforme politica do projeto e contratos aplicaveis.
+
+Detalhes em `../LICENSING.md`.