OBrain Sovereign Engine
Architecture & Core

WORKLOG

Worklog

[v1.3.9] - 2026-03-04 (N8n Omnichannel Integration - Fase 7)

Added

  • D1 Migration: Adicionado o campo abandonment_triggered_at em orders com a migration 0007_pale_nekra.sql pronta.
  • N8n Service Layer: Criado módulo focado em Webhooks assíncronos (N8nIntegrationService), suportando dispatchAbandonedCart e dispatchOrderPaid.
  • Scheduled Cronjob: Adicionado index cron que rastrea de uma em uma hora carrinhos perdidos acima de 1 hora.
  • Webhook Webhook: Atualizado pipeline de faturamento para avisar o webhook corporativo n8n no evento de checkout.session.completed em billing.ts.
  • Dev Environment: Inseridas senhas falsas em .dev.vars mirando no N8n Node na local host (Docker 5678).

[v1.3.8] - 2026-03-04 (Handoff OSeller)

Added

  • OSeller Innovation Report: Criação do oseller_innovation_report.md sugerindo SSR via React Router v7+ e Hooks preditivos para abandono de carrinho.
  • OSeller Environment Setup: Configurada as .env keys no repósito OSeller para parear dinamicamente os apontamentos com workers Cloudflare (porta 8787).

Fixed

  • OSeller Build Integrity: Resolvido peer dependency conflict react-helmet-async (vs React 19) rodando --legacy-peer-deps.
  • API Sincronizada: Endpoints como GET /api/stores/:subdomain/products confirmados consumindo da Storefront.## [v1.3.7] - 2026-03-04

Added

  • TanStack Query (Frontend): Substituição de fetch manual por React Query para cache global, evitando overfetching e melhorando a reatividade da UI nas rotas principais (UserDashboard, Marketplace, AdminDashboard).

Fixed

  • TypeScript Errors (Backend): Resolvida assinatura quebrada no construtor do PriceWatchAgent e TrendSpotterAgent em múltiplas rotas e serviços (product-importer.ts, scheduler.ts, admin.ts, products.ts, cj-webhook.ts, public-api.ts). Agora as invocações passam explicitamente o banco de dados c.env.DB ou similar.
  • Frontend Refactoring: Remoção completa de memory leaks e timeouts associados a interações assíncronas do React através de polling de refetchInterval e staleTime.

[v1.3.6] - 2026-03-04

Fixed

  • TypeScript Errors (Backend): Resolvidos erros de tipagem no backend-worker que impediam o build do projeto.
    • Adicionada tipagem explícita de Bindings ao Hono context em banners.ts.
    • Adicionado suporte a env.AI nos construtores e chamadas de HubGateway nos agentes CopyMaster, PriceWatch e TrendSpotter.

Removed

  • Obsolete Frontend Components: Removidos 6 arquivos não utilizados no frontend/src/components (ErrorBoundary.test, FavoriteButton, app-sidebar, chart-area-interactive, data-table, site-header).

Security

  • Audit Compliance: Realizada varredura de segredos e arquivos temporários (limpo).

Fixed

  • Admin Build Failure: Purga total de template strings (sql e ${}) no admin.ts. O parser do Wrangler/Esbuild estava lançando erros de "Unterminated string literal" devido a conflitos com tagged template literals e caracteres residuais.
  • Integridade de Arquivo: Reconstrução total do admin.ts via terminal (cat << EOF) para garantir limpeza absoluta de bytes corrompidos e lixo sintático no final do arquivo.

Deployed

  • Version ID: fe58c847-9b3b-440d-80b6-aadcf8828877 (Backend Hub).

[v1.2.4] - 2026-02-22

Added

  • Câmbio Unificado: Remoção da taxa estática de 5.20 no DiscoveryService. Agora o backend utiliza fetchExchangeRate() para sincronizar custos de importação com o mercado real (~5.80+).

Fixed

  • Preços no Dashboard: Correção de discrepância de ~12% nos preços sugeridos para o Mercado Livre.
  • Auditoria de Markup: Revisão do PriceDoctorService para garantir que o frete dinâmico seja aplicado corretamente sob as novas taxas.

