Skip to content

README.md

Latest commit

 

History

History
88 lines (61 loc) · 2.98 KB

README.md

File metadata and controls

88 lines (61 loc) · 2.98 KB

🌐 Full Stack Web App: Flask + React

en ru

🧪 A project developed as part of the course "Engineering of Internet Systems"
🧱 A full-fledged full-stack web application, developed step-by-step through three practical assignments.
📦 Consists of a backend (Python + Flask + REST API) and a frontend (React + MUI), integrated via Docker Compose.

📚 Project Goal

To build a fully functional client-server application — from API design to frontend implementation and containerized deployment.

The project was completed in 3 main stages:

Stage Title Description
1 Backend (API) Реализация REST API на Flask, работа с Kaggle-датасетом
2 Frontend (React SPA) Web UI built with React and Material UI
3 Integration Connecting frontend to backend and testing interactions

🛠️ Technologies Used

Backend:

  • Python 3
  • Flask + Flask-RESTful
  • CORS, JSON serialization

Frontend:

  • React
  • MUI (Material UI)

▶️ Quick Start with Docker

Prerequisites

📝 Instructions

  1. Clone the repository:
git clone https://github.com/Bit-Maximum/Full-Stack-Web-App.git
cd Full-Stack-Web-App
  1. Build and start the project:
docker-compose up --build

The application will be available at: http://localhost:3000

The frontend will send API requests to the backend available at http://localhost:5000 inside the container..

🔍 View Individual Development Stages

To view the REST API implementation (backend), check out the stage-1-backend branch:

backend/README.md

To view the frontend implementation (React SPA), check out the stage-1-backend branch:

backend/README.md

💡Service Overview

🧩 Backend API:

  • REST API built with Flask
  • Dataset loaded and processed from Kaggle
  • CRUD operations implemented
  • Includes error handling and CORS support

🧩 Frontend:

  • Interface developed with React
  • Styled using Material UI
  • Includes a table view, filters, and detailed view for items

📷 Gallery

👤 Author

Maxim Merkurev Far Eastern Federal University, 2025