# Instalación y primer arranque

## Paso a paso

### Instalar Anaquelia en la computadora de la tienda

1. Ejecuta `Anaquelia-Setup-<versión>.exe`. Windows pedirá permiso de administrador.
2. Si al descargar el instalador Chrome dice "Es posible que este archivo sea software malicioso", abre la lista de descargas y elige **Descargar archivo sospechoso** (si dice que la Navegación segura lo está revisando, espera unos segundos). Si al abrirlo aparece "Windows protegió su PC", pulsa **Más información → Ejecutar de todas formas**. Ambos avisos pasan mientras el instalador no esté firmado.
3. El asistente muestra el **contrato de licencia** de Anaquelia (EULA). Léelo y marca **Acepto el contrato** para seguir. Si no lo aceptas, el instalador se cierra y no instala nada; puedes volver a ejecutarlo cuando quieras.
4. Deja marcado **Crear un acceso directo en el Escritorio**. Marca **Permitir que el administrador vea la tienda desde otro equipo de la red local** solo si vas a monitorear desde un celular o laptop (ver [Monitoreo en Red](./monitoreo-en-red.md)).
5. Pulsa **Instalar** y al final deja marcado **Abrir Anaquelia ahora**.

### Configurar el sistema la primera vez

1. Se abre el asistente de primer arranque. Escribe el nombre, teléfono y dirección del negocio.
2. Escribe tu nombre y elige tu PIN de administrador (4 dígitos, nada fácil como `1234`).
3. Elige si quieres importar productos del catálogo precargado: ninguno, todos o por categorías. Entran con existencia 0. Si vienes de Eleventa u otro sistema, elige **Vengo de otro sistema**: no carga el catálogo de ejemplo y al terminar te lleva a **Configuración → Importar datos** (ver [Migrar desde otro sistema](./migrar-desde-otro-sistema.md)).
4. Opcional, pero muy recomendado: escribe la carpeta de una USB o de OneDrive/Google Drive para guardar ahí una copia de cada respaldo.
5. Opcional: en el paso **Licencia** puedes pulsar **Empezar prueba gratis** (30 días, necesita internet) o escribir el código de compra y pulsar **Activar** (ver [Activar la licencia del equipo](#activar-la-licencia-del-equipo)). Si no quieres hacer nada ahora, pasa de largo y actívala después.
6. Revisa que la fecha y hora de la computadora sean correctas y pulsa **Terminar y entrar**.

Después da de alta a tus cajeros en **⚙️ Configuración → Empleados y accesos** (ver [Empleados](./empleados.md)).

### Activar la licencia del equipo

Cada computadora con Anaquelia necesita su propia licencia para registrar **ventas, compras y encargos**. Mientras no tenga una válida, esas operaciones se bloquean; consultar el sistema y hacer respaldos sigue funcionando. La licencia se activa una sola vez por equipo.

**Probar gratis 30 días.** Si quieres conocer Anaquelia antes de comprar, puedes empezar una prueba gratis: tienes el sistema completo durante 30 días. Se necesita internet solo para empezar.

- En el asistente de primer arranque, en el paso **Licencia**, pulsa **Empezar prueba gratis**. Los datos del negocio que escribiste en el paso 1 se usan para la prueba.
- Si ya estás usando el sistema, entra como administrador, ve a **⚙️ Configuración → Respaldos** y pulsa **Empezar prueba gratis de 30 días** en la tarjeta **Licencia del equipo**.
- Cada computadora puede hacer **una sola prueba**. Si ya la usó, el sistema lo dice y te puedes comprar la licencia con el código de compra.
- Durante la prueba, en Inicio aparece cuántos días te quedan. Cuando quedan 7 o menos, el aviso se pone en amarillo.
- Al terminar los 30 días, el sistema deja de registrar **ventas y compras** (y encargos). Lo demás sigue igual: puedes ver tus datos, reportes y hacer respaldos.
- Para seguir sin perder nada, compra la licencia y escribe el **código de compra** en la misma tarjeta (o en el paso Licencia del asistente). Tus productos, clientes, ventas y empleados se conservan: no hace falta reinstalar ni volver a capturar.

La forma más fácil es con el **código de compra** que recibiste al comprar Anaquelia. Tiene la forma `ANQ-XXXX-XXXX-XXXX` y necesita internet solo esta vez.

1. Entra como administrador y ve a **⚙️ Configuración → Respaldos**.
2. En la tarjeta **Licencia del equipo**, escribe el **Código de compra** y pulsa **Activar con internet**. Anaquelia se conecta, recibe la licencia de este equipo y la guarda.
3. Si la tarjeta dice que la licencia está activa para tu negocio, ya puedes vender. Si aparece otro mensaje, léelo: por ejemplo, que ese código ya se usó en otra computadora. En ese caso escribe a quien te vendió Anaquelia.

**Sin internet:** en la misma tarjeta abre **¿Sin internet? Pega la clave que te enviamos**, pega la clave larga que te enviaron y pulsa **Activar licencia**. Antes envíales el **Código de este equipo** (cuatro grupos de cuatro letras o números, visible en la tarjeta) para que emitan la clave.

También puedes activarla en el paso **Licencia** del asistente de primer arranque. Ese paso es opcional.

Una clave copiada a otra computadora no sirve: solo funciona en el equipo para el que se emitió.

## 1. Requisitos

- Windows 10 u 11 de **64 bits**. Windows 7, 8 y los de 32 bits no son compatibles.
- 4 GB de RAM o más.
- Microsoft Edge (viene con Windows). Si no está, se usa el navegador predeterminado.
- No hace falta instalar nada más: Node.js viene incluido en el instalador.

## 2. Qué instala y dónde

| Qué | Dónde |
|---|---|
| El programa | `C:\Program Files\Anaquelia` |
| La base de datos y los respaldos | `C:\ProgramData\Anaquelia\data` (respaldos en `data\backups`) |
| Registros (logs) para soporte | `C:\ProgramData\Anaquelia\logs` |
| Ajustes del equipo | `C:\ProgramData\Anaquelia\anaquelia.env` |
| La licencia del equipo | `C:\ProgramData\Anaquelia\data\licencia.txt` |

- Anaquelia corre como un **servicio de Windows** llamado "Anaquelia": arranca solo al encender la computadora, aunque nadie haya iniciado sesión, y se reinicia solo si se cae.
- El acceso directo **Anaquelia** abre el sistema en una ventana propia (Edge sin barra de direcciones). Cerrar esa ventana **no** apaga el sistema. Si ya está abierta y vuelves a pulsar el ícono, se trae al frente la misma ventana en lugar de abrir otra. La ventana usa un perfil de Edge propio (`%LOCALAPPDATA%\Anaquelia\EdgeProfile`), separado del Edge que uses para otras cosas.
- En el Menú Inicio también hay **Carpeta de respaldos de Anaquelia** y **Desinstalar Anaquelia**.
- La carpeta del programa es de solo lectura para los usuarios normales: un cajero o empleado no puede cambiar sus archivos. Para modificarla hace falta una cuenta de administrador de Windows.

## 3. El asistente de primer arranque

Una instalación nueva arranca **vacía**: sin productos, ventas, clientes ni empleados, y sin datos de demostración. Mientras no exista ningún empleado, la pantalla de inicio de sesión muestra el asistente en lugar de la lista de empleados.

- Solo se puede completar **desde la misma computadora** donde está instalado. Si alguien lo abre desde otro equipo de la red, ve un aviso.
- Se completa **una sola vez**. En cuanto existe el administrador, el asistente ya no aparece.
- El administrador entra directo, sin que se le pida cambiar el PIN, porque lo eligió él mismo.
- Paso **Licencia** (el quinto de seis, después de Respaldo): puedes empezar la prueba gratis de 30 días, activar la licencia con el código de compra o dejarlo para después. Mientras no esté activa, no se registran ventas, compras ni encargos (ver [Activar la licencia del equipo](#activar-la-licencia-del-equipo)).
- Si la carpeta de copia externa no existe o no se puede escribir, el asistente lo dice y no guarda nada hasta corregirla. Después se puede cambiar en **⚙️ Configuración → Respaldos** (ver [Respaldos](./respaldos.md)).

## 4. Ajustes del equipo (`anaquelia.env`)

El archivo `C:\ProgramData\Anaquelia\anaquelia.env` admite líneas `CLAVE=valor`. Las líneas que empiezan con `#` se ignoran. Después de cambiarlo, reinicia el servicio "Anaquelia" (o la computadora).

| Clave | Para qué |
|---|---|
| `PORT` | Puerto del sistema (por defecto 3000). Cámbialo si otro programa ya usa el 3000. |
| `HOST` | `0.0.0.0` permite entrar desde otros equipos de la red. Lo pone el instalador si marcaste esa casilla. |
| `BACKUP_OFFSITE_DIR` | Carpeta de copia externa de respaldos. Tiene prioridad sobre la que se guarda en Configuración. |
| `ANTHROPIC_MODEL` | Modelo de IA para leer facturas en PDF o foto (ver [Compras](./compras.md)). |
| `ANAQUELIA_MODULOS_OCULTOS` | Módulos que no aparecen: `facturacion`, `compras_ia`, `comisionista`, separados por comas. Si la línea no está, en una instalación se ocultan los tres. Vacía (`ANAQUELIA_MODULOS_OCULTOS=`) los muestra todos. Ocultar no borra datos. Además, si el país de la tienda no es México, `facturacion`, `comisionista` y la importación de XML CFDI de Compras (`cfdi_compras`, solo se puede nombrar aquí) se ocultan solos. |

Si el puerto está ocupado, el sistema no arranca y lo explica en el registro de `C:\ProgramData\Anaquelia\logs`.

## 5. Actualizar a una versión nueva

1. Ejecuta el instalador de la versión nueva encima de la que ya tienes. No hace falta desinstalar. El asistente vuelve a mostrar el contrato de licencia: también hay que marcar **Acepto el contrato** para actualizar.
2. Si Anaquelia está abierto, el instalador avisa que lo va a cerrar. Si hay una venta a medio cobrar, pulsa **Cancelar**, termínala y vuelve a ejecutar el instalador.
3. El instalador detiene el servicio (el sistema hace un respaldo `cierre` al apagarse), reemplaza el programa y lo vuelve a iniciar.
4. La primera vez que arranca la versión nueva, antes de adaptar la base de datos, toma un respaldo `antes-de-actualizar`. Si algo saliera mal, se puede restaurar desde **⚙️ Configuración → Respaldos**.

Tus datos, empleados, ajustes y la licencia del equipo se conservan.

## 6. Desinstalar

**Desinstalar Anaquelia** pide cerrar la ventana de Anaquelia si está abierta (con opción de cancelar), detiene y quita el servicio, borra la regla del firewall y la carpeta del programa. **No borra** `C:\ProgramData\Anaquelia`: la base de datos, los respaldos, los registros, `anaquelia.env` y la licencia del equipo se quedan. Si vuelves a instalar, Anaquelia los usa de nuevo.

## 7. Preguntas frecuentes

**¿Cerrar la ventana apaga el sistema?**
No. El servidor sigue corriendo como servicio. Vuelve a abrir el acceso directo cuando quieras.

**El acceso directo dice que el sistema no responde.**
Espera unos segundos después de encender la computadora y vuelve a intentar. Si sigue igual, abre "Servicios" de Windows, busca "Anaquelia" y pulsa **Iniciar**, o revisa los registros en `C:\ProgramData\Anaquelia\logs`.

**¿Puedo usar una unidad de red (Z:) para la copia externa?**
No. El servicio de Windows no ve las unidades de red que conecta tu usuario. Usa una USB o una carpeta de OneDrive/Google Drive.

**¿Qué pasa si no acepto el contrato de licencia?**
El instalador se cierra y no instala nada. Para instalar Anaquelia hay que aceptar el contrato. Puedes volver a ejecutar el instalador cuando quieras.