From 006a28ea0f920924c7edc26978cabc9aae392135 Mon Sep 17 00:00:00 2001
From: alex <misc@wiesner.com.br>
Date: Sun, 8 Mar 2026 20:00:08 +0000
Subject: [PATCH] move documentation/ to docs/

---
 {documentation => docs}/.gitignore            |   0
 {documentation => docs}/.vitepress/config.mts |   0
 .../.vitepress/theme/index.ts                 |   0
 .../.vitepress/theme/style.css                |   0
 docs/architecture.md                          |  41 ++++++++++++++++++
 .../docs/changelogs/development_timeline.md   |   0
 .../docs/changelogs/v0-10-0.md                |   0
 .../docs/changelogs/v0-11-0.md                |   0
 .../docs/changelogs/v0-12-0.md                |   0
 .../docs/changelogs/v0-7-0.md                 |   0
 .../docs/changelogs/v0-7-1.md                 |   0
 .../docs/changelogs/v0-8-0.md                 |   0
 .../docs/changelogs/v0-9-0.md                 |   0
 .../configuration/advanced_configuration.md   |   0
 .../docs/configuration/analytics.md           |   0
 .../configuration/disable_registration.md     |   0
 .../docs/configuration/email.md               |   0
 .../configuration/google_maps_integration.md  |   0
 .../docs/configuration/immich_integration.md  |   0
 .../docs/configuration/social_auth.md         |   0
 .../configuration/social_auth/authentik.md    |   0
 .../docs/configuration/social_auth/github.md  |   0
 .../docs/configuration/social_auth/oidc.md    |   0
 .../configuration/social_auth/pocket_id.md    |   0
 .../docs/configuration/strava_integration.md  |   0
 .../docs/configuration/updating.md            |   0
 .../configuration/wanderer_integration.md     |   0
 .../docs/guides/admin_panel.md                |   0
 .../docs/guides/invite_user.md                |   0
 .../docs/guides/travel_agent.md               |   0
 .../docs/guides/v0-7-1_migration.md           |   0
 {documentation => docs}/docs/install/caddy.md |   0
 .../docs/install/dev_container_wsl.md         |   0
 .../docs/install/docker.md                    |   0
 .../docs/install/getting_started.md           |   0
 .../docs/install/kustomize.md                 |   0
 .../docs/install/nginx_proxy_manager.md       |   0
 .../docs/install/proxmox_lxc.md               |   0
 .../docs/install/quick_start.md               |   0
 .../docs/install/synology_nas.md              |   0
 .../docs/install/traefik.md                   |   0
 .../docs/install/unraid.md                    |   0
 .../docs/intro/voyage_overview.md             |   0
 .../troubleshooting/login_unresponsive.md     |   0
 .../docs/troubleshooting/nginx_failed.md      |   0
 .../docs/troubleshooting/no_images.md         |   0
 {documentation => docs}/docs/usage/usage.md   |   0
 {documentation => docs}/index.md              |   0
 {documentation => docs}/package.json          |   0
 {documentation => docs}/pnpm-lock.yaml        |   0
 .../public/authentik_settings.png             | Bin
 .../public/github_settings.png                | Bin
 .../public/unraid-config-1.png                | Bin
 .../public/unraid-config-2.png                | Bin
 .../public/unraid-config-3.png                | Bin
 {documentation => docs}/public/voyage.png     | Bin
 {documentation => docs}/public/voyage.svg     |   0
 .../static/img/favicon.png                    | Bin
 58 files changed, 41 insertions(+)
 rename {documentation => docs}/.gitignore (100%)
 rename {documentation => docs}/.vitepress/config.mts (100%)
 rename {documentation => docs}/.vitepress/theme/index.ts (100%)
 rename {documentation => docs}/.vitepress/theme/style.css (100%)
 create mode 100644 docs/architecture.md
 rename {documentation => docs}/docs/changelogs/development_timeline.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-10-0.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-11-0.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-12-0.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-7-0.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-7-1.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-8-0.md (100%)
 rename {documentation => docs}/docs/changelogs/v0-9-0.md (100%)
 rename {documentation => docs}/docs/configuration/advanced_configuration.md (100%)
 rename {documentation => docs}/docs/configuration/analytics.md (100%)
 rename {documentation => docs}/docs/configuration/disable_registration.md (100%)
 rename {documentation => docs}/docs/configuration/email.md (100%)
 rename {documentation => docs}/docs/configuration/google_maps_integration.md (100%)
 rename {documentation => docs}/docs/configuration/immich_integration.md (100%)
 rename {documentation => docs}/docs/configuration/social_auth.md (100%)
 rename {documentation => docs}/docs/configuration/social_auth/authentik.md (100%)
 rename {documentation => docs}/docs/configuration/social_auth/github.md (100%)
 rename {documentation => docs}/docs/configuration/social_auth/oidc.md (100%)
 rename {documentation => docs}/docs/configuration/social_auth/pocket_id.md (100%)
 rename {documentation => docs}/docs/configuration/strava_integration.md (100%)
 rename {documentation => docs}/docs/configuration/updating.md (100%)
 rename {documentation => docs}/docs/configuration/wanderer_integration.md (100%)
 rename {documentation => docs}/docs/guides/admin_panel.md (100%)
 rename {documentation => docs}/docs/guides/invite_user.md (100%)
 rename {documentation => docs}/docs/guides/travel_agent.md (100%)
 rename {documentation => docs}/docs/guides/v0-7-1_migration.md (100%)
 rename {documentation => docs}/docs/install/caddy.md (100%)
 rename {documentation => docs}/docs/install/dev_container_wsl.md (100%)
 rename {documentation => docs}/docs/install/docker.md (100%)
 rename {documentation => docs}/docs/install/getting_started.md (100%)
 rename {documentation => docs}/docs/install/kustomize.md (100%)
 rename {documentation => docs}/docs/install/nginx_proxy_manager.md (100%)
 rename {documentation => docs}/docs/install/proxmox_lxc.md (100%)
 rename {documentation => docs}/docs/install/quick_start.md (100%)
 rename {documentation => docs}/docs/install/synology_nas.md (100%)
 rename {documentation => docs}/docs/install/traefik.md (100%)
 rename {documentation => docs}/docs/install/unraid.md (100%)
 rename {documentation => docs}/docs/intro/voyage_overview.md (100%)
 rename {documentation => docs}/docs/troubleshooting/login_unresponsive.md (100%)
 rename {documentation => docs}/docs/troubleshooting/nginx_failed.md (100%)
 rename {documentation => docs}/docs/troubleshooting/no_images.md (100%)
 rename {documentation => docs}/docs/usage/usage.md (100%)
 rename {documentation => docs}/index.md (100%)
 rename {documentation => docs}/package.json (100%)
 rename {documentation => docs}/pnpm-lock.yaml (100%)
 rename {documentation => docs}/public/authentik_settings.png (100%)
 rename {documentation => docs}/public/github_settings.png (100%)
 rename {documentation => docs}/public/unraid-config-1.png (100%)
 rename {documentation => docs}/public/unraid-config-2.png (100%)
 rename {documentation => docs}/public/unraid-config-3.png (100%)
 rename {documentation => docs}/public/voyage.png (100%)
 rename {documentation => docs}/public/voyage.svg (100%)
 rename {documentation => docs}/static/img/favicon.png (100%)

