@jjlmoya/utils-finance 1.4.0 → 1.7.0

package/src/tool/percentageCalculator/i18n/it.ts

@@ -0,0 +1,229 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PercentageCalculatorUI } from '../ui';
+
+const slug = 'calcolatore-percentuali';
+const title = 'Calcolatore di Percentuali 4 in 1: Sconti, Aumenti e Ribassi';
+const description =
+  'Calcola facilmente le percentuali online gratuitamente. 4 strumenti in 1 per estrarre l’X% di Y, differenza percentuale, aggiungere o sottrarre l’IVA, sconti e mance automatiche.';
+
+const faqData = [
+  {
+    question: 'Come funziona il calcolatore?',
+    answer:
+      'Basta inserire i valori nelle caselle del caso d’uso corrispondente al tuo problema e il nostro calcolatore elaborerà la formula senza dover premere alcun pulsante di calcolo.',
+  },
+  {
+    question: 'È valido per calcolare l’IVA o le tasse?',
+    answer:
+      'Sì, il blocco 4 („Aggiungere o sottrarre percentuale”) è progettato proprio per casi come l’applicazione di un’IVA al 22% su un prezzo base o il calcolo di una ritenuta d’acconto.',
+  },
+  {
+    question: 'Gestisce numeri decimali e negativi?',
+    answer:
+      'Certamente. Puoi inserire numeri decimali (usando il punto) e funzionerà anche con valori negativi se devi analizzare bilanci contabili in perdita.',
+  },
+  {
+    question: 'Posso copiare i risultati?',
+    answer:
+      'Sì, ogni blocco ha un pulsante nel riquadro del risultato che copia istantaneamente la cifra negli appunti del tuo dispositivo per poterla incollare in un’altra app o documento.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Identifica il tuo problema matematico',
+    text: 'Leggi i titoli dei 4 blocchi e scegli quello che coincide con ciò che vuoi sapere (Es. Quanto è il 20% di 50? -> Blocco 1).',
+  },
+  {
+    name: 'Inserisci le cifre',
+    text: 'Compila i campi „X” e „Y”. Non preoccuparti dell’ordine, la frase di ogni blocco ti guida visivamente.',
+  },
+  {
+    name: 'Copia il risultato istantaneo',
+    text: 'La cifra apparirà in tempo real in basso mentre scrivi. Premi l’icona di copia se desideri portarla altrove.',
+  },
+];
+
+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: 'it',
+};
+
+export const content: ToolLocaleContent<PercentageCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Domande Frequenti',
+  faq: faqData,
+  bibliographyTitle: 'Fonti e Riferimenti',
+  bibliography: [
+    {
+      name: 'Calcolo di Percentuali - Wikipedia',
+      url: 'https://it.wikipedia.org/wiki/Percentuale',
+    },
+    {
+      name: 'Concetti Matematici di Base - Khan Academy',
+      url: 'https://it.khanacademy.org/math/pre-algebra/pre-algebra-ratios-rates/pre-algebra-percents/v/describing-the-meaning-of-percent',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Calcolatore di Percentuali 4 in 1: Domina i Calcoli Rapidi',
+      level: 2,
+    },
+    {
+      type: 'title',
+      text: 'A cosa serve un calcolatore di percentuali multiplo?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Calcolare le percentuali è una delle operazioni matematiche più comuni nella nostra vita quotidiana. Dal calcolo dello sconto durante i saldi, alla conoscenza della mancia adeguata in un ristorante, fino alla determinazione del margine di profitto in un’azienda o dell’interesse di un prestito. Pur essendo operazioni quotidiane, non è sempre facile eseguirle a mente o ricordare la formula esatta.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Il nostro calcolatore di percentuali 4 in 1 raggruppa gli scenari più richiesti. Non hai più bisogno di cercare su Google „come calcolare il 20 per cento” o „formula per il calcolo della percentuale”. Hai le quattro operazioni essenziali in un unico posto, in modo interattivo e con risultati istantanei.',
+    },
+    {
+      type: 'title',
+      text: 'Analisi dei 4 casi d’uso più comuni',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Per semplificarti la vita, abbiamo separato lo strumento in quattro chiari blocchi visivi che risolvono i problemi reali che affrontiamo ogni giorno:',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:percent',
+      title: '1. Quanto è l’X% di Y?',
+      html: '<p><strong>Il caso classico.</strong> Utile per calcolare sconti o mance. Se vuoi sapere quanto è il 15% di 120€, questo è lo strumento che fa per te. La formula sottostante divide semplicemente la percentuale per 100 e la moltiplica per il valore totale.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:division',
+      title: '2. Che percentuale è X di Y?',
+      html: '<p><strong>Ideale per le proporzioni.</strong> Se hai preso 45 punti in un esame da 60, che voto hai su 100? Questa funzione divide la parte per il totale e la moltiplica per cento, dandoti l’esatto peso relativo.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:chart-line-variant',
+      title: '3. Aumento o Diminuzione Percentuale',
+      html: '<p><strong>Perfetto per finanza e analisi.</strong> Di quanto è aumentato l’affitto rispetto all’anno scorso? Se prima pagavi 800€ e ora 840€, questa funzione ti dirà che hai subito un aumento del 5%. Misura la crescita o la decrescita tra due cifre.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:calculator',
+      title: '4. Aggiungere o Sottrarre percentuale a un valore',
+      html: '<p><strong>Utilissimo per l’IVA.</strong> Se hai un prezzo base (es. 100€) e devi aggiungere il 22% di IVA, questo calcolatore ti darà direttamente i 122€ finali senza dover fare operazioni intermedie. Allo stesso modo, serve per applicare uno sconto diretto (es. sottrarre il 20%).</p>',
+    },
+    {
+      type: 'title',
+      text: 'Miti comuni sul calcolo delle percentuali',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Spesso ci blocchiamo di fronte a percentuali grandi o decimali, ma ci sono alcuni „trucchi” matematici che possono semplificarti la vita. Il più famoso è la <strong>reversibilità delle percentuali</strong>.',
+    },
+    {
+      type: 'tip',
+      title: 'Il trucco della reversibilità',
+      html: '<p>Sapevi che l’X% di Y è esattamente uguale all’Y% di X? Per esempio, se ti chiedono di calcolare il 18% di 50 a mente, può sembrare complicato. Ma se lo inverti, il 50% di 18 è molto facile: è 9! Questo vale per assolutamente qualsiasi numero ed è un incredibile salvavita nel quotidiano.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Perché sbagliamo a calcolare le crescite',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Uno degli errori più comuni si verifica nel caso 3: l’aumento o la diminuzione percentuale. Immaginiamo che un’azione in borsa costi 100€, scenda del 50% e il giorno dopo salga del 50%. L’intuizione ci dice che torna a valere 100€, ma è sbagliato.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Se scende del 50% da 100€, il suo nuovo valore è 50€. Se da quei 50€ sale del 50%, l’incremento è la metà di 50 (25€). Pertanto, il prezzo finale sarebbe 75€. Questo è un esempio classico del perché i rialzi e i ribassi percentuali non sono asimmetrici e perché i calcolatori dinamici come questo prevengono gravi errori finanziari.',
+    },
+    {
+      type: 'title',
+      text: 'Uso professionale e accademico',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'La nostra interfaccia è priva di distrazioni e progettata per <strong>lavorare velocemente</strong>. Puoi tenerla in una scheda fissata del browser, passare rapidamente tra i vari campi e, grazie al pulsante di copia accanto al risultato, trasferire il dato esatto nel tuo Excel o Google Sheets senza rischio di errori di battitura.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Commercio web e negozi fisici: calcolo rapido del prezzo di vendita applicando margini commerciali e aggiungendo l’IVA.',
+        'Gestione delle risorse umane: determinazione del divario salariale, ritenute fiscali e aumenti di stipendio basati sull’inflazione.',
+        'Istruzione universitaria: professori che livellano i voti o studenti di rami scientifici che analizzano la deviazione dei loro esperimenti.',
+        'Marketing digitale: misurazione del CTR (Click Through Rate), ROAS (Return on Ad Spend) o Conversion Rate nell’eCommerce.',
+      ],
+    },
+  ],
+  ui: {
+    labelTitle: 'Calcolatore di Percentuali',
+    labelCase1Title: 'Caso 1',
+    labelCase1Question: 'Quanto è l’X% di Y?',
+    labelCase1Placeholder1: 'X',
+    labelCase1Placeholder2: 'Y',
+    labelCase1Formula: 'Formula: (X / 100) × Y',
+    labelCase2Title: 'Caso 2',
+    labelCase2Question: 'Che percentuale è X di Y?',
+    labelCase2Placeholder1: 'X',
+    labelCase2Placeholder2: 'Y',
+    labelCase2Formula: 'Formula: (X / Y) × 100',
+    labelCase3Title: 'Caso 3',
+    labelCase3Question: 'Differenza percentuale tra due valori',
+    labelCase3Placeholder1: 'Valore 1',
+    labelCase3Placeholder2: 'Valore 2',
+    labelCase3Formula: 'Formula: ((Valore 2 - Valore 1) / |Valore 1|) × 100',
+    labelCase4Title: 'Caso 4',
+    labelCase4Question: 'Aggiungere o sottrarre percentuale a un valore',
+    labelCase4Placeholder1: 'Valore',
+    labelCase4Placeholder2: '%',
+    labelCase4Formula: 'Formula: Valore ± (Valore × (% / 100))',
+    labelCase4AddLabel: 'Somma (Valore + %)',
+    labelCase4SubtractLabel: 'Sottrazione (Valore - %)',
+    labelResult: 'Risultato',
+    labelDifference: 'Differenza',
+    labelCopyTooltip: 'Copia risultato',
+    labelFormula: 'Formula',
+    percentSymbol: '%',
+  },
+};

