# MetaSoul ERP — Buyer documentation

This folder is the **commercial documentation pack** for Codester buyers.

| Document | Description |
|----------|-------------|
| [INSTALL.md](INSTALL.md) | **Canonical install** — requirements, `app:install`, migrate, seeds, production checklist |
| [CONFIGURATION.md](CONFIGURATION.md) | Environment: mail, payments, Mapbox, reCAPTCHA, marketplaces, offline, Reverb |
| [ENV.md](ENV.md) | Advertised-feature env key checklist vs `.env.example` |
| [PERFORMANCE.md](PERFORMANCE.md) | Redis, Core pagination/eager-load notes, hot-path indexes |
| [FEATURES.md](FEATURES.md) | Honest Core / Lite / Demo Mode feature matrix |
| [UPLOADS.md](UPLOADS.md) | Allowed upload types (mime hardening) |
| [DEMO_MODE.md](DEMO_MODE.md) | Demo Mode / Simulated connectors + credentials notes |
| [LIVE_MONITORING.md](LIVE_MONITORING.md) | Privacy disclosure, admin-only access, public-demo disable |
| [SEEDING.md](SEEDING.md) | Staging vs FullDemo vs empty-like-live (H7 decision) |
| [ROUTES.md](ROUTES.md) | Route cache, workspace action aliases, test:phase1 memory |
| [DEMO.md](DEMO.md) | Demo accounts & seed profiles (`db:seed` vs `db:seed-full`) |
| [DEMO_HOST.md](DEMO_HOST.md) | Public preview host ops ([erp.metasoulbd.com](https://erp.metasoulbd.com)) |
| [DEMO_DEPLOY.md](DEMO_DEPLOY.md) | **Operator** redeploy + smoke (Phase 1 remaining) |
| [ROLES.md](ROLES.md) | Portal vs workspace + staff module ACL |
| [PAYMENTS.md](PAYMENTS.md) | Stripe / PayPal / Demo Mode |
| [UX_SMOKE.md](UX_SMOKE.md) | Responsive smoke checklist (shop, portal, Core apps) |
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | 500s, Vite assets, queues, migrations |
| [MIGRATIONS.md](MIGRATIONS.md) | Large migration tree, soft FKs, packaging notes |
| [UPDATE.md](UPDATE.md) | Applying a new package version |
| [BACKUP.md](BACKUP.md) | Database and file backups |
| [DISCLAIMER.md](DISCLAIMER.md) | Trademark / originality notice |

**Offline PDF pack:** [`../docs/marketplace/MetaSoul-ERP-Documentation.pdf`](../docs/marketplace/MetaSoul-ERP-Documentation.pdf) (generated from HTML via `php scripts/generate-marketplace-pdf.php`).  
**Marketplace support FAQ:** [`../docs/marketplace/SUPPORT_FAQ.md`](../docs/marketplace/SUPPORT_FAQ.md)

After install, open these files from the project root. On a running app, **buyer-safe** pages are at `/documentation` (disclaimer, features, roles, payments, …). Pages that list demo passwords or host env notes (`INSTALL`, `ENV`, `DEMO`, `DEMO_HOST`, `SEEDING`, …) require an **admin** session at `/documentation/{page}` — guests receive 404.

**Start here:** [INSTALL.md](INSTALL.md)