initial commit 2

backend/README.md

@@ -0,0 +1,128 @@
+# 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.