SavePlace
Uma URL social. Um lugar verificável.
Pipeline para transformar URLs sociais públicas em lugares verificados por provedores.
Problema
Recomendações sociais não trazem necessariamente um lugar geograficamente verificado.
Minha contribuição
Desenvolvimento e manutenção do projeto pessoal.
THE PIPELINE / SYSTEM MAP
SavePlace
Da evidência social ao lugar verificado, com salvamento explícito.
Etapa 1 / 6
URL pública
A entrada suportada é uma URL pública TikTok; o adaptador obtém metadados oficiais via oEmbed.
Etapa 2 / 6
Cache & idempotência
Reaproveitar análise da fonte e replay; PostgreSQL separa cache reutilizável do histórico privado por sessão.
Etapa 3 / 6
Extração com IA
Metadados sustentam candidatos estruturados. Prompt, tokens, custo estimado e latência são registrados.
Etapa 4 / 6
PlaceProvider
Google Places confirma identidade geográfica. Apenas o provedor pode marcar um lugar como verificado.
Etapa 5 / 6
Revisão & evidência
Ambiguidade ou falta de evidência vira um estado de revisão, sem inventar endereço ou coordenadas.
Etapa 6 / 6
Biblioteca privada
O clique explícito salva um lugar verificado na biblioteca da sessão; dados podem ser gerenciados depois.
A IA propõe candidatos. O provedor verifica o lugar. A pessoa decide salvar.
Conexões e condições
- URL pública → Cache & idempotênciaConsulta análise existente
- Cache & idempotência → Extração com IACache miss
- Extração com IA → PlaceProviderEnvia candidatos
- PlaceProvider → Revisão & evidênciaResultado ou ambiguidade
- Revisão & evidência → Biblioteca privadaConfirmação explícita
- Cache & idempotência → Revisão & evidênciaCache hit ou replay
Percurso ilustrativo dos componentes documentados, sem execução dos projetos. Fontes consultadas em 2026-10-28.
Explore os componentes ou reproduza o percurso.
Decisão de engenharia
Cache e idempotência evitam repetir processamento e consultas externas.
Trade-off
Dependência de provedores exige observar falhas, custo e latência.
Evidência
O README documenta o M2 validado no Railway: análise, cache, idempotência, confirmação e biblioteca privada. Não são apresentados números de custo sem baseline publicado.
Documentação do projeto ↗