SAMO - Sistema de Atención Médica Ocupacional
Edición para cliente - Guía de instalación
===========================================================

QUÉ INCLUYE ESTE PAQUETE
  SAMO_instalador.exe        Instalador en un solo archivo (se descomprime y abre el instalador)
  Instalar_SAMO.cmd / .ps1   El mismo instalador, si recibió el .zip (doble clic en Instalar_SAMO.cmd)
  Guia_de_inicio_SAMO.pdf    Guía de inicio paso a paso (también en SAMO: Herramientas > Ayuda)
  App\SAMO.exe               Programa para Windows y Office de 64 bits
  App\SAMO_32bits.exe        Programa para Office de 32 bits
  Base\samo_datos_vacia.accdb  Base de datos vacía: sin pacientes, sin nómina, sin consultas.
                               Trae solo catálogos genéricos: CIE-10 (14.231 códigos), patologías,
                               tipos de atención, tipos de reposo, motivos de salida y la estructura
                               de la ficha ocupacional (formulario MSP) y de la ficha de brigadistas.
  Plantillas\                Plantilla de la ficha ocupacional (FEMO), de brigadistas / trabajos
                               especiales y de la nómina para importar desde Excel.

REQUISITOS
  - Windows 10 u 11 con .NET Framework 4.8 (ya viene con Windows).
  - Motor de base de datos de Access (ACE). Si tiene Microsoft Office con Access ya está.
    Si no: instale "Microsoft Access Database Engine 2016 Redistributable" (gratuito, de
    Microsoft) con los MISMOS bits que su Office. El instalador le avisa si falta.
  - Opcional: Microsoft Excel (para las fichas FEMO y de brigadista) y Outlook (para enviar correos).

INSTALACIÓN EN UNA SOLA COMPUTADORA
  1. Copie esta carpeta a la computadora y haga doble clic en Instalar_SAMO.cmd.
  2. Escriba la carpeta del sistema (Enter = C:\SAMO). Ahí quedan el programa, los datos,
     los documentos PDF, los logos y las plantillas.
  3. El instalador revisa Windows, .NET 4.8 y el motor de Access; si falta el motor le muestra el
     enlace oficial de Microsoft y qué archivo descargar. Al terminar abre SAMO. La primera vez:
       - SAMO genera una CLAVE PROPIA para la base de datos (20 caracteres al azar) y la guarda
         cifrada en esa computadora. Nadie más la conoce, ni siquiera el proveedor.
       - Se abre el ASISTENTE DE PRIMER ARRANQUE: nombre y RUC de la empresa, logo, ciudad
         de emisión de los documentos, feriado local, médico administrador con su PIN,
         y correos de Talento Humano, garita y servicio médico.
  4. ACTIVACIÓN: SAMO muestra el CÓDIGO DE EQUIPO (16 caracteres). Envíelo a su proveedor por
     WhatsApp o correo (botón Copiar). Pegue el CÓDIGO DE ACTIVACIÓN que le respondan y pulse
     Activar. No se necesita internet. Mientras tanto SAMO funciona 15 días en modo demostración;
     pasado ese plazo solo permite activar. La licencia indica cuántas computadoras pueden usar
     SAMO; se ve y se administra en Herramientas > Licencia y activación.
  5. Ingrese con las iniciales del administrador y su PIN.
  6. Herramientas > Importar nómina desde Excel (use Plantillas\Plantilla_Nomina.xlsx como
     modelo) y Administración para agregar al resto del personal.

INSTALACIÓN EN VARIAS COMPUTADORAS (carpeta compartida)
  1. En la primera computadora instale con la carpeta compartida, por ejemplo
     \\SERVIDOR\SAMO o Z:\SAMO, y complete el asistente.
  2. Esa primera computadora: Herramientas > "Clave de la base para otra computadora"
     (solo el administrador, con su PIN). Anote la clave en un lugar seguro.
  3. En cada computadora adicional ejecute Instalar_SAMO.cmd con la MISMA carpeta compartida.
     El instalador NO toca la base existente. Al abrir SAMO le pedirá la clave una sola vez y
     la guardará cifrada en ese equipo.
  No envíe la clave por correo ni la guarde dentro de la carpeta compartida.

MÓDULOS OPCIONALES
  - Tripulación y barcos (embarques, desembarques y certificados de embarque): apagado por
    defecto. Se activa en el asistente o en Herramientas > Módulos opcionales.

COPIAS DE SEGURIDAD
  - SAMO hace una copia diaria automática en Datos\Respaldos (30 días). Las copias quedan con
    la misma clave de la base.
  - Recomendado: copiar además la carpeta Datos a un disco externo o a la nube una vez por semana.
  - Si se pierde la computadora y nadie anotó la clave, la base NO se puede abrir.
    Guarde la clave (paso 2 de varias computadoras) aunque use una sola computadora.

SOLUCIÓN DE PROBLEMAS
  - "No se encuentra el motor": instale el Access Database Engine (ver Requisitos) y vuelva a
    ejecutar el instalador; si tiene Office de 32 bits, el acceso directo apuntará a SAMO_32bits.exe.
  - "Esta computadora todavía no tiene la clave": pídasela al administrador (paso 2).
  - Olvidó el PIN: en la pantalla de ingreso, "¿Olvidó su PIN?" (llega un código al correo de
    recuperación) o el administrador lo restablece en Administración.

ACTUALIZACIONES
  - SAMO busca versiones nuevas una vez al día al abrir (necesita internet) y en Herramientas > "Ayuda: buscar actualizaciones".
  - Siempre pregunta antes. Si acepta, descarga la versión, verifica que venga firmada por su proveedor y que el archivo no
    haya sido cambiado (huella SHA-256), y la instala AL CERRAR SAMO. Si algo no coincide, no instala nada.
  - Solo se reemplaza el programa (carpeta App). Sus datos, la configuración, los logos, los documentos y la licencia no se tocan.
    El programa anterior queda guardado en App\Anterior_antes_de_<versión>.
  - Si usa SAMO en varias computadoras con la carpeta compartida, ciérrelo en todas para que se complete.
  - Las actualizaciones se reciben mientras el soporte esté vigente (fecha que muestra Herramientas > Licencia y activación).
    Sin soporte, SAMO avisa que hay una versión nueva para que lo renueve.

SOPORTE A DISTANCIA (sin instalar programas)
  - Videollamada (WhatsApp, Meet o Teams) para conversar y ver la pantalla compartida.
  - Asistencia rápida de Windows (Quick Assist), que ya viene con Windows 10 y 11:
      1. El proveedor abre Asistencia rápida > "Ayudar a alguien" y le dicta un código de 6 dígitos.
      2. Usted abre Inicio > escriba "Asistencia rápida" > en "Obtener ayuda" escriba el código.
      3. Usted elige si el proveedor solo VE la pantalla o también puede CONTROLARLA, y pulsa Permitir.
      4. Puede terminar la sesión en cualquier momento con el botón Detener / cerrar la ventana.
  - El proveedor no puede conectarse sin que usted le dé un código nuevo y acepte en cada sesión.
  - No dicte su PIN ni la clave de la base durante el soporte: escríbalos usted mismo si se necesitan.
  - Para enviar un archivo de registro o una captura, use correo o WhatsApp; no envíe la base de datos
    (tiene datos de salud de sus trabajadores).

LICENCIA
  SAMO se entrega con licencia de uso para una sola empresa, sin código fuente.
  El código de activación vale para su empresa y su instalación (base de datos). Si cambia el
  nombre de la empresa en el asistente o crea una base nueva, pida un código nuevo.
  Ver el contrato de licencia firmado entre las partes.
