Score
0
Watch 36 Star 85 Fork 39

SenparcCoreFramework / SCFC#Apache-2.0

Join us
Explore and code with more than 5 million developers,Free private repositories !:)
Sign up
SenparcCoreFramework(SCF) 是一整套可用于构建基础项目的框架,包含了基础的缓存、数据库、模型、验证及配套管理后台,模块化,具有高度的可扩展性。 spread retract

  • C# 42.3%
  • CSS 30.3%
  • JavaScript 15.2%
  • HTML 11.9%
  • TSQL 0.3%
Clone or download
Loading...
README.md

SCF - SenparcCoreFramework

SenparcCoreFramework(SCF) 是一整套可用于构建基础项目的框架,包含了基础的缓存、数据库、模型、验证及配套管理后台,模块化,具有高度的可扩展性。

当前版本:0.1.0-beta4

说明:SCF 由盛派(Senparc)团队经过多年优化迭代的自用系统底层框架 SenparcCore 整理而来,经历了 .NET 3.5/4.5 众多系统的实战检验,并最终移植到 .NET Core,目前已在多个 .NET Core 系统中稳定运行,在将其转型为开源项目的过程中,需要进行一系列的重构、注释完善和兼容性升级,目前尚处于雏形阶段,希望大家多提意见,我们会争取在最短的时间内优化并发布第一个试用版(Preview1)。感谢大家一直以来的支持!

Preview1 版本中,我们将提供更加完善的模块化架构和辅助工具,当前源码已经可用于学习和测试使用。

当前快速更新分支:Developer-RazorPage-DDD

我们欢迎第三方开源组件提供自己的解决方案,我们将会测试并集成到 SCF 中。

SCF 除了会为大家提供完善的框架代码,还会:

  1. 提供完善的项目自动生成服务(参考 WeChatSampleBuilder),为开发者提供项目定制生成服务。

  2. 提供快捷的模块化开发和安装方法。

  3. 提供丰富的应用示例,例如微信跨平台应用平台对接,等等。

  4. 提供完善的示例代码和文档。

  5. 提供博客和视频教程(也欢迎开发者参与或发起)。

  6. 提供交流社区,包括但不仅限于问答网站QQ群、微信群、直播群。

QQ 技术交流群

环境要求

如何安装

安装过程可以选择极客型命令行安装方式,或全自动一键完成。

第一步:准备数据库

确保已经安装 SQL Server 2012 及以上版本,系统登录用户具有数据库创建权限(可以不需要使用sa等账号登录),如果必须要使用账号登录,请看这里

第二步:准备命令行工具(可跳过)

这一步是为喜欢体验手敲命令快感的极客准备的,您也可以跳过这一步,直接进入到【第三步】。

方法一(推荐):

  1. 同步源代码到本地后,使用 Visual Studio 打开 /src/SCF.sln

  2. 在 VS 菜单中选择【工具】>【Nuget包管理器】>【程序包管理器控制台】,打开命令窗口

  3. 在【程序包管理器控制台】中的【默认项目】列表中选中 Senparc.Web(默认就是),在 PM> 符号后输入命令:update-database 回车

方法二(要看运气):

  1. 使用命令行工具或 PowerShell 进入 src/Senparc.Web 路径,例如:E:\SenparcCoreFramework\SCF\src\Senparc.Web

  2. 输入命令:dotnet ef database update 回车

等待结果

稍等片刻(会自动编译一次项目,因此请勿修改项目代码),完成后输出如下结果,表示数据库安装成功:

Applying migration '20181130085128_init'.
Done.

方法一结果

方法二结果

第三步:初始化数据

  1. Senparc.Web 项目设为启动项目,并运行,地址如:https://localhost:44311/

未初始化之前,访问首页会自动显示安装界面:

点击【立即安装】按钮:

如果您未手动执行【第二步】,系统将为您在后台自动执行相关步骤。

随后,系统将自动完成初始化安装,此时页面会提示默认管理员账号和密码,请记住这两个参数,以后将无法明文找回!

  1. 点击【点击这里登录】,使用已经保存好的管理员账号及密码进行登录:
  1. 完成登录

(备用)第四步:还原样式包

如果登录及管理员后台页面样式缺失,则需要进行这一步,否则可以忽略。

点击查看

模块化开发

SCF 支持“即插即用”的模块化开发模式,您可以面向模块(或领域)进行开发,然后使用 SCF 对模块进行一键集成。

SCF 的扩展模块代号为 XSCF

如何加载模块?

第一步:加载 XSCF 扩展模块 dll

找到 XSCF 包并加载 dll 或 从 nuget 安装到 SCF 项目,例如我们官方的一个示例(ChangeNamespace),用于定制修改整个项目的命名空间:https://www.nuget.org/packages/Senparc.Xscf.ChangeNamespace

说明:Senparc.Xscf.ChangeNamespace 模块在 SCF 源码中已默认装载,无需从 nuget 下载。

第二步:进入管理员后台的 【扩展模块】 > 【模块管理】

此时可已经可以看到系统自动扫描到了新增模块:

第三步:点击所需安装模块的【安装按钮】,即可轻松完成模块安装

点击【安装】按钮后,自动进入到模块详情页面,大功告成!

如何使用已安装的模块?

在上一步模块详情页中,列出了当前模块支持的所有功能的列表:

为了让每个模块更加沟通安全,每一个功能都可以预先看到所有参数的透视说明

选择需要执行的方法,点击左侧【执行】按钮。例如点击“修改命名空间”功能的执行【执行】按钮:

按照提示输入对应的参数,点击【运行】按钮,即可执行此模块的此项功能。

执行完成后可以看到提示信息:

程序中所有命名空间已被批量修改:

此过程中无需编写一行代码!

如何更新模块?

您只需要引用最新的 dll(或安装 nuget 包),系统后台将自动扫描到版本更新:

【模块管理】页面

模块详情页面

点击【立即安装】即可完成新版本的升级!

如何自己开发模块?

SCF 的扩展模块代号为 XSCF,您可以在 ScfPackageSources 项目中找到我们的模块 示例项目,只需要“依葫芦画瓢”即可。后续稳定版发布之后将有完整的配套文档。

是否可以不使用模块化开发?

Q:我的系统比较简单,也不需要考虑移植、弹性或扩展,是否可以直接在 SCF 上进行开发?

A:当然可以。加载模块只是为了方便重和系统解耦用而已,SCF 适用于大多数开发场景,包括单体应用、分布式、容器、微信等移动端、跨平台 Hybrid 应用,等等。

待办事项:

- [ ] 前端包管理器要从Bower切换为LibMan

  • 完善 DDD 实践
  • 定制命名空间
  • 发布官网及在线 Demo
  • 发布定制模板生成器(在线)
    • 可定制默认加载模块

Comments ( 16 )

Sign in for post a comment

C#
1
https://gitee.com/SenparcCoreFramework/SCF.git
git@gitee.com:SenparcCoreFramework/SCF.git
SenparcCoreFramework
SCF
SCF
master

Help Search

205735 778617b6 1899542 205747 347fc4a1 1899542