# SimpleNote - Variables de Entorno

## Template: `.env.example`

Copia este archivo a `.env` en la raíz de `simplenote-web/`.

```env
# ============ SERVER ============
PORT=3000
HOST=0.0.0.0

# ============ DATA ============
# Raíz donde se almacenan documentos y archivos de índice
# Default: ./data (relativo al proyecto)
DATA_ROOT=./data

# ============ AUTH ============
# Token admin inicial (generado en setup). No exponer en cliente.
ADMIN_TOKEN=snk_initial_admin_token_change_me

# ============ LOGGING ============
LOG_LEVEL=info
# Opciones: trace, debug, info, warn, error, fatal

# ============ CORS ============
# Orígenes permitidos para requests cross-origin
# Default: * (permitir todos)
CORS_ORIGIN=*

# Para desarrollo local:
# CORS_ORIGIN=http://localhost:5173

# Para producción:
# CORS_ORIGIN=https://simplenote.example.com

# ============ API ============
# Versión del API en URLs
API_PREFIX=/api/v1

# ============ RATE LIMITING (opcional) ============
# Requests por minuto por IP
# RATE_LIMIT_ENABLED=true
# RATE_LIMIT_WINDOW_MS=60000
# RATE_LIMIT_MAX=100
```

## Detalle de Variables

### `PORT`
- **Tipo**: integer
- **Default**: `3000`
- **Descripción**: Puerto TCP donde Express escucha conexiones entrantes.

### `HOST`
- **Tipo**: string
- **Default**: `0.0.0.0`
- **Descripción**: Host de binding. `0.0.0.0` = todas las interfaces.

### `DATA_ROOT`
- **Tipo**: string (ruta)
- **Default**: `./data`
- **Descripción**: Directorio raíz donde se guardan:
  - `libraries/` — estructura de carpetas con documentos
  - `.tag-index.json` — índice global de tags
  - `.auth-tokens.json` — tokens de API

### `LOG_LEVEL`
- **Tipo**: enum
- **Default**: `info`
- **Opciones**: `trace`, `debug`, `info`, `warn`, `error`, `fatal`
- **Descripción**: Nivel mínimo de logs que se emiten.

### `CORS_ORIGIN`
- **Tipo**: string
- **Default**: `*`
- **Descripción**: Valor del header `Access-Control-Allow-Origin`. Usar dominio
  específico en producción para seguridad.

### `API_PREFIX`
- **Tipo**: string
- **Default**: `/api/v1`
- **Descripción**: Prefijo para todas las rutas del API. Cambiar permite versionado.

---

## CLI Config: `~/.config/simplenote/config.json`

```json
{
  "apiUrl": "http://localhost:3000/api/v1",
  "token": "snk_your_token_here",
  "activeLibrary": "550e8400-e29b-41d4-a716-446655440000"
}
```

| Campo | Descripción |
|-------|-------------|
| `apiUrl` | URL base del API (sin trailing slash) |
| `token` | Token Bearer para autenticación |
| `activeLibrary` | ID de librería activa por defecto |

---

## Flags de Línea de Comandos (CLI)

```bash
# Override apiUrl
simplenote --api-url http://custom:3000/api/v1 doc list

# Modo verbose
simplenote --verbose doc list

# Help
simplenote help
simplenote doc help create
```