# 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.*