Added

  • Ordenação Admin: Suporte a Recentes (createdAt) no AdminProducts.tsx.
  • Dados Reais IA: MarketAnalystService agora consome tendências reais dos últimos 15 dias.
  • Discovery BR: Simulação aprimorada de produtos Amazon Brasil no DiscoveryService.

Fixed / Refactored

  • Popularidade Schema: Substituído o campo inexistente listedNum por rankIndex em todo o backend (admin.ts, cj.ts, ranking.ts, product-importer.ts, cj-webhook.ts).
  • Integridade: Corrigidos erros de sintaxe no RankingService e tipagem no ProductImporter.

[v1.2.0] - 2026-02-22

Added

  • Conectividade Hub IA: HubGateway atualizado para gerenciar chamadas externas dinâmicas.
  • Integração de Agentes: CopyMaster e QualityGate agora utilizam o Gateway para processar prompts em vez de retornar mensagens de erro.
  • Factory de Agentes: Reativados todos os 9 agentes IA na factory central (agents/index.ts).

Fixed

  • Erro de referência circular e falta de import de HubGateway no PriceWatchAgent.

[v1.1.4] - 2026-02-22

Mudanças

  • Refatoração de Personas: Migração total de nomes obsoletos para a arquitetura v5.5.
    • Sherlock agora é QualityGate em todo o código de runtime.
    • LabAgent foi substituído por CopyMaster (comentários e referências em rotas).
  • Core API: Atualizados os handlers em public-api.ts para suportar as novas chaves de agentes.

