Initial QuestionGraph library and documentation

2026-09-13 12:59:36 +10:00
commit 0879a3e786
48 changed files with 7712 additions and 0 deletions
@@ -0,0 +1,34 @@
+# Dokku hosting
+
+App: questiongraph
+Server: root@peterstockings.com
+Domain: questiongraph.peterstockings.com
+
+Run from PowerShell to deploy the current source:
+
+    ./scripts/deploy-dokku.ps1
+
+The script uploads an explicitly selected source archive and invokes Dokku's
+git:from-archive deployment. It does not use the parent Bitbucket git repository.
+SSH key access, scp, and tar are required. Small deployment archives are retained
+in the local and remote temporary directories for troubleshooting.
+
+The Docker build runs npm ci, tests, TypeScript validation, and Vite on Node 24.
+The runtime image serves dist with Nginx. Direct /docs links fall back to the SPA;
+missing assets/downloads return 404. The library ZIP is generated with every build.
+
+App setup (already performed on the server):
+
+    dokku apps:create questiongraph
+    dokku domains:set questiongraph questiongraph.peterstockings.com
+    dokku builder:set questiongraph selected dockerfile
+    dokku ports:set questiongraph http:80:80
+    dokku letsencrypt:enable questiongraph
+
+Check status:
+
+    ssh root@peterstockings.com "dokku ps:report questiongraph"
+    ssh root@peterstockings.com "dokku logs questiongraph --num 100"
+
+This hosts the demo and documentation publicly, including library source download.
+Draft saves and uploads in the demo remain mocks; no claims API/database is deployed.