J-Law-Core

日本法令計算の再現を試みる alpha / PoC ライブラリ（Rust / Python / JavaScript / Ruby / Go）

J-Law-Core は、設計・API・整数演算ベースの計算表現を検証するための OSS 向け alpha / PoC です。現時点では「選択した法令計算を再現する試み」であり、「実務投入できる完成済み法令計算基盤」を約束するものではありません。

より詳しい位置付け、非ゴール、品質シグナル、免責事項は プロジェクトステータスと免責 にまとめています。

J-Law-Core は、日本の法令・告示・省令が定める一部の計算を、整数演算と分数表現で再現することを目指すライブラリです。

• 金額計算で f64 / f32 を使わず、端数処理の順序を再現
• 法令パラメータを JSON registry として外部管理し、施行日ごとの差分を履歴管理
• Rust コアに加え、C ABI と Python / WASM / Ruby / Go バインディングを提供
• tests/fixtures/ の共通 JSON を使って複数言語で同じケースを検証

この表は「実装済みの PoC スコープ」を示すものであり、各法令の網羅的実装や実務上の完全性を意味しません。利用例と API 名の対応は docs/usage.md を参照してください。

Cargo workspace メンバーは j-law-core / j-law-registry / j-law-wasm / j-law-c-ffi です。

ここでいう「検証」は CI と公開ワークフロー上の技術的な動作確認を指します。法令適合性の認証、実務上の妥当性保証、サポート契約を意味するものではありません。

• プロジェクトステータスと免責
• 利用ガイド
• Python バインディング
• WASM / JavaScript バインディング
• Ruby バインディング
• Go バインディング
• 実装ルール

以下は API 形状の確認用サンプルです。実務利用前に、一次資料と自前のテストケースで必ず検証してください。

このクレートは crates.io に公開していないため、git 依存として利用してください。

[dependencies]
j-law-core = { git = "https://github.com/kmoyashi/j-law-core", tag = "v0.0.1" }
j-law-registry = { git = "https://github.com/kmoyashi/j-law-core", tag = "v0.0.1" }

このリポジトリを手元にクローン済みの場合は、ローカルパス参照も使えます。

[dependencies]
j-law-core = { path = "crates/j-law-core" }
j-law-registry = { path = "crates/j-law-registry" }

use std::collections::HashSet;

use j_law_core::domains::real_estate::{
    calculator::calculate_brokerage_fee,
    context::RealEstateContext,
    policy::StandardMlitPolicy,
};
use j_law_core::LegalDate;
use j_law_registry::load_brokerage_fee_params;

let date = LegalDate::new(2024, 8, 1);
let ctx = RealEstateContext {
    price: 5_000_000,
    target_date: date,
    flags: HashSet::new(),
    policy: Box::new(StandardMlitPolicy),
};

let params = load_brokerage_fee_params(date)?;
let result = calculate_brokerage_fee(&ctx, &params)?;

assert_eq!(result.total_with_tax.as_yen(), 231_000);

• Python: pip install j-law-python
• JavaScript / WASM: npm install j-law-wasm
• Ruby: gem install j_law_ruby
• Go: go get github.com/kmoyashi/j-law-core/crates/j-law-go（Windows 非対応）

ローカル checkout から直接試す場合は、各 binding README の開発手順を参照してください。公開 API 名の一覧は docs/usage.md にまとめています。

make ci

make docker-test

cargo test --workspace
pytest crates/j-law-python/tests/ -v
wasm-pack build --target nodejs crates/j-law-wasm
node --test crates/j-law-wasm/tests/*.test.mjs
cd crates/j-law-ruby && bundle exec rake test
cd crates/j-law-go && make test

• crates/j-law-core/src/ では f64 / f32 を使わない
• crates/j-law-core/src/ では panic! / unwrap() / expect() を使わない
• 公開 API には根拠条文を doc コメントで明記する
• 変更に対応するテストを追加し、提出前に make ci を通す
• 公開ドキュメントや package metadata では「法的正確性を保証」「本番利用可能」と断定しない
• ドメイン追加や registry 変更時は関連 binding / fixture / docs も更新する

詳細な実装ルールは AGENTS.md を参照してください。

本ライブラリは法的助言を提供するものではありません。計算結果は参考情報にすぎず、正確性、完全性、最新性、適法性、特定目的適合性を含む一切の保証を行いません。実際の手続き、税務申告、契約実務、社内業務フローに利用する場合は、一次資料と有資格者による確認を前提としてください。詳細は プロジェクトステータスと免責 を参照してください。

MIT License