以下内容由LLM大模型详细审阅整个项目源代码后，给出的技术汇总报告：

SnIMS 定制开发框架汇总报告

一、框架概述

SnIMS (SouthNet Information Management System) 是一个企业级信息管理系统/数据管理系统框架，从 .NET Framework 4.8 升级而来，现已实现 .NET 4.8 与 .NET 8.0 双框架兼容，支持跨平台（Windows/Linux）部署和多数据库适配。

官网: www.veelink.net

二、核心特点与优势

2.1 核心特点

2.2 框架优势

1. 企业级成熟度 - 从原有 .NET 4.8 系统升级而来，经过实际项目验证
2. 国产化支持 - 原生支持达梦等国产数据库，符合信创要求
3. 灵活部署 - 可 Windows 传统部署，也可 Linux+Docker 现代化部署
4. 开发效率高 - 代码生成器 + 组件化开发，快速构建业务系统
5. 维护成本低 - 分层清晰，接口标准化，便于团队协作和后期维护
6. 技术栈灵活 - ORM 和原生 SQL 并存，简单场景用 ORM，复杂查询用原生

三、项目架构与模块

3.1 完整项目结构

SnIMS/
├── 核心层
│   ├── SnIMS.Common          # 公共工具类库（加密/文件/HTTP/缓存等）
│   ├── SnIMS.Model           # 实体模型层（含 ORM 导航属性）
│   ├── SnIMS.IDAL            # 数据访问层接口
│   ├── SnIMS.Factory         # 工厂类（依赖注入）
│   ├── SnIMS.BLL             # 业务逻辑层（含缓存管理）
│   ├── SnIMS.Engine          # 系统数据引擎（核心处理）
│
├── 前端层
│   ├── SnIMS.Control         # .NET 4.8 前端控件（WebControl）
│   ├── SnIMS.Component       # .NET 8.0 前端组件（TagHelper）
│   ├── SnIMS.Web             # .NET 4.8 Web 项目
│   ├── SnIMS.Service         # .NET 8.0 Web 项目
│   └── SnIMS.Script          # 前端脚本（SnIMS-Admin.js/SnIMS-Common.js）
│
├── 数据访问层（DAL）
│   ├── SnIMS.SqlSugarDAL     # SqlSugar ORM 实现（默认）
│   ├── SnIMS.SqlserverDAL    # SQL Server 原生 ADO.NET
│   ├── SnIMS.MySqlDAL        # MySQL 原生 ADO.NET
│   ├── SnIMS.OracleDAL       # Oracle 原生 ADO.NET
│   ├── SnIMS.PostgreSqlDAL   # PostgreSQL 原生 ADO.NET
│   ├── SnIMS.DmdbDAL         # 达梦数据库原生 ADO.NET
│   ├── SnIMS.SQLiteDAL       # SQLite 原生 ADO.NET
│   ├── SnIMS.OledbDAL        # OleDb 通用实现
│   ├── SnIMS.ApiDAL          # API 远程数据访问
│   └── SnIMS.EntityFrameworkDAL # EF ORM（已弃用）
│
├── 工具层
│   ├── SnIMS.Code            # 代码生成器（核心）
│   ├── SnIMS.Tool            # 工具类（维护/项目管理）
│   └── SnIMS.Update          # 自动升级应用
│
└── 业务模块（BLL/Engine 已内置）
    ├── Member/MemberClass    # 会员管理
    ├── Menu/Power            # 菜单权限
    ├── Company/CompanyDep    # 公司部门
    ├── Article/News          # 文章新闻
    ├── Chat/ChatGroup        # 聊天群组
    ├── Tasks/WorkStep        # 任务工作流
    ├── Files/Template        # 文件模板
    └── ...（50+ 业务模块） 

3.2 自带业务模块（50+）

四、核心先进技术

4.1 技术栈总览

4.2 核心技术亮点

1️⃣ SqlSugar ORM 深度集成

// 链式查询、导航属性、多数据库切换
var query = SqlSugarHelper.ModelToQuery(model, "Member");
query.Where(x => x.MemberID > 100)
     .OrderBy(x => x.Name)
     .ToDataTable(); 

