User Guide and System Manual of Food Ordering & Delivery System (Project: Stack-Over-Food)

User Guide

🧑‍🍳 System Overview
The Food Ordering & Delivery System is a web-based application designed to simplify online food ordering, payment, and delivery.

The system supports three main user roles:
Customer (User) – order food and make payments
Restaurant Owner – manage menus and orders
Rider (Delivery) – accept and deliver orders

Each role has specific functionalities to support their workflow within the platform.

🔐 1. Account Management
1.1 User Registration & Login
For All Users (Customer, Owner, Rider)
Navigate to the main page

Click Register if you don’t have an account
Enter:
Name
Email
Password
Click Create Account

For login:
Go to Login Page
Enter credentials
Click Login

1.2 Update Account Information
Steps:
Click Setting
Select Edit Profile
Update your information
Click Save Changes

🍔 2. Food Ordering (Customer)
2.1 Browse Restaurants & Menu
Navigate to Browse Page
Select a restaurant
View menu items

2.2 Add to Cart & Checkout
Click Add to Cart
Go to Cart Page
Click Checkout

💳 3. Payment System (PromptPay QR)
3.1 Make Payment
System generates QR Code
Scan QR using banking app
Enter the exact amount
Upload payment slip

3.2 Payment Rules
Payment must be completed within 10–15 minutes
If not completed → order becomes FAILED

📦 4. Order Status (Customer View)
Status Description
WAITING Waiting for payment
PAID Payment confirmed
COOKING Preparing food
WAIT_FOR_DELIVER Waiting for rider
DELIVERING On the way
COMPLETED Delivered
CANCELLED Cancelled by user
FAILED Payment expired

🚚 5. Delivery Process (Rider)
5.1 Accept Job
Navigate to Available Jobs
Click Accept Order

5.2 Deliver Order
Status updates to DELIVERING
Deliver food to customer
Click Complete Order

🏪 6. Restaurant Management (Owner)
6.1 Add Menu Items
Go to Dashboard
Click Add Menu
Enter:
Name
Price
Image
Preparation Time
Click Save

6.2 Manage Orders
View incoming orders
Update status:
COOKING
WAIT_FOR_DELIVER

⚠️ 7. Troubleshooting
Issue Solution
Payment not updated Wait or refresh
Upload failed Check file format
Order expired Place new order

🍽 Food Ordering & Delivery System - System Manual

📑 Table of Contents
System Overview
User Roles & Access Control
Functional Specifications
 3.1 Account Management
 3.2 Order System
 3.3 Payment System
 3.4 Delivery System
System Architecture Overview
API and Technology Stack
System Requirements
Security Considerations
Maintenance and Scalability

🧾 System Overview
The system connects customers, restaurants, and riders into a single platform.

Customers place orders
Restaurants prepare food
Riders deliver orders

🔐 User Roles & Access Control
👤 Customer
Register & login
Browse menus
Place orders
Upload payment slips
Track orders

🏪 Owner
Manage menu
View restaurant orders
Update order status

🚴 Rider
View available jobs
Accept delivery tasks
Complete deliveries

⚙️ Functional Specifications
3.1 👤 Account Management
User registration
JWT authentication
Profile management

3.2 🛒 Order System
Add items to cart
Checkout process
Order creation
Order status tracking

3.3 💳 Payment System
Generate PromptPay QR
Upload receipt
Auto verification
Payment expiration (10–15 min)

3.4 🚚 Delivery System
Rider job assignment
Accept order
Deliver & complete

🏗 System Architecture Overview
Frontend: Next.js (Tailwind CSS)
Backend: NestJS (Node.js)
Database: PostgreSQL
Authentication: JWT

🌐 API and Technology Stack
API Type: RESTful API
Frontend: Next.js + TypeScript
Backend: NestJS
Database: PostgreSQL
ORM: Sequelize

🧰 Server-Side Requirements
6.1.1 Server-Side
Processor: Intel(R) Core(TM) i7-7700HQ CPU@2.80GHz 2.81 GHz
Installed memory (RAM): 8.00 GB (7.89 GB usable)
System type: 64-bit Operating System, x64-based process
Operating System: Windows 10

6.1.2 Client-Side Requirements
CPU: Intel i5 / Ryzen 5
RAM: 8GB+
Browser: Chrome
Internet: 10 Mbps

6.2 Software Development Specifications
Backend: Node.js (NestJS)
Frontend: Next.js
Database: PostgreSQL
CI/CD: GitHub Actions

Code Repositories
The project codebase is maintained across the following repositories:

🔧 Backend - Node.js(Nest.js): https://github.com/Fewlnwza/Project-Stack-Over-Food/tree/master/backend
🖥 Frontend - React.js(Next.js): https://github.com/Fewlnwza/Project-Stack-Over-Food/tree/master/frontend

🔒 Security Considerations
JWT Authentication
Role-based access control
HTTPS encryption
Input validation
Duplicate payment detection

🔄 Maintenance and Future Scalability
Maintenance
Scheduled database backups
Monitoring payment system
API performance checks
Future Improvements
Real-time tracking
Payment gateway integration