Architecture & Core
WORKLOG
Worklog
[v1.3.9] - 2026-03-04 (N8n Omnichannel Integration - Fase 7)
Added
- D1 Migration: Adicionado o campo
abandonment_triggered_atemorderscom a migration0007_pale_nekra.sqlpronta. - N8n Service Layer: Criado módulo focado em Webhooks assíncronos (
N8nIntegrationService), suportandodispatchAbandonedCartedispatchOrderPaid. - 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.completedembilling.ts. - Dev Environment: Inseridas senhas falsas em
.dev.varsmirando no N8n Node na local host (Docker5678).
[v1.3.8] - 2026-03-04 (Handoff OSeller)
Added
- OSeller Innovation Report: Criação do
oseller_innovation_report.mdsugerindo SSR via React Router v7+ e Hooks preditivos para abandono de carrinho. - OSeller Environment Setup: Configurada as
.envkeys 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/productsconfirmados 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
PriceWatchAgenteTrendSpotterAgentem 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 dadosc.env.DBou similar. - Frontend Refactoring: Remoção completa de memory leaks e timeouts associados a interações assíncronas do React através de polling de
refetchIntervalestaleTime.
[v1.3.6] - 2026-03-04
Fixed
- TypeScript Errors (Backend): Resolvidos erros de tipagem no
backend-workerque impediam o build do projeto.- Adicionada tipagem explícita de
BindingsaoHonocontext embanners.ts. - Adicionado suporte a
env.AInos construtores e chamadas deHubGatewaynos agentesCopyMaster,PriceWatcheTrendSpotter.
- Adicionada tipagem explícita de
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 (
sqle${}) noadmin.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.tsvia 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 utilizafetchExchangeRate()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
PriceDoctorServicepara garantir que o frete dinâmico seja aplicado corretamente sob as novas taxas.
Added
- Ordenação Admin: Suporte a
Recentes(createdAt) noAdminProducts.tsx. - Dados Reais IA:
MarketAnalystServiceagora 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
listedNumporrankIndexem todo o backend (admin.ts,cj.ts,ranking.ts,product-importer.ts,cj-webhook.ts). - Integridade: Corrigidos erros de sintaxe no
RankingServicee tipagem noProductImporter.
[v1.2.0] - 2026-02-22
Added
- Conectividade Hub IA:
HubGatewayatualizado para gerenciar chamadas externas dinâmicas. - Integração de Agentes:
CopyMastereQualityGateagora 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
HubGatewaynoPriceWatchAgent.
[v1.1.4] - 2026-02-22
Mudanças
- Refatoração de Personas: Migração total de nomes obsoletos para a arquitetura v5.5.
Sherlockagora éQualityGateem todo o código de runtime.LabAgentfoi substituído porCopyMaster(comentários e referências em rotas).
- Core API: Atualizados os handlers em
public-api.tspara 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/usersimpedindo 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/:idno backend.
[v1.1.3.3] - 2026-02-22
Fixed
- Syntax de imports (
../../indexpara../../types) em múltiplos arquivos. - Type errors para o stub
CopyMasterAgent.enhanceProduct()e para a variávelisMidnightna chamada de cron daindex.ts. - Refatoração dos arquivos e remoção de
token.jsonhardcoded, com a respectiva proteção no.gitignore. - Rota
decisionMetricsRoutesmontada emindex.ts.
Removed
- Desinstaladas dependências ociosas ou incompatíveis com Workers:
bcryptjsedd-traceno backend;@fingerprintjs/fingerprintjsno 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
DiscoveryServicepara 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/productsemexternal-ai.tspara ingestão de produtos vencedores de IA externa. - FEAT (Matching): Refatorado
TrendImporterpara 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.mddocumentando 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) noindex.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.techehub.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.techestá sendo interceptado por cache ou mapeamento fantasma apesar dos arquivos corretos estarem no servidor. - ADR: Criado
0007-dual-path-routing-cloudflare.mddocumentando 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_enterpriseerank_limit_premiumestavam ambos definidos como99999quando deveriam ser1e101, bloqueando a query de vitrine completa. - REFACT (Frontend): Resolvidos erros
401 Unauthorizedlançados frequentemente por requests de checagem de "categoria ativa". Endpointapi/v1/productsnecessitava deAPI_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
OSellerOconnectorrodando React 19 / Cloudflare Pages. - ANALYSIS (Hub): Análise arquitetural confirmou que o backend
OBrain-OConnectjá possui a estrutura de API Hub Client (Rotas/stores/:sub/products,orders,banners,categoriesjá existem ewallettambém). - PIVOT: O
implementation_plan.mdfoi 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 (
v1endpoints 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
/scandovps-scraper. Pacotepython-joseintroduzido emrequirements.txt. - SECURITY (Edge): Removido
X-API-Keyestático e inserido JWT assinado pelojosenoVpsScraperAdapter(vps-adapter.ts). - ADR: Criado
docs/_consolidated/decisions/0004-jwt-edge-to-vps-auth.mddocumentando 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(Arquivobackend-worker/src/routes/raas.ts). - DX (Backend-Frontend):
index.tsalterado para exportar global typeAppRouter. - DX (Frontend): Configurado
frontend/src/lib/apiClient.tsconsumindo o cliente@hono/zod-validatorpara 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
storesRoutespara 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.
- Motivo: O endpoint
- DIAGNÓSTICO (CSP): Erro de CSP (
beacon.min.js) analisado.- Constatação: Arquivo
frontend/public/_headersJÁ contém a regra correta (script-src ... static.cloudflareinsights.com). - Veredito: O erro reportado reflete uma versão antiga deployada.
- Constatação: Arquivo
- RECOMENDAÇÃO: Redeploy do frontend
obrain-hub(que serveoseller) é necessário para aplicar o novo_headers. - DEPLOY (Backend): Executado
wrangler deploy. Versão49371a6cativa.- 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:
_headersatualizado com CSP correto.
- Resultado:
- FIX (Backend/Categories): Rota
categoriesRoutesmovida para escopo público.- Motivo: O endpoint
/api/categoriesestava retornando 401 para visitantes não logados, quebrando o menu da loja.
- Motivo: O endpoint
- 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/productsestava retornando 401. A autenticação porX-API-Keyé interna da rota, mas o middleware global bloqueava antes.
- Motivo: O endpoint
- DEPLOY (Backend): Executado
wrangler deploy(v. 56e54316). - FIX (Frontend/404): Refatorado
ProductCardpara usar componenteProductImagecom 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 lojaosellernão puderam ser corrigidas.- Motivo: Código-fonte da Storefront não encontrado no workspace. O diretório
frontendcontém apenas o Hub/Dashboard.
- Motivo: Código-fonte da Storefront não encontrado no workspace. O diretório
- 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.
- Causa: O usuário de teste (
- 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
onChangee conversão USD/BRL, forçando formataçãostep=0.01e controle de valor inicial.
- Solução: Aplicado controle de estado estrito com
- 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 buildseguido dewrangler pages deploypara 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.mdcom:- 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_mappingspara isolamento de SKUs por lojista. - Implementados handshakes OAuth2 para Shopify e Nuvemshop em
/api/integrations. - Implementado
PlatformExporterServicepara sincronização delta de catálogo. - Ativado Cron
Omnichannel Exportnoscheduledhandler. - Adicionado utilitário de validação HMAC para segurança de Webhooks.
- Criada tabela
- Pivot B2B Hub - Fase 2 Finalizada (Consolidação da API)
- Implementação de
GET /api/v1/orderscom filtros de multitenancy. - Validação de compatibilidade total das rotas
/walletcom o cliente OSeller. - Implementação de
rateLimitMiddlewarevia Cloudflare KV. - Provisionamento de Lojas (
POST /api/stores) validado para novos tenants. - Documentação interativa Swagger ativada em
/api/docs.
- Implementação de
- 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.mdcom status da auditoria.
2026-01-23 - Migration Scraper Serverless (ZenRows)
- REFACTOR: Implementado
ScraperInterfaceeScraperFactorypara desacoplar lógica de scraping. - REFACT: Limpeza e ajustes em
ScraperGovernorePriceWatchAgent. - ... (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.yamlmarcado como Canonical Source of Truth. - ADAPTER: Implementado
ZenRowsScraperAdapterpara scraping serverless sem VPS. - ADAPTER: Implementado
VpsScraperAdaptercomo fallback legado. - HYBRID: Implementado
HybridScraperAdaptercomo 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.tse 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_STRATEGYemtypes.ts,wrangler.toml. - FIX: Funções
sanitize/safeParseJsonrestauradas emBaseAgent. - VERIFICAÇÃO:
npm testpassing (53 tests). Buildtsccompatí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.mdna 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.jsone.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 emtest/)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:
.gitignoreatualizado com patterns de segurança (*.pem,*.key,venv/, etc)static-analysis.datadog.ymlsimplificado (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 > 0excluí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
listedNume aumentado delay para 4s emproduct-importer.ts. - VERIFICAÇÃO: Execução manual local via
wrangler devconfirmou 58 produtos encontrados (antes 0). - BLOCKER RESOLVIDO (R2): Bucket
obrain-imagesreativado na Cloudflare. - DEPLOY: Versão
b795b6b4enviada para produção com sucesso. - CLEANUP: Tentativa de remover bucket legado
netcar-cachefalhou (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
Bindingsemproduct-importer.tseprice-watch.ts. - VERIFICAÇÃO: Teste local (Preview Prod) confirmou 50 produtos disponíveis no armazém BR.
- DEPLOY: Versão
265c8266com 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_keyindicada 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/healthrespondendo 200 OK. - CONFIG:
.envatualizado com novo IP.
⚠️ AÇÃO REQUERIDA DO USUÁRIO
- Revogar chaves Oracle Cloud não usadas (
vizinshopadm@gmail.com) - Rotacionar API keys Datadog no painel
- Considerar
git filter-repopara limpar histórico
2026-01-18 - Correção de Imagens CJ e R2 Migration
- Backend: Adicionado
adminMigrationRouteremroutes/admin-migration.ts. - Backend: Atualizado
ImageHosterpara upload de URL externa para R2. - Backend: Adicionado suporte a CORS para
*.pages.devemindex.ts. - Frontend: Adicionado botão "Reparar Imagens" em
AdminProducts.tsx. - Frontend: Aplicado
referrerPolicy="no-referrer"emProductImage,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.tspara diagnosticar erro 500. - [Frontend/Fix] Implementado auto-fix de URLs Amazon e fallback visual no componente
ProductImage. - [Frontend/UI] Unificado o uso do componente
ProductImageemAdminProducts.tsx.
2026-01-23 - Economic Decision Governance (Credit Score)
- AUDIT: Relatório
docs/audit/technical_understanding_report.mdreescrito 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 tabelaproducts. - MIGRATION: Gerada migration
0005_glamorous_praxagora.sql. - LOGIC: Atualizado
ProductImporterpara persistir veredito e bloquear produtos inviáveis (active: false). - VERIFICATION:
npm testpassed (53 tests). logic validated via implementation.
2026-02-20
2026-02-21 - Phase 3 & OSeller Polishing
- Omnichannel Export & Sync Engine:
- Criada tabela
store_product_mappingse refatoração deplatform_tokenspara Multi-tenancy. - Implementados handshakes OAuth2 (stub) para Shopify e Nuvemshop no Worker.
- Implementado
PlatformExporterServicepara propagar preços e estoque via cronscheduled. - Adicionado utilitário de validação HMAC para segurança de Webhooks Shopify.
- Criada tabela
- 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
osellerparaENTERPRISEpara acesso total ao catálogo.
- [Backend] Adicionado endpoints v1 na Public API (
- [Frontend] Sincronização Real (Dashboard + Orders + Products) conectada ao Hub API.
- [Frontend] Unificação do modelo de preços (
pricefield) no Carrinho e tipos de Produto.
- [Frontend] Unificação do modelo de preços (
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.varse 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 Sessionsna rota/ordersgerando link de pagamento. Webhook implementado escutando.mode == paymentpara 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,SherlockServiceimplementados noagent-hubpara avaliação mercadológica e auditoria ativa. - Central de Fábrica: Implementado
CopyMasterServicenoagent-hubatrelado aoenv.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
ImageBoosterServicenoagent-hubconsumindoenv.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
/dashboardpara monitoramento de mineradoras em tempo real. - Orquestração Geral: Inicialização da infraestrutura do
LabAgentem TypeScript no HUB garantindo fluxo MestreScraper -> Analyst -> Factory.
2026-02-21 - Agent Telemetry & IA Observability (Multi-tenant)
- Backend (Hub): Expansão do schema
agentAuditLogsno D1 (latência, tokens, status, clientId) e implementação doTelemetryServiceassíncrono. - Proxy (Worker): Rota
/manager/telemetry/analyticsimplementada no backend do SaaS, atuando como ponte segura e multi-tenant para oagent-hub. - Frontend (Dashboard): Componente
AgentTelemetryChartcriado com Recharts, exibindo KPIs globais, séries temporais de 24h e ranking de performance por agente. - ADR: Criado
0005-agent-telemetry-proxy-architecture.mddocumentando a arquitetura de observabilidade. - Governance: Implementada filtragem por
clientIdnativa 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
YieldOptimizerServiceno backend-worker para varrer produtos com Auto-Pilot ativado e aplicar automaticamente o preço sugerido pela IA. - Financial ROI Dashboard: Criado componente
FinanceROIe integrado ao Dashboard do Usuário para visualização em tempo real do lucro incremental gerado por IA. - UI Support: Refatorada a
MyProductsPage.tsxpara 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.