docs+chore(setup): Debian 13 statt Ubuntu, versionsneutrale Doku, unattended-upgrades
- 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:
1 parent
7e165d37b6
commit
119b10d943
7 files changed
+24
-13
No files matched your search
@@ -4,9 +4,9 @@ Zeiterfassung & HR-Tool (Zeiterfassung, Abwesenheiten, Kiosk-Terminals, Reports)
|
||||
|
||||
## 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
|
||||
- **Deployment**: nativ auf Ubuntu (systemd + nginx), kein Docker
|
||||
- **Deployment**: nativ auf Debian (systemd + nginx), kein Docker
|
||||
- **Tests**: pytest + pytest-asyncio + pytest-cov
|
||||
|
||||
## Features (Auszug)
|
||||
|
||||
+4
-4
@@ -1,15 +1,15 @@
|
||||
# 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).
|
||||
|
||||
---
|
||||
|
||||
## Voraussetzungen (Ubuntu 22.04 / 24.04)
|
||||
## Voraussetzungen (Debian 13 "trixie")
|
||||
|
||||
```bash
|
||||
sudo apt update && sudo apt install -y \
|
||||
python3.12 python3.12-venv python3.12-dev \
|
||||
python3 python3-venv python3-dev \
|
||||
postgresql postgresql-contrib \
|
||||
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
|
||||
|
||||
cd /opt/timemaster/backend
|
||||
python3.12 -m venv venv
|
||||
python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
pip install --upgrade pip
|
||||
pip install -r requirements.txt
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
| Schicht | Technologie |
|
||||
|---------|------------|
|
||||
| Backend | Python 3.12 · FastAPI · SQLAlchemy (async) |
|
||||
| Datenbank | PostgreSQL 16 |
|
||||
| Cache / Sessions | Redis 7 |
|
||||
| Backend | Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) |
|
||||
| Datenbank | PostgreSQL (Debian-Standard) |
|
||||
| Cache / Sessions | Redis (Debian-Standard) |
|
||||
| Frontend | React 18 · TypeScript · Tailwind CSS |
|
||||
| Prozess-Manager | systemd |
|
||||
| Reverse Proxy | Nginx + Let's Encrypt |
|
||||
|
||||
@@ -8,7 +8,7 @@ Stand: 2026-05-24
|
||||
|
||||
| Schicht | Technologie | Version |
|
||||
|---------|-------------|---------|
|
||||
| Backend | Python / FastAPI | 3.12 / 0.115+ |
|
||||
| Backend | Python / FastAPI | Debian-Standard / 0.115+ |
|
||||
| ORM | SQLAlchemy async | 2.x |
|
||||
| Datenbank | PostgreSQL | 16 |
|
||||
| Cache / Sessions | Redis | 7 |
|
||||
|
||||
+1
-1
@@ -11,7 +11,7 @@ Stand: 2026-05-24
|
||||
| Primary | 192.168.1.137 | Produktion, Tests, Primär-DB |
|
||||
| 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
@@ -8,7 +8,7 @@ Stand: 2026-05-24
|
||||
|
||||
### Voraussetzungen (lokal)
|
||||
|
||||
- Python 3.12+
|
||||
- Python 3 (Debian-Standard, aktuell 3.13)
|
||||
- Node.js 20+ und npm
|
||||
- SSH-Zugang zu `root@192.168.1.137` (Tests und Datenbank laufen dort)
|
||||
- Git-Zugang zu `gitea.perlbach24.de/scripte/timemaster.git`
|
||||
|
||||
+12
-1
@@ -22,9 +22,20 @@ apt-get install -y \
|
||||
postgresql postgresql-contrib \
|
||||
redis-server \
|
||||
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
|
||||
|
||||
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"
|
||||
systemctl enable postgresql && systemctl start postgresql
|
||||
|
||||
|
||||
Reference in new issue
Block a user