Backend: - own birth data: three corrections within an hour of the first save, then one change per 24 hours (birth_data_changes); 429 birth_data_change_limit with the user-facing message; /v1/me birth_change shows the notice; admins are not limited - admins get detailed analyses free (no unit spent) - POST /v1/payments/mock (MOCK_PAYMENTS): stand-in payment that adds a unit, until Stripe is connected; on in the compose files for now Frontend: - detailed analysis offer: admin starts it free, users with units confirm, others go through the (stand-in) payment step - turning wheel with elapsed time while the summary or the analysis is being written - no "adatok javítása" on the chart page (only in the profile), limit notice there; wheel hover highlighting removed Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
Build és telepítés
A .gitea/workflows/ci.yml (Gitea Actions) két ágra fut:
- main: tesztek, majd image-build. Címkék: a commit hash első 12 karaktere és
main. - prod: ugyanez, majd telepítés a szerverre. Címkék: hash,
prodéslatest. Élesíteni tehát úgy kell, hogy a main-t a prod-ba mergeled (vagy pusholod).
A lépések:
- test:
cargo testa backendre, a workerre, a db-re, a horoscope-clientre és a service-kitre, egy Postgres szolgáltatás-konténerrel. - build: megépíti a négy image-et, és feltölti őket a
registry.sagifer.com/sagifer/sorsfonalak-<szolgáltatás>címre. A frontend buildje a TypeScript-típusokat is ellenőrzi. Egy main-en már megépült commit a cache-ből pár mp alatt újraépül. - deploy (csak prod): felmásolja a
docker-compose.yml-t és aCaddyfile-t a szerverre, beírja az újTAG-et a szerveren lévő.env-be, majddocker compose pull && up -d. Az adatbázis-migrációk a backend indulásakor futnak le. - release (csak prod, a deploy után): létrehoz egy
v<év.hónap.nap>-<hash>taget és Gitea-release-t az előző release óta bekerült commitok listájával (repó → Releases).
Kézzel is indítható a repó Actions oldaláról (workflow_dispatch).
Runner (dev szerver)
A runner a ci/runner mappában van. A jobokat a gép Dockerén indítja, így az image-buildek a meglévő BuildKit cache-t használják. A tesztek cargo-cache-e a sorsfonalak-ci-* kötetekben marad meg.
- Regisztrációs token: Gitea → repó → Beállítások → Actions → Runners → Create new runner.
- Indítás:
A regisztráció a
cd ci/runner GITEA_RUNNER_REGISTRATION_TOKEN=<token> docker compose up -drunner-datakötetbe kerül. A későbbi indításokhoz már nem kell token.
A jobok elérik a gép Docker-socketjét, ez root-jogot jelent a dev szerveren. A workflow csak a repóba pusholt commitokra fut, forkból érkező pull requestekre nem.
Repó-beállítások
Gitea → repó → Beállítások → Actions:
| Név | Fajta | Érték |
|---|---|---|
REGISTRY_TOKEN |
secret | a sagifer fiók access tokenje, write:package jogosultsággal |
DEPLOY_SSH_KEY |
secret | a szerveren lévő deploy felhasználó privát kulcsa |
DEPLOY_HOST |
variable | deploy@<szerver IP> |
DEPLOY_KNOWN_HOSTS |
variable | az ssh-keyscan <szerver IP> kimenete |
DEPLOY_PATH |
variable | nem kötelező, alapértéke /opt/sorsfonalak |
Szerver (egyszeri beállítás)
Egy friss Ubuntu dropleten, rootként:
# Docker
curl -fsSL https://get.docker.com | sh
# 2 GB swap a 2 GB RAM mellé
fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
# deploy felhasználó, aki dockert futtathat
adduser --disabled-password --gecos '' deploy && usermod -aG docker deploy
mkdir -p /home/deploy/.ssh && echo '<publikus kulcs>' > /home/deploy/.ssh/authorized_keys
chown -R deploy: /home/deploy/.ssh && chmod 700 /home/deploy/.ssh && chmod 600 /home/deploy/.ssh/authorized_keys
mkdir -p /opt/sorsfonalak && chown deploy: /opt/sorsfonalak
# tűzfal: SSH bárhonnan, HTTP/HTTPS csak a Cloudflare felől
ufw allow OpenSSH
for net in $(curl -s https://www.cloudflare.com/ips-v4) $(curl -s https://www.cloudflare.com/ips-v6); do
ufw allow from "$net" to any port 80,443 proto tcp
done
ufw enable
A Docker által kinyitott portokat az ufw magától nem szűri, ezért a 80-as és a 443-as portot a DigitalOcean Cloud Firewall-ban is érdemes a Cloudflare tartományaira korlátozni: Networking → Firewalls, Inbound: SSH, és HTTP/HTTPS a Cloudflare IP-listával.
deploy felhasználóként, a /opt/sorsfonalak mappában:
.env: az itteni.env.examplekitöltve..env.secrets:OPENROUTER_API_KEY=....docker login registry.sagifer.comegyread:packagejogú tokennel. Amíg asagiferfiók nyilvános, erre nincs szükség.
Cloudflare (sorsfonalak.hu)
- DNS:
A sorsfonalak.hu → 165.22.194.5ésCNAME www → sorsfonalak.hu, mindkettő proxyzva (narancs felhő). - SSL/TLS mód: Full (strict).
- Always Use HTTPS: ki. A Let's Encrypt a Cloudflare-en át, sima HTTP-n ellenőrzi a domaint, a tanúsítvány megújításakor is. A HTTP→HTTPS átirányítást a Caddy maga végzi.
- A Caddy a Cloudflare címtartományaiban megbízik, ezért a naplókban és a backendnél a látogató valódi IP-címe látszik (
CF-Connecting-IP).
A Google OAuth kliensnél a https://sorsfonalak.hu címet fel kell venni az engedélyezett JavaScript-források közé.
Üzemeltetés
- Naplók:
docker compose logs -f backend worker - Visszaállás korábbi verzióra:
.env-benTAG=<régebbi hash>, utánadocker compose up -d - Mentés: naponta egy
pg_dumpa/opt/sorsfonalak/backupsmappába, 14 napig megmarad. A mentéseket érdemes a szerverről is elvinni (DigitalOcean backup, vagyrsyncotthonra). - Visszatöltés:
gunzip -c backups/sorsfonalak-<dátum>.sql.gz | docker compose exec -T postgres psql -U sorsfonalak sorsfonalak