Upload files to "documents"

documents/05-production-deployment-and-recovery.md

@@ -0,0 +1,72 @@
+# AppFactory Production Deployment and Recovery Guide
+
+## Configuration
+
+Set before deployment:
+
+```bash
+CLEAR_USERS=true
+```
+
+Options:
+
+```bash
+CLEAR_USERS=true
+CLEAR_USERS=false
+```
+
+- true = delete users table, first Google login becomes admin
+- false = preserve users
+
+## Download
+
+```bash
+mkdir -p ~/Downloads
+cd ~/Downloads
+
+curl -L -o restore-appfactory.sh http://jiri-uhlir.eu/downloads/restore-appfactory.sh
+curl -L -o services.tar.gz http://jiri-uhlir.eu/downloads/services.tar.gz
+
+chmod +x restore-appfactory.sh
+```
+
+## Restore
+
+```bash
+sudo bash ./restore-appfactory.sh "$PWD/services.tar.gz" root 2>&1 | tee restore.log
+```
+
+## Optional user cleanup
+
+```bash
+DB="/opt/appfactory/data/appfactory/appfactory.db"
+
+if [ "$CLEAR_USERS" = "true" ]; then
+    cp "$DB" "$DB.before-users-clean-$(date +%Y%m%d-%H%M%S)"
+    sqlite3 "$DB" "delete from users;"
+fi
+```
+
+## Validation
+
+```bash
+/opt/appfactory/workspace/appfactory-tools/maintenance/preflight-check.sh
+docker ps --format 'table {{.Names}}\t{{.Status}}'
+```
+
+Expected:
+
+APPFACTORY PREFLIGHT: READY
+
+## Running Applications
+
+Verify user applications are running:
+
+```bash
+docker ps -a --format 'table {{.Names}}\t{{.Status}}'
+```
+
+Examples:
+
+- test-dotnet-api
+- microsoft-365-service

documents/16-security.md

@@ -0,0 +1,4 @@
+# Security
+
+Last admin protection.
+Admin-only user management.

documents/17-environment.md

@@ -0,0 +1,3 @@
+# Environment Variables
+
+Production .env values must be preserved during restore.

documents/18-roadmap.md

@@ -0,0 +1,3 @@
+# Roadmap
+
+RBAC, deeper provisioning, monitoring improvements.

documents/19-operational-checklist.md

@@ -0,0 +1,6 @@
+# Operational Checklist
+
+Preflight READY
+Core containers running
+User applications running
+OAuth functional.