Tickzend · Manual

Manual de configuración

Sistema CRM mesa de ayuda — https://app.tickzend.com

1. Acceso web

URL: https://app.tickzend.com (o localhost:3000 en desarrollo)

Root Superadmin (incrustado, no está en la base de datos):

Usuarios demo sembrados: gestor / gestor123 · tecnico1 / tecnico123

2. Cambiar la clave del root

Edita el archivo (una sola línea = la clave):

config/root-password.txt

O desde terminal:

echo 'TuNuevaClaveSegura' > config/root-password.txt

No requiere reiniciar si el proceso lee el archivo en cada login. Reinicia el servidor si usas caché agresiva.

3. Arrancar el sistema

cd tickzend
npm install
npm run dev
# Producción:
npm run build && npm start

4. Google Maps (opcional)

  1. Ve a Google Cloud Console
  2. Crea un proyecto → habilita Maps JavaScript API (y opcionalmente Maps SDK for Android)
  3. Crea una API Key restringida por dominio app.tickzend.com
  4. Copia config/google-maps.env.example a .env.local:
NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=tu_api_key
NEXT_PUBLIC_APP_URL=https://app.tickzend.com

El mapa del gestor usa Leaflet/OpenStreetMap por defecto (sin key). La key queda lista para SDK nativo del APK y futuros embeds de Google.

5. Roles

6. APK técnicos

Código en carpeta mobile/ (Expo / React Native).

cd mobile
npm install
# Desarrollo
npx expo start
# Generar APK (EAS o local):
npx eas build -p android --profile preview

Configura la URL del API en mobile/src/config.ts → https://app.tickzend.com

El APK envía ubicación a POST /api/location periódicamente para que el gestor la vea en Mapa GPS.

7. Flujo recomendado

  1. Root crea gestores y técnicos (asocia cuadrilla)
  2. Gestor crea/asigna tickets de avería
  3. Técnico abre APK → ve sus tickets → marca traslado / llegada / salida
  4. Gestor monitorea GPS y chat

Tickzend · Level 7 · app.tickzend.com