[v1.1.3.3] - 2026-02-22

  • [2026-02-21] Hotfix: Corrigido middleware global /api/* que bloqueava rotas públicas### [v1.1.3.2] - 2026-02-21

Fixed

  • Ausência de endpoint POST /manager/users impedindo criação de usuários.
  • Erro de validação Zod para role ENTERPRISE.
  • Avisos de acessibilidade do Radix UI nos diálogos de usuários.

Added

  • Endpoint DELETE /manager/users/:id no backend.

[v1.1.3.3] - 2026-02-22

Fixed

  • Syntax de imports (../../index para ../../types) em múltiplos arquivos.
  • Type errors para o stub CopyMasterAgent.enhanceProduct() e para a variável isMidnight na chamada de cron da index.ts.
  • Refatoração dos arquivos e remoção de token.json hardcoded, com a respectiva proteção no .gitignore.
  • Rota decisionMetricsRoutes montada em index.ts.

Removed

  • Desinstaladas dependências ociosas ou incompatíveis com Workers: bcryptjs e dd-trace no backend; @fingerprintjs/fingerprintjs no frontend.
  • Deletado lixo de compilações passadas (logs de build, listagem de arquivos IA) e o componente redundante FilterSidebar.tsx.

[v1.1.3.1] - 2026-02-21

  • [2026-02-21] Deploy v1.1.2 finalizado com sucesso via Wrangler.
  • [2026-02-21] Corrigido erro de build: adicionado @hono/zod-validator às dependências.
  • [2026-02-21] Implementação do DiscoveryService para mineração de Top 600 produtos BR.
  • [2026-02-21] Configuração de cron quinzenal (dias 1 e 15) no index.ts.

2026-02-21 - Integração de IA Externa e Match CJ BR (FINAL)

  • FEAT (API): Criado endpoint POST /api/external-ai/products em external-ai.ts para ingestão de produtos vencedores de IA externa.
  • FEAT (Matching): Refatorado TrendImporter para priorizar o armazém Brasil (BR) da CJ e aplicar algoritmo de similaridade (Fuzzy Match) nominal com threshold de 40%.
  • ROUTING: Registro da nova rota no entrypoint principal (index.ts).
  • ADR: Criado 0008-external-ai-product-matching-cj-br.md documentando a estratégia logística e de dados.
  • VERSION: Backend atualizado internamente (manchas de v1.1.2 preparadas).

2026-02-21 - Domain & Connectivity Fixes (Post-Audit) - FINAL

  • FIX (Backend): Implementado roteamento Dual-Path (mountRoute) no index.ts. O worker agora responde em /api/* e /* para lidar com o comportamento de stripping do Cloudflare.
  • FIX (Backend): Atualizada política de CORS para incluir explicitamente oseller.oconnector.tech e hub.oconnector.tech, permitindo credenciais.
  • FIX (Frontend HUB): Corrigido carregamento do Admin. Build promovido para produção no projeto obrain-hub. Link direto validado.
  • FIX (Frontend OSeller): Sincronizados fallbacks de API URL para garantir funcionamento offline/failover de ENV.
  • VERSION: Backend promovido para v1.1.1.
  • AUDIT: Identificada colisão de domínio customizado no Cloudflare. O tráfego de hub.oconnector.tech está sendo interceptado por cache ou mapeamento fantasma apesar dos arquivos corretos estarem no servidor.
  • ADR: Criado 0007-dual-path-routing-cloudflare.md documentando a solução de roteamento.

2026-02-20 - Pivot B2B Hub (OSeller Debug & Polish)

  • DEBUG (Frontend): Vínculos testados e verificados de que produtos não estavam sendo exibidos no OSeller na inicialização (Skeleton loaders constantes).
  • FIX (Backend/Database): Detectado erro no D1 SQLite envolvendo inversão de valores lógicos na tabela platform_config. rank_limit_enterprise e rank_limit_premium estavam ambos definidos como 99999 quando deveriam ser 1 e 101, bloqueando a query de vitrine completa.
  • REFACT (Frontend): Resolvidos erros 401 Unauthorized lançados frequentemente por requests de checagem de "categoria ativa". Endpoint api/v1/products necessitava de API_KEY. Transferido para o client público /api/stores/oseller/products.
  • FIX (TypeScript): Erro de Tipagem A propriedade 'total' não existe no tipo 'HubProductsResponse' corrigido no Service para buscar do novo formato .pagination?.total.
  • VERIFICATION: Confirmação por screenshot do agent apontando a UI e listagem 100% corretas no navegador.

2026-02-20 - Pivot B2B Hub (OSeller as Native Client)

  • DISCOVERY: Identificada base paralela OSellerOconnector rodando React 19 / Cloudflare Pages.
  • ANALYSIS (Hub): Análise arquitetural confirmou que o backend OBrain-OConnect já possui a estrutura de API Hub Client (Rotas /stores/:sub/products, orders, banners, categories já existem e wallet também).
  • PIVOT: O implementation_plan.md foi reescrito: a plataforma oficial do OBrain não é "uma loja única", mas um B2B Omnichannel Hub.
  • PLAN: Fases redesenhadas.
    • Fase 1: Validar o OSeller (Client Nativo).
    • Fase 2: Consolidar o Hub API (v1 endpoints e Auth).
    • Fase 3: Omnichannel Export (Módulo Shopify/Nuvemshop app export).
    • Fase 4: Inteligência & RaaS API.
  • VERIFICAÇÃO: O worker já expõe as queries de Multi-tenant (buscando configs da loja no D1 antes de retornar o catálogo de produtos).

2026-02-20 - Integração RaaS e Segurança Inter-serviços (Edge-to-VPS)

  • SECURITY (VPS): Implementada validação JWT Bearer token na rota /scan do vps-scraper. Pacote python-jose introduzido em requirements.txt.
  • SECURITY (Edge): Removido X-API-Key estático e inserido JWT assinado pelo jose no VpsScraperAdapter (vps-adapter.ts).
  • ADR: Criado docs/_consolidated/decisions/0004-jwt-edge-to-vps-auth.md documentando o padrão Zero-Trust entre Worker e VPS externa.
  • FEAT (Inovação): Criado MVP Risk-as-a-Service (RaaS) mapeado em /api/v1/risk/:sku (Arquivo backend-worker/src/routes/raas.ts).
  • DX (Backend-Frontend): index.ts alterado para exportar global type AppRouter.
  • DX (Frontend): Configurado frontend/src/lib/apiClient.ts consumindo o cliente @hono/zod-validator para possibilitar queries HTTP estritamente tipadas.
  • FIX: Resolvido bug de sintaxe em product-importer.ts (desativando mock CopyMasterAgent não instalado) garantindo que build não quebre.

2026-01-23 - Storefront 401 & CSP Fix

  • FIX (Backend): Movida rota storesRoutes para antes do middleware de autenticação global (verifyJwt).
    • Motivo: O endpoint GET /api/stores/:subdomain/products (usado pela storefront pública) estava retornando 401 pois tentava validar token de usuário inexistente no visitante.
    • Impacto: Storefronts agora devem carregar produtos corretamente.
  • DIAGNÓSTICO (CSP): Erro de CSP (beacon.min.js) analisado.
    • Constatação: Arquivo frontend/public/_headers JÁ contém a regra correta (script-src ... static.cloudflareinsights.com).
    • Veredito: O erro reportado reflete uma versão antiga deployada.
  • RECOMENDAÇÃO: Redeploy do frontend obrain-hub (que serve oseller) é necessário para aplicar o novo _headers.
  • DEPLOY (Backend): Executado wrangler deploy. Versão 49371a6c ativa.
    • Resultado: Rotas de loja agora estão fora do middleware de auth.
  • DEPLOY (Frontend): Executado wrangler pages deploy. URL: https://master.obrain-hub-4xk.pages.dev.
    • Resultado: _headers atualizado com CSP correto.
  • FIX (Backend/Categories): Rota categoriesRoutes movida para escopo público.
    • Motivo: O endpoint /api/categories estava retornando 401 para visitantes não logados, quebrando o menu da loja.
  • DEPLOY (Backend): Executado wrangler deploy (v. 83a62736).
  • FIX (Backend/Public API): Rota publicApiRoutes (/api/v1) movida para escopo público.
    • Motivo: O endpoint /api/v1/products estava retornando 401. A autenticação por X-API-Key é interna da rota, mas o middleware global bloqueava antes.
  • DEPLOY (Backend): Executado wrangler deploy (v. 56e54316).
  • FIX (Frontend/404): Refatorado ProductCard para usar componente ProductImage com fallback e retry de URL.
    • Motivo: Imagens externas da Amazon expiradas causavam elementos de imagem quebrados. Agora exibe placeholder "Imagem indisponível" se falhar.
  • DEPLOY (Frontend): Redeploy executado wrangler pages deploy. URL: https://master.obrain-hub-4xk.pages.dev.
  • [!] BLOCKED (Storefront): Imagens 404 na página de produto (/product/:id) da loja oseller não puderam ser corrigidas.
    • Motivo: Código-fonte da Storefront não encontrado no workspace. O diretório frontend contém apenas o Hub/Dashboard.
  • INFO (Product Rules): Investigado motivo pelo qual "regras de produtos" (Markup/Rank) não aplicam.
    • Causa: O usuário de teste (oseller.test) é SUPERADMIN, que possui bypass intencional de regras (Markup 1.0, Rank Limit 1). Isso é comportamento esperado para admins, mas confuso para simulação de loja.
  • FIX (Frontend/Admin): Inputs de preço e concorrente no Dashboard (AdminProducts.tsx) corrigidos para evitar valores float quebrados (ex: 39,2828).
    • Solução: Aplicado controle de estado estrito com onChange e conversão USD/BRL, forçando formatação step=0.01 e controle de valor inicial.
  • FIX (Frontend/Admin): Removido texto "IMPOSTO INCL." da coluna de custos para limpar a interface e evitar confusão visual ("duplicidade de label").
    • Refinado estilo das células de input ("Concorrente" e "Seu Preço") para garantir que apenas um valor seja exibido.
  • DEPLOY (Frontend): Executado npm run build seguido de wrangler pages deploy para garantir que as alterações no Admin (fixes de duplicidade e formatação) subam para produção. (O deploy anterior falhou em atualizar por falta de build).

2026-01-23 - Technical Audit & Hand-off

  • AUDITORIA (L2): Realizada análise completa do repositório para "Understanding Report".
  • DOCS: Criado docs/audit/technical_understanding_report.md com:
    • Resumo Executivo.
    • Mapa do Repositório (Backend Worker, Frontend React, VPS Python).
    • Diagrama de Fluxo (Mermaid).
    • Modelo de Dados (Schema Drizzle, Users, Products, Stores).
    • Regras de Negócio e Invariantes.
    • Integrações Externas e Riscos.
  • Pivot B2B Hub - Fase 3 EM ANDAMENTO (Omnichannel Export)
    • Criada tabela store_product_mappings para isolamento de SKUs por lojista.
    • Implementados handshakes OAuth2 para Shopify e Nuvemshop em /api/integrations.
    • Implementado PlatformExporterService para sincronização delta de catálogo.
    • Ativado Cron Omnichannel Export no scheduled handler.
    • Adicionado utilitário de validação HMAC para segurança de Webhooks.
  • Pivot B2B Hub - Fase 2 Finalizada (Consolidação da API)
    • Implementação de GET /api/v1/orders com filtros de multitenancy.
    • Validação de compatibilidade total das rotas /wallet com o cliente OSeller.
    • Implementação de rateLimitMiddleware via Cloudflare KV.
    • Provisionamento de Lojas (POST /api/stores) validado para novos tenants.
    • Documentação interativa Swagger ativada em /api/docs.
  • Pivot B2B Hub - Fase 1 Finalizada (Conectividade OSeller)
    • Resolvidos erros 404 de banners e categorias.
    • Criada infra de mensageria assíncrona com Cloudflare Queues para sincronização de produtos.
    • Injeção de seed multitenant para "oseller" no banco D1 local.
  • HANDOFF: Atualizado STATE.md com status da auditoria.

2026-01-23 - Migration Scraper Serverless (ZenRows)

  • REFACTOR: Implementado ScraperInterface e ScraperFactory para desacoplar lógica de scraping.
  • REFACT: Limpeza e ajustes em ScraperGovernor e PriceWatchAgent.
  • ... (Vide logs anteriores consolidados abaixo)

2026-01-23 - Auditoria e Purge (Ruthless Auditor)

  • DELETED: docs/SWARM_BRAINSTORM.md (Fantasy Agency Architecture - não implementada).
  • DELETED: docs/oseller-multitenant.yaml, docs/oseller-token-response.yaml (Redundantes).
  • DELETED: docs/prompts/, docs/postman/ (Artifacts obsoletos/broken).
  • CREATED: docs/_consolidated/decisions/ (Architecture Decision Records).
  • ADR: Criado 0001-hybrid-scraper-architecture.md.
  • ADR: Criado 0002-frontend-backend-split.md.
  • UPDATED: docs/oseller-integration.yaml marcado como Canonical Source of Truth.
  • ADAPTER: Implementado ZenRowsScraperAdapter para scraping serverless sem VPS.
  • ADAPTER: Implementado VpsScraperAdapter como fallback legado.
  • HYBRID: Implementado HybridScraperAdapter como estratégia de fallback.
  • GOVERNANCE: Implementado ScraperGovernor (Proxy Pattern) com:
    • Circuit Breaker: Protege VPS (abre circuito após 5 falhas).
    • Budget: Limita ZENROWS_DAILY_LIMIT (padrão 50 requests/dia).
    • State: Uso de Cloudflare KV para persistência de falhas/budget.
  • SEMANTICS: Implementado contrato de degradação em types.ts e adapters.
    • metadata.source: Rastreia origem (vps/zenrows/fallback).
    • metadata.confidence: Penalidade de 20% se usar Fallback (0.8x trust).
    • metadata.governor: Estado explícito de circuit breaker.
  • CONFIG: Adicionado ZENROWS_API_KEY, SCRAPER_STRATEGY em types.ts, wrangler.toml.
  • FIX: Funções sanitize/safeParseJson restauradas em BaseAgent.
  • VERIFICAÇÃO: npm test passing (53 tests). Build tsc compatível.

2026-01-23 - Implementação CI/CD e Governança

  • CI: Criado .github/workflows/frontend-ci.yml (lint + build + test)
  • DEPS: Criado .github/dependabot.yml (npm backend/frontend + GitHub Actions)
  • DOCS: Adicionados badges de CI status ao README.md

2026-01-23 - Documentação (README)

  • DOCS: Criado README.md na raiz com:
    • Arquitetura (Frontend/Backend/DB/Storage).
    • Estrutura do Monorepo.
    • Comandos de instalação/dev.
    • Status atual (synced with STATE).

2026-01-23 - Auditoria Crítica e Limpeza do Repositório

  • SEGURANÇA (CRÍTICO): Removidos secrets expostos:
    • docs/private_backup/PEM/ (chaves SSH/PEM Oracle Cloud)
    • .datadog-ci.json e .env.datadog (API keys Datadog)
  • INCHAÇO: Removido deploy/vps-scraper/venv_local/ (~3080 arquivos Python)
  • CÓDIGO MORTO: Removidos:
    • backend-worker/tests/ (pasta órfã - testes reais estão em test/)
    • docs/obrain-api-v1.yaml (arquivo com lixo "uma pergunta")
    • Diretórios vazios: docs/audit/, docs/doc-gen/, docs/_consolidated/99_archive/, frontend/src/layouts/
  • CONFIGURAÇÃO:
    • .gitignore atualizado com patterns de segurança (*.pem, *.key, venv/, etc)
    • static-analysis.datadog.yml simplificado (47→27 linhas, apenas JS/TS/React)
  • VERIFICAÇÃO: Testes backend passaram (2/2)
  • AUDIT: Relatório Final de Viabilidade (Buyability Audit) gerado em docs/audit/BUYABILITY_AUDIT_2026.md.

2026-01-23 - CJ Product Import Debug & Fix

  • DIAGNÓSTICO: Falha na importação automática (0 produtos encontrados).
  • ROOT CAUSE 1: Filtro listedNum > 0 excluía novos produtos (maioria tem 0).
  • ROOT CAUSE 2: Rate Limit agressivo da CJ API (1 QPS) causando erro 429.
  • FIX (Código): Removido filtro listedNum e aumentado delay para 4s em product-importer.ts.
  • VERIFICAÇÃO: Execução manual local via wrangler dev confirmou 58 produtos encontrados (antes 0).
  • BLOCKER RESOLVIDO (R2): Bucket obrain-images reativado na Cloudflare.
  • DEPLOY: Versão b795b6b4 enviada para produção com sucesso.
  • CLEANUP: Tentativa de remover bucket legado netcar-cache falhou (não vazio). Recomendado remover via Dashboard.
  • CLEANUP INT: Revertidas rotas de debug (/__force_import) para manter segurança.
  • FEAT (Import): Restrição estrita para armazéns no Brasil (countryCode='BR', isWarehouse=true).
  • FEAT (Viabilidade): Integração com Mercado Livre via Google Search (site:mercadolivre.com.br) para comparação de preços.
  • FIX (Build): Corrigidos imports circulares/incorretos de Bindings em product-importer.ts e price-watch.ts.
  • VERIFICAÇÃO: Teste local (Preview Prod) confirmou 50 produtos disponíveis no armazém BR.
  • DEPLOY: Versão 265c8266 com novas regras de negócio.

2026-01-23 - Recuperação de Infraestrutura (Scraper VPS)

  • DIAGNÓSTICO: Identificada falha no scraper (VPS deletada/inacessível).
  • DISCOVERY: Encontrada chave SSH correta ~/.ssh/abs_mcp_key indicada pelo usuário.
  • RECOVERY: Acesso SSH restabelecido na VPS 137.131.156.33.
  • DEPLOY: Scraper reinstalado via SCP + SSH (Playwright/Python).
  • FIREWALL: Regra adicionada na Security List da Oracle Cloud para liberar porta 8000.
  • VERIFICAÇÃO: Endpoint http://137.131.156.33:8000/health respondendo 200 OK.
  • CONFIG: .env atualizado com novo IP.

⚠️ AÇÃO REQUERIDA DO USUÁRIO

  1. Revogar chaves Oracle Cloud não usadas (vizinshopadm@gmail.com)
  2. Rotacionar API keys Datadog no painel
  3. Considerar git filter-repo para limpar histórico

2026-01-18 - Correção de Imagens CJ e R2 Migration

  • Backend: Adicionado adminMigrationRouter em routes/admin-migration.ts.
  • Backend: Atualizado ImageHoster para upload de URL externa para R2.
  • Backend: Adicionado suporte a CORS para *.pages.dev em index.ts.
  • Frontend: Adicionado botão "Reparar Imagens" em AdminProducts.tsx.
  • Frontend: Aplicado referrerPolicy="no-referrer" em ProductImage, ProductCard, ProductRail, AdminProducts.
  • Debug: Executada migração forçada de ~37 imagens via rota temporária.
  • [Infra/Debug] Melhorada verbosidade do proxy de telemetria em admin.ts para diagnosticar erro 500.
  • [Frontend/Fix] Implementado auto-fix de URLs Amazon e fallback visual no componente ProductImage.
  • [Frontend/UI] Unificado o uso do componente ProductImage em AdminProducts.tsx.

2026-01-23 - Economic Decision Governance (Credit Score)

  • AUDIT: Relatório docs/audit/technical_understanding_report.md reescrito para refletir identidade "Governance Engine".
  • ADR: Criado docs/_consolidated/decisions/0003-governance-over-discovery.md (Decision: Bloqueio por padrão).
  • SCHEMA: Adicionada coluna decision_context (JSON) na tabela products.
  • MIGRATION: Gerada migration 0005_glamorous_praxagora.sql.
  • LOGIC: Atualizado ProductImporter para persistir veredito e bloquear produtos inviáveis (active: false).
  • VERIFICATION: npm test passed (53 tests). logic validated via implementation.

2026-02-20

2026-02-21 - Phase 3 & OSeller Polishing

  • Omnichannel Export & Sync Engine:
    • Criada tabela store_product_mappings e refatoração de platform_tokens para Multi-tenancy.
    • Implementados handshakes OAuth2 (stub) para Shopify e Nuvemshop no Worker.
    • Implementado PlatformExporterService para propagar preços e estoque via cron scheduled.
    • Adicionado utilitário de validação HMAC para segurança de Webhooks Shopify.
  • OSeller Polishing (Initial Ecommerce Focus):
    • [Backend] Adicionado endpoints v1 na Public API (/wallet, /stats, /orders) para suporte a vitrines via API Key.
    • [Database] Promoção do tenant oseller para ENTERPRISE para acesso total ao catálogo.
  • [Frontend] Sincronização Real (Dashboard + Orders + Products) conectada ao Hub API.
    • [Frontend] Unificação do modelo de preços (price field) no Carrinho e tipos de Produto.

2026-02-21 - Phase 4: Stripe Payment Integration & Company Details

  • Setup credentials: Configuração segregada de chaves API Live (sk_live, pk_live, whsec) de Stripe no backend-worker .dev.vars e na OSeller storefront.
  • Company Data: Integração dos dados oficiais extraídos do CNPJ atualizado: OCONNECTOR TECHNOLOGY INOVA SIMPLES (I.S.), 65.162.322/0001-82 (no Hub e no OSeller).
  • SDK & Flow: Estruturação completa com Stripe Checkout Sessions na rota /orders gerando link de pagamento. Webhook implementado escutando .mode == payment para criar vendas em /billing/webhook.

2026-02-21 - Phase 5: O-Protocol HUB Centralization & LabAgent

  • Configuração de VPS: Oracle Cloud restabelecida e testada como Scrapers.
  • Inteligência Central: MarketAnalystService, SherlockService implementados no agent-hub para avaliação mercadológica e auditoria ativa.
  • Central de Fábrica: Implementado CopyMasterService no agent-hub atrelado ao env.AI (Llama-3) para geração sistemática de descrições SEO, Copies Ads e Ângulos de Vendas (Skill: copy_master).
  • Central de Fábrica (Visual): Implementado ImageBoosterService no agent-hub consumindo env.AI (Stable Diffusion XL Lightning) para geração/otimização de criativos e fotos realistas de vitrine (Skill: image_booster).
  • Dashboard: Ops-Center UI montado em rota /dashboard para monitoramento de mineradoras em tempo real.
  • Orquestração Geral: Inicialização da infraestrutura do LabAgent em TypeScript no HUB garantindo fluxo Mestre Scraper -> Analyst -> Factory.

2026-02-21 - Agent Telemetry & IA Observability (Multi-tenant)

  • Backend (Hub): Expansão do schema agentAuditLogs no D1 (latência, tokens, status, clientId) e implementação do TelemetryService assíncrono.
  • Proxy (Worker): Rota /manager/telemetry/analytics implementada no backend do SaaS, atuando como ponte segura e multi-tenant para o agent-hub.
  • Frontend (Dashboard): Componente AgentTelemetryChart criado com Recharts, exibindo KPIs globais, séries temporais de 24h e ranking de performance por agente.
  • ADR: Criado 0005-agent-telemetry-proxy-architecture.md documentando a arquitetura de observabilidade.
  • Governance: Implementada filtragem por clientId nativa em nível de query SQL (D1) para garantir isolamento de dados entre lojistas.

2026-02-21 - Phase 5: Omni-Channel Sync & AI Yield Optimization

  • Omni-Channel Webhooks: Implementada rota de integração para Nuvemshop escutando eventos de criação e pagamento de pedidos.
  • AI Auto-Pilot Logic: Desenvolvido YieldOptimizerService no backend-worker para varrer produtos com Auto-Pilot ativado e aplicar automaticamente o preço sugerido pela IA.
  • Financial ROI Dashboard: Criado componente FinanceROI e integrado ao Dashboard do Usuário para visualização em tempo real do lucro incremental gerado por IA.
  • UI Support: Refatorada a MyProductsPage.tsx para apresentar switches de Auto-Pilot e cards de inteligência preditiva estáveis.
  • Maintenance: Corrigidos diversos erros de estruturação JSX que bloqueavam o build do frontend durante a implementação dos novos recursos.

On this page

Worklog[v1.3.9] - 2026-03-04 (N8n Omnichannel Integration - Fase 7)Added[v1.3.8] - 2026-03-04 (Handoff OSeller)AddedFixedAddedFixed[v1.3.6] - 2026-03-04FixedRemovedSecurityFixedDeployed[v1.2.4] - 2026-02-22AddedFixedAddedFixed / Refactored[v1.2.0] - 2026-02-22AddedFixed[v1.1.4] - 2026-02-22Mudanças[v1.1.3.3] - 2026-02-22FixedAdded[v1.1.3.3] - 2026-02-22FixedRemoved[v1.1.3.1] - 2026-02-212026-02-21 - Integração de IA Externa e Match CJ BR (FINAL)2026-02-21 - Domain & Connectivity Fixes (Post-Audit) - FINAL2026-02-20 - Pivot B2B Hub (OSeller Debug & Polish)2026-02-20 - Pivot B2B Hub (OSeller as Native Client)2026-02-20 - Integração RaaS e Segurança Inter-serviços (Edge-to-VPS)2026-01-23 - Storefront 401 & CSP Fix2026-01-23 - Technical Audit & Hand-off2026-01-23 - Migration Scraper Serverless (ZenRows)2026-01-23 - Auditoria e Purge (Ruthless Auditor)2026-01-23 - Implementação CI/CD e Governança2026-01-23 - Documentação (README)2026-01-23 - Auditoria Crítica e Limpeza do Repositório2026-01-23 - CJ Product Import Debug & Fix2026-01-23 - Recuperação de Infraestrutura (Scraper VPS)⚠️ AÇÃO REQUERIDA DO USUÁRIO2026-01-18 - Correção de Imagens CJ e R2 Migration2026-01-23 - Economic Decision Governance (Credit Score)2026-02-202026-02-21 - Phase 3 & OSeller Polishing2026-02-21 - Phase 4: Stripe Payment Integration & Company Details2026-02-21 - Phase 5: O-Protocol HUB Centralization & LabAgent2026-02-21 - Agent Telemetry & IA Observability (Multi-tenant)2026-02-21 - Phase 5: Omni-Channel Sync & AI Yield Optimization