j-law-ruby 0.0.3

data/vendor/rust/crates/j-law-core/src/domains/income_tax/context.rs

@@ -0,0 +1,79 @@
+use crate::domains::income_tax::policy::IncomeTaxPolicy;
+use crate::types::date::LegalDate;
+use std::collections::HashSet;
+use std::fmt;
+
+/// 所得税計算に関わる法的フラグ。
+///
+/// WARNING: 各フラグの事実認定はライブラリの責任範囲外です。
+/// 呼び出し元が正しく判断した上で指定してください。
+///
+/// # 法的根拠
+/// 所得税法 各条項
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+pub enum IncomeTaxFlag {
+    /// 復興特別所得税を適用する。
+    ///
+    /// 適用要件: 2013年〜2037年の各年分の所得税。
+    /// 法的根拠: 復興財源確保法 第13条
+    ApplyReconstructionTax,
+}
+
+/// 所得税計算の入力コンテキスト。
+///
+/// # 法的根拠
+/// 所得税法 第89条第1項
+pub struct IncomeTaxContext {
+    /// 課税所得金額（円）。
+    ///
+    /// 各種所得控除を適用した後の金額。
+    /// 1,000円未満の端数は切り捨て済みであること。
+    /// 法的根拠: 所得税法 第89条第1項
+    pub taxable_income: u64,
+    /// 確定申告の対象となる年の基準日。
+    pub target_date: LegalDate,
+    /// 適用する法的フラグの集合。
+    pub flags: HashSet<IncomeTaxFlag>,
+    /// 計算ポリシー（テスト・カスタム計算での差し替えを可能にする）。
+    pub policy: Box<dyn IncomeTaxPolicy>,
+}
+
+impl fmt::Debug for IncomeTaxContext {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        f.debug_struct("IncomeTaxContext")
+            .field("taxable_income", &self.taxable_income)
+            .field("target_date", &self.target_date)
+            .field("flags", &self.flags)
+            .field("policy", &"<policy>")
+            .finish()
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::domains::income_tax::policy::StandardIncomeTaxPolicy;
+
+    #[test]
+    fn context_construction() {
+        let mut flags = HashSet::new();
+        flags.insert(IncomeTaxFlag::ApplyReconstructionTax);
+
+        let ctx = IncomeTaxContext {
+            taxable_income: 5_000_000,
+            target_date: LegalDate::new(2024, 1, 1),
+            flags,
+            policy: Box::new(StandardIncomeTaxPolicy),
+        };
+        assert_eq!(ctx.taxable_income, 5_000_000);
+        assert!(ctx.flags.contains(&IncomeTaxFlag::ApplyReconstructionTax));
+    }
+
+    #[test]
+    fn flag_equality() {
+        assert_eq!(
+            IncomeTaxFlag::ApplyReconstructionTax,
+            IncomeTaxFlag::ApplyReconstructionTax,
+        );
+    }
+}

data/vendor/rust/crates/j-law-core/src/domains/income_tax/deduction/calculator.rs

