act-generator

Proyecto full-stack con React + Vite (frontend) y FastAPI (backend).

Estructura

act-generator/
├── docker-compose.yml   # Levanta frontend + backend juntos
├── frontend/            # React + Vite
│   └── Dockerfile
└── backend/             # FastAPI
    ├── app/
    │   └── main.py      # Punto de entrada de la API
    ├── requirements.txt
    └── Dockerfile

Requisitos

• Node.js 18+ y pnpm (corepack enable)
• Python 3.11+
• (Opcional) Docker + Docker Compose para levantar todo junto

Docker Compose (todo junto)

Con Docker en marcha, desde la raíz del proyecto:

docker compose up --build

• Frontend: http://localhost:5173
• Backend / Swagger: http://localhost:8000/docs

Ambos servicios montan el código fuente como volumen, por lo que la recarga automática funciona al editar archivos en el host. El proxy de Vite apunta al servicio backend mediante la variable VITE_PROXY_TARGET.

Para detener: Ctrl+C y luego docker compose down.

---

El resto de esta guía describe cómo arrancar cada servicio sin Docker.

Backend (FastAPI)

cd backend
python3 -m venv .venv
source .venv/bin/activate          # En Windows: .venv\Scripts\activate
pip install -r requirements.txt
fastapi dev app/main.py            # Arranca en http://localhost:8000

• Documentación interactiva (Swagger): http://localhost:8000/docs
• Endpoints de ejemplo: GET /api/health, GET /api/hello?name=...

Frontend (React + Vite)

cd frontend
pnpm install
pnpm dev                           # Arranca en http://localhost:5173

Las peticiones a /api se redirigen automáticamente al backend (http://localhost:8000) mediante el proxy configurado en vite.config.js, por lo que no hay problemas de CORS en desarrollo.

Desarrollo

Arranca ambos servidores en terminales separadas (backend en el puerto 8000, frontend en el 5173) y abre http://localhost:5173. La página de inicio muestra el estado del backend consultando /api/health.