backend feladat

2026-02-13 20:50:01 +01:00
parent 0f0e463062
commit d90a6ed735
4 changed files with 0 additions and 1786 deletions
@@ -1,222 +0,0 @@
 # Egyéni Feladat – User Management Rendszer
 > **Ez a leírás teljesen kezdőknek is szól! Ha még soha nem fejlesztettél, akkor is végig tudsz menni rajta. Minden lépésnél részletes magyarázatot, példákat és forrásokat találsz.**
 ---
 ## 0. Alapok, amiket tudni érdemes
 ### Mi az a User Management rendszer?
 Egy olyan program, amiben felhasználókat tudsz létrehozni, listázni, módosítani, törölni. Ilyen van minden weboldalon, ahol regisztrálni lehet.
 ### Mik azok a REST API-k?
 Olyan szabályok szerint működő webes szolgáltatások, amikhez más programok (vagy akár te is) tudsz kéréseket küldeni (pl. "add vissza az összes felhasználót").
 ### Mik azok a rétegek (layer-ek)?
 A programot több részre bontjuk, hogy átláthatóbb legyen. Pl. külön rész kezeli az adatokat, külön rész a webes kéréseket.
 ### Mik azok a parancsok (Command) és lekérdezések (Query)?
 - **Command:** Valamit módosít (pl. új user létrehozása)
 - **Query:** Csak lekérdez (pl. összes user listázása)
 ---
 ## 1. Szükséges eszközök, telepítés
 1. **Node.js letöltése:**
   - Menj a https://nodejs.org/ oldalra, töltsd le a LTS verziót, telepítsd.
 2. **Kód szerkesztő:**
   - Ajánlott: [Visual Studio Code](https://code.visualstudio.com/)
 3. **Postman vagy Thunder Client:**
   - Ezekkel tudod tesztelni az API-t. [Postman letöltése](https://www.postman.com/downloads/)
 ---
 ## 2. Projekt létrehozása, első lépések
 1. Hozz létre egy új mappát pl. `user-management` néven.
 2. Nyisd meg a mappát VS Code-ban.
 3. Nyiss egy terminált (Terminal > New Terminal).
 4. Írd be: `npm init -y` (létrehozza a package.json-t)
 5. Telepítsd az Express-t: `npm install express`
 6. (Ha JSON fájlt használsz adattárolásra, nem kell adatbázis.)
 ---
 ## 3. Mappastruktúra kialakítása
 Javasolt szerkezet:
 ```
 user-management/
  src/
    API/
    Application/
    Domain/
    Infrastructure/
  package.json
 ```
 Minden mappába majd külön fájlokat teszünk (lásd lentebb).
 ---
 ## 4. Kódolás lépésről lépésre (példákkal)
 ### 4.1. API réteg (Express szerver)
 - Hozz létre egy `src/API/server.js` fájlt.
 - Írd bele az alábbi mintát:
 <details>
 <summary>Express szerver példa</summary>
 ```js
 import express from 'express';
 const app = express();
 app.use(express.json());
 app.get('/', (req, res) => {
  res.send('Hello, User Management!');
 });
 app.listen(3000, () => {
  console.log('Szerver fut a http://localhost:3000 címen');
 });
 ```
 </details>
 - Futtasd: `node src/API/server.js` (ha hibát ír, nézd meg, hogy mindenhol helyes-e az elérési út és a kód)
 ### 4.2. Domain réteg (interfész, entitás)
 - Hozz létre egy `src/Domain/IUserRepository.js` fájlt.
 - Írd bele, hogy milyen műveleteket vársz el (pl. createUser, getUserById, stb.)
 <details>
 <summary>IUserRepository.js példa</summary>
 ```js
 export default class IUserRepository {
  createUser(user) {}
  getUserById(id) {}
  getAllUsers() {}
  updateUser(id, user) {}
  deleteUser(id) {}
 }
 ```
 </details>
 ### 4.3. Infrastructure réteg (adattárolás)
 - Hozz létre egy `src/Infrastructure/userRepository.js` fájlt.
 - Ebben valósítsd meg az IUserRepository metódusait, pl. JSON fájlba írással/olvasással.
 <details>
 <summary>userRepository.js példa (részlet)</summary>
 ```js
 import fs from 'fs/promises';
 import path from 'path';
 import IUserRepository from '../Domain/IUserRepository.js';
 const DATA_PATH = path.resolve('src/Infrastructure/user.json');
 export default class UserRepository extends IUserRepository {
  async createUser(user) {
    // ...
  }
  // ... többi metódus ...
 }
 ```
 </details>
 - Hozz létre egy `user.json` fájlt is, pl. így:
 <details>
 <summary>user.json példa</summary>
 ```json
 []
 ```
 </details>
 ### 4.4. Application réteg (Command/Query handlerek)
 - Hozz létre minden CRUD művelethez külön Command/Query és Handler fájlt.
 - Pl. `createUserCommand.js`, `createUserCommandHandler.js`, stb.
 <details>
 <summary>createUserCommand.js példa</summary>
 ```js
 export default class CreateUserCommand {
  constructor(user) {
    this.user = user;
  }
 }
 ```
 </details>
 <details>
 <summary>createUserCommandHandler.js példa</summary>
 ```js
 import UserRepository from '../../Infrastructure/userRepository.js';
 export default class CreateUserCommandHandler {
  constructor() {
    this.userRepository = new UserRepository();
  }
  async handle(command) {
    return await this.userRepository.createUser(command.user);
  }
 }
 ```
 </details>
 ### 4.5. API végpontok (Controller, Router)
 - Hozz létre egy `userController.js`-t és egy `userRouter.js`-t az API mappában.
 - A controller hívja a handlereket, a router összeköti az útvonalakat a controllerrel.
 <details>
 <summary>userController.js példa</summary>
 ```js
 import CreateUserCommand from '../../Application/users/command/createUserCommand.js';
 import CreateUserCommandHandler from '../../Application/users/command/createUserCommandHandler.js';
 export async function createUser(req, res) {
  const command = new CreateUserCommand(req.body);
  const handler = new CreateUserCommandHandler();
  const result = await handler.handle(command);
  res.status(201).json(result);
 }
 ```
 </details>
 ---
 ## 5. Tesztelés, hibakeresés
 - Indítsd el a szervert: `node src/API/server.js`
 - Küldj kéréseket Postmanből vagy Thunder Clientből (GET, POST, PUT, DELETE)
 - Ha hibát kapsz, olvasd el figyelmesen a hibaüzenetet, keresd meg a fájlban a hibás sort.
 - Próbáld ki az összes végpontot, nézd meg, hogy minden működik-e.
 ---
 ## 6. Dokumentáció, beadás
 - Készíts egy rövid leírást (README.md), amiben leírod:
  - Mit csinál a programod?
  - Hogyan kell elindítani?
  - Milyen extra funkciót raktál bele?
 - Csatold a forráskódot és a tesztadatokat.
 ---
 ## 7. Hasznos források, videók
 - [Node.js alapok magyarul (videó)](https://www.youtube.com/watch?v=U8XF6AFGqlc)
 - [Express.js alapok magyarul (videó)](https://www.youtube.com/watch?v=1n_V2A4bHqw)
 - [REST API magyarázat (videó)](https://www.youtube.com/watch?v=Q-BpqyOT3a8)
 - [JSON fájlok kezelése Node.js-ben (angol)](https://www.digitalocean.com/community/tutorials/how-to-read-and-write-json-files-in-node-js)
 - [VS Code rövid bemutató (magyar)](https://www.youtube.com/watch?v=VqCgcpAypFQ)
 ---