This commit is contained in:
2026-03-27 09:56:26 +07:00
parent 56ab9f931e
commit 251b4ee673
26 changed files with 3076 additions and 2364 deletions

235
README.md
View File

@@ -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