vtex · danilomoura-san · Mar 20, 2026
diff --git a/mapeamento-repositorios-aplicacoes.md 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