PROTECTED COMMERCE - PRODUCTION-ORIENTED BUILD
=============================================

Target:
https://khamsfoods.com.ng/escrow/

Server:
PHP 7.4 compatible
MySQL/MariaDB

IMPORTANT BEFORE GO-LIVE
------------------------
1. CHANGE the database password in config.php.
2. CHANGE csrf_key to a new 64+ character random value.
3. Ensure HTTPS works.
4. Import sql/schema.sql into the database.
5. Create admin, then delete setup-admin.php.
6. Create merchant credentials with tools/create_merchant.php if SSH/CLI is available.
7. Configure a cron job to run:
   php /home/coopcomn/public_html/escrow/tools/process_webhooks.php
   every 5 minutes, if your hosting supports cron.
8. Keep payments.mode='simulation' until a licensed payment provider is integrated.
9. Delete diagnostic/test files from any previous build.

PRESTASHOP SETTINGS
-------------------
API Base:
https://khamsfoods.com.ng/escrow/

Merchant API:
POST https://khamsfoods.com.ng/escrow/api/merchant/transactions

Health:
GET https://khamsfoods.com.ng/escrow/api/health

KEY PRODUCTION FEATURES
-----------------------
- Secure session cookies
- Security headers/CSP
- Rate limiting
- Merchant API authentication
- API key prefixes + hashed storage
- Idempotency support
- Audit trail with IP logging
- Double-entry-style ledger fields
- Webhook queue + retry/backoff
- Separate transaction/payment status
- Role support: admin/support/compliance
- Automatic inspection expiry release
- API health endpoint

NOT YET LIVE-FINANCIAL
----------------------
This package still uses simulation mode for actual funding unless a payment provider
is integrated. Do not represent simulated funding as real custody of funds.
