@jjlmoya/utils-finance 1.3.0 → 1.6.0

package/src/tool/fireCalculator/i18n/pt.ts

@@ -0,0 +1,261 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { FIRECalculatorUI } from '../ui';
+
+const slug = 'calculadora-regra-4-por-cento-fire';
+const title = 'Calculadora FIRE: Regra dos 4% para a sua Liberdade Financeira';
+const description = 'Calcule o seu número mágico para a independência financeira usando a regra dos 4%. Planeie a sua reforma antecipada e visualize o seu caminho para a liberdade económica.';
+
+const faqData = [
+  {
+    question: 'O que é a Regra dos 4%?',
+    answer: 'A Regra dos 4% é uma estratégia de levantamento baseada no Estudo Trinity que indica que pode levantar 4% do seu património no primeiro ano de reforma, ajustando pela inflação nos anos seguintes, sem esgotar os seus fundos em 30 anos.',
+  },
+  {
+    question: 'O que é FIRE?',
+    answer: 'FIRE significa Financial Independence, Retire Early (Independência Financeira, Reforma Antecipada). É um movimento que procura alcançar a liberdade económica através de uma combinação agressiva de poupança e investimento inteligente.',
+  },
+  {
+    question: 'Qual é o meu número mágico?',
+    answer: 'O seu número mágico é o património total que precisa de acumular para poder viver dos rendimentos sem trabalhar. É calculado dividindo as suas despesas anuais pela taxa de levantamento segura (geralmente 4%).',
+  },
+  {
+    question: 'Qual a diferença entre Lean, Barista e Fat FIRE?',
+    answer: 'Lean FIRE é viver com despesas mínimas (70% das despesas atuais), Barista FIRE é trabalhar a tempo parcial enquanto os rendimentos cobrem o resto (50% das despesas), e Fat FIRE é ter um estilo de vida folgado (150% das despesas).',
+  },
+  {
+    question: 'A Regra dos 4% é realista?',
+    answer: 'A Regra dos 4% tem uma probabilidade histórica de sucesso de 95% numa carteira 50/50 ações-obrigações durante 30 anos. No entanto, não contempla o risco de sequência de retornos e baseia-se principalmente em dados do mercado norte-americano.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Calcule as suas despesas mensais',
+    text: 'Analise quanto gasta realmente cada mês, incluindo habitação, alimentação, serviços e entretenimento.',
+  },
+  {
+    name: 'Escolha a sua taxa de levantamento segura',
+    text: 'A Regra dos 4% é o padrão, mas pode ajustar entre 2,5% (mais conservador) e 6% (mais agressivo) de acordo com a sua tolerância ao risco.',
+  },
+  {
+    name: 'Introduza o seu património atual',
+    text: 'Some o total dos seus investimentos, poupanças e ativos que geram rendimento passivo.',
+  },
+  {
+    name: 'Visualize o seu progresso',
+    text: 'Observe o gráfico de crescimento e os marcos de liberdade (Lean, Barista, Fat FIRE) para entender quando alcançará a sua meta.',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'The Trinity Study: Portfolio Survivability',
+    url: 'https://en.wikipedia.org/wiki/Trinity_study',
+  },
+  {
+    name: 'Early Retirement Forum - 4% Rule Discussion',
+    url: 'https://www.bogleheads.org/forum/',
+  },
+  {
+    name: 'Shiller CAPE Index - Market Valuations',
+    url: 'https://www.multpl.com/shiller-pe',
+  },
+  {
+    name: 'Bogleheads - Guia de Investimento',
+    url: 'https://bogleheads.es/',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'FinanceApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'pt',
+};
+
+export const content: ToolLocaleContent<FIRECalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Perguntas Frequentes sobre FIRE',
+  faq: faqData,
+  bibliographyTitle: 'Fontes e Referências',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Regra dos 4%: O Santo Graal da Reforma Antecipada',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Descubra como calcular o património necessário para viver dos rendimentos para sempre. A <strong>Regra dos 4%</strong> surgiu do Estudo Trinity, realizado em 1998 por três professores de finanças. Analisaram dados históricos desde 1926 para determinar que percentagem se podia levantar anualmente sem esgotar a carteira em 30 anos.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: '95%', label: 'Sucesso Histórico' },
+        { value: '50/50', label: 'Mix Ações/Obrigações' },
+        { value: '30', label: 'Anos de Horizonte' },
+        { value: '4%', label: 'Levantamento Seguro' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'O que é o Movimento FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'FIRE é a sigla para Financial Independence, Retire Early (Independência Financeira, Reforma Antecipada).',
+        'Procura a liberdade de escolher o que fazer com o seu tempo sem que o dinheiro seja um condicionante.',
+        'Baseia-se na otimização da poupança e no investimento inteligente.',
+        'O objetivo é que os seus ativos gerem fluxo de caixa suficiente para cobrir as suas despesas.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Tipos de Liberdade Financeira',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Lean FIRE',
+          description: 'Estilo de vida minimalista. Cobre apenas as despesas básicas de sobrevivência.',
+          points: ['Poupança extrema', 'Gasto muito baixo', 'Liberdade frugal'],
+        },
+        {
+          title: 'Barista FIRE',
+          description: 'Situação híbrida onde os seus investimentos cobrem a metade das suas despesas.',
+          points: ['Trabalho por prazer', 'Segurança social coberta', 'Menor stresse'],
+        },
+        {
+          title: 'Fat FIRE',
+          description: 'Reforma com um orçamento folgado que permite luxos e viagens.',
+          points: ['Alto património', 'Zero restrições', 'Legado familiar'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Como usar a nossa Calculadora FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Controlo de Despesas:</strong> Analise as suas despesas reais dos últimos 12 meses.',
+        '<strong>Definição de SWR:</strong> Escolha a sua taxa de levantamento segura de acordo com o seu risco.',
+        '<strong>Património Atual:</strong> Introduza o valor dos seus investimentos atuais.',
+        '<strong>Capacidade de Poupança:</strong> Projete quanto tempo lhe resta para a meta.',
+        '<strong>Visualização Visual:</strong> Analise o gráfico de crescimento da sua riqueza.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Análise da Regra dos 4%',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Vantagens',
+          description: 'Por que funciona a regra dos 4%',
+          points: [
+            'Simplicidade matemática para planeamento rápido.',
+            'Baseada em dados históricos de quase um século.',
+            'Adaptável a qualquer nível de gasto.',
+          ],
+        },
+        {
+          title: 'Limitações',
+          description: 'O que não cobre a regra dos 4%',
+          points: [
+            'Não contempla o risco de sequência de retornos.',
+            'Baseada principalmente no mercado norte-americano.',
+            'Ignora mudanças drásticas na fiscalidade local.',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Factor Crítico: A Inflação',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Lembre-se que 1.000€ hoje não comprarão o mesmo no futuro. É vital usar rentabilidades reais (descontada a inflação) para que as suas projeções mantenham o poder de compra atual. A Regra dos 4% assume que ajusta os seus levantamentos anualmente pela inflação.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Calculadora FIRE: Regra dos 4%',
+    labelDescription: 'Calcule o seu número mágico para a independência financeira usando a regra dos 4% e visualize os seus marcos para a liberdade.',
+    labelMonthlyExpenses: 'Despesas Mensais',
+    labelSWR: 'Taxa de Levantamento (SWR)',
+    labelCurrentWorth: 'Património Atual',
+    labelMonthlySavings: 'Capacidade de Poupança Mensal',
+    labelAnnualReturn: 'Rentabilidade Estimada (Neta)',
+    labelFreedomMilestones: 'Marcos de Liberdade',
+    labelLeanFIRE: 'Lean FIRE (70% sobrevivência)',
+    labelBaristaFIRE: 'Barista FIRE (50% rendimento)',
+    labelFatFIRE: 'Fat FIRE (150% luxo)',
+    labelMagicNumber: 'O Seu Número Mágico para ser Livre',
+    labelMagicNumberDesc: 'Capital necessário para viver dos rendimentos',
+    labelTimeRemaining: 'Tempo até à liberdade financeira',
+    labelTimeRemainingFormat: 'Faltam-lhe {years} anos e {months} meses',
+    labelAlreadyFI: 'Já alcançou a liberdade financeira!',
+    labelUnachievable: 'Meta inalcançável com esta poupança',
+    labelHiddenCostsChecklist: 'Checklist de Despesas Ocultas',
+    labelHealth: 'Seguro de Saúde (+200€)',
+    labelTaxes: 'Impostos (+150€)',
+    labelHome: 'Manutenção da Casa (+100€)',
+    labelTravel: 'Viagens e Lazer (+300€)',
+    labelEmergency: 'Fundo de Emergência (+100€)',
+    labelSubscriptions: 'Subscrições (+50€)',
+    labelAdded: 'Adicionado:',
+    labelSavePlan: 'Guardar Plano',
+    labelSWRTooltip: 'Safe Withdrawal Rate: Percentagem das suas poupanças que pode levantar todos os anos sem ficar sem dinheiro.',
+    labelReturnTooltip: 'Rendimento anual do mercado (já descontada a inflação). O padrão histórico é de 7%.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'pt-PT',
+  },
+};

package/src/tool/fireCalculator/i18n/ru.ts

@@ -0,0 +1,261 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { FIRECalculatorUI } from '../ui';
+
+const slug = 'kalykulyator-pravila-4-protsentov-fire';
+const title = 'Калькулятор FIRE: Правило 4% для вашей финансовой свободы';
+const description = 'Рассчитайте свое магическое число финансовой независимости, используя правило 4%. Спланируйте ранний выход на пенсию и визуализируйте свой путь к экономической свободе.';
+
+const faqData = [
+  {
+    question: 'Что такое правило 4%?',
+    answer: 'Правило 4% — это стратегия снятия средств, основанная на «Исследовании Тринити», которая гласит, что вы можете снимать 4% своего капитала в первый год выхода на пенсию, корректируя эту сумму на инфляцию в последующие годы, не исчерпав при этом свои средства в течение 30 лет.',
+  },
+  {
+    question: 'Что такое FIRE?',
+    answer: 'FIRE означает Financial Independence, Retire Early (Финансовая независимость, ранний выход на пенсию). Это движение, участники которого стремятся достичь экономической свободы за счет агрессивного сочетания сбережений и разумного инвестирования.',
+  },
+  {
+    question: 'Каково мое магическое число?',
+    answer: 'Ваше магическое число — это общий капитал, который вам необходимо накопить, чтобы иметь возможность жить на доходы от него, не работая. Оно рассчитывается путем деления ваших годовых расходов на безопасную ставку снятия (обычно 4%).',
+  },
+  {
+    question: 'В чем разница между Lean, Barista и Fat FIRE?',
+    answer: 'Lean FIRE — это жизнь с минимальными расходами (70% от текущих расходов), Barista FIRE — это работа на неполный рабочий день, пока доходы от инвестиций покрывают остальное (50% расходов), и Fat FIRE — это обеспеченный образ жизни (150% расходов).',
+  },
+  {
+    question: 'Реалистично ли правило 4%?',
+    answer: 'Исторически вероятность успеха правила 4% составляет 95% для портфеля 50/50 акции/облигации в течение 30 лет. Однако оно не учитывает риск последовательности доходности и основано главным образом на данных рынка США.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Рассчитайте свои ежемесячные расходы',
+    text: 'Проанализируйте, сколько вы на самом деле тратите каждый месяц, включая жилье, питание, услуги и развлечения.',
+  },
+  {
+    name: 'Выберите безопасную ставку снятия',
+    text: 'Правило 4% является стандартом, но вы можете корректировать его в диапазоне от 2,5% (более консервативно) до 6% (более агрессивно) в зависимости от вашей терпимости к риску.',
+  },
+  {
+    name: 'Введите свой текущий капитал',
+    text: 'Сложите общую сумму ваших инвестиций, сбережений и активов, приносящих пассивный доход.',
+  },
+  {
+    name: 'Визуализируйте свой прогресс',
+    text: 'Следите за графиком роста и этапами свободы (Lean, Barista, Fat FIRE), чтобы понять, когда вы достигнете своей цели.',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'The Trinity Study: Portfolio Survivability',
+    url: 'https://en.wikipedia.org/wiki/Trinity_study',
+  },
+  {
+    name: 'Early Retirement Forum - 4% Rule Discussion',
+    url: 'https://www.bogleheads.org/forum/',
+  },
+  {
+    name: 'Shiller CAPE Index - Market Valuations',
+    url: 'https://www.multpl.com/shiller-pe',
+  },
+  {
+    name: 'Bogleheads — Руководство по инвестированию',
+    url: 'https://bogleheads.es/',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'FinanceApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'ru',
+};
+
+export const content: ToolLocaleContent<FIRECalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Часто задаваемые вопросы о FIRE',
+  faq: faqData,
+  bibliographyTitle: 'Источники и рекомендации',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Правило 4%: Святой Грааль раннего выхода на пенсию',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Узнайте, как рассчитать капитал, необходимый для того, чтобы жить на проценты вечно. <strong>Правило 4%</strong> появилось в результате «Исследования Тринити», проведенного в 1998 году тремя профессорами финансов. Они проанализировали исторические данные с 1926 года, чтобы определить, какой процент можно снимать ежегодно, не исчерпав портфель в течение 30 лет.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: '95%', label: 'Ист. успех' },
+        { value: '50/50', label: 'Микс Акции/Облигации' },
+        { value: '30', label: 'Лет горизонта' },
+        { value: '4%', label: 'Безп. снятие' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Что такое движение FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'FIRE — это аббревиатура от Financial Independence, Retire Early (Финансовая независимость, ранний выход на пенсию).',
+        'Стремление получить свободу выбора того, что делать со своим временем, не завися от денег.',
+        'Основано на оптимизации сбережений и разумном инвестировании.',
+        'Цель состоит в том, чтобы ваши активы приносили достаточный денежный поток для покрытия ваших расходов.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Виды финансовой свободы',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Lean FIRE',
+          description: 'Минималистичный образ жизни. Покрывает только базовые расходы на выживание.',
+          points: ['Экстремальная экономия', 'Очень низкие расходы', 'Скромная свобода'],
+        },
+        {
+          title: 'Barista FIRE',
+          description: 'Гибридная ситуация, когда ваши инвестиции покрывают половину ваших расходов.',
+          points: ['Работа в удовольствие', 'Соцстрахование обеспечено', 'Меньше стресса'],
+        },
+        {
+          title: 'Fat FIRE',
+          description: 'Выход на пенсию с щедрым бюджетом, позволяющим роскошь и путешествия.',
+          points: ['Высокий капитал', 'Ноль ограничений', 'Семейное наследие'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Как пользоваться нашим калькулятором FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Отслеживание расходов:</strong> Проанализируйте свои реальные расходы за последние 12 месяцев.',
+        '<strong>Определение SWR:</strong> Выберите безопасную ставку снятия в соответствии с вашим риском.',
+        '<strong>Текущий капитал:</strong> Введите стоимость ваших текущих инвестиций.',
+        '<strong>Способность к сбережению:</strong> Спрогнозируйте, сколько времени осталось до цели.',
+        '<strong>Визуализация:</strong> Проанализируйте график роста вашего благосостояния.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Анализ правила 4%',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Преимущества',
+          description: 'Почему работает правило 4%',
+          points: [
+            'Математическая простота для быстрого планирования.',
+            'Основано на исторических данных почти за столетие.',
+            'Адаптируемость к любому уровню расходов.',
+          ],
+        },
+        {
+          title: 'Ограничения',
+          description: 'Что не охватывает правило 4%',
+          points: [
+            'Не учитывает риск последовательности доходности.',
+            'Основано преимущественно на американском рынке.',
+            'Игнорирует резкие изменения в местном налогообложении.',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Критический фактор: инфляция',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Помните, что 1000 рублей сегодня не купят то же самое в будущем. Жизненно важно использовать реальную доходность (за вычетом инфляции), чтобы ваши прогнозы сохраняли текущую покупательную способность. Правило 4% предполагает, что вы ежегодно корректируете свои снятия на инфляцию.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Калькулятор FIRE: правило 4%',
+    labelDescription: 'Рассчитайте свое магическое число для финансовой независимости с помощью правила 4% и визуализируйте свои этапы на пути к свободе.',
+    labelMonthlyExpenses: 'Ежемесячные расходы',
+    labelSWR: 'Ставка снятия (SWR)',
+    labelCurrentWorth: 'Текущий капитал',
+    labelMonthlySavings: 'Ежемесячные сбережения',
+    labelAnnualReturn: 'Ожидаемая доходность (чистая)',
+    labelFreedomMilestones: 'Этапы свободы',
+    labelLeanFIRE: 'Lean FIRE (70% выживание)',
+    labelBaristaFIRE: 'Barista FIRE (50% доходов)',
+    labelFatFIRE: 'Fat FIRE (150% роскошь)',
+    labelMagicNumber: 'Ваше магическое число свободы',
+    labelMagicNumberDesc: 'Капитал, необходимый для жизни на пассивный доход',
+    labelTimeRemaining: 'Время до финансовой свободы',
+    labelTimeRemainingFormat: 'Осталось {years} лет и {months} месяцев',
+    labelAlreadyFI: 'Вы уже достигли финансовой свободы!',
+    labelUnachievable: 'Цель недостижима при таких сбережениях',
+    labelHiddenCostsChecklist: 'Список скрытых расходов',
+    labelHealth: 'Медстраховка (+20000₽)',
+    labelTaxes: 'Налоги (+15000₽)',
+    labelHome: 'Обслуживание жилья (+10000₽)',
+    labelTravel: 'Путешествия и досуг (+30000₽)',
+    labelEmergency: 'Резервный фонд (+10000₽)',
+    labelSubscriptions: 'Подписки (+5000₽)',
+    labelAdded: 'Добавлено:',
+    labelSavePlan: 'Сохранить план',
+    labelSWRTooltip: 'Safe Withdrawal Rate: процент ваших сбережений, который вы можете снимать каждый год, не рискуя остаться без денег.',
+    labelReturnTooltip: 'Ежегодная доходность рынка (уже за вычетом инфляции). Исторический стандарт — 7%.',
+    currencySymbol: '₽',
+    currencyCode: 'RUB',
+    currencyLocale: 'ru-RU',
+  },
+};