Saltar al contenido
SOLTECAAcceso clientes

Documento de trabajo

Cómo funciona el sistema

Tres cosas: dónde viven los archivos, quién puede ver cada uno y cómo se da de alta un cliente.

Estado a día de hoy

Montado sobre un Microsoft 365 de pruebas

Todo lo que se describe abajo funciona ya, pero contra un entorno de desarrollo temporal. Pasar al Microsoft 365 de la asesoría no cambia el código: cambian cinco valores de configuración.

Qué hay montado y qué falta para producción
PiezaHoyEn producción
Almacén de archivosSharePoint de un tenant de desarrollo, temporalSharePoint de la asesoría
Identidad ante MicrosoftAplicación con certificado, 10 añosIgual, certificado propio
Permiso concedidoSites.Selected sobre un único siteIgual
Usuarios y auditoríaPostgreSQL propio — no depende de MicrosoftIgual, con copias de seguridad
DocumentosSolo de pruebaLos reales, migrados si los hay

Lo que hace falta de la asesoría

  • Microsoft 365 con SharePoint

    Business Basic en adelante. Solo licencia para su personal, no para los clientes.

  • Media hora de su administrador

    Crear el site, registrar la aplicación, subir el certificado y conceder el permiso.

  • Tres datos de vuelta

    Id. de inquilino, id. de aplicación y dirección del site. Ninguno es secreto.

La idea de fondo

Los archivos no viven en la web

Viven en el SharePoint del Microsoft 365 ya contratado. La web es solo una puerta con cerradura: identifica a quien llama y le enseña lo que le corresponde —su carpeta al cliente, todas a la asesoría—. Microsoft pone el versionado, la papelera de 93 días y las copias de seguridad, sin que nadie tenga que instalar nada.

Recorrido de un documento entre el cliente, el portal y SharePointEl cliente pide permiso al portal; el portal comprueba su identidad y qué carpeta le corresponde, y solicita a Microsoft una llave temporal. Con esa llave, el archivo viaja directamente entre el navegador y SharePoint sin pasar por el servidor de la web. La asesoría entra por esa misma puerta, con permisos de gestión sobre todos los expedientes.ClientePortalMicrosoft 365Navegadorusuario y contraseñaPortalcomprueba quién eresy qué carpeta le tocaSharePointcarpeta de ese clientepide permisopide una llave temporalel archivo va directoLos documentos nunca pasan por el servidor de la webSOLTECApanel de gestiónmisma puerta, todos los expedientes
El portal autoriza, pero no toca los archivos: entrega una llave con caducidad y el documento viaja directo entre el navegador y SharePoint.

Dónde vive cada cosa

Tres piezas, una sola guarda documentos

Si desapareciera el servidor de la web no se perdería ni un archivo. Se pierde la puerta, que se vuelve a levantar.

  1. Next.js

    La web

    • Páginas públicas
    • Pantalla de acceso
    • Explorador de documentos

    No guarda ningún documento

  2. PostgreSQL

    La base de datos

    • Quién es cada usuario
    • Qué carpeta le corresponde
    • Registro de cada acceso

    No guarda ningún documento

  3. SharePoint · Microsoft 365

    El almacén

    • Todos los archivos
    • Versiones anteriores
    • Papelera de 93 días

    Aquí viven los documentos

Mapa de la web

Tres zonas, tres llaves distintas

Mapa de páginas de la webLa web tiene una zona pública con cinco páginas visibles para cualquiera —inicio, contacto y las tres legales—, una zona privada de cliente con el acceso y el explorador de sus documentos, y una zona de gestión reservada a la asesoría con el listado de clientes y las altas. Ninguna de las dos zonas privadas se indexa en buscadores.Zona públicaInicio/Contacto/contactoAviso legal/aviso-legalPrivacidad/privacidadCookies/cookiesZona cliente · no indexadaAcceso y sus documentos/portal · /portal/archivos — solo su carpetaZona asesoría · 404 para el restoClientes, accesos y sus archivos/gestion · altas · importar · ficha · archivos
Las zonas privadas no se indexan. Sin sesión, el portal redirige al acceso; /gestion responde «no existe» a cualquiera que no sea de la asesoría.

Estructura en SharePoint

Una carpeta por cliente