@@ -0,0 +1,167 @@
+use crate::domains::income_tax::deduction::context::IncomeDeductionContext;
+use crate::domains::income_tax::deduction::expense::calculate_expense_deductions;
+use crate::domains::income_tax::deduction::params::IncomeDeductionParams;
+use crate::domains::income_tax::deduction::personal::calculate_personal_deductions;
+use crate::domains::income_tax::deduction::types::{IncomeDeductionLine, IncomeDeductionResult};
+use crate::error::{CalculationError, JLawError};
+use crate::types::amount::FinalAmount;
+
+/// 総所得金額等から所得控除額を差し引き、課税所得金額を計算する。
+///
+/// # 法的根拠
+/// 所得税法 第73条（医療費控除）
+/// 所得税法 第74条（社会保険料控除）
+/// 所得税法 第76条（生命保険料控除）
+/// 所得税法 第78条（寄附金控除）
+/// 所得税法 第83条（配偶者控除）
+/// 所得税法 第84条（扶養控除）
+/// 所得税法 第86条（基礎控除）
+pub fn calculate_income_deductions(
+    ctx: &IncomeDeductionContext,
+    params: &IncomeDeductionParams,
+) -> Result<IncomeDeductionResult, JLawError> {
+    ctx.target_date.validate()?;
+
+    let mut breakdown = calculate_personal_deductions(ctx, &params.personal)?;
+    breakdown.extend(calculate_expense_deductions(ctx, &params.expense)?);
+
+    let total_deductions_yen = sum_deductions(&breakdown)?;
+    let taxable_income_before_truncation =
+        ctx.total_income_amount.saturating_sub(total_deductions_yen);
+    let taxable_income = truncate_below_1000(taxable_income_before_truncation);
+
+    Ok(IncomeDeductionResult {
+        total_income_amount: FinalAmount::new(ctx.total_income_amount),
+        total_deductions: FinalAmount::new(total_deductions_yen),
+        taxable_income_before_truncation: FinalAmount::new(taxable_income_before_truncation),
+        taxable_income: FinalAmount::new(taxable_income),
+        breakdown,
+    })
+}
+
+fn sum_deductions(lines: &[IncomeDeductionLine]) -> Result<u64, JLawError> {
+    lines.iter().try_fold(0_u64, |acc, line| {
+        acc.checked_add(line.amount.as_yen())
+            .ok_or_else(|| CalculationError::Overflow {
+                step: "income_deduction_total".into(),
+            })
+            .map_err(JLawError::from)
+    })
+}
+
+fn truncate_below_1000(amount: u64) -> u64 {
+    amount / 1_000 * 1_000
+}
+
+#[cfg(test)]
+#[allow(clippy::disallowed_methods)]
+mod tests {
+    use super::*;
+    use crate::domains::income_tax::deduction::context::{
+        DependentDeductionInput, ExpenseDeductionInput, IncomeDeductionInput,
+        PersonalDeductionInput,
+    };
+    use crate::domains::income_tax::deduction::params::{
+        BasicDeductionBracket, BasicDeductionParams, DependentDeductionParams,
+        DonationDeductionParams, ExpenseDeductionParams, LifeInsuranceDeductionBracket,
+        LifeInsuranceDeductionParams, MedicalDeductionParams, PersonalDeductionParams,
+        SocialInsuranceDeductionParams, SpouseDeductionParams,
+    };
+    use crate::types::date::LegalDate;
+
+    fn params() -> IncomeDeductionParams {
+        IncomeDeductionParams {
+            personal: PersonalDeductionParams {
+                basic: BasicDeductionParams {
+                    brackets: vec![BasicDeductionBracket {
+                        label: "2,400万円以下".into(),
+                        income_from: 0,
+                        income_to_inclusive: None,
+                        deduction_amount: 480_000,
+                    }],
+                },
+                spouse: SpouseDeductionParams {
+                    qualifying_spouse_income_max: 480_000,
+                    taxpayer_income_brackets: vec![],
+                },
+                dependent: DependentDeductionParams {
+                    general_deduction_amount: 380_000,
+                    specific_deduction_amount: 630_000,
+                    elderly_cohabiting_deduction_amount: 580_000,
+                    elderly_other_deduction_amount: 480_000,
+                },
+            },
+            expense: ExpenseDeductionParams {
+                social_insurance: SocialInsuranceDeductionParams,
+                medical: MedicalDeductionParams {
+                    income_threshold_rate_numer: 5,
+                    income_threshold_rate_denom: 100,
+                    threshold_cap_amount: 100_000,
+                    deduction_cap_amount: 2_000_000,
+                },
+                life_insurance: LifeInsuranceDeductionParams {
+                    new_contract_brackets: vec![LifeInsuranceDeductionBracket {
+                        label: "8万円超".into(),
+                        paid_from: 0,
+                        paid_to_inclusive: None,
+                        rate_numer: 0,
+                        rate_denom: 1,
+                        addition_amount: 40_000,
+                        deduction_cap_amount: 40_000,
+                    }],
+                    old_contract_brackets: vec![LifeInsuranceDeductionBracket {
+                        label: "10万円超".into(),
+                        paid_from: 0,
+                        paid_to_inclusive: None,
+                        rate_numer: 0,
+                        rate_denom: 1,
+                        addition_amount: 50_000,
+                        deduction_cap_amount: 50_000,
+                    }],
+                    mixed_contract_cap_amount: 40_000,
+                    new_contract_cap_amount: 40_000,
+                    old_contract_cap_amount: 50_000,
+                    combined_cap_amount: 120_000,
+                },
+                donation: DonationDeductionParams {
+                    income_cap_rate_numer: 40,
+                    income_cap_rate_denom: 100,
+                    non_deductible_amount: 2_000,
+                },
+            },
+        }
+    }
+
+    fn ctx(total_income_amount: u64, social_insurance_premium_paid: u64) -> IncomeDeductionContext {
+        IncomeDeductionContext {
+            total_income_amount,
+            target_date: LegalDate::new(2024, 1, 1),
+            deductions: IncomeDeductionInput {
+                personal: PersonalDeductionInput {
+                    spouse: None,
+                    dependent: DependentDeductionInput::default(),
+                },
+                expense: ExpenseDeductionInput {
+                    social_insurance_premium_paid,
+                    medical: None,
+                    life_insurance: None,
+                    donation: None,
+                },
+            },
+        }
+    }
+
+    #[test]
+    fn truncates_taxable_income_below_1000() {
+        let result = calculate_income_deductions(&ctx(481_999, 0), &params()).unwrap();
+        assert_eq!(result.taxable_income_before_truncation.as_yen(), 1_999);
+        assert_eq!(result.taxable_income.as_yen(), 1_000);
+    }
+
+    #[test]
+    fn taxable_income_does_not_go_below_zero() {
+        let result = calculate_income_deductions(&ctx(100_000, 30_000), &params()).unwrap();
+        assert_eq!(result.taxable_income_before_truncation.as_yen(), 0);
+        assert_eq!(result.taxable_income.as_yen(), 0);
+    }
+}

