# OneCaps

**Repository Path**: one996/one-caps

## Basic Information

- **Project Name**: OneCaps
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-07-02
- **Last Updated**: 2025-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# OneCaps 项目

## 项目概述

OneCaps 是一个包含多个模块的 C# 项目，当前主要包括核心功能（Core）、数据库访问（DB）、基础设施（Infrastructure）、模块（Modules）、服务层（Services）以及用户界面（UI）。

该项目旨在提供一个结构清晰、易于扩展的应用程序框架，适合用于开发模块化的企业级应用程序。

## 目录结构

- **OneCaps.Core**: 提供核心功能和扩展方法，如字符串处理等。
- **OneCaps.DB**: 包含使用 Entity Framework Core 和 SqlSugar 的数据库上下文及仓储实现。
- **OneCaps.Infrastructure**: 基础设施模块，当前未提供详细代码。
- **OneCaps.Modules**: 模块化组件存放处，具体实现待补充。
- **OneCaps.Services**: 服务层，包含业务逻辑，目前有一个 UserService 类。
- **OneCaps.UI**: 用户界面模块，使用 WPF 技术，包含 App.xaml、MainWindow.xaml 等界面文件。
- **OneCaps.sln**: 解决方案文件。
- **OnePro.Presentation**: 另一个未提供详细代码的模块。

## 主要功能

### OneCaps.Core

- 提供 `StringExtensions` 类，封装常用字符串操作，如：
  - `IsNullOrEmpty` / `IsNullOrWhiteSpace`
  - `FormatWith`
  - `ToInt` / `ToDateTime`
  - `ToMd5` / `ToBase64`
  - `Truncate` / `RemoveWhitespace`
  - 正则表达式相关方法
  - URL/HTML 编码相关方法
  - 文件路径、文件名安全处理方法

### OneCaps.DB

- 包含 `AppDbContext` 类，继承自 `DbContext`，用于 Entity Framework Core 数据库操作。
- 提供通用仓储接口 `IRepository<TEntity, TKey>` 和其实现类 `EFCoreRepository` 和 `SqlSugarRepository`。
- 支持异步数据库操作，包括增删改查、批量操作和保存更改。

### OneCaps.Services

- 包含 `UserService` 类，用于实现用户相关的业务逻辑（当前未提供具体代码）。

### OneCaps.UI

- 基于 WPF，提供图形界面支持。
- 包含 `App` 类和 `MainWindow` 类，用于应用程序的启动和主窗口展示。

## 开发环境

- 编程语言：C#
- 框架：.NET（可能为 .NET Core 或 .NET 5/6）
- 数据库支持：Entity Framework Core 和 SqlSugar（支持多种数据库类型）
- 前端框架：WPF（用于 OneCaps.UI）

## 使用说明

1. 克隆项目并打开 `OneCaps.sln` 文件。
2. 根据需要选择启动项目（例如 OneCaps.UI 或 OneCaps.Host）。
3. 配置数据库连接信息。
4. 实现业务逻辑部分（如 UserService）。
5. 运行并测试项目。

## 贡献者指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目。
2. 创建新分支。
3. 实现功能或修复 bug。
4. 提交 PR，并描述更改内容。

## 许可证

该项目使用 MIT 许可证。具体请查看项目中的 LICENSE 文件。