# OC-Using-EFCore-Instead-YesSql 

**Repository Path**: smartent/OC-Using-EFCore-Instead-YesSql

## Basic Information

- **Project Name**: OC-Using-EFCore-Instead-YesSql 
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-18
- **Last Updated**: 2026-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Oc-Using-EFCore-Instead-YesSql（Smartent Platform）

基于 [Orchard Core](https://github.com/OrchardCMS/OrchardCore) 的 **独立改造仓库**：用 **EF Core + SQL Server** **彻底替换 YesSql**（**单引擎，非双引擎**），平台层已 Relational；**CMS / Content** 计划从只读 OC v3 参考版 **回迁并接 EF**（见实施文档）。

---

## 与上游 Orchard Core 的关系

| 项 | 说明 |
|----|------|
| **基线** | Orchard Core v3.0.x（.NET 10、模块化 Shell） |
| **许可** | 继承上游 [BSD-3-Clause](LICENSE) |
| **存储** | 仅 `AddRelationalDataAccess()`；无 `OrchardCore.Data.YesSql` |
| **演进** | 不跟随上游定期 merge；以本仓库 `docs/` 与 [OC 实施过程](OC-实现Yessql-EFCore双引擎实施过程/README.md) 为准 |
| **参考源码** | 团队本地可保留只读 OC 完整版，用于 CMS 拷贝对照（不纳入本仓库 CI） |

---

## 仓库结构（速览）

```
Oc-Using-EFCore-Instead-YesSql/
├── Oc-Using-EFCore-Instead-YesSql.slnx   # 聚合解决方案
├── OC-实现Yessql-EFCore双引擎实施过程/     # YesSql→EF 全栈替换 + CMS 回迁纲领（目录名历史保留）
├── src/
│   ├── OrchardCore/                      # 框架与 Data.EntityFramework / Data.SqlServer
│   ├── OrchardCore.Modules/              # 内置模块 + HTTP API 扩展
│   ├── OrchardCore.Themes/
│   ├── Smartent.Modules/                 # 业务模块（如 Announcement）
│   ├── Smartent.Modules.Samples/         # TestApi / TestBench 样例
│   └── WebApplication/
│       └── Smartent.Framework.Application/  # 宿主（Relational + AutoSetup）
├── test/
├── docs/
└── .scripts/                             # verify-no-yessql-gate 等
```

---

## 环境要求

| 工具 | 版本 |
|------|------|
| [.NET SDK](https://dotnet.microsoft.com/download) | 10.0+（见 `global.json`） |
| SQL Server | 本地开发常用 `(local)`，库名如 `SmartentPlatform` |
| Node.js / Yarn | 仅修改前端资源时需要 |

---

## 快速开始

```powershell
cd Oc-Using-EFCore-Instead-YesSql

dotnet build src/WebApplication/Smartent.Framework.Application/Smartent.Framework.Application.csproj -c Debug

dotnet run --project src/WebApplication/Smartent.Framework.Application/Smartent.Framework.Application.csproj
```

配置要点（`appsettings*.json`）：

- `OrchardCore:StorageEngine` = **`Relational`**
- `Smartent:Database:Server` / `DefaultDatabaseName`：与 Smartent-CRM 对齐时可共用约定

详见 **[docs/README.md](docs/README.md)** 与 [relational-acceptance](docs/getting-started/relational-acceptance.md)。

---

## 构建与门禁

```powershell
.\.scripts\verify-no-yessql-gate.ps1
dotnet build Oc-Using-EFCore-Instead-YesSql.slnx -c Release
dotnet test test/OrchardCore.Data.SqlServer.Tests/OrchardCore.Data.SqlServer.Tests.csproj -c Release
```

---

## 文档

| 路径 | 内容 |
|------|------|
| [docs/README.md](docs/README.md) | 文档总索引 |
| [OC 实施过程](OC-实现Yessql-EFCore双引擎实施过程/README.md) | CMS EF 回迁阶段、验收、EF-only 定调 |
| [docs/architecture/07-CMS-EFCore回迁纲领.md](docs/architecture/07-CMS-EFCore回迁纲领.md) | 纲领摘要 |
| [docs/architecture/03-关系型Data层完整设计方案.md](docs/architecture/03-关系型Data层完整设计方案.md) | Data 层设计 |
| [AGENTS.md](AGENTS.md) | Orchard 构建与扩展约定 |

---

## 致谢

[Orchard Core](https://orchardcore.net/) 社区与 [.NET Foundation](http://www.dotnetfoundation.org)。