# Quickstart: Chatbot PDF Extractor

## Prerequisites

- PHP 8.2+, Composer
- Node.js 18+ (Angular)
- uv (opcional, para `specify` CLI): [instalar uv](https://docs.astral.sh/uv/)

## Backend

```powershell
cd D:\Projectos\Codigo\SomosTuWebMaster\ia_agent
composer install
cp .env.example .env   # si aplica
php artisan key:generate
php artisan migrate
php artisan serve
```

Variables mínimas en `.env`:

- `LLM_PROVIDER=openai|gemini`
- `OPENAI_API_KEY` / `GEMINI_API_KEY`
- `JWT_SECRET`
- `DB_SEC_*` y `DB_SEC_JSON_COLUMN=payload` (si usas BD secundaria)
- `CORS_ALLOWED_ORIGINS=http://localhost:4200`

Validar BD secundaria:

```powershell
php artisan db:validate-secondary
```

## Frontend

```powershell
cd ChatFront
npm install
npm start
```

Abrir `http://localhost:4200` — login → dashboard → agentes.

## Spec Kit (SDD)

Skills instalados en `.cursor/skills/speckit-*`. En Cursor Agent:

1. `/speckit-constitution` — principios (`.specify/memory/constitution.md`)
2. `/speckit-specify <feature>` — nueva spec en `specs/00N-*/`
3. `/speckit-plan` — plan técnico
4. `/speckit-tasks` — tasks.md
5. `/speckit-implement` — implementación

CLI (Windows, UTF-8 si falla banner):

```powershell
$env:PYTHONUTF8="1"
specify version
specify integration list
```

## Tests

```powershell
php artisan test
cd ChatFront; npm test
```