From fdd35630b43cd2bda8e49b20c3e02a02068ef8cd Mon Sep 17 00:00:00 2001
From: jiri <jiri.uhlir59@gmail.com>
Date: Wed, 10 Jun 2026 13:22:52 +0000
Subject: [PATCH] Upload files to "documents"

---
 documents/01-overview.md                |  3 ++
 documents/02-templates.md               |  3 ++
 documents/03-deployments.md             |  3 ++
 documents/04-scheduled-scripts.md       |  3 ++
 documents/06-disaster-recovery-notes.md | 59 +++++++++++++++++++++++++
 5 files changed, 71 insertions(+)
 create mode 100644 documents/01-overview.md
 create mode 100644 documents/02-templates.md
 create mode 100644 documents/03-deployments.md
 create mode 100644 documents/04-scheduled-scripts.md
 create mode 100644 documents/06-disaster-recovery-notes.md

diff --git a/documents/01-overview.md b/documents/01-overview.md
new file mode 100644
index 0000000..a6c63cc
--- /dev/null
+++ b/documents/01-overview.md
@@ -0,0 +1,3 @@
+# AppFactory Overview
+
+AppFactory je self-hosted PaaS platforma postavená na Docker, FastAPI, SQLite a shell skriptech.
diff --git a/documents/02-templates.md b/documents/02-templates.md
new file mode 100644
index 0000000..b27ceb1
--- /dev/null
+++ b/documents/02-templates.md
@@ -0,0 +1,3 @@
+# Templates
+
+app_templates je jediný source of truth.
diff --git a/documents/03-deployments.md b/documents/03-deployments.md
new file mode 100644
index 0000000..1eb1f3d
--- /dev/null
+++ b/documents/03-deployments.md
@@ -0,0 +1,3 @@
+# Deployments
+
+Flow: create_script -> registrace do apps -> deploy job.
diff --git a/documents/04-scheduled-scripts.md b/documents/04-scheduled-scripts.md
new file mode 100644
index 0000000..4796922
--- /dev/null
+++ b/documents/04-scheduled-scripts.md
@@ -0,0 +1,3 @@
+# Scheduled Scripts
+
+Scheduler vytváří joby typu run_script.
diff --git a/documents/06-disaster-recovery-notes.md b/documents/06-disaster-recovery-notes.md
new file mode 100644
index 0000000..5f412e6
--- /dev/null
+++ b/documents/06-disaster-recovery-notes.md
@@ -0,0 +1,59 @@
+# Disaster Recovery Notes
+
+## Portal is Source of Truth
+
+Google
+-> Portal Users
+-> Portal Roles
+-> Gitea Provisioning
+-> Gitea
+
+## Restore Rules
+
+Restore must NOT overwrite:
+
+- production domains
+- HTTPS configuration
+- OAuth configuration
+
+Existing .env values must remain unchanged.
+
+## TLS State
+
+Restore must preserve:
+
+- /opt/appfactory/data/caddy
+- /opt/appfactory/data/caddy-config
+
+Otherwise:
+
+- HTTPS stops working
+- Google OAuth stops working
+- Let's Encrypt rate limits may occur
+
+## Google OAuth
+
+Callback:
+
+https://services.csbot.cz/portal/auth/google/callback
+
+## Gitea
+
+Registration disabled:
+
+```ini
+DISABLE_REGISTRATION = true
+ENABLE_OPENID_SIGNUP = false
+```
+
+## Verification
+
+```bash
+curl -I https://services.csbot.cz
+curl -I https://git.csbot.cz
+curl -I https://registry.csbot.cz/v2/
+```
+
+```bash
+/opt/appfactory/workspace/appfactory-tools/maintenance/preflight-check.sh
+```