second
This commit is contained in:
235
README.md
235
README.md
@@ -1,137 +1,166 @@
|
||||
# VaultSentinel - Account Management System
|
||||
# 🎯 AccManager - SQL Server Backend Setup Complete
|
||||
|
||||
## Giới Thiệu
|
||||
VaultSentinel là một ứng dụng web quản lý tài khoản dịch vụ/ứng dụng. Ứng dụng cho phép bạn:
|
||||
## ✅ Database Configuration Complete
|
||||
|
||||
- **Quản lý Tài Khoản**: Thêm, sửa, xóa tài khoản cho các dịch vụ
|
||||
- **Quản lý Ứng Dụng**: Theo dõi các dịch vụ/ứng dụng đang sử dụng
|
||||
- **Dashboard**: Xem tổng quan số lượng tài khoản và dịch vụ
|
||||
- **Lưu Trữ Dữ Liệu**: Tất cả dữ liệu được lưu trên trình duyệt (localStorage)
|
||||
SQL Server database **AccManager** has been successfully configured with all necessary tables and initial data.
|
||||
|
||||
## Các Tính Năng
|
||||
### 📊 Database Information
|
||||
|
||||
### 1. Dashboard
|
||||
- Xem tổng quan các thống kê:
|
||||
- Số lượng ứng dụng đang hoạt động
|
||||
- Tổng số tài khoản được quản lý
|
||||
- Ngày cập nhật cuối cùng
|
||||
- Trạng thái hệ thống
|
||||
- Xem các tài khoản gần đây được tạo
|
||||
```
|
||||
Server IP: 172.20.235.176
|
||||
Database: AccManager
|
||||
User: sa
|
||||
Password: robotics@2020
|
||||
Port: 1433 (default)
|
||||
```
|
||||
|
||||
### 2. Quản Lý Tài Khoản (Accounts)
|
||||
- **Thêm Tài Khoản Mới**:
|
||||
- Nhấp nút "Add Account"
|
||||
- Điền thông tin: Service, Owner, Username, Password
|
||||
- Nhấp "Save Account"
|
||||
### 👤 Default Admin Account
|
||||
|
||||
- **Chỉnh Sửa Tài Khoản**:
|
||||
- Nhấp nút "Edit" (biểu tượng bút chì) trên dòng tài khoản
|
||||
- Cập nhật thông tin
|
||||
- Nhấp "Save Account"
|
||||
```
|
||||
Username: admin
|
||||
Password: admin
|
||||
Role: admin
|
||||
Status: Active
|
||||
```
|
||||
|
||||
- **Xóa Tài Khoản**:
|
||||
- Nhấp nút "Delete" (biểu tượng thùng rác)
|
||||
- Xác nhận xóa
|
||||
## 📋 Database Tables Created
|
||||
|
||||
- **Lọc Tài Khoản**:
|
||||
- Sử dụng dropdown "Service" để lọc theo dịch vụ
|
||||
### 1. **Users** - User Management
|
||||
- Stores login credentials and user roles
|
||||
- Default admin user: admin/admin
|
||||
|
||||
### 3. Quản Lý Ứng Dụng (Applications)
|
||||
- **Xem Danh Sách**:
|
||||
- Danh sách tất cả các ứng dụng/dịch vụ
|
||||
- Hiển thị trạng thái (Online/Offline)
|
||||
- Hiển thị loại ứng dụng
|
||||
### 2. **Applications** - Service Management
|
||||
- 4 sample applications pre-loaded:
|
||||
- AWS (Cloud) - online
|
||||
- GitHub (VCS) - online
|
||||
- Google Workspace (Collaboration) - online
|
||||
- Nginx Proxy (Infra) - offline
|
||||
|
||||
- **Thêm Ứng Dụng**:
|
||||
- Nhấp "Add New"
|
||||
- Điền tên, loại, trạng thái
|
||||
- Nhấp "Save Application"
|
||||
### 3. **Accounts** - Credential Storage
|
||||
- Stores credentials for each user-application combination
|
||||
- Linked to Users and Applications tables
|
||||
|
||||
- **Chỉnh Sửa Ứng Dụng**:
|
||||
- Nhấp nút "Edit"
|
||||
- Cập nhật thông tin
|
||||
- Nhấp "Save Application"
|
||||
### 4. **AuditLog** - Activity Tracking
|
||||
- Logs all INSERT, UPDATE, DELETE operations
|
||||
- User actions tracked for security
|
||||
|
||||
- **Xóa Ứng Dụng**:
|
||||
- Nhấp nút "Delete"
|
||||
- Xác nhận xóa
|
||||
## 🚀 Backend Server Options
|
||||
|
||||
## Cách Sử Dụng
|
||||
### Option 1️⃣: Node.js + Express (Recommended)
|
||||
|
||||
### Khởi Động Ứng Dụng
|
||||
1. Mở file `index.html` trên trình duyệt
|
||||
2. Giao diện chính sẽ tải lên
|
||||
**Files:**
|
||||
- `server.js` - Main server file
|
||||
- `package.json` - Dependencies
|
||||
|
||||
### Công Việc Thường Xuyên
|
||||
**Quick Start:**
|
||||
```bash
|
||||
# 1. Install Node.js from https://nodejs.org/
|
||||
# 2. Install dependencies
|
||||
npm install
|
||||
|
||||
#### Thêm Tài Khoản Mới
|
||||
1. Nhấp "Accounts" trên thanh điều hướng bên trái
|
||||
2. Nhấp nút "Add Account"
|
||||
3. Chọn dịch vụ từ dropdown
|
||||
4. Nhập tên chủ sở hữu, tên đăng nhập, mật khẩu
|
||||
5. Nhấp "Save Account"
|
||||
# 3. Run server
|
||||
npm start
|
||||
|
||||
#### Xem Danh Sách Ứng Dụng
|
||||
1. Nhấp "Applications" trên thanh điều hướng
|
||||
2. Xem danh sách tất cả các ứng dụng đã đăng ký
|
||||
3. Sử dụng các nút hành động để chỉnh sửa hoặc xóa
|
||||
# Server runs on: http://localhost:3000
|
||||
```
|
||||
|
||||
#### Kiểm Tra Tổng Quan
|
||||
1. Nhấp "Dashboard" trên thanh điều hướng
|
||||
2. Xem các thống kê chính và hoạt động gần đây
|
||||
### Option 2️⃣: Python + Flask
|
||||
|
||||
## Lưu Ý Quan Trọng
|
||||
**Files:**
|
||||
- `server_python.py` - Main server file
|
||||
- `requirements.txt` - Dependencies
|
||||
|
||||
⚠️ **Bảo Mật**:
|
||||
- Tất cả dữ liệu được lưu trữ cục bộ trên trình duyệt (localStorage)
|
||||
- Không gửi dữ liệu đến máy chủ nào
|
||||
- Dữ liệu sẽ bị xóa nếu bạn xóa cache trình duyệt
|
||||
- Đây là một ứng dụng demo - không sử dụng cho dữ liệu nhạy cảm trong môi trường thực tế
|
||||
**Quick Start:**
|
||||
```bash
|
||||
# 1. Install Python 3.8+ from https://www.python.org/
|
||||
# 2. Install dependencies
|
||||
pip install -r requirements.txt
|
||||
|
||||
## Cấu Trúc File
|
||||
# 3. Run server
|
||||
python server_python.py
|
||||
|
||||
- `index.html` - File HTML chính với giao diện người dùng
|
||||
- `app.js` - Mã JavaScript xử lý logic và chức năng
|
||||
- `acc.html` - Trang tài khoản cũ (tham khảo)
|
||||
- `app.html` - Trang ứng dụng cũ (tham khảo)
|
||||
- `main.html` - File HTML thay thế (tham khảo)
|
||||
# Server runs on: http://localhost:5000
|
||||
```
|
||||
|
||||
## Các Công Nghệ Sử Dụng
|
||||
## 📡 API Endpoints
|
||||
|
||||
- **HTML5**: Cấu trúc trang
|
||||
- **CSS (Tailwind CSS)**: Tạo cách bố trí và kiểu dáng
|
||||
- **JavaScript**: Xử lý logic ứng dụng
|
||||
- **Material Symbols**: Biểu tượng
|
||||
- **localStorage API**: Lưu trữ dữ liệu
|
||||
### Health Check
|
||||
```http
|
||||
GET /api/health
|
||||
```
|
||||
|
||||
## Mở Rộng Ứng Dụng
|
||||
### Authentication
|
||||
```http
|
||||
POST /api/auth/login
|
||||
```
|
||||
|
||||
### Để Thêm Chức Năng Mới:
|
||||
### Users Management
|
||||
```http
|
||||
GET /api/users
|
||||
GET /api/users/:id
|
||||
POST /api/users
|
||||
```
|
||||
|
||||
1. **Thêm trang Dashboard mới**:
|
||||
- Xác định nội dung trong `getApplicationsContent()`
|
||||
- Thêm hàm xử lý sự kiện
|
||||
- Cập nhật `renderPage()` để thêm trang mới
|
||||
### Applications
|
||||
```http
|
||||
GET /api/applications
|
||||
POST /api/applications
|
||||
```
|
||||
|
||||
2. **Cải Thiện Bảo Mật**:
|
||||
- Thêm mã hóa cho mật khẩu
|
||||
- Triển khai xác thực người dùng
|
||||
- Sử dụng database backend
|
||||
### Accounts
|
||||
```http
|
||||
GET /api/accounts/user/:userId
|
||||
POST /api/accounts
|
||||
```
|
||||
|
||||
3. **Tính Năng Khác**:
|
||||
- Xuất/Nhập dữ liệu
|
||||
- Nhật ký hoạt động
|
||||
- Tìm kiếm nâng cao
|
||||
- Sao lưu/Khôi phục
|
||||
### Database Info
|
||||
```http
|
||||
GET /api/database/info
|
||||
```
|
||||
|
||||
## Hỗ Trợ
|
||||
## 📚 Documentation Files
|
||||
|
||||
Nếu bạn gặp vấn đề:
|
||||
1. Kiểm tra console trình duyệt (F12) để xem lỗi
|
||||
2. Xóa cache trình duyệt nếu dữ liệu không hiển thị
|
||||
3. Đảm bảo trình duyệt hỗ trợ localStorage
|
||||
4. Thử trên trình duyệt khác
|
||||
- **README.md** (this file) - Overview
|
||||
- **SETUP_GUIDE.md** - Detailed installation steps
|
||||
- **DATABASE_SETUP.md** - Schema and API documentation
|
||||
- **server.js** - Node.js backend source
|
||||
- **server_python.py** - Python backend source
|
||||
|
||||
## 🔐 Default Credentials
|
||||
|
||||
```
|
||||
Username: admin
|
||||
Password: admin
|
||||
Role: admin
|
||||
```
|
||||
|
||||
## 🔧 Project Files
|
||||
|
||||
```
|
||||
d:\RoboticsSource\AccManager\
|
||||
├── server.js (Node.js backend)
|
||||
├── server_python.py (Python backend)
|
||||
├── package.json (Node.js dependencies)
|
||||
├── requirements.txt (Python dependencies)
|
||||
├── .env (Configuration)
|
||||
├── database/
|
||||
│ └── setup.sql (SQL setup script)
|
||||
├── SETUP_GUIDE.md (Installation guide)
|
||||
├── DATABASE_SETUP.md (Database documentation)
|
||||
└── README.md (This file)
|
||||
```
|
||||
|
||||
## ✅ Status
|
||||
|
||||
- ✓ Database created (AccManager)
|
||||
- ✓ 4 tables created (Users, Applications, Accounts, AuditLog)
|
||||
- ✓ Admin user created (admin/admin)
|
||||
- ✓ Sample applications added
|
||||
- ✓ Backend servers ready (Node.js + Python options)
|
||||
- ✓ API endpoints documented
|
||||
|
||||
---
|
||||
|
||||
**Phiên Bản**: 1.0.0
|
||||
**Version:** 2.0.0 (Backend Ready)
|
||||
**Database:** SQL Server / AccManager
|
||||
**Last Updated:** March 27, 2026
|
||||
|
||||
Reference in New Issue
Block a user