@jjlmoya/utils-finance 1.4.0 → 1.6.0

package/src/tool/fireCalculator/i18n/ja.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 = 'four-percent-rule-fire-calculator';
+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: '歴史的に、株式50%・債券50%のポートフォリオにおいて、30年間で95%の成功確率があるとされています。ただし、収益順序のリスクは考慮されておらず、主に米国市場のデータに基づいています。',
+  },
+];
+
+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: 'JPY' },
+  inLanguage: 'ja',
+};
+
+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年に3人の財務教授によって行われた「トリニティ・スタディ」から生まれました。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: [
+            '迅速な計画のための数学的な簡潔さ。',
+            '約1世紀にわたる歴史データに基づいている。',
+            'あらゆる支出レベルに適応可能。',
+          ],
+        },
+        {
+          title: '限界',
+          description: '4%ルールがカバーしていないこと',
+          points: [
+            '収益順序のリスク（引退直後の下落）を考慮していない。',
+            '主に米国市場のデータに基づいている。',
+            '地域の税制の大幅な変更は無視されている。',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: '重要な要因：インフレ',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '現在の100万円は将来同じ価値ではないことを忘れないでください。予測を現実的に保つためには、インフレを差し引いた実質利回りを使用することが不可欠です。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: '医療保険 (+30,000円)',
+    labelTaxes: '税金 (+20,000円)',
+    labelHome: '住宅維持費 (+10,000円)',
+    labelTravel: '旅行・レジャー (+50,000円)',
+    labelEmergency: '緊急予備資金 (+10,000円)',
+    labelSubscriptions: 'サブスクリプション (+5,000円)',
+    labelAdded: '追加済み:',
+    labelSavePlan: 'プランを保存',
+    labelSWRTooltip: 'Safe Withdrawal Rate: 資産が枯渇するリスクを抑えつつ、毎年取り崩せる資産の割合。',
+    labelReturnTooltip: '年間市場利回り（インフレ調整後）。歴史的な標準は7%です。',
+    currencySymbol: '¥',
+    currencyCode: 'JPY',
+    currencyLocale: 'ja-JP',
+  },
+};

package/src/tool/fireCalculator/i18n/ko.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 = 'four-percent-rule-fire-calculator';
+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: '역사적으로 주식 50%, 채권 50% 포트폴리오에서 30년간 성공 확률이 95%에 달합니다. 다만, 수익률 순서 리스크는 고려되지 않았으며 주로 미국 시장 데이터에 기반하고 있습니다.',
+  },
+];
+
+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: 'KRW' },
+  inLanguage: 'ko',
+};
+
+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: '현재의 100만원이 미래에도 같은 가치가 아님을 기억하세요. 예측을 현실적으로 유지하려면 인플레이션을 제외한 실질 수익률을 사용하는 것이 필수적입니다. 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: '의료 보험 (+200,000원)',
+    labelTaxes: '세금 (+150,000원)',
+    labelHome: '주택 유지비 (+100,000원)',
+    labelTravel: '여행 및 레저 (+300,000원)',
+    labelEmergency: '비상금 (+100,000원)',
+    labelSubscriptions: '구독 서비스 (+50,000원)',
+    labelAdded: '추가됨:',
+    labelSavePlan: '플랜 저장',
+    labelSWRTooltip: 'Safe Withdrawal Rate: 자산 고갈 위험 없이 매년 인출할 수 있는 자산 비율.',
+    labelReturnTooltip: '연간 시장 수익률 (인플레이션 반영 후). 역사적 표준은 7%입니다.',
+    currencySymbol: '₩',
+    currencyCode: 'KRW',
+    currencyLocale: 'ko-KR',
+  },
+};