Update README.md
This commit is contained in:
parent
b0ee86c924
commit
9f917de54a
253
README.md
253
README.md
@ -1,239 +1,126 @@
|
|||||||
|
|
||||||
# LiftEllenőr
|
# LiftEllenőr
|
||||||
|
|
||||||
Magyar nyelvű liftellenőrzési és naplózási rendszer technikusok számára.
|
> Magyar nyelvű liftellenőrzési és karbantartás-naplózási rendszer felvonószerelők és technikusok számára.
|
||||||
|
|
||||||
Az alkalmazás főbb részei:
|
## 🌟 Funkciók
|
||||||
|
|
||||||
- nyilvános landing oldal: `/`
|
- **🔒 Biztonságos hozzáférés:** JWT alapú hitelesítés és felhasználókezelés.
|
||||||
- bejelentkezés: `/bejelentkezes`
|
- **📝 Nyilvántartás:** Eszközök és hozzájuk tartozó karbantartási naplók elkülönített kezelése.
|
||||||
- regisztráció: `/regisztracio`
|
- **⚡ Gyors adatrögzítés:** Modális felületek új eszközök és naplóbejegyzések gyors felviteléhez.
|
||||||
- technikusi kezelőfelület: `/alkalmazas`
|
- **📎 Dokumentumkezelés:** PDF formátumú jegyzőkönyvek csatolása a naplóbejegyzésekhez.
|
||||||
- kereshető naplóoldal: `/naplo`
|
- **📊 Műszerfal:** Közelgő és lejárt ellenőrzési határidők vizuális nyomon követése.
|
||||||
|
- **🛠️ Beépített eszközök:** Kereshető napló, Adminer adatbázis-kezelő és seed script teszteléshez.
|
||||||
|
|
||||||
## Funkciók
|
## 🛠 Tech Stack
|
||||||
|
|
||||||
- JWT alapú hitelesítés
|
- **Frontend:** HTML/CSS/JS statikus fájlok, Nginx (webszerver és API proxy)
|
||||||
- PostgreSQL adatbázis
|
- **Backend:** Node.js (Express)
|
||||||
- külön kezelt eszközök és naplóbejegyzések
|
- **Adatbázis:** PostgreSQL
|
||||||
- modalos új eszköz / új napló folyamat
|
- **Infrastruktúra:** Docker / Podman Compose
|
||||||
- PDF csatolmányok feltöltése egy naplóhoz
|
|
||||||
- közelgő ellenőrzési határidők műszerfala
|
|
||||||
- Adminer webes adatbázis-kezelő a stack részeként
|
|
||||||
- nagy mennyiségű tesztadat generálása seed scripttel
|
|
||||||
|
|
||||||
## Stack
|
## 🚀 Gyors indítás
|
||||||
|
|
||||||
A `compose.yaml` alapján a rendszer ezekből a szolgáltatásokból áll:
|
### Előfeltételek
|
||||||
|
- [Node.js](https://nodejs.org/) (v22+)
|
||||||
|
- Docker és Docker Compose (vagy Podman)
|
||||||
|
|
||||||
- `frontend`
|
### Telepítés és futtatás
|
||||||
Nginx konténer, a statikus frontend kiszolgálására és az API proxyzására.
|
|
||||||
- `backend`
|
|
||||||
Node.js + Express alkalmazás, API-val és hitelesítéssel.
|
|
||||||
- `postgres`
|
|
||||||
PostgreSQL adatbázis a felhasználók, eszközök, naplók és fájlmetaadatok tárolására.
|
|
||||||
- `adminer`
|
|
||||||
Webes adatbázis-kezelő a PostgreSQL gyors böngészéséhez és ellenőrzéséhez.
|
|
||||||
|
|
||||||
## Portok
|
|
||||||
|
|
||||||
- alkalmazás: `http://localhost:8080`
|
|
||||||
- PostgreSQL: `localhost:5432`
|
|
||||||
- Adminer: `http://localhost:8090`
|
|
||||||
|
|
||||||
## Előfeltételek
|
|
||||||
|
|
||||||
- Node.js 22 körüli verzió
|
|
||||||
- npm
|
|
||||||
- Podman Compose vagy Docker Compose
|
|
||||||
|
|
||||||
## Gyors indítás
|
|
||||||
|
|
||||||
1. Függőségek telepítése:
|
1. Függőségek telepítése:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm install
|
npm install
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2. A teljes stack indítása:
|
2. A környezeti változók beállítása (opcionális, alapértelmezések az `.env.example`-ben):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
podman compose up -d
|
cp .env.example .env
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Ha Docker Compose-t használsz:
|
|
||||||
|
|
||||||
|
3. A teljes stack (Nginx, API, DB, Adminer) indítása:
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Nyisd meg az alkalmazást:
|
|
||||||
|
|
||||||
```text
|
*(Ha Podmant használsz, cseréld a `docker`-t `podman`-ra.)*
|
||||||
http://localhost:8080
|
4. Nyisd meg az alkalmazást a böngészőben: **http://localhost:8080**
|
||||||
```
|
|
||||||
|
|
||||||
## Stack kezelése
|
## 🔌 Hálózat és Portok
|
||||||
|
|
||||||
Indítás:
|
| Szolgáltatás | Port | Cím |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| **Alkalmazás (Nginx)** | `8080` | `http://localhost:8080` |
|
||||||
|
| **Backend API** | `3000` | `http://localhost:3000` |
|
||||||
|
| **PostgreSQL** | `5432` | `localhost:5432` |
|
||||||
|
| **Adminer** | `8090` | `http://localhost:8090` |
|
||||||
|
|
||||||
```bash
|
## 🗄️ Adatbázis és Tesztadatok (Seeding)
|
||||||
podman compose up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
Leállítás:
|
A projekt tartalmaz egy generátort (seed script), amellyel pillanatok alatt feltölthető az adatbázis tesztadatokkal (technikusok, útvonalak, liftek, naplók).
|
||||||
|
|
||||||
```bash
|
**Alapértelmezett teszt jelszó:** `teszt123`
|
||||||
podman compose down
|
|
||||||
```
|
|
||||||
|
|
||||||
Leállítás kötetekkel együtt:
|
Tesztadatok generálása:
|
||||||
|
|
||||||
```bash
|
|
||||||
podman compose down -v
|
|
||||||
```
|
|
||||||
|
|
||||||
Logok megtekintése:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
podman compose logs -f
|
|
||||||
```
|
|
||||||
|
|
||||||
Csak a backend logjai:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
podman compose logs -f backend
|
|
||||||
```
|
|
||||||
|
|
||||||
## Adminer használata
|
|
||||||
|
|
||||||
Az Adminer a `http://localhost:8090` címen érhető el.
|
|
||||||
|
|
||||||
Bejelentkezési adatok:
|
|
||||||
|
|
||||||
- rendszer: `PostgreSQL`
|
|
||||||
- szerver: `postgres`
|
|
||||||
Ha a böngészőből közvetlenül a hoston futó PostgreSQL-re csatlakozol, használhatod a `127.0.0.1` címet is, de a compose stacken belül a szolgáltatás neve `postgres`.
|
|
||||||
- felhasználó: `lift_admin`
|
|
||||||
- jelszó: `lift_secret`
|
|
||||||
- adatbázis: `lift_manager`
|
|
||||||
|
|
||||||
Adminerben hasznos műveletek:
|
|
||||||
|
|
||||||
- `users` tábla ellenőrzése
|
|
||||||
- `elevators` tábla böngészése
|
|
||||||
- `logs` és `log_files` kapcsolatok megtekintése
|
|
||||||
- seed után gyors ellenőrzés, hogy a tömeges tesztadat bekerült-e
|
|
||||||
|
|
||||||
## Seed adatok
|
|
||||||
|
|
||||||
A projekt tartalmaz egy seed scriptet sok tesztadat előállításához:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm run seed
|
npm run seed
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Ez több útvonalat, technikust, eszközt és sok kapcsolódó naplóbejegyzést hoz létre.
|
Adatbázis teljes törlése és újragenerálása:
|
||||||
|
|
||||||
Alap teszt jelszó:
|
|
||||||
|
|
||||||
```text
|
|
||||||
teszt123
|
|
||||||
```
|
|
||||||
|
|
||||||
Teljes újratöltéshez, a meglévő adatok törlésével:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm run seed:reset
|
npm run seed:reset
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Egyedi mennyiségekkel:
|
### Egyedi seed paraméterek
|
||||||
|
|
||||||
|
Testreszabhatod a generált adatok mennyiségét a CLI argumentumokkal:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
node scripts/seed.js --reset --routes 8 --users-per-route 4 --elevators-per-route 20 --logs-per-elevator 16
|
node scripts/seed.js --reset --routes 8 --users-per-route 4 --elevators-per-route 20 --logs-per-elevator 16
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Elérhető paraméterek:
|
### Adminer (Adatbázis böngésző)
|
||||||
|
|
||||||
- `--reset`
|
Az adatbázis közvetlen eléréséhez nyisd meg a `http://localhost:8090` címet az alábbi adatokkal:
|
||||||
Törli a meglévő adatokat seed előtt.
|
|
||||||
- `--routes`
|
|
||||||
Hány technikusi útvonal készüljön.
|
|
||||||
- `--users-per-route`
|
|
||||||
Hány felhasználó készüljön útvonalanként.
|
|
||||||
- `--elevators-per-route`
|
|
||||||
Hány eszköz készüljön útvonalanként.
|
|
||||||
- `--logs-per-elevator`
|
|
||||||
Hány napló készüljön eszközönként.
|
|
||||||
|
|
||||||
## Fejlesztői használat
|
* **Rendszer:** `PostgreSQL`
|
||||||
|
* **Szerver:** `postgres` *(ha hostról csatlakozol: `127.0.0.1`)*
|
||||||
|
* **Felhasználó:** `lift_admin`
|
||||||
|
* **Jelszó:** `lift_secret`
|
||||||
|
* **Adatbázis:** `lift_manager`
|
||||||
|
|
||||||
Ha nem konténerből akarod indítani a backendet:
|
## 💻 Helyi fejlesztés (Docker nélkül)
|
||||||
|
|
||||||
1. gondoskodj róla, hogy a PostgreSQL fusson
|
Ha a backendet natívan, konténeren kívül szeretnéd futtatni fejlesztéshez (a PostgreSQL-nek futnia kell):
|
||||||
2. telepítsd a függőségeket
|
|
||||||
3. indítsd a szervert
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Adatbázis indítása compose-zal
|
||||||
|
docker compose up -d postgres
|
||||||
|
|
||||||
|
# Backend indítása
|
||||||
npm install
|
npm install
|
||||||
npm start
|
npm start
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Alapértelmezett backend port:
|
*Megjegyzés: A frontend statikus fájljait és az API proxy-t alapértelmezetten az Nginx kezeli. Helyi backend fejlesztésnél érdemes a compose stacket használni, és csak a backend konténert újraépíteni változáskor.*
|
||||||
|
|
||||||
|
## 📂 Projekt struktúra
|
||||||
|
|
||||||
```text
|
```text
|
||||||
http://localhost:3000
|
.
|
||||||
```
|
├── nginx/ # Nginx konfiguráció (default.conf)
|
||||||
|
├── public/ # Statikus frontend fájlok (HTML, CSS, JS)
|
||||||
Ebben az esetben a frontend proxyzása nélkül a teljes alkalmazás használatához továbbra is a compose-os Nginx a legegyszerűbb út.
|
├── scripts/ # Segédscriptek (pl. seed.js)
|
||||||
|
├── compose.yaml # Docker Compose konfiguráció
|
||||||
## Környezeti változók
|
├── server.js # Express backend belépési pont
|
||||||
|
└── .env.example # Környezeti változók sablonja
|
||||||
Az alapértelmezett értékek az `.env.example` fájlban vannak összegyűjtve.
|
|
||||||
|
|
||||||
Fontos változók:
|
|
||||||
|
|
||||||
- `PORT`
|
|
||||||
- `JWT_SECRET`
|
|
||||||
- `DATABASE_URL`
|
|
||||||
- `SEED_PASSWORD`
|
|
||||||
Opcionális. Ezzel felülírható a seedelt felhasználók alap jelszava.
|
|
||||||
|
|
||||||
## Adatmodell röviden
|
|
||||||
|
|
||||||
- `users`
|
|
||||||
Technikusi felhasználók és útvonalak.
|
|
||||||
- `elevators`
|
|
||||||
Az eszközök aktuális állapota és következő ellenőrzési adatai.
|
|
||||||
- `logs`
|
|
||||||
Történeti naplóbejegyzések, eszközhöz kapcsolva.
|
|
||||||
- `log_files`
|
|
||||||
A naplóbejegyzésekhez tartozó PDF fájlmetaadatok.
|
|
||||||
|
|
||||||
## Tipikus használati folyamat
|
|
||||||
|
|
||||||
1. Indítsd el a stack-et.
|
|
||||||
2. Ha kell, seedeld az adatbázist `npm run seed:reset` paranccsal.
|
|
||||||
3. Nyisd meg az alkalmazást a `http://localhost:8080` címen.
|
|
||||||
4. Jelentkezz be vagy regisztrálj.
|
|
||||||
5. Az `/alkalmazas` oldalon kezeld az eszközöket és hozz létre új naplóbejegyzéseket.
|
|
||||||
6. A `/naplo` oldalon keresd és szűrd a bejegyzéseket.
|
|
||||||
7. Adminerben ellenőrizd az adatokat, ha fejlesztés vagy hibakeresés közben szükséges.
|
|
||||||
|
|
||||||
## Fontos fájlok
|
|
||||||
|
|
||||||
- `server.js`
|
|
||||||
Express route-ok, auth, adatbázis-műveletek
|
|
||||||
- `compose.yaml`
|
|
||||||
frontend + backend + postgres + adminer stack
|
|
||||||
- `nginx/default.conf`
|
|
||||||
frontend route-ok és API proxy
|
|
||||||
- `public/index.html`
|
|
||||||
landing oldal
|
|
||||||
- `public/app.html`
|
|
||||||
kezelőfelület
|
|
||||||
- `public/logs.html`
|
|
||||||
külön naplóoldal
|
|
||||||
- `public/style.css`
|
|
||||||
központi stíluslap
|
|
||||||
- `scripts/seed.js`
|
|
||||||
tesztadat-generáló script
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user