Show page

Differences

This shows you the differences between two versions of the page.

--- isi:laboratoare:06 [2025/11/09 23:11]
alexandru.predescu
+++ isi:laboratoare:06 [2025/11/15 10:58] (current)
alexandru.predescu
@@ Line 1: / Line 1: @@
-===== Laboratorul 06. Arhitectura client-server =====
+===== Laboratorul 06. Arhitectura client-server. Python Flask =====
 ==== Obiective laborator ====
@@ Line 11: / Line 11: @@
   * Cum funcționează cererile și răspunsurile (request-response cycle)
-=== Scenarii din viața reală unde veți folosi asta ===
+=== Exemple de aplicare ===
 La job:
@@ Line 32: / Line 32: @@
   * Dashboard-uri pentru crypto
   * Orice idee de startup
 În acest laborator veți înțelege **cum funcționează** cu adevărat o aplicație web. Veți scrie codul care procesează cereri, validează date, interacționează cu baza de date și returnează răspunsuri - toate acestea fiind componentele esențiale ale oricărei aplicații moderne. Veți dezvolta **o aplicație completă** folosind arhitectura client-server. În plus față de laboratoarele anterioare, veți crea un **backend REST API** în Flask care gestionează task-uri (adăugare, citire, actualizare, ștergere) și le stochează într-o bază de date SQLite.
@@ Line 74: / Line 73: @@
   * **Corpul răspunsului**, care conține datele returnate clientului (ex. un fișier HTML sau JSON).
-== Request-response cycle ==
+== Ciclul Request-Responsee ==
 Mecanismul de bază în arhitectura client-server este **Request-response cycle**.
@@ Line 83: / Line 82: @@
 Acest proces permite interacțiunea continuă între client și server, fiecare cerere fiind procesată independent.
-== Endpoint-uri (Routes) ==
+== Endpoint-uri (rute) ==
 Un endpoint este o adresă URL la care serverul răspunde. În Flask:
@@ Line 94: / Line 93: @@
 </code>
-== Metode HTTP (Verbe) ==
+== Metode HTTP (verbe) ==
-- **GET**: Citește/Returnează/Afișează/Obține date (ex: obține lista de task-uri)
+  * **GET**: Citește/Returnează/Afișează/Obține date (ex: obține lista de task-uri)
-- **POST**: Creează/Postează date noi (ex: adaugă un task nou)
+  * **POST**: Creează/Postează date noi (ex: adaugă un task nou)
-- **PUT**: Actualizează (Pune chestii noi peste) date existente (ex: marchează task ca finalizat)
+  * **PUT**: Actualizează (Pune chestii noi peste) date existente (ex: marchează task ca finalizat)
-- **DELETE**: Șterge date (ex: șterge un task)
+  * **DELETE**: Șterge date (ex: șterge un task)
 == JSON - Formatul de Date ==
@@ Line 113: / Line 112: @@
 </code>
