prodaric-scaffolding

Plantilla (scaffolding) para crear aplicaciones cliente Prodaric (ERP, CRM, POS, Accounting, HRM) sobre Prodaric Framework.

Cómo usar esta plantilla

Opción 1: "Use this template" en GitHub

1. En esta página, clic en Use this template → Create a new repository.
2. Elige nombre (p. ej. prodaric-accounting) y crea el repo.
3. Clona tu nuevo repo y continúa con los pasos siguientes.

Opción 2: degit (sin historial de git)

npx degit prodaric/prodaric-scaffolding mi-prodaric-app
cd mi-prodaric-app

Después de crear el proyecto

1. Renombra el proyecto en package.json (name, description, applicationName en theia.frontend.config).

2. Configura el token de GitHub Packages (para @prodaric). Crea o edita .npmrc en tu home o en el proyecto:

   @prodaric:registry=https://npm.pkg.github.com/
   //npm.pkg.github.com/:_authToken=TU_TOKEN_GITHUB
   

3. Instala dependencias:

   npm install

4. Genera el bundle de Theia (obligatorio la primera vez):

   • Solo navegador: npm run rebuild
   • Con Electron: npm run rebuild:electron

5. Arranca la aplicación:

   • Navegador: npm run start (por defecto en http://localhost:3000)
   • Electron: npm run start:electron

Estructura

• package.json — dependencia de @prodaric/framework y Theia; scripts de build y arranque.
• .npmrc — registro npm para el scope @prodaric.
• scripts/theia-electron-main.js — entrada Electron (delega al código generado por Theia).
• src/ — lugar para los módulos de frontend de tu aplicación (ver src/README.md).

Los directorios lib/ y src-gen/ se generan al ejecutar npm run rebuild o npm run rebuild:electron; no hace falta versionarlos.

Requisitos

• Node.js >= 18
• npm >= 8
• Token de GitHub con permiso de lectura de paquetes para la org prodaric