Add unified versioning and changelog workflow

.gitignore

@@ -8,7 +8,6 @@ backend/.env.*
 frontend/.env
 frontend/.env.*
 !frontend/.env.example
-android/local.properties
 android/keystore.properties
 android/*.jks
 android/*.keystore
@@ -70,6 +69,7 @@ android_react/ios/
 Thumbs.db
 .idea/
 .codex
+.tmp-venv/
 .vscode/*
 !.vscode/extensions.json
 *.swp

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## Versión actual
+
+- Versión base: `1.0.1`
+
+## Historial
+
+### 1.0.1 - 2026-04-07
+
+- Se unifica la versión inicial de `frontend`, `backend` y `android`.
+- Se establece `1.0.1` como versión base de arranque del sistema.
+- Se agrega el archivo `VERSION` como fuente única de versión.
+- Se agrega el script `scripts/set-version.sh` para actualizar versiones de forma sincronizada.
+
+## Cómo registrar una nueva versión
+
+1. Ejecuta `./scripts/set-version.sh X.Y.Z`
+2. Actualiza este archivo con la nueva versión y sus cambios principales.
+3. Haz las pruebas normales del sistema.
+4. Guarda cambios en git y despliega.

DEPLOY_ANDROID.md

@@ -0,0 +1,40 @@
+# Deploy Android
+
+## Versión actual
+
+- Base actual: `1.0.1`
+- Fuente de verdad: [VERSION](/home/mgonzalez/desarrollo/react/linkedsign/VERSION)
+- Historial de cambios: [CHANGELOG.md](/home/mgonzalez/desarrollo/react/linkedsign/CHANGELOG.md)
+
+## Pasos
+
+1. Haz los cambios en `dev`.
+2. Si corresponde, sube versión:
+   - `./scripts/set-version.sh X.Y.Z`
+   - actualiza `CHANGELOG.md`
+3. Prueba la app:
+   - `source /etc/profile.d/android-sdk.sh`
+   - `cd android`
+   - `GRADLE_USER_HOME=/home/mgonzalez/desarrollo/react/linkedsign/android/.gradle-home ./gradlew assembleDebug`
+4. Si todo está bien, genera release:
+   - `GRADLE_USER_HOME=/home/mgonzalez/desarrollo/react/linkedsign/android/.gradle-home ./gradlew assembleRelease`
+5. Copia el APK release:
+   - `cp android/app/build/outputs/apk/release/app-release.apk android/apk/LinkedSign-release.apk`
+6. Guarda cambios en git:
+   - `git add .`
+   - `git commit -m "mensaje"`
+7. Sube a Gitea:
+   - `git push origin main`
+8. Sube el APK a producción:
+   - `scp -P 2203 android/apk/LinkedSign-release.apk deploy@192.168.222.3:/opt/apps/linkedsign/apk/`
+9. Limpia archivos `.md` en producción:
+   - `find /opt/apps/linkedsign -type f -iname '*.md' -delete`
+10. Verifica descarga pública:
+   - `https://sign.linkedcorp.net/api/downloads/android-apk`
+
+## Notas
+
+- La `keystore` de producción está fuera de git.
+- No pierdas la `keystore` ni las contraseñas.
+- Si cambias algo visual de la app, no hace falta tocar la web.
+- Si cambias el contrato del API, prueba login, documentos y firma antes de subir release.

DEPLOY_WEB.md

@@ -0,0 +1,54 @@
+# Deploy Web
+
+## Versión actual
+
+- Base actual: `1.0.1`
+- Fuente de verdad: [VERSION](/home/mgonzalez/desarrollo/react/linkedsign/VERSION)
+- Historial de cambios: [CHANGELOG.md](/home/mgonzalez/desarrollo/react/linkedsign/CHANGELOG.md)
+
+## Pasos
+
+1. Haz los cambios en `dev`.
+2. Si corresponde, sube versión:
+   - `./scripts/set-version.sh X.Y.Z`
+   - actualiza `CHANGELOG.md`
+3. Prueba local:
+   - `cd frontend && npm run build`
+   - `cd ../backend && node -e "require('./src/app')"`
+4. Guarda cambios en git:
+   - `git add .`
+   - `git commit -m "mensaje"`
+5. Sube a Gitea:
+   - `git push origin main`
+6. En el servidor app entra por SSH:
+   - `ssh deploy@192.168.222.3 -p 2203`
+7. Actualiza código:
+   - `cd /opt/apps/linkedsign/source`
+   - `git fetch origin main`
+   - `git reset --hard origin/main`
+8. Recompila frontend:
+   - `cd /opt/apps/linkedsign/source/frontend`
+   - `npm ci`
+   - `npm run build`
+9. Publica frontend:
+   - `rm -rf /opt/apps/linkedsign/frontend/*`
+   - `cp -r dist /opt/apps/linkedsign/frontend/`
+   - `cp server.js /opt/apps/linkedsign/frontend/`
+10. Publica backend:
+   - `rm -rf /opt/apps/linkedsign/backend/*`
+   - `cp -r /opt/apps/linkedsign/source/backend/* /opt/apps/linkedsign/backend/`
+   - `cd /opt/apps/linkedsign/backend`
+   - `npm ci --omit=dev`
+11. Reinicia servicios:
+   - `sudo systemctl restart linkedsign-frontend`
+   - `sudo systemctl restart linkedsign-backend`
+12. Limpia archivos `.md` en producción:
+   - `find /opt/apps/linkedsign -type f -iname '*.md' -delete`
+13. Verifica:
+   - `curl -I http://127.0.0.1:3000`
+   - `curl http://127.0.0.1:4000/health`
+
+## Notas
+
+- Si cambias variables de entorno, actualiza `/opt/apps/linkedsign/backend/.env`.
+- Si cambias rutas del APK o storage, revisa también `PRODUCCION.md`.

PRODUCCION.md

@@ -0,0 +1,87 @@
+# Producción LinkedSign
+
+## Versión actual
+
+- Base actual: `1.0.1`
+- Fuente de verdad: [VERSION](/home/mgonzalez/desarrollo/react/linkedsign/VERSION)
+- Historial de cambios: [CHANGELOG.md](/home/mgonzalez/desarrollo/react/linkedsign/CHANGELOG.md)
+
+## Servidor de aplicación
+
+- Host: `192.168.222.3`
+- SSH: `deploy@192.168.222.3 -p 2203`
+- Ruta base: `/opt/apps/linkedsign`
+
+## Estructura en servidor
+
+- Código fuente: `/opt/apps/linkedsign/source`
+- Frontend runtime: `/opt/apps/linkedsign/frontend`
+- Backend runtime: `/opt/apps/linkedsign/backend`
+- Storage persistente: `/opt/apps/linkedsign/storage`
+- Logs: `/opt/apps/linkedsign/logs`
+
+## Servicios persistentes
+
+- Backend: `linkedsign-backend.service`
+- Frontend: `linkedsign-frontend.service`
+
+## Puertos internos
+
+- Frontend: `127.0.0.1:3000`
+- Backend: `127.0.0.1:4000`
+
+## Estado actual
+
+- Frontend local responde en `3000`
+- Backend local responde en `4000`
+- Ambos servicios quedaron `enabled` y `running`
+
+## Nginx Proxy Manager
+
+### Proxy host principal
+
+- Domain: `sign.linkedcorp.net`
+- Forward Hostname/IP: `192.168.222.3`
+- Forward Port: `3000`
+- Scheme: `http`
+- SSL: certificado para `sign.linkedcorp.net`
+
+### Custom location
+
+- Location: `/api`
+- Forward Hostname/IP: `192.168.222.3`
+- Forward Port: `4000`
+- Scheme: `http`
+
+No hace falta rewrite. El backend ya acepta `/api`.
+
+## Base de datos
+
+- Host MariaDB: `192.168.222.32`
+- Base de datos: `linkedsign`
+- Usuario: `linkedsign_user`
+
+## Estado base confirmado
+
+- MariaDB en `192.168.222.32` ya permite acceso desde `192.168.222.3`
+- Tablas de producción ya fueron creadas y validadas
+- El dominio público operativo es `https://sign.linkedcorp.net`
+
+## Comandos útiles
+
+```bash
+sudo systemctl status linkedsign-frontend
+sudo systemctl status linkedsign-backend
+sudo journalctl -u linkedsign-frontend -n 100 --no-pager
+sudo journalctl -u linkedsign-backend -n 100 --no-pager
+```
+
+## Notas de versión
+
+1. Toda nueva versión debe reflejarse en `VERSION`.
+2. Toda nueva versión debe registrarse en `CHANGELOG.md`.
+3. Producción no debe conservar archivos `.md` después del despliegue.
+
+## Seguridad
+
+El token de Gitea usado durante esta preparación quedó expuesto en el chat. Debe rotarse.

VERSION

@@ -0,0 +1 @@
+1.0.1

android/app/build.gradle

@@ -18,8 +18,8 @@ android {
         applicationId "net.linkedcorp.linkedsign"
         minSdk 26
         targetSdk 35
-        versionCode 1
+        versionCode 10001
-        versionName "0.1.0"
+        versionName "1.0.1"
 
         buildConfigField "String", "API_BASE_URL", "\"${apiBaseUrl}\""
     }

android/app/src/main/java/net/linkedcorp/linkedsign/ui/LinkedSignApp.kt

@@ -586,6 +586,7 @@ private fun AuthFlow(
                     }
                 )
             }
+            if (BuildConfig.DEBUG) {
                 Text(
                     "Servidor: ${BuildConfig.API_BASE_URL}",
                     color = Color(0xFF9CA3AF),
@@ -594,6 +595,7 @@ private fun AuthFlow(
                 )
             }
         }
+    }
 }
 
 @Composable

backend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedsign-backend",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "private": true,
   "description": "Initial backend for LinkedSign",
   "main": "src/server.js",

frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "0.0.0",
+  "version": "1.0.1",
   "type": "module",
   "scripts": {
     "dev": "vite",

scripts/set-version.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -ne 1 ]]; then
+  echo "Usage: $0 <version>"
+  exit 1
+fi
+
+VERSION="$1"
+
+if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "Version must use semver format, for example: 1.0.1"
+  exit 1
+fi
+
+IFS='.' read -r MAJOR MINOR PATCH <<< "$VERSION"
+VERSION_CODE=$((MAJOR * 10000 + MINOR * 100 + PATCH))
+
+printf '%s\n' "$VERSION" > VERSION
+
+sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"$VERSION\"/" frontend/package.json
+sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"$VERSION\"/" backend/package.json
+sed -i "s/versionCode [0-9]\\+/versionCode $VERSION_CODE/" android/app/build.gradle
+sed -i "s/versionName \"[^\"]*\"/versionName \"$VERSION\"/" android/app/build.gradle
+
+echo "Version updated to $VERSION"
+echo "Android versionCode: $VERSION_CODE"