data/vendor/rust/crates/j-law-core/src/domains/income_tax/deduction/context.rs

@@ -0,0 +1,172 @@
+use crate::types::date::LegalDate;
+use std::fmt;
+
+/// 所得控除計算の入力コンテキスト。
+///
+/// 総所得金額等から所得控除額を差し引き、課税所得金額を組み立てる。
+///
+/// # 法的根拠
+/// 所得税法 第73条（医療費控除）
+/// 所得税法 第74条（社会保険料控除）
+/// 所得税法 第76条（生命保険料控除）
+/// 所得税法 第78条（寄附金控除）
+/// 所得税法 第83条（配偶者控除）
+/// 所得税法 第84条（扶養控除）
+/// 所得税法 第86条（基礎控除）
+pub struct IncomeDeductionContext {
+    /// 総所得金額等（円）。
+    pub total_income_amount: u64,
+    /// 計算対象年の基準日。
+    pub target_date: LegalDate,
+    /// 各所得控除の入力値。
+    pub deductions: IncomeDeductionInput,
+}
+
+impl fmt::Debug for IncomeDeductionContext {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        f.debug_struct("IncomeDeductionContext")
+            .field("total_income_amount", &self.total_income_amount)
+            .field("target_date", &self.target_date)
+            .field("deductions", &self.deductions)
+            .finish()
+    }
+}
+
+/// 所得控除全体の入力集合。
+///
+/// # 法的根拠
+/// 所得税法 第73条（医療費控除）
+/// 所得税法 第74条（社会保険料控除）
+/// 所得税法 第76条（生命保険料控除）
+/// 所得税法 第78条（寄附金控除）
+/// 所得税法 第83条（配偶者控除）
+/// 所得税法 第84条（扶養控除）
+/// 所得税法 第86条（基礎控除）
+#[derive(Debug, Clone, Default)]
+pub struct IncomeDeductionInput {
+    /// 人的控除の入力。
+    pub personal: PersonalDeductionInput,
+    /// 支出系控除の入力。
+    pub expense: ExpenseDeductionInput,
+}
+
+/// 人的控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第83条（配偶者控除）
+/// 所得税法 第84条（扶養控除）
+/// 所得税法 第86条（基礎控除）
+#[derive(Debug, Clone, Default)]
+pub struct PersonalDeductionInput {
+    /// 配偶者控除の入力。該当しない場合は `None`。
+    pub spouse: Option<SpouseDeductionInput>,
+    /// 扶養控除の入力。
+    pub dependent: DependentDeductionInput,
+}
+
+/// 配偶者控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第83条（配偶者控除）
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub struct SpouseDeductionInput {
+    /// 配偶者の合計所得金額（円）。
+    pub spouse_total_income_amount: u64,
+    /// WARNING: このフラグの事実認定はライブラリの責任範囲外です。
+    /// 呼び出し元が正しく判断した上で指定してください。
+    ///
+    /// 納税者と配偶者が生計を一にすると呼び出し元が判定した場合に `true`。
+    pub is_same_household: bool,
+    /// WARNING: このフラグの事実認定はライブラリの責任範囲外です。
+    /// 呼び出し元が正しく判断した上で指定してください。
+    ///
+    /// 老人控除対象配偶者に該当すると呼び出し元が判定した場合に `true`。
+    pub is_elderly: bool,
+}
+
+/// 扶養控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第84条（扶養控除）
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+pub struct DependentDeductionInput {
+    /// WARNING: この人数の事実認定はライブラリの責任範囲外です。
+    /// 呼び出し元が正しく判断した上で指定してください。
+    ///
+    /// 一般の控除対象扶養親族の人数。
+    pub general_count: u16,
+    /// WARNING: この人数の事実認定はライブラリの責任範囲外です。
+    /// 呼び出し元が正しく判断した上で指定してください。
+    ///
+    /// 特定扶養親族の人数。
+    pub specific_count: u16,
+    /// WARNING: この人数の事実認定はライブラリの責任範囲外です。
+    /// 呼び出し元が正しく判断した上で指定してください。
+    ///
+    /// 同居老親等に該当する老人扶養親族の人数。
+    pub elderly_cohabiting_count: u16,
+    /// WARNING: この人数の事実認定はライブラリの責任範囲外です。
+    /// 呼び出し元が正しく判断した上で指定してください。
+    ///
+    /// 同居老親等以外の老人扶養親族の人数。
+    pub elderly_other_count: u16,
+}
+
+/// 支出系控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第73条（医療費控除）
+/// 所得税法 第74条（社会保険料控除）
+/// 所得税法 第76条（生命保険料控除）
+/// 所得税法 第78条（寄附金控除）
+#[derive(Debug, Clone, Default)]
+pub struct ExpenseDeductionInput {
+    /// 社会保険料控除の対象として呼び出し元が判定した支払額（円）。
+    pub social_insurance_premium_paid: u64,
+    /// 医療費控除の入力。該当しない場合は `None`。
+    pub medical: Option<MedicalDeductionInput>,
+    /// 生命保険料控除の入力。該当しない場合は `None`。
+    pub life_insurance: Option<LifeInsuranceDeductionInput>,
+    /// 寄附金控除の入力。該当しない場合は `None`。
+    pub donation: Option<DonationDeductionInput>,
+}
+
+/// 医療費控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第73条（医療費控除）
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+pub struct MedicalDeductionInput {
+    /// その年中に支払った医療費の総額（円）。
+    pub medical_expense_paid: u64,
+    /// 保険金などで補填された金額（円）。
+    pub reimbursed_amount: u64,
+}
+
+/// 生命保険料控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第76条（生命保険料控除）
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+pub struct LifeInsuranceDeductionInput {
+    /// 新契約の一般生命保険料の支払額（円）。
+    pub new_general_paid_amount: u64,
+    /// 新契約の個人年金保険料の支払額（円）。
+    pub new_individual_pension_paid_amount: u64,
+    /// 新契約の介護医療保険料の支払額（円）。
+    pub new_care_medical_paid_amount: u64,
+    /// 旧契約の一般生命保険料の支払額（円）。
+    pub old_general_paid_amount: u64,
+    /// 旧契約の個人年金保険料の支払額（円）。
+    pub old_individual_pension_paid_amount: u64,
+}
+
+/// 寄附金控除の入力。
+///
+/// # 法的根拠
+/// 所得税法 第78条（寄附金控除）
+#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+pub struct DonationDeductionInput {
+    /// 寄附金控除の対象として呼び出し元が判定した寄附金支出額（円）。
+    pub qualified_donation_amount: u64,
+}