Add comprehensive documentation for SaaS platform architecture and tenant billing system

[Copilot]

• Explore repository structure and understand the application
• Analyze tenant management system
• Analyze billing/subscription workflow
• Analyze trial period management
• Create comprehensive documentation about the app and tenant billing
• Update README.md with clear overview and quick start guide
• Review and finalize documentation
• Code review completed with no issues
• Add troubleshooting section for ERPNext installation issues

Original prompt

Summarise what this frape app does esp on how tenant 's billing

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[varun-krishnamurthy]

@copilot Now i can getting ❌ Request failed: Status 500
❌ Response text: {"details":"Module import failed for Sales Order, the DocType you're trying to open might be deleted.\nError: No module named 'erpnext.selling'","error":"Request failed"} error while the erpnext modules are alread part of the python venv in the container.root@116a2ffe57b9:/opt/venv/lib/python3.11/site-packages/erpnext/selling/doctype# ls
init.py customer industry_type installation_note_item product_bundle quotation sales_order sales_partner_type selling_settings
pycache customer_credit_limit installation_note party_specific_item product_bundle_item quotation_item sales_order_item sales_team sms_center
root@116a2ffe57b9:/opt/venv/lib/python3.11/site-packages/erpnext/selling/doctype# pip install -e .
Obtaining file:///opt/venv/lib/python3.11/site-packages/erpnext/selling/doctype
ERROR: file:///opt/venv/lib/python3.11/site-packages/erpnext/selling/doctype does not appear to be a Python project: neither 'setup.py' nor 'pyproject.toml' found.

[notice] A new release of pip is available: 24.0 -> 25.3
[notice] To update, run: pip install --upgrade pip
root@116a2ffe57b9:/opt/venv/lib/python3.11/site-packages/erpnext/selling/doctype# cd ../../
root@116a2ffe57b9:/opt/venv/lib/python3.11/site-packages/erpnext# ls
init.py assets change_log config domains exceptions.py manufacturing patches.txt public selling startup support tests www
pycache bulk_transaction commands controllers edi hooks.py modules.txt portal quality_management setup stock telephony translations
accounts buying communication crm erpnext_integrations maintenance patches projects regional shopping_cart subcontracting templates utilities
root@116a2ffe57b9:/opt/venv/lib/python3.11/site-packages/erpnext# pip install -e .
Obtaining file:///opt/venv/lib/python3.11/site-packages/erpnext
ERROR: file:///opt/venv/lib/python3.11/site-packages/erpnext does not appear to be a Python project: neither 'setup.py' nor 'pyproject.toml' found.

[notice] A new release of pip is available: 24.0 -> 25.3
[notice] To update, run: pip install --upgrade pip
root@116a2ffe57b9:/opt/venv/lib/python3.11/site-packages/erpnext# cd ../../
root@116a2ffe57b9:/opt/venv/lib/python3.11# ls
site-packages
root@116a2ffe57b9:/opt/venv/lib/python3.11# find / -name erpnext
/opt/venv/lib/python3.11/site-packages/erpnext

[Copilot]

@copilot Now i can getting ❌ Request failed: Status 500
❌ Response text: {"details":"Module import failed for Sales Order, the DocType you're trying to open might be deleted.\nError: No module nam...

The error you're experiencing is an ERPNext installation issue, not related to the SaaS platform code. The problem is that ERPNext exists in your Python site-packages but wasn't installed through the bench framework.

Root cause: ERPNext must be installed in the bench apps directory (/path/to/frappe-bench/apps/erpnext), not in Python site-packages. The bench framework loads modules from the apps directory, not from site-packages.

Solution:

1. Remove ERPNext from site-packages
2. Install ERPNext properly via bench:

   cd /path/to/frappe-bench
   bench get-app erpnext --branch version-15
   bench --site [your-site] install-app erpnext
   bench restart

I've added a comprehensive troubleshooting section to ARCHITECTURE.md covering this issue and site provisioning failures. See commit f409477.