chore: sync staging workspace

2025-11-01 19:02:09 +01:00
parent 478754ab02
commit 5a79646daf
58 changed files with 2035 additions and 709 deletions
--- a/deployment/README.md
+++ b/deployment/README.md
@@ -43,18 +43,24 @@ Developer → git push

 ```
 deployment/
+├── ansible/                   # Ansible config, playbooks, inventory, templates
+├── gitea-runner/              # Self-hosted Gitea Actions runner stack
 ├── stacks/                    # Docker Compose stacks
-│   ├── traefik/              # Reverse proxy with SSL
-│   ├── gitea/                # Git server
-│   ├── registry/             # Private Docker registry
 │   ├── application/          # Main PHP application
-│   ├── postgres/             # Database
-│   └── monitoring/           # Portainer + Grafana + Prometheus
-├── ansible/                   # Automation playbooks
-│   ├── playbooks/            # Deployment automation
-│   ├── inventory/            # Server inventory
-│   └── secrets/              # Ansible Vault secrets
-└── docs/                      # Deployment documentation
+│   ├── gitea/                # Git server
+│   ├── minio/                # Object storage
+│   ├── monitoring/           # Portainer, Grafana, Prometheus
+│   ├── postgresql/           # PostgreSQL database
+│   ├── registry/             # Private Docker registry
+│   ├── staging/              # Optional staging stack
+│   └── traefik/              # Reverse proxy with SSL certificates
+├── docs/                      # 📚 Dokumentation (siehe docs/README.md)
+│   ├── guides/               # Anleitungen & Guides
+│   ├── reference/            # Referenz-Dokumentation
+│   ├── status/               # Status & Tracking
+│   ├── tests/                # Test-Dokumentation
+│   └── history/              # Logs & Historie
+└── README.md (dieses Dokument)
 ```

 ## Getting Started
@@ -70,7 +76,7 @@ git push origin main  # → Automatisches Deployment!

 **Pipeline-Status:** `https://git.michaelschiemer.de/michael/michaelschiemer/actions`

-**📖 Vollständige Anleitung:** Siehe [QUICK_START.md](QUICK_START.md) oder [CODE_CHANGE_WORKFLOW.md](CODE_CHANGE_WORKFLOW.md)
+**📖 Vollständige Anleitung:** Siehe [docs/guides/quick-start.md](docs/guides/quick-start.md) oder [docs/guides/code-change-workflow.md](docs/guides/code-change-workflow.md)

 ---

@@ -113,7 +119,7 @@ Each stack has its own README with detailed configuration:
 - [Gitea](stacks/gitea/README.md) - Git server configuration
 - [Registry](stacks/registry/README.md) - Private registry setup
 - [Application](stacks/application/README.md) - Application deployment
- [PostgreSQL](stacks/postgres/README.md) - Database configuration
+- [PostgreSQL](stacks/postgresql/README.md) - Database configuration
 - [Monitoring](stacks/monitoring/README.md) - Monitoring stack

 ## Deployment Commands
@@ -141,7 +147,7 @@ ansible-playbook -i inventory/production.yml \
  playbooks/rollback.yml
 ```

-**📖 Vollständige Command-Referenz:** Siehe [DEPLOYMENT_COMMANDS.md](DEPLOYMENT_COMMANDS.md)
+**📖 Vollständige Command-Referenz:** Siehe [docs/guides/deployment-commands.md](docs/guides/deployment-commands.md)

 ### Update Specific Stack
 ```bash
@@ -183,11 +189,11 @@ git push origin main

 **📖 Vollständige Dokumentation:**

- **[QUICK_START.md](QUICK_START.md)** ⭐ - Schnellstart-Guide für Deployment
- **[CODE_CHANGE_WORKFLOW.md](CODE_CHANGE_WORKFLOW.md)** - Kompletter Guide für Codeänderungen
- **[APPLICATION_STACK_DEPLOYMENT.md](APPLICATION_STACK_DEPLOYMENT.md)** - Detaillierter Deployment-Ablauf
- **[CI_CD_STATUS.md](CI_CD_STATUS.md)** - CI/CD Pipeline Status & Checkliste
- **[DEPLOYMENT_SUMMARY.md](DEPLOYMENT_SUMMARY.md)** - Projekt-Status Übersicht
+- **[docs/guides/quick-start.md](docs/guides/quick-start.md)** ⭐ - Schnellstart-Guide für Deployment
+- **[docs/guides/code-change-workflow.md](docs/guides/code-change-workflow.md)** - Kompletter Guide für Codeänderungen
+- **[docs/reference/application-stack.md](docs/reference/application-stack.md)** - Detaillierter Deployment-Ablauf
+- **[docs/status/ci-cd-status.md](docs/status/ci-cd-status.md)** - CI/CD Pipeline Status & Checkliste
+- **[docs/status/deployment-summary.md](docs/status/deployment-summary.md)** - Projekt-Status Übersicht

 ### Pipeline Details