2️⃣ 动态 Razor 模板渲染

// RazorLight 动态编译模板
public static string RenderRazor(string template, object model)
{
    RazorLightEngine _engine = new RazorLightEngineBuilder()
        .UseMemoryCachingProvider()
        .DisableEncoding()
        .Build();
    return _engine.CompileRenderStringAsync(template, model).Result;
} 

3️⃣ 跨表文本自动填充

// 自动关联查询并填充文本字段
dt.Columns.Add("MemberClassID_MemberClass_Name", typeof(string));
MemberClassID_MemberClass = TemplateHandle.GetMainTable(
    "MemberClass", 
    Filter.GetArrFromTable(dt, "MemberClassID"), 
    "MemberClassID,Name", false); 

4️⃣ 双框架兼容设计

#if NET48
    public class ControlBasic : CompositeControl  // Web Forms
#else
    public class ControlBasic : TagHelper  // ASP.NET Core
#endif 

5️⃣ 工厂模式依赖注入

// 运行时动态选择 DAL 实现
public static IMember CreateMember()
{
    string CacheKey = "Member";
    object objType = DataAccess.CreateObject(CacheKey);
    return (IMember)objType;
} 

6️⃣ 内置缓存系统

// 本机内存缓存，支持 Lambda 查询
public void InitCache(int top = 1000)
{
    DbCache<Member>.Inserts("Member", GetList(null, top, true));
}
public List<Member> GetCache(Func<Member, bool> predicate)
{
    return DbCache<Member>.Search("Member", predicate).ToList();
} 

五、数据层架构

5.1 支持的数据库

5.2 数据访问层次

Web/Service (前端)
      ↓
Component/Control (组件层)
      ↓
Engine/Data (数据引擎 - 跨表文本填充)
      ↓
BLL (业务逻辑 - 缓存管理)
      ↓
Factory (工厂 - 动态创建)
      ↓
IDAL (接口层 - 标准化)
      ↓
┌─────────┬─────────┬─────────┐
↓         ↓         ↓         ↓
SqlSugar  SqlServer MySQL   Oracle  ... (多实现) 

六、前端页面引擎

6.1 组件化开发模式

<!-- Razor 视图使用示例 -->
<MemberControl MemberClassID="1" DisplayType="2">
    <MainTemplate>
        <table>
            <ItemTemplate>
                <tr>
                    <td>{{Name}}</td>
                    <td>{{MemberClassID_MemberClass_Name}}</td>
                </tr>
            </ItemTemplate>
        </table>
    </MainTemplate>
</MemberControl> 

6.2 渲染流程

1. Razor 解析 <MemberControl> 标签
   ↓
2. 触发 ProcessAsync() 方法
   ↓
3. 构建查询条件 → 调用 MemberData.GetList()
   ↓
4. 数据填充跨表文本字段
   ↓
5. 解析模板 (MainTemplate/ItemTemplate 等)
   ↓
6. RazorLight 编译渲染 → 输出 HTML 

七、代码生成器

7.1 生成内容

7.2 生成器特点

• 读取数据库表结构自动生成
• 支持主键/外键/导航属性配置
• 支持跨表查询字段配置
• 一次生成，多数据库适配

八、设计模式应用

九、适用场景

✅ 推荐场景

⚠️ 注意事项

• 前端采用服务器端渲染模式，不适合纯前后端分离场景
• 代码生成器生成的代码需要理解后使用
• 部分第三方商业控件（Spire 系列）需要授权

十、总结评价

📊 框架评分

🎯 核心价值主张

SnIMS 是一个务实的企业级开发框架，不追求最新技术栈，但求稳定、高效、易维护。双框架兼容策略让现有 .NET 4.8 项目可以平滑迁移，多数据库支持满足国产化需求，代码生成器和组件化开发大幅提升开发效率。

报告生成时间: 2026 年 3 月 5 日
分析基于版本: SnIMS 从 .NET 4.8 升级到 .NET 8.0 的版本