chore: bootstrap module from working instance and add install guide

README.md

@@ -0,0 +1,51 @@
+# Donations Module (MVP Scaffold)
+
+This module adds donation goal management and donation intent capture for HumHub spaces.
+
+## Current MVP Features
+
+- Space menu entry: **Donations**
+- Space settings page with:
+  - One-click **Run Donations Setup**
+  - PayPal and Stripe provider settings (including recurring toggles)
+  - Donation goal creation/edit/delete
+- Public donations page in each enabled space
+- Stripe checkout session creation for one-time and recurring donations
+- PayPal one-time order creation and approve redirect
+- PayPal recurring subscription creation and approve redirect
+- Stripe webhook processing for checkout completion and transaction state updates
+- PayPal webhook signature verification and event processing for capture/subscription updates
+- Donation intent creation and provider checkout metadata storage
+- Admin history page for transactions, subscriptions, and recent webhook events
+- Initial database schema for goals, transactions, subscriptions, webhook events, provider config, and blocks
+
+## Install / Update in Container
+
+```bash
+docker cp /tmp/humhub_rescue_modules/donations humhub:/var/www/localhost/htdocs/protected/modules/
+```
+
+## Apply Migrations
+
+```bash
+docker exec humhub php /var/www/localhost/htdocs/protected/yii migrate/up --migrationPath=/var/www/localhost/htdocs/protected/modules/donations/migrations --interactive=0
+```
+
+## Test Flow
+
+1. Enable module in a Space: `Space > Manage > Modules > Donations`.
+2. Open `Space > Settings > Donations`.
+3. Click **Run Donations Setup**.
+4. Enable at least one provider (PayPal or Stripe) and save.
+5. Create one or more donation goals.
+6. Configure your Stripe/PayPal credentials in settings.
+7. For Stripe, set webhook endpoint from Donations Settings (space-scoped URL), for example:
+  - `https://<your-host>/s/<space-url>/donations/donations/stripe-webhook`
+8. Open `Space > Donations` and submit a donation.
+9. Confirm rows are created/updated in `rescue_donation_transaction`.
+10. Use **Webhook Simulation Tools** in Donations Settings to validate Stripe/PayPal webhook processing locally.
+
+## Next Implementation Steps
+
+- Add stronger webhook secret resolution per space/site
+- Add admin reporting and transaction history UI