Convert-it/CLAUDE.md

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
• Conversores de Documento: /pt-BR/conversores-de-documento/pdf-para-texto

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
• Convertidores de Documento: /es-MX/convertidores-de-documento/pdf-a-texto

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

DocumentConverters

• Controllers: PdfToTextController, PdfBarcodeLineController
• Funcionalidades: Extrair texto/Markdown de PDFs e detectar linha digitável de boletos
• URL PT: /pt-BR/conversores-de-documento/pdf-para-texto e /pt-BR/conversores-de-documento/linha-digitavel-do-pdf
• URL ES: /es-MX/convertidores-de-documento/pdf-a-texto e /es-MX/convertidores-de-documento/linea-digitada-desde-pdf

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.