🚀 Fullstack Application – User Management

👩‍💻 Author

Imane Lmzk

---

📌 Description

This project is a Fullstack Web Application composed of:

• A Backend API built with Node.js, Express, and TypeScript
• A Frontend application (to be connected or extended)

The backend provides a RESTful API to manage users, while the frontend consumes these APIs to display and interact with data.

---

🧱 Architecture Overview

Frontend (UI)
   ↓ HTTP Requests
Backend (Express API)
   ↓
Database (PostgreSQL via Prisma ORM)

---

🛠️ Tech Stack

🔙 Backend

• Node.js
• Express.js
• TypeScript
• Prisma ORM
• PostgreSQL

🔜 Frontend (Planned / Optional)

• Flutter (Mobile/Web) OR
• React.js (optional)

🧪 Tools

• Postman (API testing)
• Git & GitHub

---

📂 Project Structure

project-root/
│
├── backend/
│   ├── src/
│   │   ├── config/
│   │   ├── controllers/
│   │   ├── routes/
│   │   ├── models/
│   │   ├── middlewares/
│   │   └── server.ts
│
├── frontend/ (optional / upcoming)
│
└── README.md

---

⚙️ Installation

Clone the repository:

git clone https://github.com/imanelmzk/Back-END-with-Postman.git
cd ts_1

Backend Setup

cd backend
npm install

---

▶️ Running the Backend Server

npm run dev

Server will run on:

http://localhost:3000

---

🔌 API Endpoints

📍 Get all users

GET /users

📍 Get user by ID

GET /users/:id

📍 Create a user

POST /users

Body:

{
  "name": "Imane lmzk",
  "email": "imane.lmzk@gmail.com"
}

📍 Update a user

PUT /users/:id

📍 Delete a user

DELETE /users/:id

---

🧠 Key Concepts Learned

• REST API design
• HTTP methods & status codes
• MVC architecture (Routes → Controllers)
• ORM usage with Prisma
• Asynchronous programming (async/await)
• Backend–Frontend communication

---

🧪 Testing

You can test the backend using:

• Postman
• Any REST client

---

📈 Future Improvements

Backend

• JWT Authentication
• Data validation (Zod / Joi)
• Pagination & filtering
• Role-based access control

Frontend

• Build UI with Flutter or React
• Connect to backend API
• Authentication UI (login/register)

DevOps

• Deployment (Render / Railway)
• Environment variables (.env)

---

📬 Contact

Feel free to connect or reach out for collaboration!

---