CTECH Web System

Hệ thống quản lý trường học CTECH - Full-stack web application với Node.js + Express backend và Vanilla JavaScript frontend.

📋 Yêu cầu hệ thống

Trước khi bắt đầu, đảm bảo máy tính đã cài đặt:

Node.js >= 16.x (Download)
MySQL >= 8.0 (Download)
Git (optional, để clone repository)

🚀 Hướng dẫn cài đặt

Bước 1: Clone hoặc download project

# Nếu dùng Git
git clone https://github.com/GauCandy/Ctech-Web
cd "Api Web"

# Hoặc download ZIP và giải nén

Bước 2: Cài đặt dependencies

npm install

Lệnh này sẽ cài đặt tất cả packages cần thiết:

express, mysql2, multer
openai (cho chatbot)
pdfjs-dist (parse PDF thời khóa biểu)
dotenv, cors, và các dependencies khác

Bước 3: Cấu hình database

3.1. Tạo database MySQL

Mở MySQL Command Line hoặc MySQL Workbench và chạy:

CREATE DATABASE ctech_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3.2. Tạo file `.env`

Tạo file .env ở thư mục gốc với nội dung:

# Database Configuration
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_mysql_password
DB_NAME=ctech_db

# Server Configuration
PORT=3000

# Session Configuration (optional, có giá trị mặc định)
SESSION_TIMEOUT=3600                # 1 giờ (3600 giây)
SESSION_REMEMBER_TIMEOUT=2592000    # 30 ngày (2592000 giây)

# OpenAI Configuration (cho chatbot)
OPENAI_API_KEY=sk-your-openai-api-key

# Bank Information (cho VietQR payment)
BANK_BIN=970422
BANK_NUMBER=0372360619
BANK_OWNER=Tran Tuan Tu
BANK_NAME=MB Bank

Lưu ý:

Thay your_mysql_password bằng mật khẩu MySQL của bạn
Nếu không dùng chatbot, có thể bỏ qua OPENAI_API_KEY
Bank info dùng để tạo VietQR code thanh toán

Bước 4: Tạo thư mục uploads

mkdir uploads
mkdir uploads\services

Hoặc trên Linux/Mac:

mkdir -p uploads/services

Lưu ý: Database schema sẽ được tự động tạo khi chạy server lần đầu tiên. Server tự động đọc file src/backend/database/schema.sql và tạo các bảng:

user_accounts - Tài khoản người dùng
students, teachers, admin_profiles - Hồ sơ theo role
user_sessions - Session tokens
services - Dịch vụ trường cung cấp
orders - Đơn hàng
vouchers - Mã giảm giá
student_device_registry - Quản lý thiết bị sinh viên
student_device_logins - Lịch sử đăng nhập thiết bị

Không cần chạy manual SQL script!

▶️ Chạy ứng dụng

Khởi động server

node index.js

Nếu thành công, bạn sẽ thấy:

Database connection pool is ready.
Services catalog exported to ... (X services, extraTxt=Y).
API server listening on port 3000

Lưu ý: Lần chạy đầu tiên, server sẽ tự động:

Tạo tất cả các bảng từ schema.sql
Export services catalog cho chatbot
Khởi động web server trên port 3000

Truy cập ứng dụng

Mở trình duyệt và truy cập:

Trang chủ: http://localhost:3000
Đăng nhập: http://localhost:3000/login
Dịch vụ: http://localhost:3000/services
Lịch học: http://localhost:3000/schedule
Admin: http://localhost:3000/admin

Kiểm tra API health

curl http://localhost:3000/api/status

Hoặc mở: http://localhost:3000/api/status

👤 Tài khoản mặc định

Sau khi setup xong, hệ thống sẽ tự động tạo tài khoản admin từ environment variable. Kiểm tra trong code src/backend/api/features/auth/services/adminAccountService.js để biết username/password.

Tạo tài khoản sinh viên mới:

curl -X POST http://localhost:3000/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Nguyen Van A",
    "email": "student@example.com",
    "phoneNumber": "0123456789",
    "classCode": "CNTT2024A",
    "department": "Công nghệ thông tin",
    "password": "password123"
  }'

🔧 Development

Cấu trúc thư mục

Api Web/
├── src/
│   ├── backend/           # Backend API
│   │   ├── api/          # API routes và controllers
│   │   ├── database/     # Database setup và connection
│   │   └── server/       # Express app configuration
│   └── frontend/         # Frontend static files
│       ├── css/         # Stylesheets
│       ├── js/          # JavaScript modules
│       ├── img/         # Images
│       └── *.html       # HTML pages
├── uploads/              # Uploaded files
├── index.js             # Application entry point
├── package.json         # Dependencies
└── .env                 # Environment configuration

Scripts hữu ích

# Khởi động server
node index.js

# Hoặc dùng nodemon để auto-restart khi code thay đổi
npm install -g nodemon
nodemon index.js

Test API với curl

Login:

curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"SV001","password":"password123"}'

Get services:

curl http://localhost:3000/api/services

Get services với authentication:

curl http://localhost:3000/api/services \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

📚 Documentation

API.md - Complete API documentation
src/backend/README.md - Backend architecture
src/frontend/README.md - Frontend architecture

🎯 Tính năng chính

✅ Authentication - Login với session tokens (remember me support)
✅ User Management - Quản lý sinh viên, giáo viên, admin
✅ Services - Catalog dịch vụ với categories (real-time updates)
✅ Orders - Đặt hàng và thanh toán qua VietQR
✅ Vouchers - Hệ thống mã giảm giá
✅ Timetable - Upload và parse PDF thời khóa biểu
✅ Chatbot - AI chatbot với OpenAI (cached responses)
✅ Admin Panel - Quản lý users, services, orders
✅ Presentation Mode - Thuyết trình với điều khiển từ xa
✅ Theme System - Đổi theme động
✅ Device Management - 1 thiết bị per sinh viên

