Initial LinkedSign platform

2026-04-06 20:33:59 -05:00
commit 1074c7c9d2
159 changed files with 19072 additions and 0 deletions
@@ -0,0 +1,98 @@
+# LinkedSign Frontend
+
+Aplicación web React + Vite para LinkedSign. Se complementa con el backend REST y con la app Android.
+
+## Módulos visibles
+
+- autenticación
+- documentos
+- certificados
+- estilo de firma
+- firmar
+- verificación pública
+
+## Flujo actual
+
+### Autenticación
+
+- registro con correo y contraseña segura
+- validación por enlace enviado al correo
+- reenvío automático del enlace si el usuario intenta iniciar sesión sin validar
+- cambio de contraseña desde el bloque del usuario del menú lateral
+- confirmación de cambio de contraseña por correo
+
+### Documentos
+
+En el menú **Documentos** existen dos tablas:
+
+1. **Documentos originales para firmar**
+   - subir PDF
+   - ver original
+   - descargar original
+   - enviar a firmar
+   - eliminar
+
+2. **Documentos firmados generados**
+   - ver el PDF firmado antes de descargar
+   - descargar el PDF firmado
+
+### Certificados
+
+- subir `.p12` / `.pfx`
+- ver sujeto, emisor y vigencia
+- ver si el archivo incluye cadena embebida
+
+### Estilo Firma
+
+El menú **Estilo Firma** centraliza la configuración visual del usuario:
+
+- clásico
+- QR
+- profesional
+- imagen
+
+Para QR:
+
+- izquierda / derecha
+- fondo transparente o suave
+- sin borde o con borde
+
+La preferencia se reutiliza en futuras firmas.
+
+### Firmar
+
+El menú **Firmar** usa:
+
+- documento original
+- certificado activo
+- razón
+- ubicación
+- posición visible elegida sobre el PDF
+- configuración visual guardada en **Estilo Firma**
+
+### Verificación pública
+
+- las firmas con QR apuntan a una URL pública de verificación
+- la pantalla muestra si la firma sigue siendo válida dentro del registro de LinkedSign
+
+## Desarrollo
+
+```bash
+cd /home/mgonzalez/desarrollo/react/linkedsign/frontend
+npm install
+npm run dev
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Relación con Android
+
+La app móvil en [android/README.md](/home/mgonzalez/desarrollo/react/linkedsign/android/README.md):
+
+- usa la misma autenticación
+- consume el mismo backend
+- sincroniza documentos, certificados y firmados bajo petición