fixed-overtime-calculator 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# fixed-overtime-calculator
+
+This is a CLI tool that calculates the amount of the fixed overtime allowance (fixed overtime pay) based on the total gross pay.
+This tool is designed for use in Japan and is based on Japanese labor laws.
+
+総支給額から、定額残業手当（固定残業代）の金額を計算するCLIツールです。
+
+## 使い方
+
+インストールは不要です。`npx` でそのまま実行できます。
+
+```sh
+npx fixed-overtime-calculator
+```
+
+実行すると、対話形式で3つの質問に答えるだけで結果が表示されます。
+
+1. 総支給額
+2. 月平均所定労働時間
+3. みなし残業時間
+
+## 出力例
+
+総支給額30万円、月平均所定労働時間160時間、みなし残業30時間の場合。
+
+```
+$ npx fixed-overtime-calculator
+✔ 総支給額を入力してください · 300000
+✔ 所定労働時間を入力してください · 160
+✔ みなし残業時間を入力してください · 30
+【入力】
+ 総支給額:              300,000円
+ 月平均所定労働時間:      160時間
+ みなし残業時間:           30時間
+
+【内訳】
+ 基本給:                243,000円
+ 定額残業代:             57,000円
+----------------------------------
+ 合計:                  300,000円
+
+ みなし残業 30時間分の定額残業代は57,000円です。
+
+【単価】
+ 時間給:               1,518.75円
+ 割増単価(1.25倍):     1,898.44円
+※時間給が地域別最低賃金を下回らないようご注意ください
+
+【注意】
+・法定時間外労働の割増率1.25倍のみを前提としています。深夜割増や休日割増は含みません。
+・実際の残業時間がみなし残業時間を超えた月は、超過分の割増賃金を別途支払う必要があります。
+・定額残業代が有効とされるには、通常の労働時間の賃金部分と割増賃金部分を判別できること、およびその手当が時間外労働の対価であることが必要です。
+・総支給額は、家族手当・通勤手当など割増賃金の基礎から除外される賃金を除いた額を入力してください。除外できるかは名称ではなく実質で判断されます。
+・本ツールの結果は目安です。実際の賃金設計は社会保険労務士等の専門家にご確認ください。
+```
+
+## 計算のしくみ
+
+総支給額を T、月平均所定労働時間を H、みなし残業時間を N、基本給を B とします。
+
+割増賃金は `時間給 × 1.25 × 残業時間` で計算されるため、両者の関係は次の式になります。
+
+```
+T = B + (B ÷ H × 1.25 × N)
+```
+
+## 前提条件
+
+- **割増率は法定時間外労働の1.25倍のみ**を扱います。深夜割増（25%）、法定休日割増（35%）、月60時間超の割増（50%）は対象外です。固定残業代は法定時間外労働分のみを対象とするのが一般的なためです。
+- **総支給額は、割増賃金の基礎から除外される賃金を除いた額**を入力してください。労働基準法37条5項および同法施行規則21条により、次の7つが限定列挙されています。
+
+  家族手当、通勤手当、別居手当、子女教育手当、住宅手当、臨時に支払われた賃金、1ヶ月を超える期間ごとに支払われる賃金
+
+  ただしこれらは**名称ではなく実質で判断**されます。家族手当でも家族数に関係なく一律に支払われるものや、通勤手当でも距離に関係なく一律に支払われるものは、算定の基礎に含めなければなりません。
+
+- 月平均所定労働時間は入力値をそのまま使用します。年間所定休日数からの自動計算は行いません。
+- 最低賃金との比較は行いません。
+
+## 固定残業代を設計する際の留意点
+
+**実際の残業時間がみなし残業時間を超えた月は、超過分の割増賃金を別途支払う必要があります**（労働基準法37条1項）。
+また固定残業代が有効と認められるには、**通常の労働時間の賃金部分と割増賃金部分を判別できること（明確区分性）**と、**その手当が時間外労働の対価であること（対価性）**が必要とされています（最判平成29年7月7日 医療法人康心会事件、最判平成30年7月19日 日本ケミカル事件）。
+なお1時間当たりの賃金額および割増賃金額に1円未満の端数が生じた場合、50銭未満を切り捨て、50銭以上を1円に切り上げる処理が認められています（基発第150号）。本ツールは単価を参考値として端数を丸めずに表示しています。
+
+## 必要環境
+
+- Node.js 18以上
+
+## 免責
+
+本ツールの結果はあくまで目安です。実際の賃金設計にあたっては、社会保険労務士等の専門家にご確認ください。
+
+## 参考
+
+- [労働基準法 第37条（時間外、休日及び深夜の割増賃金）](https://laws.e-gov.go.jp/law/322AC0000000049)
+- [労働基準法施行規則 第21条（割増賃金の基礎から除外される賃金）](https://laws.e-gov.go.jp/law/322M40000100023)
+- [固定残業代（定額残業代）の取扱い | 厚生労働省 スタートアップ労働条件](https://www.startup-roudou.mhlw.go.jp/qa/zigyonushi/chingin/q11.html)
+
+## ライセンス
+
+MIT

package/cli.js

@@ -0,0 +1,40 @@
+import enquirer from "enquirer";
+
+export const askTotal = async () => {
+  const prompt = new enquirer.Input({
+    message: "総支給額を入力してください",
+    validate: (value) => {
+      const result = validatePositiveNumber(value);
+      if (result !== true) return result;
+      if (!Number.isInteger(Number(value))) return "整数を入力してください。";
+      return true;
+    },
+  });
+  const answer = await prompt.run();
+  return Number(answer);
+};
+
+export const askMonthlyHours = async () => {
+  const prompt = new enquirer.Input({
+    message: "所定労働時間を入力してください",
+    validate: validatePositiveNumber,
+  });
+  const answer = await prompt.run();
+  return Number(answer);
+};
+
+export const askOvertimeHours = async () => {
+  const prompt = new enquirer.Input({
+    message: "みなし残業時間を入力してください",
+    validate: validatePositiveNumber,
+  });
+  const answer = await prompt.run();
+  return Number(answer);
+};
+
+const validatePositiveNumber = (value) => {
+  const number = Number(value);
+  if (Number.isNaN(number)) return "数値を入力してください。";
+  if (number <= 0) return "0より大きい金額を入力してください。";
+  return true;
+};

package/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { calculate } from "./overtime.js";
+import { buildReport } from "./report.js";
+import { askTotal, askMonthlyHours, askOvertimeHours } from "./cli.js";
+
+const total = await askTotal();
+const monthlyHours = await askMonthlyHours();
+const overtimeHours = await askOvertimeHours();
+
+console.log(buildReport(calculate({ total, monthlyHours, overtimeHours })));

package/overtime.js

@@ -0,0 +1,19 @@
+const PREMIUM_RATE = 1.25;
+
+export const calculate = ({ total, monthlyHours, overtimeHours }) => {
+  const ratio = 1 + (PREMIUM_RATE * overtimeHours) / monthlyHours;
+  // 基本給を100円単位で切り捨て、差額を定額残業代に寄せることで内訳の合計を総支給額に一致させる
+  const baseSalary = Math.floor(total / ratio / 100) * 100;
+  const fixedAmount = total - baseSalary;
+  const hourlyWage = baseSalary / monthlyHours; // 時給
+
+  return {
+    total,
+    monthlyHours,
+    overtimeHours,
+    baseSalary,
+    fixedAmount,
+    hourlyWage,
+    premiumUnitWage: hourlyWage * PREMIUM_RATE,
+  };
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "fixed-overtime-calculator",
+  "version": "1.0.0",
+  "description": "総支給額から、定額残業手当（固定残業代）の金額を計算するCLIツールです。",
+  "bin": {
+    "fixed-overtime-calculator": "index.js"
+  },
+  "main": "index.js",
+  "scripts": {
+    "test": "node --test",
+    "lint": "prettier --check . && eslint .",
+    "fix": "prettier --write . && eslint --fix ."
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.9.1",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.12.0",
+    "prettier": "^3.9.6"
+  },
+  "dependencies": {
+    "enquirer": "^2.4.1"
+  },
+  "files": [
+    "index.js",
+    "overtime.js",
+    "report.js",
+    "cli.js"
+  ]
+}

package/report.js

@@ -0,0 +1,68 @@
+const LABEL_COLUMN = 22;
+const AMOUNT_COLUMN = 10;
+const pattern = /[ -~｡-ﾟ]/;
+const NOTES = [
+  "法定時間外労働の割増率1.25倍のみを前提としています。深夜割増や休日割増は含みません。",
+  "実際の残業時間がみなし残業時間を超えた月は、超過分の割増賃金を別途支払う必要があります。",
+  "定額残業代が有効とされるには、通常の労働時間の賃金部分と割増賃金部分を判別できること、およびその手当が時間外労働の対価であることが必要です。",
+  "総支給額は、家族手当・通勤手当など割増賃金の基礎から除外される賃金を除いた額を入力してください。除外できるかは名称ではなく実質で判断されます。",
+  "本ツールの結果は目安です。実際の賃金設計は社会保険労務士等の専門家にご確認ください。",
+];
+
+export const buildReport = (result) => {
+  return [
+    "【入力】",
+    ` ${padEndByWidth("総支給額:", LABEL_COLUMN)}${padStartByWidth(formatYen(result.total), AMOUNT_COLUMN)}`,
+    ` ${padEndByWidth("月平均所定労働時間:", LABEL_COLUMN)}${padStartByWidth(formatHours(result.monthlyHours), AMOUNT_COLUMN)}`,
+    ` ${padEndByWidth("みなし残業時間:", LABEL_COLUMN)}${padStartByWidth(formatHours(result.overtimeHours), AMOUNT_COLUMN)}`,
+    "",
+    "【内訳】",
+    ` ${padEndByWidth("基本給:", LABEL_COLUMN)}${padStartByWidth(formatYen(result.baseSalary), AMOUNT_COLUMN)}`,
+    ` ${padEndByWidth("定額残業代:", LABEL_COLUMN)}${padStartByWidth(formatYen(result.fixedAmount), AMOUNT_COLUMN)}`,
+    "----------------------------------",
+    ` ${padEndByWidth("合計:", LABEL_COLUMN)}${padStartByWidth(formatYen(result.total), AMOUNT_COLUMN)}`,
+    "",
+    ` みなし残業 ${result.overtimeHours}時間分の定額残業代は${formatYen(result.fixedAmount)}です。`,
+    "",
+    "【単価】",
+    ` ${padEndByWidth("時間給:", LABEL_COLUMN)}${padStartByWidth(formatYen(result.hourlyWage, 2), AMOUNT_COLUMN)}`,
+    ` ${padEndByWidth("割増単価(1.25倍):", LABEL_COLUMN)}${padStartByWidth(formatYen(result.premiumUnitWage, 2), AMOUNT_COLUMN)}`,
+    "※時間給が地域別最低賃金を下回らないようご注意ください",
+    "",
+    "【注意】",
+    ...NOTES.map((note) => `・${note}`),
+  ].join("\n");
+};
+
+const formatYen = (amount, fractionDigits = 0) => {
+  return `${amount.toLocaleString("ja-JP", {
+    minimumFractionDigits: fractionDigits,
+    maximumFractionDigits: fractionDigits,
+  })}円`;
+};
+
+const formatHours = (hours) => {
+  return `${hours}時間`;
+};
+
+const displayWidth = (text) => {
+  let width = 0;
+  for (const char of text) {
+    if (pattern.test(char)) {
+      width += 1;
+    } else {
+      width += 2;
+    }
+  }
+  return width;
+};
+
+const padEndByWidth = (text, columnSize) => {
+  const space = columnSize - displayWidth(text);
+  return `${text}${" ".repeat(Math.max(space, 0))}`;
+};
+
+const padStartByWidth = (text, columnSize) => {
+  const space = columnSize - displayWidth(text);
+  return `${" ".repeat(Math.max(space, 0))}${text}`;
+};