From 717fcb9c81d2bc3cc7a84a3ebea6572d7ff0f5cf Mon Sep 17 00:00:00 2001
From: doc <doc@filenotfound.org>
Date: Mon, 30 Jun 2025 20:06:28 +0000
Subject: uploading documentation

---
 genesishosting/provisioning/checklist.md           | 23 ++++++++++++++++++++++
 .../provisioning/post-deploy-verification.md       | 22 +++++++++++++++++++++
 genesishosting/provisioning/whmcs-integration.md   | 23 ++++++++++++++++++++++
 3 files changed, 68 insertions(+)
 create mode 100644 genesishosting/provisioning/checklist.md
 create mode 100644 genesishosting/provisioning/post-deploy-verification.md
 create mode 100644 genesishosting/provisioning/whmcs-integration.md

(limited to 'genesishosting/provisioning')

diff --git a/genesishosting/provisioning/checklist.md b/genesishosting/provisioning/checklist.md
new file mode 100644
index 0000000..13741d3
--- /dev/null
+++ b/genesishosting/provisioning/checklist.md
@@ -0,0 +1,23 @@
+# Provisioning Checklist
+
+This checklist is followed every time a new service is deployed.
+
+## Pre-Provisioning
+
+- [ ] Verify order and payment in WHMCS
+- [ ] Confirm product mapping is correct
+- [ ] Check available server resources
+
+## Provisioning
+
+- [ ] Trigger appropriate script/module
+- [ ] Log provisioning result
+- [ ] Assign DNS entries if applicable
+- [ ] Generate Let’s Encrypt SSL if public-facing
+
+## Post-Provisioning
+
+- [ ] Send welcome email via WHMCS
+- [ ] Confirm monitoring alert is active
+- [ ] Test login credentials and endpoints
+- [ ] Label service with client ID in Grafana/Prometheus
diff --git a/genesishosting/provisioning/post-deploy-verification.md b/genesishosting/provisioning/post-deploy-verification.md
new file mode 100644
index 0000000..d46f727
--- /dev/null
+++ b/genesishosting/provisioning/post-deploy-verification.md
@@ -0,0 +1,22 @@
+# Post-Deployment Verification
+
+All services go through a post-deploy QA check to ensure they're live and stable.
+
+## Verification Tasks
+
+- [ ] Service reachable from public IP or internal route
+- [ ] DNS resolves correctly (for domains/subdomains)
+- [ ] SSL certificate is active and trusted
+- [ ] Admin login works as expected
+- [ ] Usage quotas correctly applied (disk, users, bandwidth)
+
+## Monitoring
+
+- [ ] Add to Prometheus for service-specific metrics
+- [ ] Set alert thresholds (e.g., disk > 80%)
+- [ ] Confirm Telegram/Mastodon alert webhook is functional
+
+## Documentation
+
+- [ ] Log final status in WHMCS admin notes
+- [ ] Store internal service details in `genesis-inventory.yaml`
diff --git a/genesishosting/provisioning/whmcs-integration.md b/genesishosting/provisioning/whmcs-integration.md
new file mode 100644
index 0000000..3f5663d
--- /dev/null
+++ b/genesishosting/provisioning/whmcs-integration.md
@@ -0,0 +1,23 @@
+# WHMCS Integration
+
+WHMCS handles client billing, service provisioning, and support workflows.
+
+## Services Integrated
+
+| Service      | Method                          |
+|--------------|---------------------------------|
+| DirectAdmin  | Built-in WHMCS module           |
+| AzuraCast    | Custom provisioning script       |
+| TeamTalk     | API + XML user patching scripts |
+
+## Auto-Provisioning Steps
+
+1. Client signs up and completes payment
+2. WHMCS triggers product-specific hook
+3. Script/module provisions the service
+4. Welcome email is sent with credentials
+
+## Logging & Troubleshooting
+
+- Logs stored at `/var/log/whmcs-hooks.log`
+- Errors generate internal ticket automatically if provisioning fails
-- 
cgit v1.2.3