221 lines
3.8 KiB
Markdown
221 lines
3.8 KiB
Markdown
# 🚀 Hướng Dẫn Chạy AccManager - Dành cho Người Dùng Mới
|
|
|
|
## 📋 Bước 1: Kiểm Tra Node.js
|
|
|
|
Mở **PowerShell** và chạy:
|
|
|
|
```powershell
|
|
node --version
|
|
npm --version
|
|
```
|
|
|
|
**Kết quả mong đợi:**
|
|
```
|
|
v18.16.0 (hoặc version cao hơn)
|
|
9.6.7 (hoặc version khác)
|
|
```
|
|
|
|
Nếu thấy version → **OK, tiếp tục bước 2**
|
|
|
|
---
|
|
|
|
## 📋 Bước 2: Vào Thư Mục Dự Án
|
|
|
|
Copy-paste lệnh này vào PowerShell:
|
|
|
|
```powershell
|
|
cd d:\RoboticsSource\AccManager
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Bước 3: Cài Đặt Dependencies
|
|
|
|
Copy-paste lệnh này vào PowerShell:
|
|
|
|
```powershell
|
|
npm install
|
|
```
|
|
|
|
**Chờ cho tới khi thấy:**
|
|
```
|
|
added XXX packages in XXs
|
|
```
|
|
|
|
(Sẽ mất 1-3 phút tùy tốc độ mạng)
|
|
|
|
---
|
|
|
|
## 📋 Bước 4: Chạy Backend Server
|
|
|
|
Copy-paste lệnh này vào PowerShell:
|
|
|
|
```powershell
|
|
npm start
|
|
```
|
|
|
|
**Khi thành công, bạn sẽ thấy:**
|
|
```
|
|
========================================
|
|
AccManager Backend Server
|
|
========================================
|
|
✓ Server running on http://localhost:3000
|
|
✓ Database: AccManager
|
|
✓ Default admin: admin / admin
|
|
|
|
API Endpoints:
|
|
POST /api/auth/login
|
|
GET /api/database/info
|
|
GET /api/users
|
|
GET /api/applications
|
|
GET /api/accounts/user/:userId
|
|
========================================
|
|
```
|
|
|
|
**👉 ĐỪNG ĐÓNG TERMINAL NÀY - Server đang chạy!**
|
|
|
|
---
|
|
|
|
## 🌐 Bước 5: Mở Ứng Dụng
|
|
|
|
**Mở trình duyệt** (Chrome, Firefox, Edge...) copy-paste URL này:
|
|
|
|
```
|
|
http://localhost:3000/pages/login.html
|
|
```
|
|
|
|
---
|
|
|
|
## 🔐 Bước 6: Đăng Nhập
|
|
|
|
**Nhập thông tin:**
|
|
- Username: `admin`
|
|
- Password: `admin`
|
|
|
|
Nhấp **Login**
|
|
|
|
---
|
|
|
|
## ✅ Nếu Thành Công
|
|
|
|
Bạn sẽ thấy:
|
|
- ✓ Trang Dashboard
|
|
- ✓ Quản lý Accounts
|
|
- ✓ Quản lý Applications
|
|
- ✓ Thông tin Database
|
|
|
|
---
|
|
|
|
## ❌ Nếu Có Lỗi
|
|
|
|
### Lỗi 1: "npm: The term 'npm' is not recognized"
|
|
**Giải pháp:**
|
|
- Đóng PowerShell hiện tại
|
|
- Mở PowerShell **mới**
|
|
- Chạy lại `npm --version`
|
|
|
|
### Lỗi 2: "Cannot find module 'express'"
|
|
**Giải pháp:**
|
|
```powershell
|
|
npm install
|
|
npm start
|
|
```
|
|
|
|
### Lỗi 3: "Port 3000 already in use"
|
|
**Giải pháp:** Có chương trình khác dùng port 3000
|
|
```powershell
|
|
# Dừng server cũ (Ctrl+C)
|
|
# Rồi chạy lại: npm start
|
|
```
|
|
|
|
### Lỗi 4: "Cannot connect to database"
|
|
**Giải pháp:** Kiểm tra SQL Server
|
|
- Đảm bảo SQL Server đang chạy
|
|
- IP: 172.20.235.176 có reach được không
|
|
|
|
```powershell
|
|
ping 172.20.235.176
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 Full Workflow - Copy Toàn Bộ Lệnh
|
|
|
|
Nếu bạn muốn copy toàn bộ một lần:
|
|
|
|
```powershell
|
|
# Kiểm tra Node.js
|
|
node --version
|
|
|
|
# Vào thư mục
|
|
cd d:\RoboticsSource\AccManager
|
|
|
|
# Cài packages
|
|
npm install
|
|
|
|
# Chạy server
|
|
npm start
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Các Lệnh Hữu Ích Khác
|
|
|
|
### Dừng Server
|
|
Nhấp **Ctrl + C** trong PowerShell
|
|
|
|
### Chạy Server Ở Chế Độ Development (auto-restart)
|
|
```powershell
|
|
npm run dev
|
|
```
|
|
|
|
### Kiểm Tra API Health
|
|
Mở browser khác nhập:
|
|
```
|
|
http://localhost:3000/api/health
|
|
```
|
|
|
|
### Xem Tất Cả Users
|
|
```
|
|
http://localhost:3000/api/users
|
|
```
|
|
|
|
### Xem Tất Cả Applications
|
|
```
|
|
http://localhost:3000/api/applications
|
|
```
|
|
|
|
### Database Info
|
|
```
|
|
http://localhost:3000/api/database/info
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Sơ Đồ Port
|
|
|
|
| URL | Port | Mục đích |
|
|
|-----|------|---------|
|
|
| http://localhost:3000/pages/login.html | 3000 | Frontend |
|
|
| http://localhost:3000/api/health | 3000 | Backend API |
|
|
| 172.20.235.176 | 1433 | SQL Server |
|
|
|
|
---
|
|
|
|
## 🎯 Tóm Tắt - 4 Bước Chính
|
|
|
|
1. **Mở PowerShell**
|
|
2. **Chạy:**
|
|
```powershell
|
|
cd d:\RoboticsSource\AccManager
|
|
npm install
|
|
npm start
|
|
```
|
|
3. **Chờ thấy "Server running on http://localhost:3000"**
|
|
4. **Mở browser vào: http://localhost:3000/pages/login.html**
|
|
5. **Đăng nhập: admin / admin**
|
|
|
|
---
|
|
|
|
**Chúc bạn thành công! 🚀**
|