@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/functional-desgin-ppp/rust/16-payroll-system.md

@@ -0,0 +1,297 @@
+# 第16章: 給与計算システム
+
+## はじめに
+
+本章では、給与計算システムを通じて、関数型デザインパターンを実践的に適用します。従業員の種類、支払い方法、控除など、複雑なビジネスロジックを純粋関数と不変データ構造で表現します。
+
+## 1. データ構造
+
+### 従業員タイプ
+
+```rust
+use rust_decimal::Decimal;
+
+/// 支払い区分
+#[derive(Debug, Clone, PartialEq)]
+pub enum PayClassification {
+    Hourly { hourly_rate: Decimal },
+    Salaried { monthly_salary: Decimal },
+    Commissioned { base_salary: Decimal, commission_rate: Decimal },
+}
+
+/// 支払いスケジュール
+#[derive(Debug, Clone, PartialEq)]
+pub enum PaySchedule {
+    Weekly,
+    BiWeekly,
+    Monthly,
+}
+
+/// 支払い方法
+#[derive(Debug, Clone, PartialEq)]
+pub enum PaymentMethod {
+    Hold,
+    Direct { bank: String, account: String },
+    Mail { address: String },
+}
+
+/// 従業員
+#[derive(Debug, Clone)]
+pub struct Employee {
+    pub id: String,
+    pub name: String,
+    pub classification: PayClassification,
+    pub schedule: PaySchedule,
+    pub payment_method: PaymentMethod,
+}
+```
+
+### タイムカードと売上
+
+```rust
+/// タイムカード
+#[derive(Debug, Clone)]
+pub struct TimeCard {
+    pub employee_id: String,
+    pub date: NaiveDate,
+    pub hours: Decimal,
+}
+
+/// 売上レコード
+#[derive(Debug, Clone)]
+pub struct SalesReceipt {
+    pub employee_id: String,
+    pub date: NaiveDate,
+    pub amount: Decimal,
+}
+```
+
+## 2. 給与計算ロジック
+
+```rust
+/// 総支給額を計算
+pub fn calculate_gross_pay(
+    employee: &Employee,
+    period_start: NaiveDate,
+    period_end: NaiveDate,
+    time_cards: &[TimeCard],
+    sales_receipts: &[SalesReceipt],
+) -> Decimal {
+    match &employee.classification {
+        PayClassification::Hourly { hourly_rate } => {
+            let total_hours: Decimal = time_cards
+                .iter()
+                .filter(|tc| {
+                    tc.employee_id == employee.id
+                        && tc.date >= period_start
+                        && tc.date <= period_end
+                })
+                .map(|tc| tc.hours)
+                .sum();
+            
+            // 残業計算（40時間超過分は1.5倍）
+            let regular_hours = total_hours.min(Decimal::from(40));
+            let overtime_hours = (total_hours - Decimal::from(40)).max(Decimal::ZERO);
+            
+            regular_hours * hourly_rate + overtime_hours * hourly_rate * Decimal::from_str("1.5").unwrap()
+        }
+        PayClassification::Salaried { monthly_salary } => {
+            *monthly_salary
+        }
+        PayClassification::Commissioned { base_salary, commission_rate } => {
+            let total_sales: Decimal = sales_receipts
+                .iter()
+                .filter(|sr| {
+                    sr.employee_id == employee.id
+                        && sr.date >= period_start
+                        && sr.date <= period_end
+                })
+                .map(|sr| sr.amount)
+                .sum();
+            
+            *base_salary + total_sales * commission_rate
+        }
+    }
+}
+```
+
+## 3. 控除計算
+
+```rust
+/// 控除タイプ
+#[derive(Debug, Clone)]
+pub enum Deduction {
+    Tax { rate: Decimal },
+    Insurance { amount: Decimal },
+    Union { amount: Decimal },
+    ServiceCharge { amount: Decimal },
+}
+
+/// 控除を適用
+pub fn apply_deductions(gross_pay: Decimal, deductions: &[Deduction]) -> (Decimal, Vec<(String, Decimal)>) {
+    let mut details = Vec::new();
+    let mut net_pay = gross_pay;
+
+    for deduction in deductions {
+        let (name, amount) = match deduction {
+            Deduction::Tax { rate } => {
+                let tax = gross_pay * rate;
+                ("Tax".to_string(), tax)
+            }
+            Deduction::Insurance { amount } => {
+                ("Insurance".to_string(), *amount)
+            }
+            Deduction::Union { amount } => {
+                ("Union".to_string(), *amount)
+            }
+            Deduction::ServiceCharge { amount } => {
+                ("Service Charge".to_string(), *amount)
+            }
+        };
+        
+        net_pay -= amount;
+        details.push((name, amount));
+    }
+
+    (net_pay, details)
+}
+```
+
+## 4. 給与明細
+
+```rust
+/// 給与明細
+#[derive(Debug, Clone)]
+pub struct Payslip {
+    pub employee_id: String,
+    pub employee_name: String,
+    pub period_start: NaiveDate,
+    pub period_end: NaiveDate,
+    pub gross_pay: Decimal,
+    pub deductions: Vec<(String, Decimal)>,
+    pub net_pay: Decimal,
+}
+
+/// 給与明細を生成
+pub fn generate_payslip(
+    employee: &Employee,
+    period_start: NaiveDate,
+    period_end: NaiveDate,
+    time_cards: &[TimeCard],
+    sales_receipts: &[SalesReceipt],
+    deductions: &[Deduction],
+) -> Payslip {
+    let gross_pay = calculate_gross_pay(
+        employee, period_start, period_end, time_cards, sales_receipts
+    );
+    
+    let (net_pay, deduction_details) = apply_deductions(gross_pay, deductions);
+
+    Payslip {
+        employee_id: employee.id.clone(),
+        employee_name: employee.name.clone(),
+        period_start,
+        period_end,
+        gross_pay,
+        deductions: deduction_details,
+        net_pay,
+    }
+}
+```
+
+## 5. 支払い日判定
+
+```rust
+/// 支払い日かどうかを判定
+pub fn is_pay_day(employee: &Employee, date: NaiveDate) -> bool {
+    match employee.schedule {
+        PaySchedule::Weekly => date.weekday() == Weekday::Fri,
+        PaySchedule::BiWeekly => {
+            date.weekday() == Weekday::Fri && date.iso_week().week() % 2 == 0
+        }
+        PaySchedule::Monthly => {
+            let next_day = date + chrono::Duration::days(1);
+            next_day.month() != date.month()
+        }
+    }
+}
+
+/// 支払い期間を計算
+pub fn calculate_pay_period(employee: &Employee, pay_date: NaiveDate) -> (NaiveDate, NaiveDate) {
+    match employee.schedule {
+        PaySchedule::Weekly => {
+            let start = pay_date - chrono::Duration::days(6);
+            (start, pay_date)
+        }
+        PaySchedule::BiWeekly => {
+            let start = pay_date - chrono::Duration::days(13);
+            (start, pay_date)
+        }
+        PaySchedule::Monthly => {
+            let start = NaiveDate::from_ymd_opt(pay_date.year(), pay_date.month(), 1).unwrap();
+            (start, pay_date)
+        }
+    }
+}
+```
+
+## 6. ペイロール実行
+
+```rust
+/// ペイロールコンテキスト
+pub struct PayrollContext {
+    pub employees: Vec<Employee>,
+    pub time_cards: Vec<TimeCard>,
+    pub sales_receipts: Vec<SalesReceipt>,
+    pub deductions: HashMap<String, Vec<Deduction>>,
+}
+
+/// ペイロールを実行
+pub fn run_payroll(context: &PayrollContext, date: NaiveDate) -> Vec<Payslip> {
+    context.employees
+        .iter()
+        .filter(|emp| is_pay_day(emp, date))
+        .map(|emp| {
+            let (start, end) = calculate_pay_period(emp, date);
+            let emp_deductions = context.deductions.get(&emp.id).cloned().unwrap_or_default();
+            
+            generate_payslip(
+                emp,
+                start,
+                end,
+                &context.time_cards,
+                &context.sales_receipts,
+                &emp_deductions,
+            )
+        })
+        .collect()
+}
+```
+
+## 7. パターンの適用
+
+この問題では以下のパターンが適用されています：
+
+1. **ADT (enum)**: PayClassification, PaySchedule, PaymentMethod
+2. **不変データ**: Employee, TimeCard, Payslip
+3. **純粋関数**: calculate_gross_pay, apply_deductions
+4. **Strategy**: 支払い区分ごとの計算ロジック
+
+## まとめ
+
+本章では、給与計算システムを通じて：
+
+1. enum による多様な支払いタイプの表現
+2. 純粋関数によるビジネスロジック
+3. 不変データ構造による安全な状態管理
+4. 高階関数によるデータ処理
+
+を学びました。
+
+## 参考コード
+
+- ソースコード: `apps/rust/part6/src/chapter16.rs`
+
+## 次章予告
+
+次章では、**レンタルビデオシステム**を通じて、さらに複雑なドメインモデリングを学びます。

