Known框架实战演练——进销存框架搭建

本文介绍如何使用Known开发框架搭建进销存管理系统的项目结构，以及开发前的一些配置和基础代码。

• 项目代码：JxcLite
• 开源地址： https://gitee.com/known/JxcLite

1. 创建项目结构

使用cmd命令工具，进入D:\Publics\JxcLite目录，先安装Known框架项目模板，再用命令创建项目结构。两个命令如下：

dotnet new install KnownTemplate
dotnet new known --name=JxcLite

命令执行成功后，该文件夹下面自动生成JxcLite项目文件，项目文件结构如下：

├─JxcLite          -> 项目模块类库。
├─JxcLite.Client   -> 项目前端页面类库。
├─JxcLite.Web      -> 项目后端业务逻辑类库。
├─JxcLite.WinForm  -> 项目WinForm App。
├─JxcLite.sln      -> 项目解决方案文件。

双击打开JxcLite.sln文件，即可通过VS2022开发工具修改和添加系统项目文件。

2. 开发前准备

2.1. 配置数据库

本项目默认使用Known框架模板提供的SQLite数据库，如果要更改其他数据库，请参考官方文档更换数据库。

2.2. 配置系统名称

用VS2022打开项目后，双击JxcLite项目中的AppConfig.cs文件，修改系统名称。代码如下：

public static class AppConfig
{
    public static string AppName => "进销存管理系统";
}

2.3. 配置系统扩展按钮

双击JxcLite项目中的Resources\actions.txt资源文件，在此扩展Known框架提供的功能按钮信息，例如本项目除增删改查导按钮之外，还需要退货、确认、开票、回款按钮。

Return  | 退货 | rollback   | primary
Confirm | 确认 | check      | primary
Invoice | 开票 | profile    | primary
Payment | 回款 | pay-circle | primary

2.4. 配置多语言

如果项目需要多语言，双击打开JxcLite项目中的AppConfig.cs文件，在AddJxcLite方法中修改多语言设置，代码如下：

public static class AppConfig
{
    public static void AddJxcLite(this IServiceCollection services)
    {
        services.AddKnown(info =>
        {
            ...
            info.IsLanguage = true;
            ...
        });
    }
}

在JxcLite项目中的Resources\Locales文件夹下修改对应语言的资源文件，资源文件为Dictionary对象的JSON数据，内容如下所示：

//简体中文
{
  "Menu.BasicData": "基础数据",
  "GoodsInfo": "商品信息",
}
//English
{
  "Menu.BasicData": "Basic Data",
  "GoodsInfo": "Goods Info",
}

2.5. 系统常量

系统常量包含商业伙伴类型（PartnerType）和业务单据类型（BillType），代码如下：

public class PartnerType
{
    public const string Supplier = "供应商";
    public const string Customer = "客户";
}

public class BillType
{
    public const string Import = "进货";
    public const string ImportReturn = "进退货";
    public const string Export = "销货";
    public const string ExportReturn = "销退货";
}

3. 安装运行

配置完成后，直接运行项目。第一次运行，需要先安装程序，填写企业信息和管理员密码，安装时，自动生成框架数据库表和示例数据。安装成功后，直接跳转到登录页面，输入Admin和安装时设置的管理员密码登录进入系统。

4. 配置数据字典

在基础数据-数据字典模块添加如下数据字典。

5. 配置功能菜单

下面我们根据需求文档整理好功能模块数据，在系统管理-模块管理中逐一添加进去，各模块数据表格如下：