Fabók Árpád

Ami a kezdetekben egy egyszerű e-commerce gyakorló feladatként indult végül abban a gondolatban tetőzött, hogy „mi lenne ha a Bookline.hu oldalt Solarpunk motívumokkal tematizálnánk?” Természetesen nincs saját könyvesbolti adatbázisom, legalább is nem a tízezres méretekben, így a bolt inventory-ját a Google Books nyílvános API hívásokkal lekérdezhető adatbázisa helyettesíti, ezt leszámítva azonban ugyanúgy meg lehet mindent „venni” mint egy igazi boltban. (Megjegyezendő azonban, hogy a Google Books fenntart egy napi 1000 lekérdezési limitet API kulcsonként, és bár igyekeztem Redis cache-elést bevezetni az applikációba a nap végén ez egy példa oldal ami nem fog több száz felhasználót kiszolgálni.)

Az oldalra bárki képes regisztrálni és bejelentkezni akár saját email cím / jelszó kombinációval, akár a Google bejelentkezési felületen keresztül (és minta oldal lévén akár törölheted is a fiókodat ha úgy gondolod). Ha egy bejelentkezett felhasználó megvásárol egy vagy több könyvet akkor azokat egy Magángyűjteménybe szervezve fogja megtalálni a saját felhasználói fiókjában ahol akár személyes értékeléseket is írhat róluk és azok véletlenszerűen megjelenhetnek a főoldal könyvajánlói szakaszában. Sőt, aki elfelejtette a jelszavát annak az email címére levélben megküld egy kriptografikusan generált URL-t amin keresztül csak az adott felhasználó tud újraregisztrálni (jelszót változtatni) egy adott idősávon belül.

Az applikáció Next.js 15 keretrendszerben lett megírva és egyszerű Javascriptet és CSS-t használ, valamint jó sok Tailwind osztályt. A felhasználói autentikációt és munkamenet kezelést a NextAuth csomag végzi, az ezekhez szükséges adatbázis műveletekhez pedig egy külső MongoDB Atlas adatbázist használ. Egy ennél kicsit részletesebb beszámolóhoz azt javasolnám hogy látogass el az oldalra és próbálj meg minél több lábléc üzenetet összevadászni.

GitHub forráskód: https://github.com/FarpadGit/Solibrarium

Egy Angular 19+-ban írt közösségi fórum oldal ami egy Reddithez hasonló beágyazott komment struktúrával teszi lehetővé, hogy a felhasználók megjegyzéseket hagyjanak egymás posztjai alatt, amiket „járásokba” (kategóriákba) szervezve jelenít meg a főoldal. Minden felhasználó írhat saját kommentet akár az eredeti posztra akár mások válaszaira, lájkolhatják mások kommentjeit vagy létrehozhatnak új posztot a főoldalon, a posztjaikhoz pedig csatolhatnak maximum 9 kép csatolmányt. Mindezt akár bejelentkezés nélkül is megtehetik, ugyanis az oldal felkeresésekor alapvetően mindenki egy megosztott „vendég” fiókba van bejelentkezve és minden alap funkció mindenkinek egyformán elérhető, csak ezzel együtt ez azt is jelenti, hogy bárki könnyedén felülírhatja amit itt csináltál. Bejelentkezett felhasználók írásait azonban csak ők maguk változtathatják meg és a lájkjaikat is csak ők vonhatják vissza. Bejelentkezni Google-os email címmel lehet a jobb felső lebegő gombra kattintva. (Aki bejelentkezik az bekerül az app adatbázisába.)

Ez a projekt valójában két együttműködő projekt egyben (három, hogyha a kép csatolmány szervert is külön beszámoljuk), egy felhasználó oldali frontend ami egy Angular SPA (Single Page Application), és egy szerver oldali backend ami egy Fastify alapú Nest.js keretrendszerben íródott. Ez a két kód két különböző címen került hosztolásra, és a projekt fő kihívása az volt hogy a két oldal sikeresen tudjon sütiken keresztül kommunikálni egymással, nemcsak a CORS védelem ellenében hanem a Vercel sajátos implementációs megoldásait is körbejárva.

A frontend oldal Typescriptet és SCSS stíluslapokat használ, az adatbázis pedig egy helyben tárolt PostgeSQL adatbázis amit a Vercel biztosít.

A kép csatolmányok kezeléséért egy saját Medea nevű projekt a felelős, ami API hívásokon keresztül kommunikál a Wayfarer backend oldalával és a felhasználó által feltöltött képeket egy saját adatbázisban tartja nyílván. (Egész pontosan a workflow úgy néz ki, hogy a Wayfarer frontend oldala feltölti a csatolmányokat a Vercel Blob adattárházba ami pont ilyen adatfájlokra specializálódott, majd szól a Medea-nak hogy másolja fel azokat az ImageKit.io médiakezelő platformra és tartsa számon őket egy saját Postgres adatbázisban, majd az megküldi a feltöltött képek URL-jét a Wayfarer-nek. Vendég felhasználók csatolmányait 30 nap után törli a rendszer és a posztokban csak egy placeholder kép fog megjelenni.)

Github forráskód: https://github.com/FarpadGit/Wayfarer