@jjlmoya/utils-finance 1.1.0

package/src/tool/lotteryOptimizer/index.ts

@@ -0,0 +1,33 @@
+import type { FinanceToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import LotteryOptimizerComponent from './component.astro';
+import LotteryOptimizerSEO from './seo.astro';
+import LotteryOptimizerBibliography from './bibliography.astro';
+import type { LotteryOptimizerUI } from './ui';
+
+export type LotteryOptimizerLocaleContent = ToolLocaleContent<LotteryOptimizerUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const lotteryOptimizer: FinanceToolEntry<LotteryOptimizerUI> = {
+  id: 'optimizador-loterias',
+  icons: {
+    bg: 'mdi:dice-multiple',
+    fg: 'mdi:star',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { LotteryOptimizerComponent, LotteryOptimizerSEO, LotteryOptimizerBibliography };
+
+export const LOTTERY_OPTIMIZER_TOOL: ToolDefinition = {
+  entry: lotteryOptimizer,
+  Component: LotteryOptimizerComponent,
+  SEOComponent: LotteryOptimizerSEO,
+  BibliographyComponent: LotteryOptimizerBibliography,
+};

package/src/tool/lotteryOptimizer/logic.ts

@@ -0,0 +1,133 @@
+export type LotteryId = 'gordo' | 'nino' | 'euromillones' | 'primitiva' | 'bonoloto';
+
+export interface LotteryGame {
+  id: LotteryId;
+  name: string;
+  cost: number;
+  jackpot: number;
+  odds: number;
+  description: string;
+  payoutRate: number;
+}
+
+export const LOTTERY_DATA: Record<LotteryId, LotteryGame> = {
+  gordo: {
+    id: 'gordo',
+    name: 'Lotería de Navidad',
+    cost: 20,
+    jackpot: 400000,
+    odds: 100000,
+    payoutRate: 70,
+    description: 'El mayor reparto de premios del mundo. Probabilidad alta de ganar algo.',
+  },
+  nino: {
+    id: 'nino',
+    name: 'Lotería del Niño',
+    cost: 20,
+    jackpot: 200000,
+    odds: 100000,
+    payoutRate: 70,
+    description: 'Triplica las posibilidades de reintegro respecto a Navidad.',
+  },
+  euromillones: {
+    id: 'euromillones',
+    name: 'Euromillones',
+    cost: 2.5,
+    jackpot: 17000000,
+    odds: 139838160,
+    payoutRate: 50,
+    description: 'Premios astronómicos, probabilidades casi imposibles.',
+  },
+  primitiva: {
+    id: 'primitiva',
+    name: 'La Primitiva',
+    cost: 1,
+    jackpot: 2000000,
+    odds: 139838160,
+    payoutRate: 55,
+    description: 'La lotería más antigua de España. Difícil pero más barata.',
+  },
+  bonoloto: {
+    id: 'bonoloto',
+    name: 'Bonoloto',
+    cost: 0.5,
+    jackpot: 400000,
+    odds: 13983816,
+    payoutRate: 55,
+    description: 'La más económica. Ideal para jugar a diario con poco presupuesto.',
+  },
+};
+
+export class LotteryLogic {
+  private static getChristmasRecommendation(tickets: number): { recommendation: string; optimalTickets: number } {
+    if (tickets < 5) {
+      return {
+        recommendation:
+          'Para una gestión de riesgo básica, se suele buscar diversificar terminaciones. Jugar pocas unidades mantiene la ilusión con el mínimo riesgo de capital.',
+        optimalTickets: 1,
+      };
+    }
+    if (tickets < 10) {
+      return {
+        recommendation:
+          'Acercarse a los 10 décimos (200€) garantiza estadísticamente un reintegro, pero recuerda que esto supone recuperar solo el 10% de lo invertido en ese nivel.',
+        optimalTickets: tickets,
+      };
+    }
+    return {
+      recommendation:
+        'Has superado el umbral de diversificación básica. A partir de aquí, cada décimo extra aumenta tu exposición al riesgo sin mejorar la eficiencia de retorno.',
+      optimalTickets: 10,
+    };
+  }
+
+  private static getOtherRecommendation(
+    totalCost: number,
+    tickets: number,
+    cost: number
+  ): { recommendation: string; optimalTickets: number } {
+    if (totalCost > 15) {
+      return {
+        recommendation:
+          'En juegos de probabilidad extrema, no hay "estrategia óptima" más allá de limitar estrictamente el gasto. Reducir la cuantía es la mejor jugada.',
+        optimalTickets: Math.floor(5 / cost),
+      };
+    }
+    return {
+      recommendation:
+        'Mantener una participación simbólica es la forma más racional de participar en sorteos con botes astronómicos.',
+      optimalTickets: tickets,
+    };
+  }
+
+  static calculateStats(id: LotteryId, tickets: number) {
+    const game = LOTTERY_DATA[id];
+    const totalCost = tickets * game.cost;
+    const winProbability = 1 - Math.pow((game.odds - 1) / game.odds, tickets);
+    const expectedValue = game.jackpot * (tickets / game.odds) - totalCost;
+
+    const isChristmas = id === 'gordo' || id === 'nino';
+    const { recommendation, optimalTickets } = isChristmas
+      ? this.getChristmasRecommendation(tickets)
+      : this.getOtherRecommendation(totalCost, tickets, game.cost);
+
+    return {
+      totalCost,
+      winProbability: winProbability * 100,
+      expectedValue,
+      recommendation,
+      optimalTickets,
+      efficiency: (game.payoutRate / 100) * (tickets / totalCost),
+    };
+  }
+
+  static compareGames() {
+    return Object.values(LOTTERY_DATA)
+      .map((game) => ({
+        name: game.name,
+        score: game.payoutRate / 100 / (game.odds / 1000000),
+        odds: game.odds,
+      }))
+      .sort((a, b) => b.score - a.score);
+  }
+}

package/src/tool/lotteryOptimizer/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { lotteryOptimizer } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await lotteryOptimizer.i18n[locale]?.();
+if (!content) return null;
+---
+<SEORenderer content={{ locale: locale as string, sections: content.seo }} />

package/src/tool/lotteryOptimizer/ui.ts

@@ -0,0 +1,33 @@
+export interface LotteryOptimizerUI {
+  gameTranslations?: Record<string, { name: string; description: string }>;
+  labelTitle: string;
+  labelDescription: string;
+  labelSelectGame: string;
+  labelConfigurePlay: string;
+  labelAdjustQuantity: string;
+  labelTotalInvestment: string;
+  labelTickets: string;
+  labelUnits: string;
+  labelExposureAnalysis: string;
+  labelSelectLottery: string;
+  labelOptimalCutoff: string;
+  labelProbabilitySuccess: string;
+  labelExpectedValue: string;
+  labelReturnTheoretical: string;
+  labelSocialReturnIndex: string;
+  labelLow: string;
+  labelMedium: string;
+  labelHigh: string;
+  labelComparison: string;
+  labelLottery: string;
+  labelCost: string;
+  labelTypicalPrize: string;
+  labelDifficulty: string;
+  labelAccessible: string;
+  labelDifficult: string;
+  labelExtreme: string;
+  labelNote: string;
+  currencySymbol: string;
+  currencyCode: string;
+  currencyLocale: string;
+}

package/src/tool/mortgage/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { mortgage } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await mortgage.i18n[locale]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}