From 4dbc4b62a93632c0168a3f003969e65988b7cca1 Mon Sep 17 00:00:00 2001 From: doublegreem Date: Sat, 28 Feb 2026 10:17:30 -0300 Subject: [PATCH 1/4] docs: split README into executive intro and detailed source guide --- README.md | 131 +++++++++++--------------------------------------- src/README.md | 106 +++++++++++++++++++++++++++++++++++++--- 2 files changed, 126 insertions(+), 111 deletions(-) diff --git a/README.md b/README.md index aec4f1a..e9283b1 100644 --- a/README.md +++ b/README.md @@ -1,119 +1,44 @@ -# 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) -![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) +![Status](https://img.shields.io/badge/status-Public%20Evaluation-0a7a5a) +![Architecture](https://img.shields.io/badge/architecture-VSC%20Compliant-blue) +![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`). +> **Economy-First Blockchain Protocol for Real World Assets (RWA)** -## Links Rapidos +Repositorio oficial do GEMLAB para avaliacao tecnica-institucional (Centelha Fase 2). -- 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` - -## O que um jurado deve encontrar aqui - -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: +## VSC (Value-Separated Control) Architecture -- Certificacao por unidade/lote. -- Assinatura SaaS de operacao. -- Relatorios tecnicos para diligencia. +1. **Value Layer (The Truth):** validacao cientifica off-chain (Raman) ancorada por hash criptografico. +2. **Control Layer (The Rules):** smart contracts e attestation para integridade, rastreabilidade e compliance. +3. **Interface Layer (The View):** interfaces desacopladas para verificacao publica e operacao segura. -Limites regulatorios: +### Core Features -- Nao e oferta publica de investimento. -- Nao promete rentabilidade. -- Nao atua como instituicao financeira. +- **Fail-Fast Validation:** fluxo invalido falha quando faltam attestations obrigatorias. +- **Data Economy:** dados pesados off-chain; somente provas (`bytes32`) on-chain. +- **Zero-Trust Security:** segregacao de papeis, gates de release e varredura de segredos. -## Capacidade de Execucao (track record tecnico) +--- -Equipe executora Centelha: +## Quick Access -- 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. +- Plataforma institucional (Vercel): 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` +- Checklist GO/NO-GO: `docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md` +- Hardening publico: `docs/GITHUB_PUBLIC_HARDENING_CHECKLIST.md` -Detalhes em: `LICENSING.md` +## Documentacao Completa -### Aviso Creative Commons (conteudo) +Para narrativa completa (pitch, roadmap, equipe, modelo de negocio, licenciamento e operacao): +- `src/README.md` -GEMLAB © 2025 by Diego Guedes Da Silva is licensed under Creative Commons Attribution-NonCommercial 4.0 International. +## Licenciamento -## Nota de Escopo +Licenciamento segmentado em `LICENSING.md`. -Este repositorio publico mostra maturidade tecnica para avaliacao institucional. -Operacoes sensiveis de backend (chaves, pipelines privados e governanca interna) permanecem segregadas. diff --git a/src/README.md b/src/README.md index 5519aff..a32ab39 100644 --- a/src/README.md +++ b/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`. From 8e10e1a68c39e1bfdc39d5a8ffeb50c49fe435a8 Mon Sep 17 00:00:00 2001 From: doublegreem Date: Sat, 28 Feb 2026 10:28:21 -0300 Subject: [PATCH 2/4] chore: declutter src root by archiving legacy docs for juror-friendly repo view --- .../archive/src-legacy-docs}/AUTH_FIX_GUIDE.md | 0 .../archive/src-legacy-docs}/Attributions.md | 0 {src => docs/archive/src-legacy-docs}/CHANGELOG.md | 0 .../archive/src-legacy-docs}/COMMIT_GUIDE.md | 0 .../archive/src-legacy-docs}/CONTRIBUTING.md | 0 .../archive/src-legacy-docs}/DEPLOY_INSTRUCTIONS.md | 0 .../ECOSYSTEM_CRYPTO_TRANSFORMATION.md | 0 .../src-legacy-docs}/GITHUB_UPDATE_SUMMARY.md | 0 .../LEAN_COMPLIANCE_IMPLEMENTATION.md | 0 .../src-legacy-docs}/MOBILE_RESPONSIVE_GUIDE.md | 0 .../src-legacy-docs}/MOBILE_UPDATE_SUMMARY.md | 0 .../src-legacy-docs}/ORACLE_FISCAL_DOCUMENTATION.md | 0 .../archive/src-legacy-docs}/PLATFORM_COMPLETE.md | 0 .../archive/src-legacy-docs}/PROJECT_OVERVIEW.md | 0 .../archive/src-legacy-docs}/QUICK_START.md | 0 docs/archive/src-legacy-docs/README.md | 13 +++++++++++++ .../src-legacy-docs}/RELEASE_NOTES_v1.1.0.md | 0 .../src-legacy-docs}/TEMP_INCENTIVOS_CARDS.txt | 0 18 files changed, 13 insertions(+) rename {src => docs/archive/src-legacy-docs}/AUTH_FIX_GUIDE.md (100%) rename {src => docs/archive/src-legacy-docs}/Attributions.md (100%) rename {src => docs/archive/src-legacy-docs}/CHANGELOG.md (100%) rename {src => docs/archive/src-legacy-docs}/COMMIT_GUIDE.md (100%) rename {src => docs/archive/src-legacy-docs}/CONTRIBUTING.md (100%) rename {src => docs/archive/src-legacy-docs}/DEPLOY_INSTRUCTIONS.md (100%) rename {src => docs/archive/src-legacy-docs}/ECOSYSTEM_CRYPTO_TRANSFORMATION.md (100%) rename {src => docs/archive/src-legacy-docs}/GITHUB_UPDATE_SUMMARY.md (100%) rename {src => docs/archive/src-legacy-docs}/LEAN_COMPLIANCE_IMPLEMENTATION.md (100%) rename {src => docs/archive/src-legacy-docs}/MOBILE_RESPONSIVE_GUIDE.md (100%) rename {src => docs/archive/src-legacy-docs}/MOBILE_UPDATE_SUMMARY.md (100%) rename {src => docs/archive/src-legacy-docs}/ORACLE_FISCAL_DOCUMENTATION.md (100%) rename {src => docs/archive/src-legacy-docs}/PLATFORM_COMPLETE.md (100%) rename {src => docs/archive/src-legacy-docs}/PROJECT_OVERVIEW.md (100%) rename {src => docs/archive/src-legacy-docs}/QUICK_START.md (100%) create mode 100644 docs/archive/src-legacy-docs/README.md rename {src => docs/archive/src-legacy-docs}/RELEASE_NOTES_v1.1.0.md (100%) rename {src => docs/archive/src-legacy-docs}/TEMP_INCENTIVOS_CARDS.txt (100%) diff --git a/src/AUTH_FIX_GUIDE.md b/docs/archive/src-legacy-docs/AUTH_FIX_GUIDE.md similarity index 100% rename from src/AUTH_FIX_GUIDE.md rename to docs/archive/src-legacy-docs/AUTH_FIX_GUIDE.md diff --git a/src/Attributions.md b/docs/archive/src-legacy-docs/Attributions.md similarity index 100% rename from src/Attributions.md rename to docs/archive/src-legacy-docs/Attributions.md diff --git a/src/CHANGELOG.md b/docs/archive/src-legacy-docs/CHANGELOG.md similarity index 100% rename from src/CHANGELOG.md rename to docs/archive/src-legacy-docs/CHANGELOG.md diff --git a/src/COMMIT_GUIDE.md b/docs/archive/src-legacy-docs/COMMIT_GUIDE.md similarity index 100% rename from src/COMMIT_GUIDE.md rename to docs/archive/src-legacy-docs/COMMIT_GUIDE.md diff --git a/src/CONTRIBUTING.md b/docs/archive/src-legacy-docs/CONTRIBUTING.md similarity index 100% rename from src/CONTRIBUTING.md rename to docs/archive/src-legacy-docs/CONTRIBUTING.md diff --git a/src/DEPLOY_INSTRUCTIONS.md b/docs/archive/src-legacy-docs/DEPLOY_INSTRUCTIONS.md similarity index 100% rename from src/DEPLOY_INSTRUCTIONS.md rename to docs/archive/src-legacy-docs/DEPLOY_INSTRUCTIONS.md diff --git a/src/ECOSYSTEM_CRYPTO_TRANSFORMATION.md b/docs/archive/src-legacy-docs/ECOSYSTEM_CRYPTO_TRANSFORMATION.md similarity index 100% rename from src/ECOSYSTEM_CRYPTO_TRANSFORMATION.md rename to docs/archive/src-legacy-docs/ECOSYSTEM_CRYPTO_TRANSFORMATION.md diff --git a/src/GITHUB_UPDATE_SUMMARY.md b/docs/archive/src-legacy-docs/GITHUB_UPDATE_SUMMARY.md similarity index 100% rename from src/GITHUB_UPDATE_SUMMARY.md rename to docs/archive/src-legacy-docs/GITHUB_UPDATE_SUMMARY.md diff --git a/src/LEAN_COMPLIANCE_IMPLEMENTATION.md b/docs/archive/src-legacy-docs/LEAN_COMPLIANCE_IMPLEMENTATION.md similarity index 100% rename from src/LEAN_COMPLIANCE_IMPLEMENTATION.md rename to docs/archive/src-legacy-docs/LEAN_COMPLIANCE_IMPLEMENTATION.md diff --git a/src/MOBILE_RESPONSIVE_GUIDE.md b/docs/archive/src-legacy-docs/MOBILE_RESPONSIVE_GUIDE.md similarity index 100% rename from src/MOBILE_RESPONSIVE_GUIDE.md rename to docs/archive/src-legacy-docs/MOBILE_RESPONSIVE_GUIDE.md diff --git a/src/MOBILE_UPDATE_SUMMARY.md b/docs/archive/src-legacy-docs/MOBILE_UPDATE_SUMMARY.md similarity index 100% rename from src/MOBILE_UPDATE_SUMMARY.md rename to docs/archive/src-legacy-docs/MOBILE_UPDATE_SUMMARY.md diff --git a/src/ORACLE_FISCAL_DOCUMENTATION.md b/docs/archive/src-legacy-docs/ORACLE_FISCAL_DOCUMENTATION.md similarity index 100% rename from src/ORACLE_FISCAL_DOCUMENTATION.md rename to docs/archive/src-legacy-docs/ORACLE_FISCAL_DOCUMENTATION.md diff --git a/src/PLATFORM_COMPLETE.md b/docs/archive/src-legacy-docs/PLATFORM_COMPLETE.md similarity index 100% rename from src/PLATFORM_COMPLETE.md rename to docs/archive/src-legacy-docs/PLATFORM_COMPLETE.md diff --git a/src/PROJECT_OVERVIEW.md b/docs/archive/src-legacy-docs/PROJECT_OVERVIEW.md similarity index 100% rename from src/PROJECT_OVERVIEW.md rename to docs/archive/src-legacy-docs/PROJECT_OVERVIEW.md diff --git a/src/QUICK_START.md b/docs/archive/src-legacy-docs/QUICK_START.md similarity index 100% rename from src/QUICK_START.md rename to docs/archive/src-legacy-docs/QUICK_START.md diff --git a/docs/archive/src-legacy-docs/README.md b/docs/archive/src-legacy-docs/README.md new file mode 100644 index 0000000..a93ea45 --- /dev/null +++ b/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 diff --git a/src/RELEASE_NOTES_v1.1.0.md b/docs/archive/src-legacy-docs/RELEASE_NOTES_v1.1.0.md similarity index 100% rename from src/RELEASE_NOTES_v1.1.0.md rename to docs/archive/src-legacy-docs/RELEASE_NOTES_v1.1.0.md diff --git a/src/TEMP_INCENTIVOS_CARDS.txt b/docs/archive/src-legacy-docs/TEMP_INCENTIVOS_CARDS.txt similarity index 100% rename from src/TEMP_INCENTIVOS_CARDS.txt rename to docs/archive/src-legacy-docs/TEMP_INCENTIVOS_CARDS.txt From 48023e80b34c145cff3b29c5f7979b80584ada5e Mon Sep 17 00:00:00 2001 From: doublegreem Date: Sat, 28 Feb 2026 10:30:38 -0300 Subject: [PATCH 3/4] docs: create juror-first landing flow with START HERE guide --- JURORS_START_HERE.md | 35 ++++++++++++++++++++++++++++++++ README.md | 48 ++++++++++++++++---------------------------- 2 files changed, 52 insertions(+), 31 deletions(-) create mode 100644 JURORS_START_HERE.md diff --git a/JURORS_START_HERE.md b/JURORS_START_HERE.md new file mode 100644 index 0000000..14817aa --- /dev/null +++ b/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) diff --git a/README.md b/README.md index e9283b1..ad72791 100644 --- a/README.md +++ b/README.md @@ -2,43 +2,29 @@ ![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) ![Security](https://img.shields.io/badge/security-Preflight%20%2B%20Secret%20Scan-16a34a) ![Deploy](https://img.shields.io/badge/deploy-Vercel-111111?logo=vercel) -> **Economy-First Blockchain Protocol for Real World Assets (RWA)** +> Infraestrutura de confianca para ativos gemologicos com trilha verificavel: `Raman -> SpectralHash -> EAS -> Certificado + QR`. -Repositorio oficial do GEMLAB para avaliacao tecnica-institucional (Centelha Fase 2). +## Comece Aqui (Jurado) ---- +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) -## VSC (Value-Separated Control) Architecture +## O que este repositorio prova -1. **Value Layer (The Truth):** validacao cientifica off-chain (Raman) ancorada por hash criptografico. -2. **Control Layer (The Rules):** smart contracts e attestation para integridade, rastreabilidade e compliance. -3. **Interface Layer (The View):** interfaces desacopladas para verificacao publica e operacao segura. +- 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. -### Core Features - -- **Fail-Fast Validation:** fluxo invalido falha quando faltam attestations obrigatorias. -- **Data Economy:** dados pesados off-chain; somente provas (`bytes32`) on-chain. -- **Zero-Trust Security:** segregacao de papeis, gates de release e varredura de segredos. - ---- - -## Quick Access - -- Plataforma institucional (Vercel): 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` -- Checklist GO/NO-GO: `docs/CENTELHA_SUBMISSION_GO_NO_GO_2026-02-27.md` -- Hardening publico: `docs/GITHUB_PUBLIC_HARDENING_CHECKLIST.md` - -## Documentacao Completa - -Para narrativa completa (pitch, roadmap, equipe, modelo de negocio, licenciamento e operacao): -- `src/README.md` - -## Licenciamento - -Licenciamento segmentado em `LICENSING.md`. +## Links tecnicos essenciais +- 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) From 4775f3586a26940155e3df593adec04c63530a7f Mon Sep 17 00:00:00 2001 From: doublegreem Date: Sat, 28 Feb 2026 10:33:02 -0300 Subject: [PATCH 4/4] docs: add one-screen executive panel for juror first impression --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index ad72791..526671c 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,15 @@ > Infraestrutura de confianca para ativos gemologicos com trilha verificavel: `Raman -> SpectralHash -> EAS -> Certificado + QR`. +## Painel Executivo (1 tela) + +| 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. | + ## Comece Aqui (Jurado) 1. **Visao rapida (3 min):** [`JURORS_START_HERE.md`](./JURORS_START_HERE.md)