From c996e24b429118977c670ec41b000d333a647938 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 20 Mar 2026 00:42:00 +0000 Subject: [PATCH] =?UTF-8?q?Adiciona=20mapeamento=20de=20reposit=C3=B3rios?= =?UTF-8?q?=20de=20aplica=C3=A7=C3=B5es=20VTEX?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documento com pesquisa detalhada de 24 aplicações internas da VTEX e seus repositórios públicos correspondentes no GitHub. Aplicações pesquisadas: tracking-api, ts, tsi, whatsappapi, wrkctlimp, geoapi, help-center-server, iam-login, janus-edge, janus-router, lambda, pfm, places, portal-sitemap, prdfeed, prtwrk, pyggy, rcvd-offers-api, sc, simdb, skuapi, spmapi, srapitmp, storedash. Organizações pesquisadas: vtex, vtex-apps, vtexdocs, vtex-sites, vtex-trainings e outras organizações VTEX menores. Co-authored-by: Danilo Moura --- mapeamento-repositorios-aplicacoes.md | 396 ++++++++++++++++++++++++++ 1 file changed, 396 insertions(+) create mode 100644 mapeamento-repositorios-aplicacoes.md diff --git a/mapeamento-repositorios-aplicacoes.md b/mapeamento-repositorios-aplicacoes.md new file mode 100644 index 0000000..4d42e15 --- /dev/null +++ b/mapeamento-repositorios-aplicacoes.md @@ -0,0 +1,396 @@ +# Mapeamento de Repositórios de Aplicações VTEX + +Este documento mapeia os nomes de aplicações internas da VTEX aos repositórios públicos encontrados na organização VTEX no GitHub (incluindo `vtex`, `vtex-apps`, `vtexdocs` e organizações relacionadas). + +> **Nota:** Muitas dessas aplicações são serviços internos da VTEX cujos repositórios não são públicos. A pesquisa abaixo foi realizada em todos os repositórios públicos das organizações VTEX no GitHub, usando busca direta por nome, busca por código-fonte, busca em manifestos de aplicações VTEX IO, e pesquisa na web. + +--- + +## Resumo Geral + +| Aplicação | Repositório(s) Público(s) Encontrado(s) | Nível de Confiança | +|---|---|---| +| tracking-api | Referenciado como `vtex-tracking-api` em `vtex/openapi-schemas` | Alto | +| ts | Nenhum repositório público identificado | — | +| tsi | Nenhum repositório público identificado | — | +| whatsappapi | Nenhum repositório público identificado | — | +| wrkctlimp | Nenhum repositório público identificado | — | +| geoapi | Nenhum repositório público identificado (ver candidatos) | — | +| help-center-server | Nenhum repositório público identificado (ver candidatos) | — | +| iam-login | Nenhum repositório público identificado (ver candidatos) | — | +| janus-edge | Componente de infraestrutura VTEX — referenciado em vários repositórios | Alto | +| janus-router | Componente de infraestrutura VTEX — referenciado em vários repositórios | Alto | +| lambda | Nenhum repositório público identificado | — | +| pfm | Nenhum repositório público identificado | — | +| places | `vtex-apps/places-graphql`, `vtex-apps/place-components`, `vtex-apps/order-places` | Alto | +| portal-sitemap | `vtex-apps/store-sitemap` (possível evolução) | Médio | +| prdfeed | Nenhum repositório público identificado | — | +| prtwrk | Nenhum repositório público identificado | — | +| pyggy | Nenhum repositório público identificado | — | +| rcvd-offers-api | Nenhum repositório público identificado (ver candidatos) | — | +| sc | Nenhum repositório público identificado | — | +| simdb | Nenhum repositório público identificado | — | +| skuapi | Nenhum repositório público identificado (ver candidatos) | — | +| spmapi | Nenhum repositório público identificado | — | +| srapitmp | Nenhum repositório público identificado | — | +| storedash | `vtex-apps/storedash-proxy` + referências em `vtex/node-vtex-api`, `vtex-apps/console`, `vtex-apps/bubbles` | Alto | + +--- + +## Detalhamento por Aplicação + +### 1. tracking-api + +**Repositórios encontrados com indícios fortes:** + +- **`vtex/openapi-schemas`** — O arquivo `config.json` referencia o codebase interno `vtex-tracking-api` como fonte da documentação "VTEX - Tracking.json". + - URL: https://github.com/vtex/openapi-schemas + - O repositório `vtex-tracking-api` em si não é público. +- **`vtex-apps/orders-tracking`** — Boilerplate de integração de tracking para VTEX IO (.NET Core). Manifesto declara dependência de `vtex.tracking-builder`. + - URL: https://github.com/vtex-apps/orders-tracking +- **`vtex-apps/orders-tracking-example`** — Boilerplate para consumo de notificações de invoice e tracking. + - URL: https://github.com/vtex-apps/orders-tracking-example +- **`vtex-apps/carrier-hubs-examples`** — Contém exemplo de integração de tracking para transportadoras. + - URL: https://github.com/vtex-apps/carrier-hubs-examples + +**Conclusão:** O repositório principal `vtex-tracking-api` é **privado**. Existem repositórios públicos de boilerplate/exemplo que consomem essa API. + +--- + +### 2. ts + +**Repositórios encontrados:** Nenhum repositório específico com este nome. + +A sigla "ts" é extremamente genérica e coincide com muitos termos (TypeScript, etc.). Nenhum repositório público da VTEX foi identificado como sendo esta aplicação específica. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 3. tsi + +**Repositórios encontrados:** Nenhum repositório específico com este nome. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 4. whatsappapi + +**Repositórios encontrados:** Nenhum repositório específico com este nome. + +As buscas por "whatsapp" na org VTEX retornaram apenas referências em documentação sobre integrações de terceiros (WhatsApp Business, notificações Personal Shopper, etc.), mas nenhum repositório dedicado a uma API de WhatsApp. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 5. wrkctlimp + +**Repositórios encontrados:** Nenhum. + +O nome parece ser uma abreviação interna (possivelmente "worker control import" ou similar). Nenhuma referência foi encontrada em repositórios públicos. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 6. geoapi + +**Repositórios encontrados com indícios possíveis (candidatos):** + +- **`vtex-apps/places-graphql`** — Serviço de geolocalização de endereços via GraphQL (usa Google Maps API). + - URL: https://github.com/vtex-apps/places-graphql + - Descrição no manifesto: "Service related to address geolocation" +- **`vtex-apps/geolocation-graphql-interface`** — Interface GraphQL para resolvedores de geolocalização. + - URL: https://github.com/vtex-apps/geolocation-graphql-interface +- **`vtex-apps/google-geolocation-resolver`** — Implementação da interface de geolocalização com Google Maps API. + - URL: https://github.com/vtex-apps/google-geolocation-resolver + +**Conclusão:** Nenhum repositório com o nome exato `geoapi`. Os repositórios de geolocalização listados acima podem ser relacionados, mas `geoapi` é provavelmente um serviço **privado/interno** distinto. + +--- + +### 7. help-center-server + +**Repositórios encontrados com indícios possíveis (candidatos):** + +- **`vtexdocs/help-center-content`** — Repositório de conteúdo do Help Center da VTEX. + - URL: https://github.com/vtexdocs/help-center-content +- **`vtexdocs/helpcenter`** — Frontend/aplicação do Help Center. + - URL: https://github.com/vtexdocs/helpcenter + +**Conclusão:** Os repositórios acima são relacionados ao conteúdo e frontend do Help Center. O `help-center-server` (backend/servidor) é provavelmente um repositório **privado/interno**. + +--- + +### 8. iam-login + +**Repositórios encontrados com indícios possíveis (candidatos):** + +- **`vtex-apps/login`** — App de login para VTEX IO Stores (docs e mensagens de login). + - URL: https://github.com/vtex-apps/login +- **`vtex/action-toolbelt-login`** — GitHub Action para login via VTEX Toolbelt. + - URL: https://github.com/vtex/action-toolbelt-login + +**Conclusão:** Nenhum repositório público com o nome `iam-login`. O sistema de IAM (Identity and Access Management) da VTEX é provavelmente um serviço **privado/interno**. O `vtex/openapi-schemas` referencia `vtex-id` e `license-manager` como codebases internos relacionados a autenticação/autorização. + +--- + +### 9. janus-edge + +**Referências encontradas (componente de infraestrutura):** + +`janus-edge` é um componente da infraestrutura de CDN/proxy da VTEX. Não é um repositório independente, mas sim parte da camada de API gateway/edge computing da plataforma. + +Referências encontradas em: +- **`vtex-apps/store-sitemap`** — Manifesto declara política de acesso a `janus-edge.vtex.com.br` para leitura de `robots.txt`. + - URL: https://github.com/vtex-apps/store-sitemap +- **`vtex/lens`** — Código verifica header `X-Powered-by-VTEX-Janus-Edge` para identificar respostas VTEX. + - URL: https://github.com/vtex/lens +- **`vtexdocs/help-center-content`** — Documentação explica o header `X-VTEX-Cache-Status-Janus-Edge` (HIT/MISS) para identificar cache na camada CDN. + - URL: https://github.com/vtexdocs/help-center-content +- **`vtex/openapi-schemas`** — Referências em documentação de APIs (ex: Pricing API). + - URL: https://github.com/vtex/openapi-schemas + +**Conclusão:** `janus-edge` é um componente de infraestrutura **interna** (edge/CDN layer). Seu código-fonte não é público. + +--- + +### 10. janus-router + +**Referências encontradas (componente de infraestrutura):** + +`janus-router` é parte do API gateway da VTEX, responsável pelo roteamento de requests na plataforma. + +Referências encontradas em: +- **`vtex/grunt-vtex`** — README e código referenciam o header `X-VTEX-Janus-Router-CurrentApp-EnvironmentType`. + - URL: https://github.com/vtex/grunt-vtex +- **`vtex/lens`** — Código lê header `X-VTEX-Janus-Router-Backend-App`. + - URL: https://github.com/vtex/lens +- **`vtex/node-vtex-api`** — A classe `JanusClient` implementa integração com o Janus (conecta a `portal.vtexcommercestable.com.br`). + - URL: https://github.com/vtex/node-vtex-api +- **`vtex/io-clients`** — Múltiplos clientes (OMS, Logistics, MasterData, Conditions, Affiliate) estendem `JanusClient`. + - URL: https://github.com/vtex/io-clients +- **`vtexdocs/dev-portal-content`** — Documentação sobre criação de clientes para APIs via Janus. + - URL: https://github.com/vtexdocs/dev-portal-content + +**Conclusão:** `janus-router` é um componente de infraestrutura **interna** (API gateway/router). Seu código-fonte não é público. + +--- + +### 11. lambda + +**Repositórios encontrados:** Nenhum repositório público específico da VTEX com este nome. + +A VTEX utiliza primariamente serviços containerizados via VTEX IO (Node.js/Koa) em vez de AWS Lambda. Referências a "lambda" em repositórios VTEX são incidentais (exemplos de CDK, changelog entries, etc.). + +**Conclusão:** Provável repositório **privado/interno** ou componente de infraestrutura interna. Sem correspondência pública encontrada. + +--- + +### 12. pfm + +**Repositórios encontrados:** Nenhum repositório público específico com este nome. + +As buscas retornaram apenas referências incidentais ao termo "pfm" em arquivos não relacionados (yarn-error.log, ícones, etc.). + +**Conclusão:** Provável repositório **privado/interno**. Possivelmente relacionado a "Payment/Financial Management". Sem correspondência pública encontrada. + +--- + +### 13. places + +**Repositórios encontrados com indícios fortes:** + +- **`vtex-apps/places-graphql`** — Serviço GraphQL de geolocalização de endereços. + - URL: https://github.com/vtex-apps/places-graphql + - Vendor: `vtex`, Name: `places-graphql` + - Descrição: "Service related to address geolocation" + - Linguagem: TypeScript + - Ativo (não arquivado) +- **`vtex-apps/place-components`** — Componentes reutilizáveis de localização/endereço. + - URL: https://github.com/vtex-apps/place-components + - Referencia `vtex.places` como dependência. +- **`vtex-apps/order-places`** — App relacionada a locais de pedido. + - URL: https://github.com/vtex-apps/order-places + - Arquivado. +- **`vtex-apps/checkout-shipping`** — Referencia `vtex.places` no manifesto. + - URL: https://github.com/vtex-apps/checkout-shipping + +**Conclusão:** A aplicação `places` tem forte correspondência com o ecossistema `vtex.places-graphql` / `vtex.place-components`. Esses repositórios são **públicos**. + +--- + +### 14. portal-sitemap + +**Repositórios encontrados com indícios fortes:** + +- **`vtex-apps/store-sitemap`** — App oficial de geração de sitemap para VTEX IO stores. + - URL: https://github.com/vtex-apps/store-sitemap + - Vendor: `vtex`, Name: `store-sitemap` + - Descrição: "Sitemap for vtex.store" + - Ativo, atualizado recentemente (2026-03-18) + - O manifesto referencia `portal.vtexcommercestable.com.br` em suas políticas de acesso. + +**Conclusão:** `portal-sitemap` provavelmente foi **renomeado/evoluído** para `store-sitemap`. O repositório `vtex-apps/store-sitemap` é a versão pública atual. O serviço original `portal-sitemap` pode ter sido um componente legado. + +--- + +### 15. prdfeed + +**Repositórios encontrados:** Nenhum repositório público específico com este nome. + +O nome sugere "product feed". Repositórios relacionados encontrados (sem correspondência direta): +- **`vtex-apps/orders-feed-example`** — Boilerplate para consumo de eventos OMS (feed de pedidos, não de produtos). +- **`vtex/FeedConsumerCSharp`** — Consumer boilerplate para VTEX Feed v3. + +**Conclusão:** Provável repositório **privado/interno** (possivelmente "Product Feed"). Sem correspondência pública encontrada. + +--- + +### 16. prtwrk + +**Repositórios encontrados:** Nenhum. + +O nome sugere uma abreviação interna. Nenhuma referência foi encontrada em repositórios públicos. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 17. pyggy + +**Repositórios encontrados:** Nenhum. + +Nenhuma referência foi encontrada em repositórios públicos da VTEX. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 18. rcvd-offers-api + +**Repositórios encontrados com indícios possíveis (candidatos):** + +O nome sugere "Received Offers API" — relacionado ao marketplace da VTEX. Repositórios possivelmente relacionados: +- **`vtex/openapi-schemas`** — O `config.json` referencia os codebases internos `vcs.offer-manager` e `sent-offers` para a documentação de "Marketplace APIs - Sent Offers". +- Documentação VTEX menciona funcionalidade de "Received SKUs" em marketplaces. + +**Conclusão:** Provável repositório **privado/interno**. O codebase interno `vcs.offer-manager` / `sent-offers` pode estar relacionado, mas `rcvd-offers-api` (lado do receptor) não tem repositório público. + +--- + +### 19. sc + +**Repositórios encontrados:** Nenhum repositório específico com este nome. + +A sigla "sc" é extremamente genérica (possivelmente "Sales Channel", "Smart Checkout", ou outra abreviação interna). Nenhum repositório público da VTEX foi identificado como correspondente. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 20. simdb + +**Repositórios encontrados:** Nenhum. + +Nenhuma referência foi encontrada em repositórios públicos da VTEX. + +**Conclusão:** Provável repositório **privado/interno** (possivelmente "Simulation Database" ou similar). Sem correspondência pública encontrada. + +--- + +### 21. skuapi + +**Repositórios encontrados com indícios possíveis (candidatos):** + +- **`vtex/openapi-schemas`** — O `config.json` referencia o codebase interno `catalog-api` e `catalog` como fontes das APIs de catálogo (que incluem operações de SKU). +- **`vtex-apps/sku-list`** — Componente de listagem de SKUs para B2B stores. + - URL: https://github.com/vtex-apps/sku-list +- **`vtex-apps/inactive-sku`** — App para gerenciamento de SKUs inativos. + - URL: https://github.com/vtex-apps/inactive-sku + +**Conclusão:** O `skuapi` é provavelmente um serviço **privado/interno**, possivelmente parte do sistema de catálogo (`catalog-api`). Os repositórios públicos de SKU são componentes de frontend, não a API em si. + +--- + +### 22. spmapi + +**Repositórios encontrados:** Nenhum. + +Nenhuma referência foi encontrada em repositórios públicos da VTEX. + +**Conclusão:** Provável repositório **privado/interno**. Sem correspondência pública encontrada. + +--- + +### 23. srapitmp + +**Repositórios encontrados:** Nenhum. + +O sufixo "tmp" sugere que pode ser uma aplicação/serviço temporário. Nenhuma referência foi encontrada. + +**Conclusão:** Provável repositório **privado/interno** (temporário). Sem correspondência pública encontrada. + +--- + +### 24. storedash + +**Repositórios encontrados com indícios fortes:** + +`storedash` é a plataforma interna de métricas/analytics da VTEX, baseada em Elasticsearch/Kibana. + +- **`vtex-apps/storedash-proxy`** — Proxy VTEX IO para a API do StoreDash. + - URL: https://github.com/vtex-apps/storedash-proxy + - Título: "IO Console API" + - Descrição: "VTEX developer console API" + - Manifesto declara acesso a `api.vtex.com/api/storedash/{{account}}/metrics/*` + - Arquivado. +- **`vtex/node-vtex-api`** — Código interno de métricas usa `getDefaultStoredashProperties()` para envio de métricas de runtime. + - URL: https://github.com/vtex/node-vtex-api +- **`vtex-apps/console`** — Console de desenvolvedores VTEX que consome dados do StoreDash via GraphQL. + - URL: https://github.com/vtex-apps/console +- **`vtex-apps/bubbles`** — Visualização de pedidos que consome `storedash-api.vtex.com/api/storedash/orderStream`. + - URL: https://github.com/vtex-apps/bubbles +- **`vtex/pickup-points-modal`** — README referencia dashboard Kibana em `search-storedash-data-3-...es.amazonaws.com`. + - URL: https://github.com/vtex/pickup-points-modal + +**Conclusão:** O core do `storedash` é um serviço **privado/interno** (API de métricas em `storedash-api.vtex.com`). O repositório público `vtex-apps/storedash-proxy` é um proxy VTEX IO para essa API. + +--- + +## Repositórios de Referência Cruzada + +Os seguintes repositórios da VTEX são fontes úteis que referenciam múltiplas aplicações internas: + +| Repositório | Descrição | URL | +|---|---|---| +| `vtex/openapi-schemas` | Schemas OpenAPI com mapeamento de codebases internos | https://github.com/vtex/openapi-schemas | +| `vtex/node-vtex-api` | Biblioteca de API do VTEX IO (contém JanusClient, métricas StoreDash) | https://github.com/vtex/node-vtex-api | +| `vtex/io-clients` | Clientes HTTP para APIs VTEX via Janus | https://github.com/vtex/io-clients | +| `vtexdocs/help-center-content` | Documentação do Help Center | https://github.com/vtexdocs/help-center-content | +| `vtexdocs/dev-portal-content` | Conteúdo do portal de desenvolvedores | https://github.com/vtexdocs/dev-portal-content | + +--- + +## Metodologia + +A pesquisa foi realizada nas seguintes organizações GitHub: +- `vtex` (265 repositórios públicos) +- `vtex-apps` (494 repositórios públicos) +- `vtexdocs` (21 repositórios públicos) +- `vtex-sites` (46 repositórios públicos) +- `vtex-trainings` (18 repositórios públicos) +- Outras organizações VTEX menores + +Métodos de busca utilizados: +1. Busca direta por nome exato de repositório em todas as organizações +2. Busca parcial/fuzzy por nome em listas completas de repositórios +3. Busca por código-fonte via GitHub Code Search (referências no código) +4. Busca em arquivos `manifest.json` de aplicações VTEX IO +5. Busca em `config.json` do repositório `openapi-schemas` (mapeamento de codebases) +6. Busca web por referências em documentação e fontes externas +7. Acesso direto via GitHub API para repositórios candidatos + +**Data da pesquisa:** 20 de Março de 2026