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)
  Video - como instalar APTO.url   Abre el video de instalación (2 minutos) en la página de APTO
  App\SAMO.exe               Programa para Windows y Office de 64 bits
  App\SAMO_32bits.exe        Programa para Office de 32 bits
  semilla\                   Catálogos iniciales para la base nueva: 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.
                               Sin pacientes, sin nómina, sin consultas.
  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).
  - Desde la versión 280 los datos se guardan en SQL Server (ya no en un archivo de Access) y por
    eso NO hace falta el motor de Access. En la computadora principal el instalador instala
    SQL Server Express, gratuito y oficial de Microsoft. Si el paquete trae la carpeta SQL (con
    SQLEXPR_x64_ENU.exe) no descarga nada; si no, lo descarga la primera vez (unos 750 MB).
  - Opcional: Microsoft Excel (para las fichas FEMO y de brigadista) y Outlook (para enviar correos).

INSTALACIÓN: UNA SOLA PREGUNTA
  Haga doble clic en Instalar_SAMO.cmd (o SAMO_instalador.exe). El instalador pregunta dónde
  va a estar la base de datos SQL Server:
    1 = INSTALAR TODO AQUÍ: instala SQL Server Express (gratis) en esta PC, sin preguntas.
        Esta queda como PC principal (o única). Lo normal si no tiene SQL Server.
    2 = USAR EL SQL SERVER QUE YA TIENE LA EMPRESA: se elige de una lista, se prueba y listo.
    3 = Una PC ADICIONAL. Se conecta sola a la principal (la que se instaló con la opción 1).

  1. PC PRINCIPAL (también si APTO se usará en una sola computadora)
     Pulse Enter para usar la carpeta C:\SAMO (recomendado) y pulse Sí cuando Windows pida permiso
     de administrador. Tarda de 5 a 20 minutos. El instalador, sin más pasos:
       - instala SQL Server Express (instancia APTO) y crea la base APTO con sus tablas y catálogos;
       - crea el usuario de la base apto_app con una contraseña al azar que nadie escribe: queda
         cifrada en esa computadora; desactiva el usuario «sa» de SQL Server;
       - deja SQL Server en el puerto 14330 y abre el firewall solo para redes privadas o de la
         empresa (nunca en redes públicas);
       - comparte la carpeta de APTO en la red (documentos PDF, logos, plantillas) solo para APTO,
         con una cuenta de Windows oculta (apto_red) con contraseña al azar;
       - si Windows tiene la red como «Pública», la cambia a «Privada» (no lo haga en un wifi de
         cafetería, hotel o aeropuerto);
       - hace que la computadora no se suspenda sola mientras esté enchufada;
       - si en la carpeta ya había datos de una versión anterior (archivo Access), los pasa a
         SQL Server y revisa fila por fila que no falte nada. El archivo Access queda intacto.
     Al terminar abre APTO. La primera vez:
       - 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.
       - ACTIVACIÓN: APTO 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 funciona 15 días en modo demostración;
         pasado ese plazo solo permite activar. La licencia indica cuántas computadoras pueden
         usarlo; se ve en Herramientas > Licencia y activación.
       - Ingrese con las iniciales del administrador y su PIN.
       - Herramientas > Importar nómina desde Excel (use Plantillas\Plantilla_Nomina.xlsx como
         modelo) y Administración para agregar al resto del personal.

  3. PC ADICIONAL
     Deje APTO ABIERTO en la principal, ejecute el instalador en la computadora nueva y elija 3.
     El instalador busca solo la principal en la red. En la principal aparece un aviso: el
     administrador pulsa Sí y escribe su PIN. Listo: la carpeta compartida y la contraseña de la
     base llegan cifradas. No hay que escribir rutas, servidores, contraseñas ni claves.

  Importante:
  - Varias computadoras pueden usar APTO al mismo tiempo.
  - La computadora principal debe estar encendida mientras las demás usan APTO.
  - Las demás deben estar en la MISMA red (el mismo wifi o cable de la oficina). Desde otra red
    (la casa, otro wifi) no encuentran la principal; para eso use una VPN de la empresa.
  - NUNCA ponga la carpeta de APTO en OneDrive, Google Drive o Dropbox. El instalador no lo permite.
  - Volver a ejecutar el instalador en la principal (opción 1) no borra nada ni cambia la
    contraseña de la base: sirve para reparar.

  2. SQL SERVER QUE YA TIENE LA EMPRESA
     a. El instalador busca los SQL Server de esta computadora y de la red y los muestra en una
        lista: escriba el número. Si no aparece, escriba el nombre del servidor: es el mismo que TI
        escribe en SQL Server Management Studio, en «Nombre del servidor» (ejemplos: SRV-SQL01,
        SRV-SQL01\SQLEXPRESS, 192.168.1.20,1433).
     b. Enter = cada persona entra con su usuario de Windows (recomendado, sin contraseñas).
        U = un usuario y contraseña de SQL que le dio TI (la contraseña se guarda cifrada).
     c. El instalador PRUEBA la conexión antes de seguir. Si falla, explica por qué (servidor no
        encontrado, usuario sin permiso) y deja intentar otra vez.
     d. Base de datos: Enter = APTO. Si no existe, el instalador la crea (si el usuario tiene
        permiso). Si no tiene permiso: TI crea una base vacía con ese nombre y da db_owner (o
        db_datareader, db_datawriter y db_ddladmin) al grupo de Windows de quienes usan APTO.
     e. El programa crea sus tablas y catálogos solo. Cambiar después: App\SAMO.exe --base
     f. Otras computadoras: si la carpeta de APTO es una carpeta compartida (\\SERVIDOR\APTO),
        basta crear el acceso directo a App\SAMO.exe; si no, repita la opción 2 en cada una.
     Sin preguntas: Instalar_SAMO.cmd -SqlServidor "SRV-SQL01\SQLEXPRESS" -SqlBase APTO

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
  - APTO hace una copia diaria automática de la base SQL Server en Datos\Respaldos de la
    computadora principal (archivo .bak, 30 días).
  - Recomendado: copiar además la carpeta Datos\Respaldos a un disco externo o a la nube una vez
    por semana.
  - Con el SQL Server de la empresa (opción 2) las copias las hace TI en su servidor.

SOLUCIÓN DE PROBLEMAS
  - «No se pudo descargar SQL Server Express»: revise internet y vuelva a ejecutar el instalador
    (opción 1). No se pierde nada.
  - Una PC adicional no encuentra la principal: que la principal esté encendida, con APTO abierto,
    y las dos en la misma red. Vuelva a ejecutar el instalador en la principal (opción 1) si se
    cambió de red.
  - «Esta computadora todavía no tiene la contraseña de SQL Server»: vuelva a ejecutar el
    instalador en esa computadora y elija 3.
  - 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.
