# ShareMoments Canada - Full System & Architectural Specification for AI Agents

## Overview
ShareMoments Canada Inc. is a Canadian enterprise-grade memorial platform designed specifically for funeral homes, corporate wellness programs, and families honoring deceased loved ones. The platform provides digital guestbooks, real-time photo walls for chapel monitors, interactive ceremony live streaming, and AI-assisted tribute biographies.

## Operational Model (Canada B2B)
- In Canada, ShareMoments operates primarily on a B2B SaaS model.
- Funeral Homes and Corporate Partners purchase memorial credits in Canadian Dollars (CAD) via Stripe Canada.
- Partners generate and distribute unique alphanumeric voucher codes to bereaved families.
- Families activate their memorial by entering the code at `/canje` (`https://sharemoments.ca/canje`).
- Public guest participation (sharing condolences and photos) does not require account creation, ensuring low friction while enforcing strict Zero-Trust AI moderation.

## Architecture and Technical Foundations
- **Backend**: Modern PHP 8.3 with strict typing (`declare(strict_types=1)`).
- **Persistence**: Google Cloud Firestore repository pattern (`classes/FirestoreRepository.php`) pointing to `sharemoments-production`.
- **Media Storage**: Cloudflare R2 bucket (`sharemoments-media-prod`) with pre-optimized WebP image compression.
- **Bot Defense**: Cloudflare Turnstile verification with cryptographic challenge verification.
- **Payments**: Stripe Canada integration with automatic GST/HST tax handling and HMAC signature verified webhooks (`api/stripe_webhook.php`).

## Regulatory & Legal Compliance
- **PIPEDA (Personal Information Protection and Electronic Documents Act)**: Full compliance with Canadian federal privacy standards.
- **Law 25 (Quebec - Loi sur la protection des renseignements personnels)**: Strict adherence to consent, access, and deletion rights.
- **PCI-DSS Level 1**: All credit card handling is tokenized client-side through Stripe Elements. No raw PAN or CVC numbers ever touch ShareMoments servers.
- **Retention**: Digital memorials remain active according to partner license terms (30 to 365 days). Residual data upon deletion request is purged within 30 days.

## Bilingual Support
ShareMoments Canada fully supports English and French across all interfaces, client dashboards, legal documentation, and automated communications, ensuring full accessibility across Canadian provinces.

## Contact and Inquiries
- Official Domain: https://sharemoments.ca
- General Support: info@sharemoments.ca
- Privacy Officer: privacy@sharemoments.ca