El nombre lleva el NIF delante, para que dos empresas homónimas no se confundan. Regla única: lo que empieza por guion bajo no existe para el cliente.

Documentos/
└─ Clientes/
   └─ B12345678 - Talleres Pérez SL/
      ├─ Entrada cliente/     el cliente sube aquí
      ├─ Impuestos/           solo lectura
      ├─ Nóminas/
      ├─ Contabilidad/
      └─ _interno/            solo asesoría
  • Las crea el alta

    Al dar de alta un cliente, el portal crea estas cinco carpetas en SharePoint.

  • El cliente no elige carpeta

    Su ámbito sale de la sesión, no de la dirección que escribe.

  • Doble comprobación

    Además se verifica que lo pedido cuelga de esa carpeta.

  • Todo queda registrado

    Acceso, descarga, subida y denegación, con usuario y hora.

Quién hace qué

La misma puerta, dos llaves

Cliente · /portal

Entra con el correo y la contraseña que le da la asesoría. Sin cuenta de Microsoft.

  • Ve solo su expediente
  • Consulta y descarga cuando quiera
  • Sube documentación sin usar el correo

Asesoría · /gestion

Trabaja íntegramente desde el navegador. No hay que instalar nada ni sincronizar carpetas: el panel da acceso a todos los expedientes.

  • Entra a los archivos de cualquier cliente desde su ficha
  • Sube, descarga, renombra y elimina
  • Ve las carpetas _interno, invisibles para el cliente

Novedad · panel de gestión

Altas y accesos sin tocar la terminal

Ya no hace falta un comando para dar de alta a nadie. Todo se hace desde /gestion.

  • Alta de cliente

    Ficha + carpetas en SharePoint + primer usuario, en un solo formulario.

  • Importar CSV

    La cartera entera de golpe. Plantilla lista para Excel en español.

  • Contraseña automática

    Se genera al alta, se enseña una vez y se copia al portapapeles.

  • Restablecer acceso

    Contraseña nueva al momento; se limpian los intentos fallidos previos.

  • Bloquear y reactivar

    Por usuario o por cliente entero, anotando el motivo.

  • Ficha editable

    Nombre, contacto y notas. El NIF y la carpeta no se tocan nunca.

Novedad · archivos desde el panel

El expediente de cualquier cliente, sin salir de la web

Cada ficha lleva a un explorador con la carpeta completa de ese cliente, _interno incluido. Es la carpeta real de SharePoint: lo que se hace aquí queda hecho allí, con su versionado y su papelera.

  • Ver y navegar

    Toda la carpeta del cliente, con las internas marcadas como tales.

  • Descargar

    Igual que el cliente, pero sobre cualquier expediente.

  • Subir

    Desde cualquier ordenador con navegador, dentro o fuera de la oficina.

  • Editar

    Abre el documento en SharePoint; los de Office se editan en el navegador.

  • Renombrar y crear carpetas

    Dentro del expediente. Mover entre clientes no se permite.

  • Eliminar

    Solo la asesoría. Va a la papelera de SharePoint: 93 días para recuperarlo.

Seguridad

Las seis reglas que lo sostienen

  • Contraseñas cifradas

    Argon2id. Ni la asesoría puede leer la de un cliente.

  • Cinco intentos

    Cinco fallos en 15 minutos y la cuenta queda bloqueada.

  • Sesión de 8 horas

    Una jornada. Después hay que volver a entrar.

  • Nadie cruza de expediente

    La carpeta sale de la base de datos; el cliente, de la sesión.

  • /gestion no existe

    Para quien no es de la asesoría responde 404, no «prohibido».

  • Auditoría completa

    Login, descarga, subida, alta y bloqueo, con quién y cuándo.

Lo que falta

Que lo nuevo aparezca solo

Con trescientos clientes, nadie va a abrir trescientas carpetas cada mañana. Lo que queda por hacer va todo en la misma dirección.

  1. Bandeja de entradas

    Una sola pantalla con lo último que ha subido cualquier cliente.

  2. Columnas «Cliente» y «Subido por»

    Hoy SharePoint atribuye todo a la aplicación; el dato solo está en la base de datos.

  3. Aviso a la asesoría

    Correo con quién ha subido qué y enlace a la carpeta.

  4. Aviso al cliente

    Cuando le dejan documentación. Es lo que hace que entre.