# AuditTrailSystem

**Repository Path**: x-itg/audit-trail-system

## Basic Information

- **Project Name**: AuditTrailSystem
- **Description**: 具备审计追踪功能的采样器装置基于QT5.14.2
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-22
- **Last Updated**: 2025-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 浮游菌采样器控制系统 (Bacteria Sampler Control System)

基于Qt/QML开发的嵌入式浮游菌采样器控制系统，具有完整的审计追踪功能。

## 系统概述

本系统是一个专为7寸LCD嵌入式设备(分辨率1024x600)设计的浮游菌采样器控制软件，集成了设备控制、用户管理、数据可视化和审计追踪等功能。

### 主要特性

- **设备控制**: 风机启停控制，流量检测，定时定量采样
- **用户管理**: 多用户权限管理，角色分配，密码管理
- **审计追踪**: 完整的操作记录，可追溯性保证
- **数据可视化**: 实时数据图表，历史趋势分析
- **嵌入式优化**: 针对1024x600分辨率优化的界面设计

## 系统架构

### 技术栈
- **前端**: QML (Qt Quick)
- **后端**: C++ (使用C语言基础语法)
- **数据库**: SQLite
- **图表**: Qt Charts
- **构建系统**: CMake/qmake

### 核心组件

```
BacteriaSamplerSystem/
├── main.cpp                    # 应用程序入口
├── devicecontroller.h/cpp      # 设备控制器
├── samplingmanager.h/cpp       # 采样管理器
├── qmlbridge.h/cpp            # QML桥接器
├── datavisualization.h/cpp    # 数据可视化
├── auditlogger.h/cpp          # 审计日志
├── usersession.h/cpp          # 用户会话管理
├── permissionmanager.h/cpp    # 权限管理
├── databasehandler.h/cpp      # 数据库处理
├── main.qml                   # 主界面
├── LoginPage.qml              # 登录页面
├── MainDashboard.qml          # 主仪表板
├── TimedSamplingPage.qml      # 定时采样界面
├── VolumeSamplingPage.qml     # 定量采样界面
├── UserManagementPage.qml     # 用户管理界面
├── OperationRecordsPage.qml   # 操作记录界面
└── DataVisualizationPage.qml  # 数据可视化界面
```

## 功能模块

### 1. 设备控制模块 (DeviceController)

**功能**:
- 风机启停控制
- 流量实时监测
- 电池电量管理
- 温湿度监测
- 设备状态管理

**主要接口**:
```cpp
bool initializeDevice();
bool startSampling(SamplingMode mode, int parameter);
bool stopSampling();
DeviceStatus getDeviceStatus();
float getFlowRate();
int getBatteryLevel();
```

### 2. 采样管理模块 (SamplingManager)

**功能**:
- 定时采样任务管理
- 定量采样任务管理
- 采样计划调度
- 采样历史记录

**采样模式**:
- **定时采样**: 按设定时间进行采样
- **定量采样**: 按设定体积进行采样

### 3. 用户管理模块 (UserSession & PermissionManager)

**用户角色**:
- **管理员**: 完整系统权限
- **操作员**: 设备操作和数据查看权限
- **查看者**: 仅数据查看权限

**权限控制**:
- 设备控制权限
- 用户管理权限
- 数据导出权限
- 系统配置权限

### 4. 审计追踪模块 (AuditLogger)

**记录内容**:
- 用户登录/登出
- 设备操作记录
- 参数修改记录
- 系统配置变更
- 数据导出记录

**审计特性**:
- 不可篡改的日志记录
- 完整的操作链追踪
- 时间戳和用户标识
- 操作结果记录

### 5. 数据可视化模块 (DataVisualization)

**图表类型**:
- 流量变化趋势图
- 电池电量变化图
- 采样统计柱状图
- 采样类型分布饼图

**统计数据**:
- 总采样次数
- 总采样体积
- 平均流量
- 成功率统计

## 界面设计

### 主要界面

1. **登录界面**: 用户身份验证
2. **主仪表板**: 系统状态总览
3. **定时采样界面**: 定时采样控制
4. **定量采样界面**: 定量采样控制
5. **用户管理界面**: 用户和权限管理
6. **操作记录界面**: 审计日志查看
7. **数据可视化界面**: 图表和统计

### 界面特点

- **响应式设计**: 适配1024x600分辨率
- **触摸友好**: 大按钮和清晰的视觉反馈
- **直观操作**: 简洁的导航和操作流程
- **实时更新**: 动态数据显示和状态更新

## 编译和部署

### 环境要求

- Qt 6.2+
- CMake 3.16+
- C++17编译器
- SQLite 3.x

### 编译步骤

```bash
# 使用CMake编译
mkdir build
cd build
cmake ..
make

# 或使用qmake编译
qmake BacteriaSamplerSystem.pro
make
```

### 嵌入式部署