diff --git a/documentation/.gitignore b/docs/.gitignore
similarity index 100%
rename from documentation/.gitignore
rename to docs/.gitignore
diff --git a/documentation/.vitepress/config.mts b/docs/.vitepress/config.mts
similarity index 100%
rename from documentation/.vitepress/config.mts
rename to docs/.vitepress/config.mts
diff --git a/documentation/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
similarity index 100%
rename from documentation/.vitepress/theme/index.ts
rename to docs/.vitepress/theme/index.ts
diff --git a/documentation/.vitepress/theme/style.css b/docs/.vitepress/theme/style.css
similarity index 100%
rename from documentation/.vitepress/theme/style.css
rename to docs/.vitepress/theme/style.css
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 00000000..d16f63a9
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1,41 @@
+# Voyage Architecture
+
+> **Status**: Stub — to be expanded as architecture evolves.
+
+## Overview
+
+Voyage is a self-hosted travel companion built with SvelteKit (frontend) and Django REST Framework (backend), deployed via Docker.
+
+## Key Architectural Patterns
+
+### API Proxy
+The frontend never calls Django directly. All API calls go through `src/routes/api/[...path]/+server.ts`, which proxies to the Django server, injecting CSRF tokens and managing session cookies.
+
+### Services (Docker Compose)
+- `web` → SvelteKit frontend (`:8015`)
+- `server` → Django via Gunicorn + Nginx (`:8016`)
+- `db` → PostgreSQL + PostGIS (`:5432`)
+- `cache` → Memcached (internal)
+
+### Authentication
+Session-based via `django-allauth`. CSRF tokens from `/auth/csrf/`, passed as `X-CSRFToken` header.
+
+## Backend Apps
+- `adventures` — core domain (locations, collections, itineraries, notes, transportation, MCP)
+- `users` — user management
+- `worldtravel` — countries, regions, cities, visited tracking
+- `integrations` — external service integrations
+- `achievements` — gamification
+- `chat` — LLM chat/agent
+
+## Frontend Structure
+- `src/routes/` — SvelteKit file-based routing
+- `src/lib/types.ts` — TypeScript interfaces
+- `src/lib/components/` — Svelte components by domain
+- `src/locales/` — i18n JSON files
+
+## TODO
+- [ ] Data flow diagrams
+- [ ] Database schema overview
+- [ ] Deployment architecture
+- [ ] MCP endpoint architecture
diff --git a/documentation/docs/changelogs/development_timeline.md b/docs/docs/changelogs/development_timeline.md
similarity index 100%
rename from documentation/docs/changelogs/development_timeline.md
rename to docs/docs/changelogs/development_timeline.md
diff --git a/documentation/docs/changelogs/v0-10-0.md b/docs/docs/changelogs/v0-10-0.md
similarity index 100%
rename from documentation/docs/changelogs/v0-10-0.md
rename to docs/docs/changelogs/v0-10-0.md
diff --git a/documentation/docs/changelogs/v0-11-0.md b/docs/docs/changelogs/v0-11-0.md
similarity index 100%
rename from documentation/docs/changelogs/v0-11-0.md
rename to docs/docs/changelogs/v0-11-0.md
diff --git a/documentation/docs/changelogs/v0-12-0.md b/docs/docs/changelogs/v0-12-0.md
similarity index 100%
rename from documentation/docs/changelogs/v0-12-0.md
rename to docs/docs/changelogs/v0-12-0.md
diff --git a/documentation/docs/changelogs/v0-7-0.md b/docs/docs/changelogs/v0-7-0.md
similarity index 100%
rename from documentation/docs/changelogs/v0-7-0.md
rename to docs/docs/changelogs/v0-7-0.md
diff --git a/documentation/docs/changelogs/v0-7-1.md b/docs/docs/changelogs/v0-7-1.md
similarity index 100%
rename from documentation/docs/changelogs/v0-7-1.md
rename to docs/docs/changelogs/v0-7-1.md
diff --git a/documentation/docs/changelogs/v0-8-0.md b/docs/docs/changelogs/v0-8-0.md
similarity index 100%
rename from documentation/docs/changelogs/v0-8-0.md
rename to docs/docs/changelogs/v0-8-0.md
diff --git a/documentation/docs/changelogs/v0-9-0.md b/docs/docs/changelogs/v0-9-0.md
similarity index 100%
rename from documentation/docs/changelogs/v0-9-0.md
rename to docs/docs/changelogs/v0-9-0.md
diff --git a/documentation/docs/configuration/advanced_configuration.md b/docs/docs/configuration/advanced_configuration.md
similarity index 100%
rename from documentation/docs/configuration/advanced_configuration.md
rename to docs/docs/configuration/advanced_configuration.md
diff --git a/documentation/docs/configuration/analytics.md b/docs/docs/configuration/analytics.md
similarity index 100%
rename from documentation/docs/configuration/analytics.md
rename to docs/docs/configuration/analytics.md
diff --git a/documentation/docs/configuration/disable_registration.md b/docs/docs/configuration/disable_registration.md
similarity index 100%
rename from documentation/docs/configuration/disable_registration.md
rename to docs/docs/configuration/disable_registration.md
diff --git a/documentation/docs/configuration/email.md b/docs/docs/configuration/email.md
similarity index 100%
rename from documentation/docs/configuration/email.md
rename to docs/docs/configuration/email.md
diff --git a/documentation/docs/configuration/google_maps_integration.md b/docs/docs/configuration/google_maps_integration.md
similarity index 100%
rename from documentation/docs/configuration/google_maps_integration.md
rename to docs/docs/configuration/google_maps_integration.md
diff --git a/documentation/docs/configuration/immich_integration.md b/docs/docs/configuration/immich_integration.md
similarity index 100%
rename from documentation/docs/configuration/immich_integration.md
rename to docs/docs/configuration/immich_integration.md
diff --git a/documentation/docs/configuration/social_auth.md b/docs/docs/configuration/social_auth.md
similarity index 100%
rename from documentation/docs/configuration/social_auth.md
rename to docs/docs/configuration/social_auth.md
diff --git a/documentation/docs/configuration/social_auth/authentik.md b/docs/docs/configuration/social_auth/authentik.md
similarity index 100%
rename from documentation/docs/configuration/social_auth/authentik.md
rename to docs/docs/configuration/social_auth/authentik.md
diff --git a/documentation/docs/configuration/social_auth/github.md b/docs/docs/configuration/social_auth/github.md
similarity index 100%
rename from documentation/docs/configuration/social_auth/github.md
rename to docs/docs/configuration/social_auth/github.md
diff --git a/documentation/docs/configuration/social_auth/oidc.md b/docs/docs/configuration/social_auth/oidc.md
similarity index 100%
rename from documentation/docs/configuration/social_auth/oidc.md
rename to docs/docs/configuration/social_auth/oidc.md
diff --git a/documentation/docs/configuration/social_auth/pocket_id.md b/docs/docs/configuration/social_auth/pocket_id.md
similarity index 100%
rename from documentation/docs/configuration/social_auth/pocket_id.md
rename to docs/docs/configuration/social_auth/pocket_id.md
diff --git a/documentation/docs/configuration/strava_integration.md b/docs/docs/configuration/strava_integration.md
similarity index 100%
rename from documentation/docs/configuration/strava_integration.md
rename to docs/docs/configuration/strava_integration.md
diff --git a/documentation/docs/configuration/updating.md b/docs/docs/configuration/updating.md
similarity index 100%
rename from documentation/docs/configuration/updating.md
rename to docs/docs/configuration/updating.md
diff --git a/documentation/docs/configuration/wanderer_integration.md b/docs/docs/configuration/wanderer_integration.md
similarity index 100%
rename from documentation/docs/configuration/wanderer_integration.md
rename to docs/docs/configuration/wanderer_integration.md
diff --git a/documentation/docs/guides/admin_panel.md b/docs/docs/guides/admin_panel.md
similarity index 100%
rename from documentation/docs/guides/admin_panel.md
rename to docs/docs/guides/admin_panel.md
diff --git a/documentation/docs/guides/invite_user.md b/docs/docs/guides/invite_user.md
similarity index 100%
rename from documentation/docs/guides/invite_user.md
rename to docs/docs/guides/invite_user.md
diff --git a/documentation/docs/guides/travel_agent.md b/docs/docs/guides/travel_agent.md
similarity index 100%
rename from documentation/docs/guides/travel_agent.md
rename to docs/docs/guides/travel_agent.md
diff --git a/documentation/docs/guides/v0-7-1_migration.md b/docs/docs/guides/v0-7-1_migration.md
similarity index 100%
rename from documentation/docs/guides/v0-7-1_migration.md
rename to docs/docs/guides/v0-7-1_migration.md
diff --git a/documentation/docs/install/caddy.md b/docs/docs/install/caddy.md
similarity index 100%
rename from documentation/docs/install/caddy.md
rename to docs/docs/install/caddy.md
diff --git a/documentation/docs/install/dev_container_wsl.md b/docs/docs/install/dev_container_wsl.md
similarity index 100%
rename from documentation/docs/install/dev_container_wsl.md
rename to docs/docs/install/dev_container_wsl.md
diff --git a/documentation/docs/install/docker.md b/docs/docs/install/docker.md
similarity index 100%
rename from documentation/docs/install/docker.md
rename to docs/docs/install/docker.md
diff --git a/documentation/docs/install/getting_started.md b/docs/docs/install/getting_started.md
similarity index 100%
rename from documentation/docs/install/getting_started.md
rename to docs/docs/install/getting_started.md
diff --git a/documentation/docs/install/kustomize.md b/docs/docs/install/kustomize.md
similarity index 100%
rename from documentation/docs/install/kustomize.md
rename to docs/docs/install/kustomize.md
diff --git a/documentation/docs/install/nginx_proxy_manager.md b/docs/docs/install/nginx_proxy_manager.md
similarity index 100%
rename from documentation/docs/install/nginx_proxy_manager.md
rename to docs/docs/install/nginx_proxy_manager.md
diff --git a/documentation/docs/install/proxmox_lxc.md b/docs/docs/install/proxmox_lxc.md
similarity index 100%
rename from documentation/docs/install/proxmox_lxc.md
rename to docs/docs/install/proxmox_lxc.md
diff --git a/documentation/docs/install/quick_start.md b/docs/docs/install/quick_start.md
similarity index 100%
rename from documentation/docs/install/quick_start.md
rename to docs/docs/install/quick_start.md
diff --git a/documentation/docs/install/synology_nas.md b/docs/docs/install/synology_nas.md
similarity index 100%
rename from documentation/docs/install/synology_nas.md
rename to docs/docs/install/synology_nas.md
diff --git a/documentation/docs/install/traefik.md b/docs/docs/install/traefik.md
similarity index 100%
rename from documentation/docs/install/traefik.md
rename to docs/docs/install/traefik.md
diff --git a/documentation/docs/install/unraid.md b/docs/docs/install/unraid.md
similarity index 100%
rename from documentation/docs/install/unraid.md
rename to docs/docs/install/unraid.md
diff --git a/documentation/docs/intro/voyage_overview.md b/docs/docs/intro/voyage_overview.md
similarity index 100%
rename from documentation/docs/intro/voyage_overview.md
rename to docs/docs/intro/voyage_overview.md
diff --git a/documentation/docs/troubleshooting/login_unresponsive.md b/docs/docs/troubleshooting/login_unresponsive.md
similarity index 100%
rename from documentation/docs/troubleshooting/login_unresponsive.md
rename to docs/docs/troubleshooting/login_unresponsive.md
diff --git a/documentation/docs/troubleshooting/nginx_failed.md b/docs/docs/troubleshooting/nginx_failed.md
similarity index 100%
rename from documentation/docs/troubleshooting/nginx_failed.md
rename to docs/docs/troubleshooting/nginx_failed.md
diff --git a/documentation/docs/troubleshooting/no_images.md b/docs/docs/troubleshooting/no_images.md
similarity index 100%
rename from documentation/docs/troubleshooting/no_images.md
rename to docs/docs/troubleshooting/no_images.md
diff --git a/documentation/docs/usage/usage.md b/docs/docs/usage/usage.md
similarity index 100%
rename from documentation/docs/usage/usage.md
rename to docs/docs/usage/usage.md
diff --git a/documentation/index.md b/docs/index.md
similarity index 100%
rename from documentation/index.md
rename to docs/index.md
diff --git a/documentation/package.json b/docs/package.json
similarity index 100%
rename from documentation/package.json
rename to docs/package.json
diff --git a/documentation/pnpm-lock.yaml b/docs/pnpm-lock.yaml
similarity index 100%
rename from documentation/pnpm-lock.yaml
rename to docs/pnpm-lock.yaml
diff --git a/documentation/public/authentik_settings.png b/docs/public/authentik_settings.png
similarity index 100%
rename from documentation/public/authentik_settings.png
rename to docs/public/authentik_settings.png
diff --git a/documentation/public/github_settings.png b/docs/public/github_settings.png
similarity index 100%
rename from documentation/public/github_settings.png
rename to docs/public/github_settings.png
diff --git a/documentation/public/unraid-config-1.png b/docs/public/unraid-config-1.png
similarity index 100%
rename from documentation/public/unraid-config-1.png
rename to docs/public/unraid-config-1.png
diff --git a/documentation/public/unraid-config-2.png b/docs/public/unraid-config-2.png
similarity index 100%
rename from documentation/public/unraid-config-2.png
rename to docs/public/unraid-config-2.png
diff --git a/documentation/public/unraid-config-3.png b/docs/public/unraid-config-3.png
similarity index 100%
rename from documentation/public/unraid-config-3.png
rename to docs/public/unraid-config-3.png
diff --git a/documentation/public/voyage.png b/docs/public/voyage.png
similarity index 100%
rename from documentation/public/voyage.png
rename to docs/public/voyage.png
diff --git a/documentation/public/voyage.svg b/docs/public/voyage.svg
similarity index 100%
rename from documentation/public/voyage.svg
rename to docs/public/voyage.svg
diff --git a/documentation/static/img/favicon.png b/docs/static/img/favicon.png
similarity index 100%
rename from documentation/static/img/favicon.png
rename to docs/static/img/favicon.png