ricardo/Convert-it
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a5f2975bcb
Convert-it/CLAUDE.md
Ricardo Carneiro be3a93f90d
Some checks failed
Deploy ASP.NET MVC to OCI / build-and-deploy (push) Has been cancelled
Details
fix: ajustes de idioma e pipelina
2025-09-12 13:45:37 -03:00

3.4 KiB
Raw Blame History

Claude Context - Convert-It Online

Projeto Overview

Convert-It Online é uma aplicação web ASP.NET Core que oferece ferramentas gratuitas de conversão de arquivos com suporte a múltiplos idiomas.

URLs Amigáveis ao SEO - SISTEMA IMPLEMENTADO

Estrutura de URLs Traduzidas

IMPORTANTE: O projeto agora possui URLs totalmente traduzidas para melhor SEO.

URLs por Idioma:

Português (pt-BR):

  • Ferramentas de Texto: /pt-BR/ferramentas-de-texto/conversor-de-maiusculas-minusculas
  • Conversores de Imagem: /pt-BR/conversores-de-imagem/jpg-para-webp

Espanhol (es-MX, es-CL, es-PY):

  • Herramientas de Texto: /es-MX/herramientas-de-texto/conversor-de-mayusculas-minusculas
  • Convertidores de Imagen: /es-MX/convertidores-de-imagen/jpg-a-webp

Arquitetura do Sistema de URLs

  1. UrlTranslationService: Mapeia URLs traduzidas para controllers originais
  2. RouteConstraints personalizados:
    • LocalizedAreaRouteConstraint
    • LocalizedControllerRouteConstraint
  3. Resources (.resx): Contêm as traduções das URLs em UrlTextTools, UrlImageConverters, etc.

Estrutura de Localização

Idiomas Suportados

  • pt-BR (Português Brasil) - idioma padrão
  • es-MX (Espanhol México)
  • es-CL (Espanhol Chile)
  • es-PY (Espanhol Paraguai)

Arquivos de Resources

  • SharedResource.{culture}.resx - Resources compartilhados incluindo traduções de URL
  • Areas/*/Views/*/Index.{culture}.resx - Resources específicos de views
  • Views/Home/*.{culture}.resx - Resources das páginas principais

Areas e Controllers

TextTools

  • Controller: CaseConverterController
  • Funcionalidade: Conversão de texto (maiúsculas, minúsculas, primeira maiúscula)
  • URL PT: /pt-BR/ferramentas-de-texto/conversor-de-maiusculas-minusculas
  • URL ES: /es-MX/herramientas-de-texto/conversor-de-mayusculas-minusculas

ImageConverters

  • Controller: JpgToWebpController
  • Funcionalidade: Conversão de JPG para WebP
  • URL PT: /pt-BR/conversores-de-imagem/jpg-para-webp
  • URL ES: /es-MX/convertidores-de-imagen/jpg-a-webp

Desenvolvimento Guidelines

Adicionando Novos Conversores

  1. Controller: Criar em Areas/{AreaName}/Controllers/
  2. URL Translation: Adicionar mapeamento em UrlTranslationService
  3. Resources: Adicionar traduções em todos os arquivos .resx relevantes
  4. Testing: Verificar URLs traduzidas em todos os idiomas

Manutenção URLs SEO

  • ✅ SEMPRE verificar se novas funcionalidades seguem padrão de URL traduzida
  • ✅ Manter compatibilidade com URLs antigas (fallback implementado)
  • ✅ Validar traduções em todos os idiomas suportados
  • ✅ Usar nomes descritivos e friendly nas URLs traduzidas

Padrões de Nomenclatura

  • URLs sempre em minúsculas
  • Usar hífens (-) para separar palavras
  • Manter consistência entre idiomas
  • Refletir a funcionalidade real da ferramenta

Comandos Úteis

  • Build: dotnet build
  • Run: dotnet run
  • Test local: navegar para https://localhost:59345/pt-BR/ferramentas-de-texto/conversor-de-maiusculas-minusculas

Status Atual

✅ Sistema de URLs traduzidas implementado e funcionando ✅ Suporte completo para 4 idiomas ✅ RouteConstraints personalizados implementados ✅ Fallback para URLs antigas mantido 🔄 Aguardando testes finais

Mantenha este arquivo atualizado quando adicionar novos conversores ou idiomas.