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 aec4f1a..526671c 100644 --- a/README.md +++ b/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) - -GEMLAB © 2025 by Diego Guedes Da Silva is licensed under Creative Commons Attribution-NonCommercial 4.0 International. - -## 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) 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 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`.