feat: Add recipe images, requirements freeze, and INSTALL.md

This commit is contained in:
2026-10-29 08:51:44 +01:00
parent e11762e264
commit 418be69369
18 changed files with 122 additions and 9 deletions
+91
View File
@@ -0,0 +1,91 @@
# What To Cook (WTC) - Kochbuch & Wochenplaner
Digitales Kochbuch, Wochenmen?planer & Buchdruck-Engine (FastAPI & MariaDB).
## Systemanforderungen
- Debian 12 / 13 (oder kompatibles Linux)
- Python 3.13+ mit `python3-venv`
- Nginx (Reverse Proxy mit SSL)
- MariaDB Server auf \`db.waiswuaschd.de:3306\` (Datenbank: \`v2_db_wtc_cookbook\`)
## 1. Installation
```bash
# Repository klonen
cd /home/maxi/Projekt
git clone https://gitea.sp13l.de/kobold-ai/wtc.waiswuaschd.de.git wtc.waiswuaschd.de
cd wtc.waiswuaschd.de
# Python Virtualenv erstellen und Abh?ngigkeiten installieren
python3 -m venv venv
./venv/bin/pip install --upgrade pip
./venv/bin/pip install -r requirements.txt
```
## 2. Umgebungsvariablen (.env)
Erstelle im Projektverzeichnis eine `.env` Datei:
```ini
DB_ENGINE=mariadb
MARIADB_HOST=db.waiswuaschd.de
MARIADB_PORT=3306
MARIADB_USER=v2_usr_wtc_cookbook
MARIADB_PASS=XKikHf&j6Wj!rs5%A8#ZzyvE#*A1hT
MARIADB_NAME=v2_db_wtc_cookbook
APP_USERNAME=admin
APP_PASSWORD=wtc2026!
SECRET_KEY=wtc_secure_hmac_secret_key_2026_kochbuch_session
```
## 3. Systemd Service (/etc/systemd/system/wtc.service)
```ini
[Unit]
Description=What To Cook (WTC) Zufallsgenerator f?r Essen (FastAPI)
After=network.target
[Service]
Type=simple
User=maxi
Group=maxi
WorkingDirectory=/home/maxi/Projekt/wtc.waiswuaschd.de
Environment="PATH=/home/maxi/Projekt/wtc.waiswuaschd.de/venv/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/maxi/Projekt/wtc.waiswuaschd.de/venv/bin/uvicorn app.main:app --host 127.0.0.1 --port 8003 --workers 1
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
```
Aktivieren und starten:
```bash
sudo systemctl daemon-reload
sudo systemctl enable --now wtc
```
## 4. Nginx Reverse Proxy
```nginx
server {
listen 80;
server_name wtc.dev.waiswuaschd.de;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name wtc.dev.waiswuaschd.de;
client_max_body_size 50M;
# SSL Zertifikate hier konfigurieren (z. B. via certbot)
location /static/ {
alias /home/maxi/Projekt/wtc.waiswuaschd.de/app/static/;
}
location / {
proxy_pass http://127.0.0.1:8003;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
```
Binary file not shown.

After

Width:  |  Height:  |  Size: 320 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 435 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 332 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 406 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 322 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 536 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 248 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 210 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 134 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 362 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 331 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 226 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 753 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 825 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 395 KiB

+31 -9
View File
@@ -1,9 +1,31 @@
fastapi>=0.110.0
uvicorn>=0.29.0
jinja2>=3.1.3
python-dotenv>=1.0.1
pydantic>=2.6.0
python-multipart>=0.0.9
pymysql>=1.1.0
cryptography>=42.0.0
pillow>=10.0.0
annotated-doc==0.0.5
annotated-types==0.8.0
anyio==4.15.1
certifi==2026.7.22
cffi==2.1.1
click==8.5.0
cryptography==50.0.2
fastapi==0.141.1
h11==0.16.0
httpcore==1.0.9
httpx==0.28.1
idna==3.20
Jinja2==3.1.6
lxml==6.1.3
MarkupSafe==3.0.3
pillow==12.3.0
pycparser==3.11
pydantic==2.13.5
pydantic_core==2.46.5
PyMySQL==1.2.3
pypdf==6.20.1
python-docx==1.2.0
python-dotenv==1.2.3
python-multipart==0.0.32
python-pptx==1.0.2
starlette==1.7.0
typing-inspection==0.4.4
typing_extensions==4.16.0
uvicorn==0.53.0
websockets==17.2
xlsxwriter==3.2.9