Subscribely

Modern előfizetés-kezelő demó Next.js + MongoDB technológiával – a szerepkör-alapú hozzáférés, előfizetési folyamatok és konténerizált telepítés fókuszált bemutatója.

✨ Áttekintés / Gyorsinfók

• Terjedelem: 2 hónapos kreatív projekt (technikai bemutató, nem éles üzleti alkalmazás)
• Elsődleges cél: Egy teljes előfizetési rendszer bemutatása szerepkör-alapú hozzáférés-kezeléssel (RBAC), biztonságos hitelesítéssel, email folyamatokkal és Dockerizált fejlesztési/telepítési élménnyel.
• Licenc: MIT

📄 Leírás

A Subscribely egy demó alkalmazás, amely egy konfigurálható előfizetési piacteret valósít meg Admin és Felhasználó (User) szerepkörökkel. Tartalmazza a teljes (end-to-end) előfizetési folyamatot (vásárlás, lemondás, admin általi visszavonás), egyenlegkezelést, email értesítéseket, valamint fejlesztőbarát telepítést Docker és Vercel segítségével.

Megjegyzés: Ez a projekt egy technikai bemutató – portfólióhoz, tanuláshoz és demózáshoz hasznos –, nem piaci bevezetésre szánt termék.

✨ Bemutató

🔧 Funkciók

Hitelesítés és Szerepkörök

• Felhasználó regisztráció és bejelentkezés
• Szerepkör-alapú hozzáférés-vezérlés (Admin / User)
• Biztonságos JWT-alapú hitelesítés

Felhasználói lehetőségek

• Alapértelmezett USD egyenleg új fiókoknál
• "Előfizetési Áruház" böngészése
• Előfizetések vásárlása (max. 3 aktív)
• Előfizetések lemondása
• Profilbeállítások és fióktörlési lehetőség (folyamatban/work-in-progress)

Admin lehetőségek

• Előfizetési csomagok létrehozása / szerkesztése / törlése
• Összes felhasználói előfizetés megtekintése a platformon
• Felhasználói előfizetések visszavonása (automatikus emailt vált ki)
• Felhasználói egyenlegek módosítása

Előfizetési Rendszer

• Konfigurálható csomagok (név, leírás, ár, státusz)
• Rugalmas időtartamok (1 nap, 14 nap, 1 hónap stb.)
• Automatikus egyenleglevonás vásárláskor
• Email értesítések: vásárlási visszaigazolás, lemondások, admin általi visszavonások

📐 Technológiai Stack

• Next.js (App Router, TypeScript)
• MongoDB (Mongoose-szal)
• Vercel (telepítés/hosting)
• Docker & Docker Compose (lokális konténerizált fejlesztés)
• Node.js
• Tailwind CSS (stílusok)
• React Hook Form + Zod (űrlapok és validáció)
• Shadcn UI (komponens alapok)
• Nodemailer (email folyamatok)
• Sentry (monitorozás)
• Arcjet (biztonsági integráció)
• Repó és kollaboráció: GitHub

🗂️ Projekt Struktúra (magas szintű)

Plaintext

/ ├── .github/ ├── .husky/ ├── app/ ├── components/ ├── config/ ├── lib/ ├── public/ ├── types/ ├── docker-compose.yml ├── Dockerfile ├── next.config.js ├── package.json └── README.md

🌐 Fejlesztési Gyakorlatok

• Erősen típusos kód (TypeScript)
• Konvencionális commitok a tiszta előzményekért
• Git hookok Husky + lint-staged segítségével
• ESLint + Prettier szabványosítás
• JSDoc kommentek a kulcsfontosságú modulokhoz
• Sentry a futásidejű hibafigyeléshez

📥 Telepítés

Hagyományos (lokális fejlesztés)

Bash

# Klónozás git clone <github.com/dan0dev/Subs...ubscription.Manager.git> cd Subscribely.Subscription.Manager # Függőségek telepítése npm install # Fejlesztői szerver npm run dev # Az alkalmazás itt fog futni: <localhost:3000>

Docker (környezeti azonosság miatt ajánlott)

Előfeltételek: Docker 20.10+, Docker Compose v2+

Bash

# Klónozás és belépés git clone <github.com/dan0dev/Subs...ubscription.Manager.git> cd Subscribely.Subscription.Manager # Hozd létre a .env fájlt a sablonból és töltsd ki az értékeket # Indítás (build + futtatás) docker compose up --build # Fejlesztéshez "live reload" (automatikus frissítés) funkcióval docker compose up

🌳 Környezeti Változók

Állítsd be ezeket a .env.local fájlban vagy a Docker környezetben:

Code snippet

MONGODB_URI= JWT_SECRET= JWT_EXPIRES_IN= GMAIL_USER= GMAIL_PASSWORD= ARCJET_KEY= SENTRY_AUTH_TOKEN=

💻 Telepítés / Élesítés

• Az alkalmazás Vercelre van telepítve (lásd next.config.js és Vercel projekt beállítások).
• Docker támogatás elérhető alternatív telepítési célpontokhoz.

📝 Teendők / Jövőbeli fejlesztések

🤝 Közreműködés

Nyílt forráskódú – a közreműködést szívesen fogadjuk. Kérlek, olvasd el a CONTRIBUTING.md fájlt. Hibajelentésekhez és funkciókérelmekhez használd a GitHub Issues felületét.

📃 Licenc

MIT – lásd a LICENSE fájlt a repóban.