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

---
 documents/01-current-state.md           | 36 +++++++++++++++++++++++++
 documents/02-restore-and-production.md  | 16 +++++++++++
 documents/05-alerting.md                |  3 +++
 documents/06-ownership-and-bootstrap.md |  3 +++
 documents/07-roadmap.md                 |  3 +++
 5 files changed, 61 insertions(+)
 create mode 100644 documents/01-current-state.md
 create mode 100644 documents/02-restore-and-production.md
 create mode 100644 documents/05-alerting.md
 create mode 100644 documents/06-ownership-and-bootstrap.md
 create mode 100644 documents/07-roadmap.md

diff --git a/documents/01-current-state.md b/documents/01-current-state.md
new file mode 100644
index 0000000..9b2df78
--- /dev/null
+++ b/documents/01-current-state.md
@@ -0,0 +1,36 @@
+# AppFactory - Current State
+
+## Infrastructure
+- Caddy
+- Gitea
+- Registry
+- Portal
+- Worker
+- Webhook
+- Monitor
+
+## Authentication
+- Google OAuth functional
+- First Google user becomes admin
+- Additional users become viewer
+- Users stored in portal database
+
+## Roles
+- admin
+- developer
+- viewer
+
+## Security
+- Last admin protection
+- Admin-only user management
+
+## Gitea
+- Registration disabled
+- OpenID signup disabled
+- Portal is source of truth
+
+## Provisioning
+- gitea_user_id
+- gitea_sync_status
+- gitea_sync_error
+- gitea_synced_at
diff --git a/documents/02-restore-and-production.md b/documents/02-restore-and-production.md
new file mode 100644
index 0000000..a9d9b89
--- /dev/null
+++ b/documents/02-restore-and-production.md
@@ -0,0 +1,16 @@
+# Restore and Production Notes
+
+## Fixed
+- Restore preserves production .env values
+- Missing keys are appended
+- Existing configured values are preserved
+- HTTPS configuration preserved
+- Domain configuration preserved
+- OAuth configuration preserved
+
+## Remaining Issue
+Restore must preserve:
+- /opt/appfactory/data/caddy
+- /opt/appfactory/data/caddy-config
+
+Otherwise Let's Encrypt state can be lost.
diff --git a/documents/05-alerting.md b/documents/05-alerting.md
new file mode 100644
index 0000000..9f97765
--- /dev/null
+++ b/documents/05-alerting.md
@@ -0,0 +1,3 @@
+# Alerting
+
+Incident -> Alert Rule -> Alert Event -> Job -> Shell Script.
diff --git a/documents/06-ownership-and-bootstrap.md b/documents/06-ownership-and-bootstrap.md
new file mode 100644
index 0000000..2dacf33
--- /dev/null
+++ b/documents/06-ownership-and-bootstrap.md
@@ -0,0 +1,3 @@
+# Ownership and Bootstrap
+
+Používá APPFACTORY_UID, APPFACTORY_GID a APPFACTORY_DOCKER_GID.
diff --git a/documents/07-roadmap.md b/documents/07-roadmap.md
new file mode 100644
index 0000000..8ee372a
--- /dev/null
+++ b/documents/07-roadmap.md
@@ -0,0 +1,3 @@
+# Roadmap
+
+Alerting UI, Bootstrap v2, HTTPS, OAuth, Backup/Restore.