# ComptaPro — Guía del cliente: instalación, puesta en marcha y copias de seguridad Desde el archivo de instalación recibido del editor hasta las copias de seguridad semanales, pasando por el primer arranque, el período de prueba de 30 días y la activación de la clave. > **Público**: usted, el cliente (propietario o contador que instala y gestiona > ComptaPro). > **Documentos complementarios** (solo en francés): > `installateur/Lisez-moi.txt` (memo entregado con la instalación) y > `installateur/deploiement/README-deploiement.md` (instalación silenciosa en > varios puestos, para su informático). > Los comandos de la §5 (copia, verificación, restauración) se han ejecutado y > verificado; los pasos de interfaz descritos en la §1 a la §4 corresponden al > instalador y a las pantallas del programa. > > **Idiomas**: el instalador está solo en francés — sus páginas, la opción > « Lancer ComptaPro maintenant » y el acceso « Pointage employés » conservan > sus etiquetas en francés. La interfaz del **programa** puede cambiarse a > inglés o español: selector « Langue » (parte inferior de la barra lateral), > o Configuración → Cuentas de usuario → Idioma. Los nombres de pantalla se > dan en el idioma en que usted lee, seguidos de la etiqueta francesa cuando > difiere. > > **Otras versiones**: [français](GUIDE-CLIENT.md) · [english](GUIDE-CLIENT.en.md) --- ## 1. Instalación ### 1.1 Qué se necesita antes de empezar | Necesidad | Detalle | |---|---| | Sistema | Windows 10 o posterior, arquitectura de 64 bits | | Permisos | No se requiere administrador: la instalación es **por usuario** | | Red | No se necesita conexión a Internet para usar el programa | | Archivo | `ComptaPro-Setup-.exe` recibido del editor (si se publica una huella SHA-256 junto al enlace, verifíquela antes de ejecutar) | ### 1.2 Ejecutar el instalador 1. Haga doble clic en `ComptaPro-Setup-.exe`. 2. Deje la carpeta de instalación propuesta: `%LOCALAPPDATA%\Programs\ComptaPro` — el programa y sus datos quedan juntos, con escritura libre y sin permisos de administrador. 3. Las casillas propuestas: | Opción | Por defecto | Efecto | |---|---|---| | Crear un acceso directo en el escritorio | marcada | acceso « ComptaPro » para lanzar el programa | | Iniciar ComptaPro automáticamente con Windows | desmarcada | el servidor arranca al iniciar sesión, en una ventana en segundo plano | | Crear la tarea de respaldo que importa los extractos depositados mientras el programa está cerrado (cada 15 minutos) | desmarcada (opcional) | márquela si deposita extractos bancarios con ComptaPro cerrado: la tarea lo relanza en segundo plano para importarlos | 4. Al final, deje marcada « Lancer ComptaPro maintenant » («Lanzar ComptaPro ahora»). ### 1.3 Dónde viven sus datos Todo es local, en la carpeta de instalación: | Carpeta | Contenido | |---|---| | `compta\data\` | base de datos, fotos de facturas, sesiones | | `compta\sauvegardes\` | archivos de copia de seguridad (ver §5) | | `compta\planifier\` | scripts de tareas planificadas (copia, rescate de extractos) | No se envía ningún dato a Internet (véase también §4: la activación se verifica localmente). ### 1.4 Actualizar Basta con ejecutar el nuevo `ComptaPro-Setup-.exe`: el servidor se detiene automáticamente, los archivos se reemplazan y sus datos se conservan. Las tareas planificadas existentes (copia, rescate de extractos) se conservan — la carpeta de instalación no cambia, así que sus rutas siguen siendo válidas. El script de la tarea de respaldo solo se regenera si la opción « secours » se vuelve a marcar (o se pasa con `/TASKS=secours`) al momento de la actualización. ### 1.5 Desinstalar Panel de control → Programas y características → ComptaPro → Desinstalar. Windows le preguntará si desea eliminar también sus datos contables (irreversible) o conservarlos. Por defecto, se conservan los datos y los archivos de copia. --- ## 2. Primer arranque ### 2.1 La ventana negra es el programa - Haga doble clic en el acceso « ComptaPro » (escritorio o menú Inicio). - **Deje abierta la ventana negra**: es el servidor del programa. **NO CIERRE ESTA VENTANA**, de lo contrario el programa se detiene — la causa más frecuente de « ComptaPro no responde ». Si se cierra por accidente, vuelva a lanzar el acceso: eso es todo. - La ventana muestra tres direcciones: - `http://localhost:8090/` — el programa en **este** puesto (el navegador se abre automáticamente); - `http://localhost:8090/punch` — la página de fichaje; - la dirección de la **red local**: es ella, y no localhost, la que usan los teléfonos de los empleados para fichar. ### 2.2 Primer inicio de sesión | Campo | Valor inicial | |---|---| | Usuario | `admin` | | Contraseña | `admin1234` | → **Cambie la contraseña inmediatamente**: Configuración (« Paramètres ») → Cuentas de usuario (« Comptes administrateurs »). ### 2.3 Datos de demostración En la muy primera apertura, el programa carga un juego de datos de demostración (facturas, gastos, empleados, fichajes) para que cada pantalla sea significativa. A partir de entonces trabaja con sus propios datos; si duda del origen de un documento, compruebe su fecha. ### 2.4 Fichaje de los empleados - Página dedicada: `http://:8090/punch` (se abre con el acceso « Pointage employés » del menú Inicio — etiqueta en francés). - Los teléfonos fichan mediante la dirección de red que muestra la ventana negra — nunca mediante `localhost`, que designa cada teléfono en sí. --- ## 3. Período de prueba de 30 días - **La cuenta atrás comienza en la primera apertura** del programa: sin trámites, sin tarjeta de crédito, **todas las funciones** durante 30 días completos, con sus datos reales. - La duración se cuenta desde la primera apertura: retroceder el reloj de la máquina no prolonga la prueba. - Recordatorios: aparece una banda durante los **10 últimos días** de prueba (se pone en rojo por debajo de **3 días**) y lleva directamente a la pantalla Licencia. - Pasados los 30 días, sin clave, el programa queda bloqueado: solo siguen accesibles el inicio de sesión, la pantalla Licencia y el fichaje. Sus datos permanecen en la máquina. - **No existe un comando « prolongar la prueba »**: para más tiempo, pida una clave al editor mediante el formulario del sitio (una clave de duración limitada hace de prueba prolongada — ver §4). --- ## 4. Activación y renovación 1. Menú → **Licencia y activación** (« Licence et activation »). 2. Introduzca la clave facilitada por el editor — comienza por **`CMPR2.`** — y confirme. 3. La pantalla muestra el estado de su licencia: tipo y, para una clave de duración limitada, su **fecha de vencimiento**. Datos a recordar: - **La verificación es 100% local**: la clave es una firma digital (Ed25519) comprobada en su máquina; no se envía nada por Internet, ni clave ni datos (afirmación en la página de venta y en la pantalla Licencia). - **Dos tipos de claves**: | Tipo | Validez | |---|---| | Perpetua | sin límite de tiempo | | De duración limitada | 1 año; pasada la fecha mostrada en la pantalla Licencia, el programa queda bloqueado | - **Renovación**: el editor le entrega una clave de renovación para introducir en el mismo sitio (pantalla Licencia). - **La clave es un título al portador**: quien la posea puede activarla. Consérvela fuera del equipo (copia en papel o correo) — le servirá en caso de reinstalación; no la comparta. --- ## 5. Copias de seguridad y restauración ### 5.1 Qué contiene un archivo Cada copia agrupa **la base de datos, las fotos de las facturas y las sesiones**, en un archivo con fecha: ``` sauvegarde-AAAA-MM-JJ_HH-MM-SS.zip.chiffre (cifrado — por defecto) sauvegarde-AAAA-MM-JJ_HH-MM-SS.zip (sin cifrar, con --sans-chiffrement) ``` - Carpeta por defecto: `compta\sauvegardes\`. - **La contraseña es imprescindible**: sin ella, un archivo cifrado queda indefinidamente inutilizable. Se pasa a la planificación con `--mot-de-passe` y se guarda en `compta\planifier\mot-de-passe-sauvegarde.txt` — **guárdela también en otro sitio** que este puesto. - Los archivos solo protegen si salen de la máquina: copie `compta\sauvegardes\` periódicamente a un disco externo o a un recurso de red. Abra una ventana de comandos **en la carpeta de instalación** (`%LOCALAPPDATA%\Programs\ComptaPro`). Si `node` no está en su PATH, use el Node incluido con el programa (`.runtime\node\node.exe`), como abajo. ### 5.2 Copia manual ``` .runtime\node\node.exe compta\scripts\sauvegarde.js ``` - Puede ejecutarse **mientras el programa está en marcha** (instantánea `VACUUM INTO`, sin detener nada). - Conserva los **5 últimos** archivos por defecto: `--conserver N` para cambiarlo, `--tout-conserver` para no borrar nada. - La contraseña se toma (en este orden) de `--mot-de-passe`, de la variable de entorno `SAUVEGARDE_MOT_DE_PASSE` y después del archivo `compta\planifier\mot-de-passe-sauvegarde.txt`. ### 5.3 Copia semanal planificada ``` .runtime\node\node.exe compta\scripts\planifier-sauvegarde.js -aide ``` E instálela (valores por defecto: **cada lunes a las 02:00**, 5 archivos conservados): ``` .runtime\node\node.exe compta\scripts\planifier-sauvegarde.js --mot-de-passe ``` - La tarea aparece en el Programador de tareas de Windows como « ComptaPro - Sauvegarde hebdomadaire »; el script generado está en `compta\planifier\`, el registro en `compta\sauvegardes\`. - Como toda tarea del usuario, solo se ejecuta si el ordenador está encendido y el usuario ha iniciado sesión a la hora prevista. - `--jour` / `--heure` / `--conserver` ajustan la planificación; `--afficher` muestra el estado; `--desinstaller` la retira. ### 5.4 Verificar la integridad de los archivos ``` .runtime\node\node.exe compta\scripts\sauvegarde.js -verifier ``` Comprobación CRC32 de cada entrada, SHA-256 de la base, integridad SQLite, conteos, fotos y sesiones — **sin crear ni borrar nada**. Código de salida 1 si un archivo está alterado. Detalle de un solo archivo: ``` .runtime\node\node.exe compta\scripts\restauration.js --verifier-seulement ``` ### 5.5 Restaurar 1. **Detenga ComptaPro** (cierre la ventana negra): la restauración rechaza ejecutarse si el servidor está escuchando. 2. Compruebe el archivo si hace falta (arriba) y aplíquelo: ``` .runtime\node\node.exe compta\scripts\restauration.js "" --mot-de-passe ``` 3. **Reinicie ComptaPro**: sus datos han vuelto al estado del archivo, idéntico (la restauración reemplaza la carpeta de datos, no « fusiona » nada). Ante la duda sobre un archivo, `--verifier-seulement` no modifica nada: es el modo de comprobación antes de comprometerse.