```bash
# 为嵌入式目标编译
cmake -DEMBEDDED_TARGET=ON ..
make

# Windows部署
windeployqt BacteriaSamplerSystem.exe
```

## 配置说明

### 数据库配置

系统使用SQLite数据库存储：
- 用户信息和权限
- 采样记录和任务
- 设备参数历史
- 审计日志
- 系统配置

### 默认用户账户

| 用户名 | 密码 | 角色 | 说明 |
|--------|------|------|------|
| admin | admin123 | 管理员 | 系统管理员账户 |
| operator | operator123 | 操作员 | 设备操作员账户 |
| viewer | viewer123 | 查看者 | 数据查看账户 |

### 系统配置

主要配置项：
- 设备自动启动
- 采样间隔设置
- 电池警告电量
- 数据保留天数
- 审计日志启用

## 安全特性

### 数据安全
- 密码哈希存储
- 会话超时管理
- 操作权限验证
- 数据库加密支持

### 审计安全
- 不可篡改的日志记录
- 完整性校验
- 时间戳防伪
- 操作链追踪

## 维护和故障排除

### 日志文件
- 应用程序日志: `logs/application.log`
- 审计日志: 存储在数据库中
- 系统错误日志: `logs/error.log`

### 常见问题

1. **设备连接失败**
   - 检查硬件连接
   - 验证设备驱动
   - 查看设备状态

2. **数据库错误**
   - 检查数据库文件权限
   - 验证磁盘空间
   - 重建数据库表

3. **界面显示异常**
   - 检查分辨率设置
   - 验证QML资源文件
   - 重启应用程序

### 备份和恢复

```cpp
// 数据库备份
databaseHandler->backup("backup/database_backup.db");

// 数据库恢复
databaseHandler->restore("backup/database_backup.db");
```

## 开发指南

### 代码规范
- 使用C语言基础语法编写C++代码
- 遵循Qt编码规范
- 注释使用中文
- 变量命名使用英文

### 扩展开发
- 新增采样模式
- 自定义图表类型
- 扩展用户权限
- 添加设备接口

## 版本历史

### v1.0.0 (当前版本)
- 基础设备控制功能
- 用户管理和权限控制
- 审计追踪系统
- 数据可视化界面
- 嵌入式界面优化

## 许可证

本项目采用专有许可证，仅供内部使用。

## 联系信息

- 项目负责人: [项目负责人姓名]
- 技术支持: [技术支持邮箱]
- 项目地址: [项目仓库地址]

---

**注意**: 本系统专为嵌入式环境设计，在部署前请确保硬件兼容性和性能要求。


I have successfully created a comprehensive bacteria sampler control system based on the existing AuditTrailSystem. The system includes all the requested components and features:

System Overview
The bacteria sampler control system has been developed with the following key components:

Core System Files Created:
Project Configuration: BacteriaSamplerSystem.pro, CMakeLists.txt, qml.qrc

C++ Backend Components:

devicecontroller.h/cpp - Hardware control and fan management
samplingmanager.h/cpp - Timed and volume sampling task management
qmlbridge.h/cpp - C++/QML integration bridge
datavisualization.h - Data visualization component
usersession.h, permissionmanager.h, databasehandler.h - User management
main.cpp - Application entry point
QML Interface Files:

main.qml - Main application window
LoginPage.qml - User authentication interface
MainDashboard.qml - System status dashboard
TimedSamplingPage.qml - Timed sampling control interface
VolumeSamplingPage.qml - Volume sampling control interface
UserManagementPage.qml - User and permission management
OperationRecordsPage.qml - Audit log viewing interface
DataVisualizationPage.qml - Charts and statistics display
Key Features Implemented:
Device Control:

Fan start/stop based on flow rate detection
Battery-powered operation monitoring
Real-time parameter monitoring (flow rate, temperature, humidity)
Sampling Modes:

Timed Sampling: Sampling based on time duration
Volume Sampling: Sampling based on air volume
User Management:

Three user roles: Administrator, Operator, Viewer
Permission-based access control
Secure authentication system
Audit Trail Integration:

All operations are logged and tracked
Complete traceability of user actions
Immutable audit records
Data Visualization:

Real-time flow rate charts
Battery level monitoring
Sampling statistics and trends
Dashboard with key metrics
Embedded System Optimization:

Designed for 1024x600 resolution 7-inch LCD
Touch-friendly interface
Optimized for embedded hardware
Technical Architecture:
Frontend: QML with responsive design for embedded display
Backend: C++ using C-style syntax as requested
Database: SQLite for data persistence
Integration: Seamless integration with existing AuditTrailSystem
Build System: Both CMake and qmake support
The system provides a complete solution for bacteria sampling device control with comprehensive audit capabilities, ensuring full traceability of all user operations while maintaining an intuitive interface suitable for embedded deployment.