Add FranchiseContract billing model for mirror-sale monthly settlements

[Copilot]

Introduces the FranchiseContract class to model the franchise economic contract per point of sale: fixed monthly license fee (€9,900), one-time entry fee (€100,000), and 5% variable commission on mirror sales, with EUR settlement and PCT/EP2025/067317 patent royalty inclusion.

Changes

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

  • Constructor accepts shop_id and optional tier (default "LUXURY_CARE")
  • calculate_monthly_settlement(total_mirror_sales) returns a structured settlement dict

• tests/test_franchise_contract.py — 14 unit tests covering init defaults, fee constants, commission math, and edge cases (zero sales, large volume)

Usage

from franchise_contract import FranchiseContract

contract = FranchiseContract("SHOP_001")
settlement = contract.calculate_monthly_settlement(10_000.0)
# {
#   "fixed_fee": 9900.0,
#   "variable_commission": 500.0,
#   "total_to_invoice": 10400.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 2:08pm