package/src/tool/percentageCalculator/i18n/ja.ts

@@ -0,0 +1,229 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PercentageCalculatorUI } from '../ui';
+
+const slug = 'percentage-calculator';
+const title = '4 in 1 パーセント計算機：割引・値上げ・値下げ';
+const description =
+  'オンラインで簡単にパーセント計算を無料で行えます。XのY%、パーセントの差、消費税の加算・減算、バーゲンセール、チップ計算など、4つのツールが1つに。';
+
+const faqData = [
+  {
+    question: 'この計算機はどのように使いますか？',
+    answer:
+      '問題に対応するユースケースの入力欄に数値を入力するだけです。計算ボタンを押す必要はなく、リアルタイムで数式が処理されます。',
+  },
+  {
+    question: '消費税や税金の計算に使えますか？',
+    answer:
+      'はい、ブロック4（「値にパーセントを加算または減算する」）は、本体価格に消費税を適用したり、源泉徴収税を計算したりする場合に最適です。',
+  },
+  {
+    question: '小数や負の数は扱えますか？',
+    answer:
+      'もちろんです。小数は「 . 」（ピリオド）を使って入力できます。また、損失を含む会計収支を分析する場合など、負の値も入力可能です。',
+  },
+  {
+    question: '結果をコピーできますか？',
+    answer:
+      'はい、各ブロックの結果欄にあるボタンを押すと、数値を即座にクリップボードにコピーできます。他のアプリや書類に簡単に貼り付けられます。',
+  },
+];
+
+const howToData = [
+  {
+    name: '数学的な問題を特定する',
+    text: '4つのブロックのタイトルを確認し、知りたいことに一致するものを選択します（例：50の20%はいくら？ → ブロック1）。',
+  },
+  {
+    name: '数値を入力する',
+    text: '「X」と「Y」の欄を埋めます。順序を気にする必要はありません。各ブロックの説明が視覚的にガイドします。',
+  },
+  {
+    name: '即座に表示される結果をコピーする',
+    text: '入力するのと同時に、リアルタイムで結果が表示されます。コピーアイコンを押して、数値を活用しましょう。',
+  },
+];
+
+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<PercentageCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'よくある質問',
+  faq: faqData,
+  bibliographyTitle: '情報源とリファレンス',
+  bibliography: [
+    {
+      name: 'パーセントの計算 - Wikipedia',
+      url: 'https://ja.wikipedia.org/wiki/パーセント',
+    },
+    {
+      name: '基本的な数学の概念 - Khan Academy',
+      url: 'https://ja.khanacademy.org/math/pre-algebra/pre-algebra-ratios-rates/pre-algebra-percents/v/describing-the-meaning-of-percent',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '4 in 1 パーセント計算機：素早い計算をマスターする',
+      level: 2,
+    },
+    {
+      type: 'title',
+      text: '複合パーセント計算機は何に役立ちますか？',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'パーセント計算は、私たちの日常生活で最も一般的な数学的操作の1つです。セールの割引額の計算、レストランでの適切なチップの把握から、ビジネスでの利益率やローンの利息の決定まで。日常的な操作であるにもかかわらず、暗算したり正確な数式を思い出したりするのは必ずしも簡単ではありません。',
+    },
+    {
+      type: 'paragraph',
+      html: '当社の4-in-1パーセント計算機は、最も需要の高いシナリオをグループ化しています。もはやGoogleで「20パーセントの出し方」や「パーセント計算の公式」を検索する必要はありません。4つの必須操作が1か所にまとまっており、インタラクティブで即座に結果が得られます。',
+    },
+    {
+      type: 'title',
+      text: '4つの最も一般的なユースケースの確認',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '利便性を高めるために、ツールを4つの明確な視覚的ブロックに分割し、毎日直面する現実の問題を解決できるようにしました。',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:percent',
+      title: '1. YのX%はいくらですか？',
+      html: '<p><strong>最も標準的なケースです。</strong> 割引やチップの計算に便利です。12,000円の15%を知りたい場合はこのツールを使います。数式は単純にパーセンテージを100で割り、合計値に掛けます。</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:division',
+      title: '2. XはYの何パーセントですか？',
+      html: '<p><strong>割合を知りたい場合に最適です。</strong> 60点満点の試験で45点取った場合、100点満点では何点になりますか？この機能は部分を全体で割り、100を掛けることで正確な相対的比率を算出します。</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:chart-line-variant',
+      title: '3. パーセンテージの増加または減少',
+      html: '<p><strong>財務や分析に最適です。</strong> 昨年から家賃はどれくらい上がりましたか？以前は80,000円で現在は84,000円だった場合、この機能は5%増加したことを教えてくれます。2つの数値間の成長または減少を測定します。</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:calculator',
+      title: '4. 値にパーセントを加算または減算する',
+      html: '<p><strong>消費税計算に非常に便利です。</strong> 本体価格（例：10,000円）に10%の消費税を加える必要がある場合、この計算機は中間的な操作をすることなく直接最終価格の11,000円を表示します。同様に、直接的な割引（例：20%を引く）を適用する際にも使えます。</p>',
+    },
+    {
+      type: 'title',
+      text: 'パーセント計算に関する一般的な誤解',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '大きなパーセンテージや小数を見ると戸惑うことがよくありますが、生活を楽にしてくれるいくつかの数学的な「コツ」があります。最も有名なのは、<strong>パーセントの可逆性</strong>です。',
+    },
+    {
+      type: 'tip',
+      title: '可逆性のコツ',
+      html: '<p>「YのX%」は「XのY%」と全く同じであることを知っていましたか？例えば、50の18%を暗算で出そうとすると難しく感じるかもしれません。しかし、逆にしてみると「18の50%」となり、とても簡単に「9」だとわかります！これは絶対にどんな数字にも当てはまり、日常生活において驚くほど役立つライフハックです。</p>',
+    },
+    {
+      type: 'title',
+      text: '成長率の計算で間違いやすい理由',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '最も多い間違いの1つはケース3、つまりパーセンテージの増加または減少で起こります。株価が10,000円で、50%下落し、翌日に50%上昇したと想像してみてください。直感的には10,000円に戻る気がしますが、それは間違いです。',
+    },
+    {
+      type: 'paragraph',
+      html: '10,000円から50%下がると、新しい価格は5,000円になります。その5,000円から50%上がると、上昇分は5,000円の半分（2,500円）です。したがって、最終的な価格は7,500円になります。パーセントの上昇と下落は非対称であり、このような動的な計算機が重大な財務的エラーを防ぐ古典的な例です。',
+    },
+    {
+      type: 'title',
+      text: '業務および学術用途',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '当社のインターフェースは余計なものを削ぎ落とし、<strong>素早い作業</strong>ができるよう設計されています。ブラウザのタブにピン留めしておけば、各入力欄をスムーズに移動でき、結果の横にあるコピーボタンのおかげで、入力ミスのリスクなくExcelやGoogleスプレッドシートに正確なデータを転送できます。',
+    },
+    {
+      type: 'list',
+      items: [
+        'ECサイトや実店舗：販売利益率を適用し、消費税を加算した販売価格の迅速な計算。',
+        '人事管理：賃金格差の決定、源泉徴収税、CPI（消費者物価指数）に紐づいた昇給の算出。',
+        '大学教育：点数の傾斜配分を行う教員や、実験データの偏差を分析する理系学生。',
+        'デジタルマーケティング：ECサイトにおけるCTR（クリック率）、ROAS（広告費回収率）、またはコンバージョン率の測定。',
+      ],
+    },
+  ],
+  ui: {
+    labelTitle: 'パーセント計算機',
+    labelCase1Title: 'ケース 1',
+    labelCase1Question: 'YのX%はいくらですか？',
+    labelCase1Placeholder1: 'X',
+    labelCase1Placeholder2: 'Y',
+    labelCase1Formula: '公式: (X / 100) × Y',
+    labelCase2Title: 'ケース 2',
+    labelCase2Question: 'XはYの何パーセントですか？',
+    labelCase2Placeholder1: 'X',
+    labelCase2Placeholder2: 'Y',
+    labelCase2Formula: '公式: (X / Y) × 100',
+    labelCase3Title: 'ケース 3',
+    labelCase3Question: '2つの値のパーセント差',
+    labelCase3Placeholder1: '値 1',
+    labelCase3Placeholder2: '値 2',
+    labelCase3Formula: '公式: ((値 2 - 値 1) / |値 1|) × 100',
+    labelCase4Title: 'ケース 4',
+    labelCase4Question: '値にパーセントを加算または減算する',
+    labelCase4Placeholder1: '値',
+    labelCase4Placeholder2: '%',
+    labelCase4Formula: '公式: 値 ± (値 × (% / 100))',
+    labelCase4AddLabel: '加算 (値 + %)',
+    labelCase4SubtractLabel: '減算 (値 - %)',
+    labelResult: '結果',
+    labelDifference: '差',
+    labelCopyTooltip: '結果をコピー',
+    labelFormula: '公式',
+    percentSymbol: '%',
+  },
+};