129 lines
3.2 KiB
Markdown
129 lines
3.2 KiB
Markdown
# Backend Python para Flutter
|
|
|
|
Backend en Python con FastAPI para autenticar usuarios y guardar direcciones en PostgreSQL. No usa HTTPS; expone HTTP en el puerto 8000 por defecto.
|
|
|
|
## Qué debes cambiar
|
|
|
|
### 1. Configuración del backend
|
|
Crea el archivo `backend/.env` copiando `backend/.env.example` y reemplaza estos valores:
|
|
|
|
```env
|
|
DATABASE_URL=postgresql+psycopg://postgres:TU_PASSWORD@10.77.234.29:5432/hackaton
|
|
SECRET_KEY=pon-una-clave-larga-y-segura-aqui
|
|
ACCESS_TOKEN_EXPIRE_MINUTES=10080
|
|
CORS_ORIGINS=http://localhost:3000,http://10.0.2.2:3000,http://10.77.234.6:8000
|
|
```
|
|
|
|
### 2. Configuración de Flutter
|
|
En Flutter, la URL base del backend está en [lib/app_config.dart](../lib/app_config.dart). Debe apuntar al backend HTTP, por ejemplo:
|
|
|
|
```dart
|
|
static const String apiBaseUrl = String.fromEnvironment(
|
|
'API_BASE_URL',
|
|
defaultValue: 'http://10.77.234.6:8000',
|
|
);
|
|
```
|
|
|
|
No pongas la cadena `postgresql://...` en Flutter. Esa cadena solo va en el backend.
|
|
|
|
## Variables que usa el backend
|
|
|
|
- `DATABASE_URL`: conexión a PostgreSQL.
|
|
- `SECRET_KEY`: clave para firmar el token JWT.
|
|
- `ACCESS_TOKEN_EXPIRE_MINUTES`: tiempo de vida del token.
|
|
- `CORS_ORIGINS`: orígenes permitidos para la app Flutter o pruebas web.
|
|
|
|
## Estructura de PostgreSQL
|
|
|
|
El backend crea las tablas automáticamente al arrancar con `Base.metadata.create_all(...)`, pero si quieres crearlas manualmente, este es el esquema esperado.
|
|
|
|
### Tabla `users`
|
|
|
|
```sql
|
|
CREATE TABLE IF NOT EXISTS users (
|
|
id SERIAL PRIMARY KEY,
|
|
name VARCHAR(120) NOT NULL,
|
|
email VARCHAR(255) NOT NULL UNIQUE,
|
|
password_hash VARCHAR(255) NOT NULL,
|
|
last_login_at TIMESTAMPTZ NULL,
|
|
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
|
);
|
|
```
|
|
|
|
### Tabla `addresses`
|
|
|
|
```sql
|
|
CREATE TABLE IF NOT EXISTS addresses (
|
|
id SERIAL PRIMARY KEY,
|
|
user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
|
house_number VARCHAR(50) NOT NULL,
|
|
colonia VARCHAR(120) NOT NULL,
|
|
street VARCHAR(160) NOT NULL,
|
|
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
|
);
|
|
```
|
|
|
|
## Datos que se envían desde Flutter
|
|
|
|
### Registro
|
|
Se envía al endpoint `POST /auth/register`:
|
|
|
|
```json
|
|
{
|
|
"name": "Juan Perez",
|
|
"email": "juan@mail.com",
|
|
"password": "123456"
|
|
}
|
|
```
|
|
|
|
### Inicio de sesión
|
|
Se envía al endpoint `POST /auth/login`:
|
|
|
|
```json
|
|
{
|
|
"email": "juan@mail.com",
|
|
"password": "123456"
|
|
}
|
|
```
|
|
|
|
### Dirección
|
|
Se envía al endpoint `POST /addresses` con token Bearer:
|
|
|
|
```json
|
|
{
|
|
"email": "juan@mail.com",
|
|
"houseNumber": "12A",
|
|
"colonia": "Centro",
|
|
"street": "Reforma"
|
|
}
|
|
```
|
|
|
|
## Endpoints disponibles
|
|
|
|
- `POST /auth/register`
|
|
- `POST /auth/login`
|
|
- `GET /me`
|
|
- `POST /addresses`
|
|
- `GET /health`
|
|
|
|
## Instalar y ejecutar
|
|
|
|
```bash
|
|
cd backend
|
|
python -m venv .venv
|
|
.venv\Scripts\activate
|
|
pip install -r requirements.txt
|
|
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
|
|
```
|
|
|
|
## Cómo funciona la conexión
|
|
|
|
1. Flutter llama a `http://IP_DEL_BACKEND:8000`.
|
|
2. El backend recibe login/registro y crea el token JWT.
|
|
3. El backend conecta a PostgreSQL usando `DATABASE_URL`.
|
|
4. Al guardar la dirección, el backend asocia la dirección al usuario autenticado.
|
|
|
|
## Nota importante
|
|
|
|
Si pruebas desde un celular físico, `10.0.2.2` no sirve para la API. Debes usar la IP real de la computadora donde corre el backend.
|