conversao-distancia

KO | EN

gitlite — search

#javascript #llm #golang #android #deep-learning #docker #windows #awesome #cli #awesome-list #pytorch #mcp #ios #open-source

conversao-distancia

(★ 21)

No description available.

conversao-distancia Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Conversor de Distância

Uma aplicação web moderna para conversão entre diferentes unidades de distância, desenvolvida em Python Flask com interface responsiva e interativa.

## 🚀 Funcionalidades

### 📐 Conversões Suportadas
- **Metro** ↔ Quilômetros, Milhas, Pés, Centímetros, Jardas
- **Centímetros** ↔ Polegadas
- Precisão de até 6 casas decimais

### 🎨 Interface Moderna
- **Design responsivo** com Bootstrap 5
- **Gradientes** e efeitos Glass
- **Ícones Font Awesome** em toda interface
- **Animações suaves** e transições
- **Tema moderno** com cores harmoniosas

### ⚡ Funcionalidades Avançadas
- **Conversão em tempo real** via AJAX
- **Botão swap** para trocar unidades
- **Histórico** das últimas 10 conversões
- **Validação** de entrada em tempo real
- **Loading states** com spinners
- **Tratamento de erros** elegante

## 🛠️ Tecnologias Utilizadas

### Backend
- **Python 3.12+**
- **Flask 2.0.1** - Framework web
- **Gunicorn 20.1.0** - Servidor WSGI

### Frontend
- **HTML5** com templates Jinja2
- **CSS3** com gradientes e animações
- **JavaScript ES6+** com AJAX
- **Bootstrap 5.1** para responsividade
- **Font Awesome 6.0** para ícones

### Arquitetura
- **Server-side processing** - Todos os cálculos no backend
- **RESTful API** com endpoint `/convert-api`
- **AJAX** para conversões em tempo real
- **LocalStorage** para persistência do histórico

## 📦 Instalação e Execução

### Pré-requisitos
```bash
# Python 3.12+
python3 --version

# Virtualenv (opcional, mas recomendado)
pip install virtualenv
```

### 1. Clonar o Repositório
```bash
git clone <url-do-repo>
cd conversao-distancia
```

### 2. Criar Ambiente Virtual (Recomendado)
```bash
virtualenv .venv
source .venv/bin/activate  # Linux/Mac
# ou
.venv\Scripts\activate     # Windows
```

### 3. Instalar Dependências
```bash
cd src
pip install -r requirements.txt
```

### 4. Executar Aplicação

#### Desenvolvimento
```bash
python3 main.py
```

#### Produção com Gunicorn
```bash
gunicorn -w 4 -b 0.0.0.0:8000 main:app
```

### 5. Acessar a Aplicação
- **Local**: http://127.0.0.1:5000
- **Produção**: http://localhost:8000

## 🧪 Testes

### Teste da API
```bash
python3 test_api.py
```

### Teste Manual
1. Abra a aplicação no navegador
2. Digite um valor (ex: 1000)
3. Selecione uma conversão (ex: Metro → Quilômetros)
4. Veja o resultado em tempo real
5. Clique "Converter" para salvar no histórico

## 📁 Estrutura do Projeto

```
conversao-distancia/
├── README.md              # Este arquivo
├── CLAUDE.md              # Instruções para Claude Code
├── test_api.py            # Testes da API
└── src/
    ├── main.py            # Aplicação Flask principal
    ├── requirements.txt   # Dependências Python
    ├── templates/
    │   └── index.html     # Template principal
    └── static/
        ├── css/
        │   └── style.css  # Estilos customizados
        └── js/
            └── converter.js # JavaScript interativo
```

## 🔧 API Endpoints

### `POST /convert-api`
Endpoint para conversões via AJAX.

**Request:**
```json
{
    "conversion_type": "1",
    "value": 1000
}
```

**Response:**
```json
{
    "success": true,
    "result": 1.0,
    "unit": "quilômetros",
    "original_value": 1000
}
```

**Tipos de Conversão:**
- `1`: Metro → Quilômetros
- `2`: Quilômetros → Metro
- `3`: Metro → Milhas
- `4`: Milhas → Metro
- `5`: Metro → Pés
- `6`: Pés → Metro
- `7`: Centímetros → Metro
- `8`: Metro → Centímetros
- `9`: Polegadas → Centímetros
- `10`: Centímetros → Polegadas
- `11`: Jardas → Metro
- `12`: Metro → Jardas

## 🎯 Recursos Especiais

### ⌨️ Atalhos de Teclado
- **Ctrl/Cmd + Enter**: Converter
- **Esc**: Limpar entrada

### 📱 Responsividade
- Interface otimizada para desktop, tablet e mobile
- Layout flexível com breakpoints Bootstrap

### 🔄 Histórico Inteligente
- Persiste entre sessões do navegador
- Limite de 10 conversões mais recentes
- Formato de data/hora brasileiro

### ⚡ Performance
- Debounce de 800ms para conversão em tempo real
- Caching inteligente de resultados
- Animações otimizadas com CSS3

## 🚀 Deploy

### Gunicorn (Recomendado)
```bash
gunicorn -w 4 -b 0.0.0.0:8000 --chdir src main:app
```

### Docker (Opcional)
```dockerfile
FROM python:3.12-slim
WORKDIR /app
COPY src/ .
RUN pip install -r requirements.txt
EXPOSE 8000
CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:8000", "main:app"]
```

conversao-distancia

conversao-distancia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

conversao-distancia

conversao-distancia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README