# SHiRE Dental licensing architecture

## Editions

- **SHiRE OS Module:** entitlement is supplied by the trusted SHiRE OS shell. No separate customer activation is shown.
- **Professional Standalone:** 14-day trial followed by activation or subscription entitlement.

## Included scaffold

`src/lib/license.js` provides installation identity, trial state, activation state and edition checks. The local activation-key parser exists only for development and demonstrations.

## Production activation service

A commercial release should add a SHiRE-controlled API with:

- account and organisation records;
- Stripe customer/subscription identifiers;
- signed short-lived entitlement tokens;
- device activation and deactivation limits;
- offline grace periods;
- revocation and refund handling;
- audit logging;
- webhook processing for checkout, renewal, cancellation, payment failure and refunds.

The browser or desktop client should contain only the public signature-verification key. Stripe secret keys and licence-signing private keys must remain server-side.