-== Status Codes (Coduri de Răspuns) ==
+== Status Codes (coduri de răspuns) ==
- * **200 OK**: Cererea a fost procesată cu succes
+  * **200 OK**: Cererea a fost procesată cu succes
- * **201 Created**: Resursă nouă creată cu succes
+  * **201 Created**: Resursă nouă creată cu succes
- * **400 Bad Request**: Date invalide trimise de client
+  * **400 Bad Request**: Date invalide trimise de client
- * **404 Not Found**: Resursa nu există
+  * **404 Not Found**: Resursa nu există
- * **500 Internal Server Error**: Eroare pe server
+  * **500 Internal Server Error**: Eroare pe server
+==== Plan Laborator ====
 === Setup ===
 . Pentru a începe, asigurați-vă că aveți instalat [[https://www.python.org/downloads/|Python]].
+**Nu aveți Python?** > [[https://www.python.org/downloads/|python.org/downloads]] (bifați "Add to PATH" la instalare!)
 . Verificați instalarea rulând comanda în terminal: ''python --version''.
 . Descarcati scheletul de cod de [[https://github.com/ACS-ISI/Backend_Server|aici]].
+<code bash>
+git clone https://github.com/ACS-ISI/Backend_Server
+cd Backend_Server
+</code>
+**Nu aveți git?** > Descărcați ZIP de pe GitHub > Extract
 <note>
@@ Line 153: / Line 163: @@
 </note>
+**Salvați fișierul după fiecare modificare. Serverul se restartează automat (debug mode).**
 . Deschideti proiectul folosind IDE-ul preferat, de exemplu Visual Studio Code cu extensia Python sau un IDE specializat pentru Python, precum [[https://www.jetbrains.com/pycharm/|PyCharm]] și rulați comanda pentru instalarea dependențelor din fișierul //requirements.txt//.
@@ Line 165: / Line 177: @@
 . Dupa finalizarea primului **TO DO** pentru testare descarcati postman de [[https://www.postman.com/downloads/|aici]].
+<note tip>
+Tutorial testare cu Postman:
+. **New Request**:
+  * Method: `PUT`
+  * URL: `http://localhost:5000/tasks/1` (înlocuiți `1` cu ID-ul unui task existent)
+. **Body > raw > JSON**:
+<code json>
+{
+  "completed": true
+}
+</code>
+. **Send**
+**Rezultat așteptat:**
+<code json>
+{
+  "id": 1,
+  "title": "Finalizează laboratorul",
+  "description": "Task 1 și Task 2",
+  "completed": true
+}
+</code>
+</note>
 <note tip>
@@ Line 188: / Line 230: @@
 === Task ===
-Completati **TO DO**-urile din scheletul de cod, acestea sunt **self explanatory**. Scopul acestora este sa intelegeti cum sa interactionati cu o baza de date prin intermediul unui **server**. Prin aceste metode numite **endpoint-uri** puteti realiza comunicarea dintre client si server.
+Completati **TO DO**-urile din scheletul de cod, acestea sunt **self explanatory**. Pentru paginare, puneti doi parametri: page (numarul paginii) si limit (numar de inregistrari per pagina). Scopul acestora este sa intelegeti cum sa interactionati cu o baza de date prin intermediul unui **server**. Prin aceste metode numite **endpoint-uri** puteti realiza comunicarea dintre client si server.
 <note tip>
 **Urmăriți comentariile din schelet** și tutorialul Flask-SQLAlchemy [[https://flask-sqlalchemy.readthedocs.io/en/stable/quickstart/|Quick Start]] pentru a implementa operațiile cu baza de date necesare pentru implementarea funcționalităților de lucru cu datele. Alternativ, folosiți direct biblioteca [[https://docs.python.org/3/library/sqlite3.html|sqlite3]] (vezi exemple în scheletul de cod) pentru a interoga baza de date folosind sintaxă SQL.
@@ Line 226: / Line 268: @@
+== Probleme Comune ==
-=== [Q&A] ===
+Eroare: "ModuleNotFoundError: No module named 'flask'"
+**Soluție**: Nu ai instalat dependențele. Rulează:
+<code bash>
+pip install -r requirements.txt
+</code>
+Eroare: "Address already in use"
+**Soluție**: Portul 5000 este deja folosit. Oprește procesul anterior sau schimbă portul:
+<code python>
+app.run(debug=True, port=5001)
+</code>
+Eroare: "404 Not Found" când testezi în Postman
+**Verificări**:
+  * Serverul Flask rulează? (vezi în terminal)
+  * URL-ul este corect? (ex: `http://localhost:5000/tasks`)
+  * Metoda HTTP este corectă? (GET, POST, etc.)
+Date nu apar în baza de date
+**Verificări**:
+  * Ai apelat `db.session.commit()`?
+  * Nu sunt erori în consolă?
+  * Verifică cu DB Browser dacă fișierul `tasks.db` există în folder-ul `instance`
+==== [Q&A] ====
 == De ce trecem de la Firebase la Flask? ==
@@ Line 278: / Line 352: @@
   * Planifici să scalezi aplicația
   * Vrei să înveți cum funcționează cu adevărat un backend
+==== Resurse Utile ====
+== Documentație ==
+  * [Flask Official Docs](https://flask.palletsprojects.com/)
+  * [Flask-SQLAlchemy Quickstart](https://flask-sqlalchemy.readthedocs.io/en/stable/quickstart/)
+  * [HTTP Status Codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)
+  * [REST API Best Practices](https://restfulapi.net/)
+== Tutoriale Video ==
+  * [Flask Tutorial for Beginners](https://www.youtube.com/watch?v=Z1RJmh_OqeA)
+  * [Building a REST API with Flask](https://www.youtube.com/watch?v=s_ht4AKnWZg)
+== Cheat sheets ==
+  * [Flask Cheat Sheet](https://s3.us-east-2.amazonaws.com/prettyprinted/flask_cheatsheet.pdf)
+  * [SQLAlchemy Cheat Sheet](https://www.pythonsheets.com/notes/python-sqlalchemy.html)

Administrativ

Laboratoare

Proiect

Arhivă

isi/laboratoare/06.1762722717.txt.gz · Last modified: 2025/11/09 23:11 by alexandru.predescu

Show page Old revisions

Media Manager Back to top