@@ -207,21 +213,13 @@ Access monitoring tools:

 ## Backup & Recovery

-### Automated Backups
+### Current State

- **PostgreSQL**: Daily backups with 7-day retention
- **Gitea Data**: Weekly backups
- **Registry Images**: On-demand backups
+Infrastructure backups are handled per stack. The PostgreSQL stack ships helper scripts under `stacks/postgresql/scripts/` (see `backup.sh` and `restore.sh`). Registry and Gitea data snapshots are currently managed manually on the host.

-### Manual Backup
-```bash
-ansible-playbook -i inventory/production.yml playbooks/backup.yml
-```
+### Roadmap

-### Restore from Backup
-```bash
-ansible-playbook -i inventory/production.yml playbooks/restore.yml
-```
+An Ansible-level backup/restore playbook is still planned. Track progress in `DEPLOYMENT-TODO.md` and update this section once the playbook is available.

 ## Security

@@ -248,7 +246,7 @@ docker network inspect traefik-public
 ### View Logs
 ```bash
 # Application logs
-docker compose -f stacks/application/docker-compose.yml logs -f app-php
+docker compose -f stacks/application/docker-compose.yml logs -f app

 # Traefik logs
 docker compose -f stacks/traefik/docker-compose.yml logs -f
@@ -256,25 +254,22 @@ docker compose -f stacks/traefik/docker-compose.yml logs -f

 ## 📚 Dokumentation Index

-**Vollständige Dokumentations-Übersicht:** Siehe [DOCUMENTATION_INDEX.md](DOCUMENTATION_INDEX.md)
+**Vollständige Dokumentations-Übersicht:** Siehe [docs/README.md](docs/README.md)

 **Wichtigste Dokumente:**
- **[QUICK_START.md](QUICK_START.md)** ⭐ - Schnellstart
- **[CODE_CHANGE_WORKFLOW.md](CODE_CHANGE_WORKFLOW.md)** - Code deployen
- **[APPLICATION_STACK_DEPLOYMENT.md](APPLICATION_STACK_DEPLOYMENT.md)** - Deployment-Details
- **[CI_CD_STATUS.md](CI_CD_STATUS.md)** - CI/CD Status
- **[DEPLOYMENT_SUMMARY.md](DEPLOYMENT_SUMMARY.md)** - Projekt-Übersicht
+- **[docs/guides/quick-start.md](docs/guides/quick-start.md)** ⭐ - Schnellstart
+- **[docs/guides/code-change-workflow.md](docs/guides/code-change-workflow.md)** - Code deployen
+- **[docs/reference/application-stack.md](docs/reference/application-stack.md)** - Deployment-Details
+- **[docs/status/ci-cd-status.md](docs/status/ci-cd-status.md)** - CI/CD Status
+- **[docs/status/deployment-summary.md](docs/status/deployment-summary.md)** - Projekt-Übersicht

 ## Support

-For issues and questions, see:
- [Troubleshooting Guide](docs/troubleshooting.md)
- [Workflow Troubleshooting](WORKFLOW-TROUBLESHOOTING.md)
- [CI/CD Status](CI_CD_STATUS.md) - Mit Troubleshooting-Section
-
-## Migration from Docker Swarm
-
-See [Migration Guide](docs/migration-from-swarm.md) for detailed instructions on migrating from the old Docker Swarm setup.
+Für spezifische Fragen helfen die folgenden Dokumente weiter:
+- [docs/reference/workflow-troubleshooting.md](docs/reference/workflow-troubleshooting.md) – Fehleranalyse für Laufzeiten & Pipelines
+- [docs/status/ci-cd-status.md](docs/status/ci-cd-status.md) – Pipeline-Status & Checklisten
+- [docs/status/deployment-summary.md](docs/status/deployment-summary.md) – Aktueller Projektüberblick
+- [docs/reference/application-stack.md](docs/reference/application-stack.md) – Detaillierte Deployment-Schritte

 ## License