sinkroniq-mobile

Sinkronet

Plataforma de facturacion electronica para Ecuador con tres frentes activos:

• backend/: API fiscal, colas SRI, ATS, retenciones, suscripciones, branding y correo documental.
• mobile/: app Expo/React Native para owner, staff y operacion fiscal mobile-first.
• landing/: landing Vite/React con PWA complementaria y CTA comerciales.

Estado actual

Al 10 de marzo de 2026 el proyecto ya expone:

• factura, nota de credito, guia de remision, liquidacion de compra y LC Reembolso empleado
• retenciones electronicas
• ATS mensual por tenant
• dashboard operativo y busqueda transversal de comprobantes
• refresh token, monitoreo de certificados, recovery SRI y backup activable
• RIDE/PDF, XML, ZIP y entrega por email o WhatsApp segun plan

Arranque local

Workspace

npm install

Backend con Docker Compose

Si quieres levantar api + worker + signer + postgres + redis con una sola orden:

npm run docker:up

Servicios:

• API: http://127.0.0.1:3000/api
• Ops dashboard: http://127.0.0.1:3000/ops-dashboard
• Signer: http://127.0.0.1:4000/health
• PostgreSQL: 127.0.0.1:55432
• Redis: 127.0.0.1:56379

Para apagar:

npm run docker:down

Guia:

• docs/docker_compose_local.md

Backend

npm run --workspace=backend dev

Comandos utiles:

• npm run --workspace=backend migrate:deploy
• npm run --workspace=backend generate
• npm run --workspace=backend start:worker
• npm run --workspace=backend preflight:runtime

Mobile

npm run --workspace=mobile start

mobile/.env debe definir EXPO_PUBLIC_API_URL para apuntar al backend.

Landing

npm run landing

La landing Vite queda disponible por defecto en http://127.0.0.1:4173/.

Documentacion clave

• docs/estructura_proyecto_actual.md
• docs/codigo_proyecto_actual.md
• docs/render_deploy_recommended.md
• docs/guia_usuario_render_y_primer_ingreso.md
• docs/docker_compose_local.md
• docs/E2E_CONTROLADO.md
• docs/README.md
• docs/generate-current-doc-snapshots.js
• backend/docs/OPERATIONS.md
• backend/docs/EMPRESA_MIGRATION_PLAN.md
• backend/docs/PHASE4_HOMOLOGATION.md
• mobile/README.md

Politica de documentacion

• docs/ dentro del repo contiene solo documentacion canonica, versionada y util para operacion/despliegue.
• El material historico, borradores, adjuntos pesados y archivos de trabajo se mantiene fuera del repo en C:\proyectos web\Docs.

Notas de arquitectura

• El tenant actual sigue basado en ownerId; la tabla Empresa esta documentada como migracion objetivo, no como runtime activo.
• Mobile reutiliza servicios backend existentes; no debe abrir capas paralelas para ATS, retenciones, dashboard o busqueda.
• La firma fiscal sigue centralizada en backend/signer; el movil no debe manejar .p12 en cliente.