# DTerminal

**Repository Path**: miss4826/dterminal

## Basic Information

- **Project Name**: DTerminal
- **Description**: DTerminal.Cloud 是一个用于云端项目管理与终端任务追踪的 .NET Blazor 应用。该项目包括多个模块，允许用户通过图形界面添加、编辑和查看项目、部件、版本和任务，并通过 TCP 服务与本地终端进行通信。项目使用 Entity Framework Core 进行数据库操作，并通过 Bootstrap 提供前端样式。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-01-03
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DTerminal.Cloud 项目 README

## 项目概述

DTerminal.Cloud 是一个用于云端项目管理与终端任务追踪的 .NET Blazor 应用。该项目包括多个模块，允许用户通过图形界面添加、编辑和查看项目、部件、版本和任务，并通过 TCP 服务与本地终端进行通信。项目使用 Entity Framework Core 进行数据库操作，并通过 Bootstrap 提供前端样式。

## 项目结构

- `DTerminal.Cloud/` - 主 Blazor 项目目录，包含前端组件、服务、模型等。
- `DTerminal.Cloud.LocalService/` - 本地 TCP 服务和 Windows 窗体界面。
- `ConsoleApp1/` - 包含实体类和数据库上下文。

## 主要功能

- **项目管理**：可以添加、查看和编辑项目信息，包括项目名称、客户、产品和客户端。
- **部件管理**：一个项目可以包含多个部件，可以添加和查看部件详情。
- **版本管理**：每个部件可以有多个版本，包括创建日期、标题和备注。
- **任务管理**：每个版本可以有多个任务，包括任务编号、分析类型、请求人、备注和开始日期。
- **文件浏览**：支持浏览与特定任务或版本相关的文件系统资源。
- **TCP 通信**：通过 TCP 协议与本地终端通信，实现文件路径的远程打开功能。
- **Blazor UI**：提供现代化网页界面，使用 MudBlazor 和 Bootstrap 进行样式设计。

## 主要组件

- **前端组件**：Blazor 页面和组件（如 `Dashboard`, `Projects`, `Parts`, `Versions`, `Tasks`, `Explorer`）。
- **数据服务**：`ProjectService`, `PartService`, `VersionService`, `TaskService`，用于与数据库交互。
- **TCP 服务**：`TcpClientService` 和 `TcpListenerService`，用于与本地终端通信。
- **数据库模型**：使用 `PtdDbContext` 和 EF Core 进行数据持久化。

## 技术栈

- .NET 8
- Blazor
- Entity Framework Core
- Bootstrap 5.3
- MudBlazor
- TCP 通信

## 数据库

- 使用 SQLite 数据库，文件为 `appData.db`。
- 数据库迁移由 `PtdDbContext` 处理。

## 使用说明

### 启动应用

1. 确保已安装 .NET 8 SDK。
2. 在项目根目录下运行命令：`dotnet run --project DTerminal.Cloud/DTerminal.Cloud.csproj`。
3. 浏览器将自动打开，进入主界面。

### 使用功能

- **项目管理**：
  - 在 "项目" 页面可以添加新项目，编辑或删除现有项目。
  - 点击项目名称可以进入部件管理页面。

- **部件管理**：
  - 在部件页面可以添加新部件，编辑或删除现有部件。
  - 点击部件名称可以进入版本管理页面。

- **版本管理**：
  - 在版本页面可以添加新版本，编辑或删除现有版本。
  - 点击版本名称可以进入任务管理页面。

- **任务管理**：
  - 在任务页面可以添加新任务，编辑或删除现有任务。
  - 点击任务可以浏览相关文件，并与本地终端进行通信。

- **文件浏览**：
  - 在 "文件资源管理器" 页面可以查看文件和目录，排序，复制和打开文件路径。
  - 文件路径会通过 `TcpClientService` 发送至本地终端。

### 本地服务

- `DTerminal.Cloud.LocalService` 项目包含一个简单的 Windows 窗体界面，用于监听来自网页应用的 TCP 请求。
- 该界面包含一个按钮，可以手动触发打开本地文件路径的功能。
- 通知图标允许在系统托盘中运行应用程序，支持退出和控制面板功能。

## 开发与扩展

- **添加新模块**：在 Blazor 项目中创建新的页面和对话框，并在服务中添加对应的数据访问逻辑。
- **UI 样式**：前端样式使用 Bootstrap 和 MudBlazor，可以通过修改 `.razor.css` 文件进行自定义。
- **数据模型**：使用 `PtdDbContext` 与 SQLite 数据库交互，可以使用 EF Core 命令进行迁移和更新。

## 许可证

本项目使用 [MIT 许可证](#)（如果适用，否则请指定实际的许可证）。

## 联系方式

- 作者：[您的名字]
- 邮箱：[您的邮箱]
- 项目主页：[Gitee 项目链接]

如需更多帮助，请查看项目 Wiki 或提交 Issue。