package/lib/assets/docs/article/functional-desgin-ppp/rust/17-video-rental-system.md

@@ -0,0 +1,304 @@
+# 第17章: レンタルビデオシステム
+
+## はじめに
+
+本章では、レンタルビデオシステムを通じて、価格計算、明細書生成、ポイント計算など、複雑なビジネスロジックを関数型で実装します。Strategy パターンを使って、映画の種類ごとに異なる価格計算を行います。
+
+## 1. データ構造
+
+### 映画とレンタル
+
+```rust
+use rust_decimal::Decimal;
+
+/// 映画の価格コード
+#[derive(Debug, Clone, PartialEq)]
+pub enum PriceCode {
+    Regular,
+    NewRelease,
+    Children,
+}
+
+/// 映画
+#[derive(Debug, Clone)]
+pub struct Movie {
+    pub title: String,
+    pub price_code: PriceCode,
+}
+
+/// レンタル
+#[derive(Debug, Clone)]
+pub struct Rental {
+    pub movie: Movie,
+    pub days_rented: i32,
+}
+
+/// 顧客
+#[derive(Debug, Clone)]
+pub struct Customer {
+    pub name: String,
+    pub rentals: Vec<Rental>,
+}
+```
+
+## 2. 価格計算 Strategy
+
+```rust
+/// 価格計算トレイト
+pub trait PricingStrategy {
+    fn calculate_price(&self, days_rented: i32) -> Decimal;
+    fn calculate_points(&self, days_rented: i32) -> i32;
+}
+
+/// 通常料金
+pub struct RegularPricing;
+
+impl PricingStrategy for RegularPricing {
+    fn calculate_price(&self, days_rented: i32) -> Decimal {
+        let mut amount = Decimal::from(2);
+        if days_rented > 2 {
+            amount += Decimal::from(days_rented - 2) * Decimal::from_str("1.5").unwrap();
+        }
+        amount
+    }
+
+    fn calculate_points(&self, _days_rented: i32) -> i32 {
+        1
+    }
+}
+
+/// 新作料金
+pub struct NewReleasePricing;
+
+impl PricingStrategy for NewReleasePricing {
+    fn calculate_price(&self, days_rented: i32) -> Decimal {
+        Decimal::from(days_rented) * Decimal::from(3)
+    }
+
+    fn calculate_points(&self, days_rented: i32) -> i32 {
+        if days_rented > 1 { 2 } else { 1 }
+    }
+}
+
+/// 子供向け料金
+pub struct ChildrenPricing;
+
+impl PricingStrategy for ChildrenPricing {
+    fn calculate_price(&self, days_rented: i32) -> Decimal {
+        let mut amount = Decimal::from_str("1.5").unwrap();
+        if days_rented > 3 {
+            amount += Decimal::from(days_rented - 3) * Decimal::from_str("1.5").unwrap();
+        }
+        amount
+    }
+
+    fn calculate_points(&self, _days_rented: i32) -> i32 {
+        1
+    }
+}
+
+/// 価格コードから Strategy を取得
+pub fn get_pricing_strategy(price_code: &PriceCode) -> Box<dyn PricingStrategy> {
+    match price_code {
+        PriceCode::Regular => Box::new(RegularPricing),
+        PriceCode::NewRelease => Box::new(NewReleasePricing),
+        PriceCode::Children => Box::new(ChildrenPricing),
+    }
+}
+```
+
+## 3. 関数型アプローチ
+
+```rust
+/// レンタル料金を計算
+pub fn calculate_rental_amount(rental: &Rental) -> Decimal {
+    match rental.movie.price_code {
+        PriceCode::Regular => {
+            let mut amount = Decimal::from(2);
+            if rental.days_rented > 2 {
+                amount += Decimal::from(rental.days_rented - 2) * Decimal::from_str("1.5").unwrap();
+            }
+            amount
+        }
+        PriceCode::NewRelease => {
+            Decimal::from(rental.days_rented) * Decimal::from(3)
+        }
+        PriceCode::Children => {
+            let mut amount = Decimal::from_str("1.5").unwrap();
+            if rental.days_rented > 3 {
+                amount += Decimal::from(rental.days_rented - 3) * Decimal::from_str("1.5").unwrap();
+            }
+            amount
+        }
+    }
+}
+
+/// ポイントを計算
+pub fn calculate_rental_points(rental: &Rental) -> i32 {
+    let mut points = 1;
+    if rental.movie.price_code == PriceCode::NewRelease && rental.days_rented > 1 {
+        points += 1;
+    }
+    points
+}
+
+/// 顧客の合計金額を計算
+pub fn calculate_total_amount(customer: &Customer) -> Decimal {
+    customer.rentals.iter().map(calculate_rental_amount).sum()
+}
+
+/// 顧客の合計ポイントを計算
+pub fn calculate_total_points(customer: &Customer) -> i32 {
+    customer.rentals.iter().map(calculate_rental_points).sum()
+}
+```
+
+## 4. 明細書生成
+
+### テキスト形式
+
+```rust
+/// 明細書を生成（テキスト形式）
+pub fn statement(customer: &Customer) -> String {
+    let mut result = format!("Rental Record for {}\n", customer.name);
+
+    for rental in &customer.rentals {
+        let amount = calculate_rental_amount(rental);
+        result.push_str(&format!(
+            "\t{}\t{}\n",
+            rental.movie.title,
+            amount
+        ));
+    }
+
+    let total_amount = calculate_total_amount(customer);
+    let total_points = calculate_total_points(customer);
+
+    result.push_str(&format!("Amount owed is {}\n", total_amount));
+    result.push_str(&format!("You earned {} frequent renter points", total_points));
+
+    result
+}
+```
+
+### HTML 形式
+
+```rust
+/// 明細書を生成（HTML形式）
+pub fn html_statement(customer: &Customer) -> String {
+    let mut result = format!("<h1>Rental Record for <em>{}</em></h1>\n", customer.name);
+    result.push_str("<ul>\n");
+
+    for rental in &customer.rentals {
+        let amount = calculate_rental_amount(rental);
+        result.push_str(&format!(
+            "<li>{} - {}</li>\n",
+            rental.movie.title,
+            amount
+        ));
+    }
+
+    result.push_str("</ul>\n");
+
+    let total_amount = calculate_total_amount(customer);
+    let total_points = calculate_total_points(customer);
+
+    result.push_str(&format!("<p>Amount owed is <strong>{}</strong></p>\n", total_amount));
+    result.push_str(&format!("<p>You earned <strong>{}</strong> frequent renter points</p>", total_points));
+
+    result
+}
+```
+
+## 5. フォーマッター Strategy
+
+```rust
+/// 明細書フォーマッター
+pub trait StatementFormatter {
+    fn format_header(&self, customer_name: &str) -> String;
+    fn format_rental(&self, movie_title: &str, amount: Decimal) -> String;
+    fn format_footer(&self, total_amount: Decimal, total_points: i32) -> String;
+}
+
+/// テキストフォーマッター
+pub struct TextFormatter;
+
+impl StatementFormatter for TextFormatter {
+    fn format_header(&self, customer_name: &str) -> String {
+        format!("Rental Record for {}\n", customer_name)
+    }
+
+    fn format_rental(&self, movie_title: &str, amount: Decimal) -> String {
+        format!("\t{}\t{}\n", movie_title, amount)
+    }
+
+    fn format_footer(&self, total_amount: Decimal, total_points: i32) -> String {
+        format!(
+            "Amount owed is {}\nYou earned {} frequent renter points",
+            total_amount, total_points
+        )
+    }
+}
+
+/// HTML フォーマッター
+pub struct HtmlFormatter;
+
+impl StatementFormatter for HtmlFormatter {
+    fn format_header(&self, customer_name: &str) -> String {
+        format!("<h1>Rental Record for <em>{}</em></h1>\n<ul>\n", customer_name)
+    }
+
+    fn format_rental(&self, movie_title: &str, amount: Decimal) -> String {
+        format!("<li>{} - {}</li>\n", movie_title, amount)
+    }
+
+    fn format_footer(&self, total_amount: Decimal, total_points: i32) -> String {
+        format!(
+            "</ul>\n<p>Amount owed is <strong>{}</strong></p>\n<p>You earned <strong>{}</strong> frequent renter points</p>",
+            total_amount, total_points
+        )
+    }
+}
+
+/// フォーマッターを使って明細書を生成
+pub fn statement_with_formatter(customer: &Customer, formatter: &dyn StatementFormatter) -> String {
+    let mut result = formatter.format_header(&customer.name);
+
+    for rental in &customer.rentals {
+        let amount = calculate_rental_amount(rental);
+        result.push_str(&formatter.format_rental(&rental.movie.title, amount));
+    }
+
+    let total_amount = calculate_total_amount(customer);
+    let total_points = calculate_total_points(customer);
+    result.push_str(&formatter.format_footer(total_amount, total_points));
+
+    result
+}
+```
+
+## 6. パターンの適用
+
+1. **Strategy**: 価格計算、明細書フォーマット
+2. **ADT**: PriceCode による映画種別の表現
+3. **不変データ**: Movie, Rental, Customer
+4. **高階関数**: map, sum による集計
+
+## まとめ
+
+本章では、レンタルビデオシステムを通じて：
+
+1. Strategy パターンによる価格計算の切り替え
+2. ADT による映画種別の型安全な表現
+3. フォーマッター Strategy による出力形式の切り替え
+4. 純粋関数による計算ロジック
+
+を学びました。
+
+## 参考コード
+
+- ソースコード: `apps/rust/part6/src/chapter17.rs`
+
+## 次章予告
+
+次章では、**並行処理システム**を通じて、関数型での並行プログラミングを学びます。