feat: Add FranchiseContract class for monthly franchise settlement calculation

[Copilot]

Introduces FranchiseContract, the billing model for LUXURY_CARE-tier franchise points of sale, covering fixed license fee, one-time entry fee, and 5% variable commission on mirror sales.

Changes

• api/franchise_contract.py — new module with FranchiseContract:

  • license_fee = 9900.0 EUR/month per POS
  • entry_fee = 100000.0 EUR one-time implementation fee
  • variable_commission = 0.05 (5% on mirror sales)
  • calculate_monthly_settlement(total_mirror_sales) returns a settlement dict including patent royalty reference PCT/EP2025/067317

• tests/test_franchise_contract.py — 14 unit tests covering init defaults, commission math, zero-sales baseline, total calculation, and large-volume scenario

Usage

from franchise_contract import FranchiseContract

fc = FranchiseContract("SHOP_PARIS")
settlement = fc.calculate_monthly_settlement(total_mirror_sales=20_000.0)
# {
#   "fixed_fee": 9900.0,
#   "variable_commission": 1000.0,
#   "total_to_invoice": 10900.0,
#   "currency": "EUR",
#   "patent_royalty": "Included (PCT/EP2025/067317)"
# }

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
tryonyou-pilot	Error		Apr 7, 2026 1:54pm