98 lines
3.9 KiB
Markdown
98 lines
3.9 KiB
Markdown
# 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.*
|