🐛 Troubleshooting

Lỗi: "Cannot connect to MySQL"

Nguyên nhân: Database chưa chạy hoặc thông tin kết nối sai

Giải pháp:

Kiểm tra MySQL đang chạy: mysql -u root -p
Kiểm tra thông tin trong .env (DB_HOST, DB_USER, DB_PASSWORD)
Kiểm tra database ctech_db đã được tạo chưa

Lỗi: "Port 3000 already in use"

Nguyên nhân: Đã có process khác đang dùng port 3000

Giải pháp:

Đổi PORT trong .env (ví dụ: PORT=3001)
Hoặc kill process đang dùng port 3000:
- Windows: netstat -ano | findstr :3000 rồi taskkill /PID <PID> /F
- Linux/Mac: lsof -ti:3000 | xargs kill

Lỗi: "OPENAI_API_KEY not configured"

Nguyên nhân: Thiếu API key để dùng chatbot

Giải pháp:

Nếu không dùng chatbot: Bỏ qua lỗi này, các tính năng khác vẫn hoạt động
Nếu muốn dùng chatbot: Lấy API key tại https://platform.openai.com/api-keys và thêm vào .env

Lỗi: "Cannot find module"

Nguyên nhân: Dependencies chưa được cài đặt

Giải pháp:

npm install

Database tables không được tạo

Nguyên nhân: File schema.sql không tồn tại hoặc lỗi quyền

Giải pháp:

Kiểm tra file src/backend/database/schema.sql có tồn tại không
Server tự động load schema khi khởi động, kiểm tra logs
Nếu vẫn lỗi, chạy manual: mysql -u root -p ctech < src/backend/database/schema.sql
Kiểm tra user MySQL có quyền CREATE TABLE không

🔒 Security Notes

Quan trọng cho production:

Đổi tất cả passwords mặc định
Dùng HTTPS thay vì HTTP
Đổi password hashing từ SHA256 sang bcrypt:
```
npm install bcrypt
```
Enable CORS properly cho production domain
Giới hạn upload file size hợp lý
Dùng Redis thay cho in-memory cache
Enable rate limiting
Backup database thường xuyên

📝 Environment Variables Reference

Variable	Required	Default	Description
`DB_HOST`	✅	-	MySQL host
`DB_USER`	✅	-	MySQL username
`DB_PASSWORD`	✅	-	MySQL password
`DB_NAME`	✅	-	Database name
`PORT`	❌	3000	Server port
`SESSION_TIMEOUT`	❌	3600	Session TTL (seconds)
`SESSION_REMEMBER_TIMEOUT`	❌	2592000	Remember session TTL (seconds)
`OPENAI_API_KEY`	❌	-	OpenAI API key (cho chatbot)
`BANK_BIN`	❌	-	Bank BIN cho VietQR
`BANK_NUMBER`	❌	-	Bank account number
`BANK_OWNER`	❌	-	Bank account owner
`BANK_NAME`	❌	-	Bank name

🌐 Browser Support

Chrome/Edge >= 90
Firefox >= 88
Safari >= 14
Mobile browsers (iOS Safari, Chrome Android)

📞 Support

Nếu gặp vấn đề:

Kiểm tra Troubleshooting section
Xem logs trong console khi chạy node index.js
Kiểm tra API.md để hiểu cách API hoạt động
Kiểm tra MySQL logs nếu có lỗi database

📄 License

Proprietary - CTECH School Management System

Quick Start Summary:

# 1. Cài dependencies
npm install

# 2. Tạo database
mysql -u root -p
CREATE DATABASE ctech_db;

# 3. Tạo file .env với DB credentials
# (xem mẫu ở trên)

# 4. Chạy server
node index.js

# 5. Mở trình duyệt
# http://localhost:3000

Tới đây là hết rồi bạn đã có thể thiết lập thành công demo! 🎉

Name		Name	Last commit message	Last commit date
Latest commit History 70 Commits
ThamKhao		ThamKhao
src		src
uploads/services		uploads/services
.env.example		.env.example
.gitignore		.gitignore
Api Web.zip		Api Web.zip
DOCUMENTATION.md		DOCUMENTATION.md
README.md		README.md
api.md		api.md
debug.html		debug.html
generate-chatbot-knowledge.js		generate-chatbot-knowledge.js
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json
run-migration.js		run-migration.js

Folders and files

Latest commit

History

Repository files navigation

CTECH Web System

📋 Yêu cầu hệ thống

🚀 Hướng dẫn cài đặt

Bước 1: Clone hoặc download project

Bước 2: Cài đặt dependencies

Bước 3: Cấu hình database

3.1. Tạo database MySQL

3.2. Tạo file .env

Bước 4: Tạo thư mục uploads

▶️ Chạy ứng dụng

Khởi động server

Truy cập ứng dụng

Kiểm tra API health

👤 Tài khoản mặc định

🔧 Development

Cấu trúc thư mục

Scripts hữu ích

Test API với curl

📚 Documentation

🎯 Tính năng chính

🐛 Troubleshooting

Lỗi: "Cannot connect to MySQL"

Lỗi: "Port 3000 already in use"

Lỗi: "OPENAI_API_KEY not configured"

Lỗi: "Cannot find module"

Database tables không được tạo

🔒 Security Notes

📝 Environment Variables Reference

🌐 Browser Support

📞 Support

📄 License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

3.2. Tạo file `.env`

Packages