diff --git a/documents/01-architecture.md b/documents/01-architecture.md
new file mode 100644
index 0000000..88b35bd
--- /dev/null
+++ b/documents/01-architecture.md
@@ -0,0 +1,5 @@
+# Architecture
+
+Google OAuth -> Portal -> Roles -> Provisioning -> Gitea
+
+Portal is source of truth.
\ No newline at end of file
diff --git a/documents/02-components.md b/documents/02-components.md
new file mode 100644
index 0000000..c860208
--- /dev/null
+++ b/documents/02-components.md
@@ -0,0 +1,9 @@
+# Components
+
+- Portal
+- Worker
+- Webhook
+- Monitor
+- Gitea
+- Registry
+- Caddy
\ No newline at end of file
diff --git a/documents/03-database.md b/documents/03-database.md
new file mode 100644
index 0000000..38f7734
--- /dev/null
+++ b/documents/03-database.md
@@ -0,0 +1,10 @@
+# Database
+
+Main DB: appfactory.db
+
+Important tables:
+- users
+- apps
+- jobs
+- alert_rules
+- alert_events
\ No newline at end of file
diff --git a/documents/04-users-and-roles.md b/documents/04-users-and-roles.md
new file mode 100644
index 0000000..2d8ec99
--- /dev/null
+++ b/documents/04-users-and-roles.md
@@ -0,0 +1,8 @@
+# Users and Roles
+
+Roles:
+- admin
+- developer
+- viewer
+
+First Google user becomes admin.
\ No newline at end of file
diff --git a/documents/05-google-oauth.md b/documents/05-google-oauth.md
new file mode 100644
index 0000000..15d03bf
--- /dev/null
+++ b/documents/05-google-oauth.md
@@ -0,0 +1,4 @@
+# Google OAuth
+
+Callback:
+https://services.csbot.cz/portal/auth/google/callback
\ No newline at end of file