🧭 Mapeamento de Consumo dos .json do Catálogo & Plano de Ação (To-Dos)

Este documento registra a arquitetura de dados dos catálogos de projetos distribuídos entre a Central de Artefatos (D:\ai-projects\docs\central-artefatos) e o Portal Artes do Sul (d:\artesdosul\artesdosul), detalhando onde cada .json é consumido e o roadmap completo de pendências e melhorias ordenado por prioridade (P1 a P4).

---

🏗️ Arquitetura de Fluxo de Dados

flowchart TD
    subgraph RepositorioLocal["D:/ai-projects (Pastas & READMEs)"]
        READMEs["196+ Projetos com Bloco 🛡️ Sentinel Status"]
    end

    subgraph PipelineCentral["Pipeline Central de Artefatos"]
        UP["update_projetos.py"]
        AUDIT["audit_catalogo.py"]
        SUGG["suggest_online_urls.py"]
        PJ["projetos.json (173 itens)"]
        PO["projetos-online.json (266 itens)"]
    end

    subgraph DashboardsCentral["Dashboards & Relatórios"]
        STATUS_HTML["status-projetos.html"]
        INVESTOR["investor-dashboard.html"]
        TOOLS["tools-dashboard.html"]
        WHATSAPP["PROJETOS-WHATSAPP.md"]
    end

    subgraph PortalArtesDoSul["Portal Artes do Sul (Jekyll)"]
        PORT_JSON["_data/portfolio.json (94 itens)"]
        PROJ_JSON["_data/projetos.json (72 itens)"]
        INDEX_HTML["projetos/index.html (Projects Hub 91 cards)"]
        RELATORIOS["relatorio-top22-portfolio.md"]
        SHOWCASE["_posts/showcase & _includes"]
    end

    READMEs --> UP
    UP --> PJ
    PJ --> AUDIT
    SUGG --> PO
    PO --> AUDIT
    PJ --> STATUS_HTML
    PJ --> INVESTOR
    PJ --> TOOLS
    PO --> WHATSAPP

    PO -.-> PORT_JSON
    PO -.-> PROJ_JSON
    PORT_JSON --> INDEX_HTML
    PORT_JSON --> RELATORIOS
    PROJ_JSON --> SHOWCASE

---

📂 Detalhamento por Arquivo e Consumidores

Arquivo .json	Localização	Papel & Estrutura	Consumidores no Código
projetos-online.json	D:/ai-projects/docs/central-artefatos/projetos-online.json	Catálogo Canônico Online (266 apps). Contém { titulo, descricao, tags, url }.	• audit_catalogo.py (audita projetos sem URL) • suggest_online_urls.py • PROJETOS-WHATSAPP.md • RELATORIO-MONETIZACAO-TOKENS.md
projetos.json (Central)	D:/ai-projects/docs/central-artefatos/projetos.json	Inventário Mestre de Governança (173 pastas). Contém { nome, pasta, status, tier, health, stack, evolucao, pendencias }.	• status_projetos.py → status-projetos.html • investor-dashboard.html • generate_tools_tree.py • serve_with_update.py • enrich_tags.py
portfolio.json	d:/artesdosul/artesdosul/_data/portfolio.json	Catálogo Executivo de Portfólio (94 apps). Contém { href, img_src, img_alt, title, description }.	• relatorio-top20-portfolio.md • relatorio-top22-portfolio.md • Sincronizador de Cards do Projects Hub
projetos.json (Portal)	d:/artesdosul/artesdosul/_data/projetos.json	Base de Dados Jekyll de Soluções (72 itens). Contém { title, items: [{ title, image_url, link_url, description }] }.	• Jekyll Data Engine (site.data.projetos) • scripts/padronizar_tags_showcase.py • Ingestões editoriais do portal
projetos/index.html	d:/artesdosul/artesdosul/projetos/index.html	Projects Hub Cyber-Growth (91 cards interativos). Renderiza cards estáticos com persistência local em JS.	• Navegação direta dos usuários no portal (/projetos/) • Filtros reativos por categoria, prioridade, busca e to-dos

---

📋 To-Dos Completo por Prioridade

🔴 P1 — Crítico & Integridade Imediata

• Resolver divergências de catálogos: Sincronizados projetos-online.json (96 → 266), _data/portfolio.json (71 → 94) e _data/projetos.json (47 → 72).
• Eliminar 100% dos links quebrados de imagens (404s): Corrigidas referências legadas .png/.jpeg para .webp e adicionados heros reais para ChromaMesh, GlitchLab, MatrixText, IsometricCraft e AudioVisualizer 3D.
• Sincronizar Cards no Projects Hub: Inseridas as 25 novas masterpieces e ativado cálculo dinâmico de contadores de categorias em projetos/index.html.
• Criar script único de consolidação periódica: Mover a lógica de sincronização para scripts/sync_catalogo_master.py, permitindo atualizar os 4 catálogos com um único comando:

  python scripts/sync_catalogo_master.py --validate-urls
  

• Verificação de Liveness HTTP/SSL: Criar rotina para checar se todas as 266 URLs respondem HTTP 200/301 sem erros de certificado DNS/SSL.

---

🟡 P2 — Alto & Automação de Pipeline

• Integração com a Skill sentinel-status: Conectar a execução de update_projetos.py para disparar automaticamente a atualização de projetos-online.json sempre que um projeto mudar seu status para 🟢 Produção.
• Consumo Dinâmico em Jekyll: Criar include Liquid em _includes/portfolio-grid-dinamico.html consumindo diretamente site.data.portfolio, eliminando a necessidade de duplicar markup HTML manual nas páginas do blog.
• Alinhamento do _data/top22.json e _data/ecosystem.json: Atualizar os arquivos auxiliares para garantir que os 22 projetos selecionados reflitam as masterpieces mais recentes (Turismo, Brasil Muralhas, Persuasão, DevStudio, Kaizen).
• Padronização de Open Graph og:image nos deploys externos: Criar rotina que valida se cada subdomínio .artesdosul.com possui <meta property="og:image"> canônico apontando para imagem 1200x630.

---

🔵 P3 — Médio & Otimizações de UX / SEO

• Schema.org Rich Snippets: Inserir JSON-LD (ItemList e SoftwareApplication) em projetos/index.html para que os 91 projetos sejam indexados pelo Google como catálogo de software.
• Badges de Stack Técnica nos Cards: Adicionar pílulas com as principais linguagens/frameworks (ex.: React, Three.js, WebGL, PWA, Edge API) na parte inferior dos cards do Projects Hub.
• Filtro de Status Serverless/Edge: Adicionar seletor rápido no Projects Hub para filtrar apenas projetos com suporte PWA Offline ou WebGL 3D.
• Exportação Executiva (JSON / CSV): Adicionar botão no Projects Hub para exportar a lista filtrada de projetos diretamente em .json ou .csv.

---

⚪ P4 — Backlog & Melhorias Contínuas

• Geração Automática de Banners OG (Edge/Canvas): Implementar gerador dinâmico de thumbnail/OG para projetos novos que ainda não possuem hero próprio.
• Métricas de Latência no Card: Exibir ping/latência em tempo real para as APIs públicas (api.artesdosul.com, agents.ainativo.cloud).
• Exportador de Apresentação: Automação para gerar slides em HTML/Marp a partir dos dados do portfolio.json.