docs+chore(setup): Debian 13 statt Ubuntu, versionsneutrale Doku, unattended-upgrades
Security Audit / Python Dependency Audit (push) Canceled after 0s
Security Audit / Node.js Dependency Audit (push) Canceled after 0s
Security Audit / Frontend Build (tsc + vite) (push) Canceled after 0s

- Doku auf Debian 13 "trixie" umgestellt, Python/PostgreSQL/Redis als Debian-Standard
- setup_server.sh installiert und konfiguriert unattended-upgrades (kein Auto-Reboot)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
patrickandClaude Sonnet 5.5 committed 2026-11-15 16:18:42 +01:00
1 parent 7e165d37b6
commit 119b10d943
7 files changed
+24 -13

No files matched your search

+2 -2
View File
@@ -4,9 +4,9 @@ Zeiterfassung & HR-Tool (Zeiterfassung, Abwesenheiten, Kiosk-Terminals, Reports)
## Tech-Stack ## Tech-Stack
- **Backend**: Python 3.12 · FastAPI · SQLAlchemy (async) · PostgreSQL 16 · Redis 7 · Alembic - **Backend**: Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) · PostgreSQL (Debian-Standard) · Redis · Alembic
- **Frontend**: React 18 · TypeScript · Tailwind CSS · Vite - **Frontend**: React 18 · TypeScript · Tailwind CSS · Vite
- **Deployment**: nativ auf Ubuntu (systemd + nginx), kein Docker - **Deployment**: nativ auf Debian (systemd + nginx), kein Docker
- **Tests**: pytest + pytest-asyncio + pytest-cov - **Tests**: pytest + pytest-asyncio + pytest-cov
## Features (Auszug) ## Features (Auszug)
+4 -4
View File
@@ -1,15 +1,15 @@
# TimeMaster – agent-01-auth # TimeMaster – agent-01-auth
Backend: Python 3.12 · FastAPI · SQLAlchemy (async) · PostgreSQL · Redis Backend: Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) · PostgreSQL · Redis
Laufend nativ auf dem Server (kein Docker in Phase 1). Laufend nativ auf dem Server (kein Docker in Phase 1).
--- ---
## Voraussetzungen (Ubuntu 22.04 / 24.04) ## Voraussetzungen (Debian 13 "trixie")
```bash ```bash
sudo apt update && sudo apt install -y \ sudo apt update && sudo apt install -y \
python3.12 python3.12-venv python3.12-dev \ python3 python3-venv python3-dev \
postgresql postgresql-contrib \ postgresql postgresql-contrib \
redis-server nginx git build-essential libpq-dev redis-server nginx git build-essential libpq-dev
``` ```
@@ -46,7 +46,7 @@ sudo chown $USER:$USER /opt/timemaster
git clone https://github.com/dein-repo/timemaster.git /opt/timemaster git clone https://github.com/dein-repo/timemaster.git /opt/timemaster
cd /opt/timemaster/backend cd /opt/timemaster/backend
python3.12 -m venv venv python3 -m venv venv
source venv/bin/activate source venv/bin/activate
pip install --upgrade pip pip install --upgrade pip
pip install -r requirements.txt pip install -r requirements.txt
+3 -3
View File
@@ -4,9 +4,9 @@
| Schicht | Technologie | | Schicht | Technologie |
|---------|------------| |---------|------------|
| Backend | Python 3.12 · FastAPI · SQLAlchemy (async) | | Backend | Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) |
| Datenbank | PostgreSQL 16 | | Datenbank | PostgreSQL (Debian-Standard) |
| Cache / Sessions | Redis 7 | | Cache / Sessions | Redis (Debian-Standard) |
| Frontend | React 18 · TypeScript · Tailwind CSS | | Frontend | React 18 · TypeScript · Tailwind CSS |
| Prozess-Manager | systemd | | Prozess-Manager | systemd |
| Reverse Proxy | Nginx + Let's Encrypt | | Reverse Proxy | Nginx + Let's Encrypt |
+1 -1
View File
@@ -8,7 +8,7 @@ Stand: 2026-05-24
| Schicht | Technologie | Version | | Schicht | Technologie | Version |
|---------|-------------|---------| |---------|-------------|---------|
| Backend | Python / FastAPI | 3.12 / 0.115+ | | Backend | Python / FastAPI | Debian-Standard / 0.115+ |
| ORM | SQLAlchemy async | 2.x | | ORM | SQLAlchemy async | 2.x |
| Datenbank | PostgreSQL | 16 | | Datenbank | PostgreSQL | 16 |
| Cache / Sessions | Redis | 7 | | Cache / Sessions | Redis | 7 |
+1 -1
View File
@@ -11,7 +11,7 @@ Stand: 2026-05-24
| Primary | 192.168.1.137 | Produktion, Tests, Primär-DB | | Primary | 192.168.1.137 | Produktion, Tests, Primär-DB |
| Secondary | 192.168.1.164 | Replikat / Fallback | | Secondary | 192.168.1.164 | Replikat / Fallback |
Beide Server laufen Ubuntu 22.04 oder 24.04 LTS (amd64). Kein Docker in Phase 1 – alle Dienste laufen nativ als systemd-Units. Beide Server laufen Debian 13 "trixie" (amd64). Kein Docker in Phase 1 – alle Dienste laufen nativ als systemd-Units.
--- ---
+1 -1
View File
@@ -8,7 +8,7 @@ Stand: 2026-05-24
### Voraussetzungen (lokal) ### Voraussetzungen (lokal)
- Python 3.12+ - Python 3 (Debian-Standard, aktuell 3.13)
- Node.js 20+ und npm - Node.js 20+ und npm
- SSH-Zugang zu `root@192.168.1.137` (Tests und Datenbank laufen dort) - SSH-Zugang zu `root@192.168.1.137` (Tests und Datenbank laufen dort)
- Git-Zugang zu `gitea.perlbach24.de/scripte/timemaster.git` - Git-Zugang zu `gitea.perlbach24.de/scripte/timemaster.git`
+12 -1
View File
@@ -22,9 +22,20 @@ apt-get install -y \
postgresql postgresql-contrib \ postgresql postgresql-contrib \
redis-server \ redis-server \
nginx \ nginx \
git curl build-essential libpq-dev openssl sudo \ git curl build-essential libpq-dev openssl sudo unattended-upgrades \
libpango-1.0-0 libpangoft2-1.0-0 libharfbuzz0b libpango-1.0-0 libpangoft2-1.0-0 libharfbuzz0b
cat > /etc/apt/apt.conf.d/20auto-upgrades <<'APTEOF'
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";
APT::Periodic::AutocleanInterval "7";
APTEOF
cat > /etc/apt/apt.conf.d/52timemaster-unattended <<'APTEOF'
Unattended-Upgrade::Automatic-Reboot "false";
Unattended-Upgrade::Remove-Unused-Dependencies "true";
APTEOF
systemctl enable --now unattended-upgrades
echo "==> [3/7] PostgreSQL einrichten" echo "==> [3/7] PostgreSQL einrichten"
systemctl enable postgresql && systemctl start postgresql systemctl enable postgresql && systemctl start postgresql