Rendszerkövetelmények
Mire van valójában szükséged a PrimeCal futtatásához? Ez attól függ, hogyan használod. Íme egy összefoglaló minden helyzetre.
Ha a app.primecal.eu oldalt használod, semmi másra nincs szükséged egy modern böngészőn és internetkapcsolaton kívül. Ugorj egyenesen a Felhő beállítása oldalra.
Webalkalmazás (felhő vagy saját üzemeltetés)
A PrimeCal webalkalmazás bármely modern, JavaScript-et engedélyező böngészőben fut. Nincs szükség plugin-re vagy bővítményre.
Támogatott böngészők
| Böngésző | Minimális verzió | Megjegyzés |
|---|---|---|
| Google Chrome | 90+ | Ajánlott |
| Mozilla Firefox | 88+ | Teljes mértékben támogatott |
| Microsoft Edge | 90+ | Teljes mértékben támogatott |
| Apple Safari | 14+ | Teljes mértékben támogatott |
| Opera | 76+ | Chromium-alapú, működnie kell |
Az Internet Explorer nem támogatott. A felsorolt böngészők nagyon régi verzióinál előfordulhatnak elrendezési hibák vagy hiányzó funkciók. A legjobb élmény érdekében tartsd frissen a böngésződet.
Hálózati követelmények
- Internetkapcsolat szükséges a felhős verzióhoz
- A JavaScript-nek engedélyezve kell lennie — a PrimeCal egy React single-page alkalmazás, és JavaScript nélkül nem fog működni
- Sütik (cookie-k) — A munkamenet-sütik (session cookie) az azonosításhoz szükségesek; győződj meg róla, hogy a böngésződ nem blokkolja ezeket a PrimeCal domainjén
Képernyőméret
A PrimeCal alkalmazkodik bármilyen képernyőmérethez 320px szélességtől (kisebb telefonok) felfelé. Az elrendezés automatikusan vált a mobilra optimalizált nézet (alsó tabulátor sáv, érintésbarát vezérlők) és az asztali nézet (oldalsávos navigáció) között, a képernyő szélességétől függően.
Mobilalkalmazás
A PrimeCal mobilalkalmazás ugyanannak a webalkalmazásnak egy natív csomagolása (Capacitor segítségével építve). Elérhető az alkalmazásáruházakból, és ugyanazt a teljes funkcionalitást nyújtja, mint a webalkalmazás, natív eszközintegrációval kiegészítve.
Android
- Minimum OS: Android 8.0 (Oreo) vagy újabb
- Ajánlott: Android 10 vagy újabb a legjobb teljesítményért
- Letöltés a Google Play Áruházból
iOS
- Minimum OS: iOS 14 vagy újabb
- Ajánlott: iOS 16 vagy újabb
- Letöltés az Apple App Store-ból
Nem kötelező telepítened a natív alkalmazást. A app.primecal.eu webalkalmazás is kiválóan működik mobilböngészőben, és hozzáadhatod a kezdőképernyődhöz egy alkalmazásszerű élményért.
Saját üzemeltetés: Docker (ajánlott)
A legegyszerűbb módja a PrimeCal saját üzemeltetésének a Docker és a Docker Compose használata. A legtöbb saját üzemeltető így futtatja.
Követelmények
| Komponens | Minimum | Ajánlott |
|---|---|---|
| Docker Engine | 20.10+ | Legújabb stabil |
| Docker Compose | 2.0+ (v2 CLI) | Legújabb stabil |
| RAM | 1 GB elérhető | 2 GB+ |
| Lemezterület | 2 GB | 10 GB+ (adatbázis növekedéséhez) |
| CPU | 1 mag | 2+ mag |
Adatbázis
A PrimeCal-hoz PostgreSQL adatbázis szükséges. A Docker beállításnál két lehetőséged van:
- PostgreSQL beépítése a Docker Compose stack-be — a legegyszerűbb megközelítés, részletesen a Docker beállítási útmutatóban
- Külső PostgreSQL-példány használata — irányítsd a PrimeCal-t egy már meglévő adatbázisszerverre
| Adatbázis | Minimális verzió |
|---|---|
| PostgreSQL | 14+ |
Az SQLite csak helyi fejlesztéshez érhető el. Produkciós saját üzemeltetéshez nem alkalmas a párhuzamossági korlátok és a teljes szöveges keresés hiánya miatt.
Hálózat
- A 80/443-as portoknak elérhetőnek kell lenniük (vagy bármely másik portra leképezheted)
- A HTTPS erősen ajánlott produkciós környezetben — használj reverse proxy-t, például nginx-et, Traefik-et vagy Caddy-t a PrimeCal konténerek elé
Saját üzemeltetés: helyi fejlesztés
Fejlesztőknek, akik forráskódból szeretnék futtatni a PrimeCal-t.
Követelmények
| Eszköz | Minimális verzió | Megjegyzés |
|---|---|---|
| Node.js | 18 LTS | 20 LTS ajánlott |
| npm | 9+ | A Node.js-szel együtt érkezik |
| Git | Bármely friss verzió | A repó klónozásához |
| PostgreSQL | 14+ | Vagy SQLite a gyors kezdéshez |
Operációs rendszer
- Linux — Teljes mértékben támogatott, produkcióhoz ajánlott
- macOS — Teljes mértékben támogatott fejlesztéshez
- Windows — Támogatott WSL2-n vagy Git Bash-en keresztül; a natív PowerShell a legtöbb parancshoz megfelel
A teljes beállítási folyamatért lásd a Helyi fejlesztés oldalt.
Saját üzemeltetés: Kubernetes
Produkciós méretű telepítésekhez. Lásd: Saját üzemeltetés: Kubernetes.
A Kubernetes telepítésekhez szükséges:
- Kubernetes 1.24+
- Egy PostgreSQL-példány (klaszteren belül vagy menedzselt szolgáltatás, mint az RDS, Cloud SQL, Azure Database)
- Egy konténerregisztri a PrimeCal Docker image-ek tárolásához
- Egy Ingress-vezérlő (nginx-ingress, Traefik, stb.)