feat: estructura base OpenSpec + Skills + arquitectura limpia Capacitor+Dextie

packages/core/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@toldo/core",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest"
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3",
+    "vitest": "^2.1.8"
+  }
+}

packages/core/src/__tests__/cuadreRules.test.ts

@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest';
+import { calcularSaldoEsperadoEfectivo, calcularDescuadreEfectivo, calcularTotalVentas, validateAjusteMotivo } from '../rules/cuadreRules';
+
+describe('cuadreRules', () => {
+  it('calcula saldo esperado en efectivo', () => {
+    expect(calcularSaldoEsperadoEfectivo(10000, 5000, 2000)).toBe(13000);
+  });
+
+  it('calcula descuadre en efectivo', () => {
+    expect(calcularDescuadreEfectivo(13000, 12500)).toBe(-500);
+  });
+
+  it('calcula total de ventas', () => {
+    expect(calcularTotalVentas(5000, 3000)).toBe(8000);
+  });
+
+  it('lanza error si ajuste sin motivo', () => {
+    expect(() => validateAjusteMotivo('')).toThrow('El ajuste debe tener un motivo obligatorio');
+    expect(() => validateAjusteMotivo('   ')).toThrow('El ajuste debe tener un motivo obligatorio');
+  });
+
+  it('acepta ajuste con motivo', () => {
+    expect(() => validateAjusteMotivo('Corrección de inventario')).not.toThrow();
+  });
+});

packages/core/src/entities/Ajuste.ts

@@ -0,0 +1,11 @@
+export interface Ajuste {
+  id: string;
+  fecha: Date;
+  productoId: string;
+  cantidadAnterior: number;
+  cantidadNueva: number;
+  diferencia: number;
+  motivo: string;
+  modificadoPor?: string;
+  createdAt: Date;
+}

packages/core/src/entities/CuadreCaja.ts

@@ -0,0 +1,18 @@
+export interface CuadreCaja {
+  id: string;
+  fecha: Date;
+  baseInicial: number;
+  totalVentasEfectivo: number;
+  totalVentasQR: number;
+  totalGastosEfectivo: number;
+  totalGastosQR: number;
+  saldoEsperadoEfectivo: number;
+  saldoRealEfectivo?: number;
+  descuadreEfectivo?: number;
+  totalQRRegistrado?: number;
+  totalQRBanco?: number;
+  descuadreQR?: number;
+  totalVentas: number;
+  observaciones?: string;
+  createdAt: Date;
+}

packages/core/src/entities/Gasto.ts

@@ -0,0 +1,8 @@
+export interface Gasto {
+  id: string;
+  fecha: Date;
+  concepto: string;
+  monto: number;
+  formaPago?: 'EFECTIVO' | 'QR';
+  createdAt: Date;
+}

packages/core/src/entities/MovimientoInventario.ts

@@ -0,0 +1,13 @@
+export type TipoMovimiento = 'INGRESO_INICIAL' | 'INGRESO_SEMANA' | 'AJUSTE' | 'VENTA';
+
+export interface MovimientoInventario {
+  id: string;
+  fecha: Date;
+  tipo: TipoMovimiento;
+  productoId: string;
+  cantidad: number;
+  motivo?: string;
+  recibidoPor?: string;
+  referenciaId?: string;
+  createdAt: Date;
+}

packages/core/src/entities/Producto.ts

@@ -0,0 +1,8 @@
+export interface Producto {
+  id: string;
+  productorId: string;
+  nombrePresentacion: string;
+  precioUnitario: number;
+  activo: boolean;
+  createdAt: Date;
+}

packages/core/src/entities/Productor.ts

@@ -0,0 +1,6 @@
+export interface Productor {
+  id: string;
+  nombre: string;
+  activo: boolean;
+  createdAt: Date;
+}

packages/core/src/entities/Venta.ts

@@ -0,0 +1,20 @@
+export type FormaPago = 'EFECTIVO' | 'QR';
+
+export interface VentaLinea {
+  id: string;
+  ventaId: string;
+  productoId: string;
+  cantidad: number;
+  precioUnitario: number;
+  subtotal: number;
+  formaPago: FormaPago;
+}
+
+export interface Venta {
+  id: string;
+  fecha: Date;
+  lineas: VentaLinea[];
+  subtotal: number;
+  total: number;
+  createdAt: Date;
+}

packages/core/src/entities/index.ts

@@ -0,0 +1,7 @@
+export * from './Productor';
+export * from './Producto';
+export * from './MovimientoInventario';
+export * from './Venta';
+export * from './Gasto';
+export * from './Ajuste';
+export * from './CuadreCaja';

packages/core/src/index.ts

@@ -0,0 +1,2 @@
+export * from './entities';
+export * from './rules/cuadreRules';

packages/core/src/rules/cuadreRules.ts

@@ -0,0 +1,25 @@
+export function validateAjusteMotivo(motivo: string): void {
+  if (!motivo || motivo.trim().length === 0) {
+    throw new Error('El ajuste debe tener un motivo obligatorio');
+  }
+}
+
+export function calcularDescuadreEfectivo(saldoEsperado: number, saldoReal: number): number {
+  return saldoReal - saldoEsperado;
+}
+
+export function calcularSaldoEsperadoEfectivo(
+  baseInicial: number,
+  totalVentasEfectivo: number,
+  totalGastosEfectivo: number
+): number {
+  return baseInicial + totalVentasEfectivo - totalGastosEfectivo;
+}
+
+export function calcularTotalVentas(totalVentasEfectivo: number, totalVentasQR: number): number {
+  return totalVentasEfectivo + totalVentasQR;
+}
+
+export function calcularDiferenciaInventario(cantidadEsperada: number, cantidadReal: number): number {
+  return cantidadReal - cantidadEsperada;
+}

packages/core/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}