ManagerAccount/RUN_COMMANDS.md

🚀 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:

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:

cd d:\RoboticsSource\AccManager

---

📋 Bước 3: Cài Đặt Dependencies

Copy-paste lệnh này vào 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:

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:

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

# 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

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:

# 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)

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:

   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! 🚀