基于Blazor实现的轻量进销存管理系统

一套开源、免费、开箱即用的进销存管理平台，基于 .NET 10 + Blazor Server + Known 框架构建。

---

一、项目简介

JxcLite 是一套面向中小企业的轻量级进销存管理系统，覆盖了商品管理、采购进货、销售出货、库存核算、财务对账、报表统计等核心业务场景。

与市面上动辄上万元的传统进销存软件不同，JxcLite 完全开源免费，代码托管在 Gitee，开发者可以自由下载、部署、二次开发。

技术上，JxcLite 基于 Known 框架 构建 —— 一个轻量级、跨平台、插件化的 Blazor 全栈开发框架，这意味着它不仅是一套业务系统，更是一个 C# / .NET 开发者学习 Blazor 实战开发的优秀示例项目。

项目信息	详情
项目名称	JxcLite
开源地址	https://gitee.com/known/JxcLite
技术栈	.NET 10 + Blazor Server + Known Framework
数据库	SQLite（可切换 MySQL / PostgreSQL / SQL Server）
许可证	Apache 2.0
运行环境	Windows / Linux / macOS

---

二、功能模块一览

JxcLite 涵盖了进销存管理系统的七大核心模块：

2.1 基础数据

统一维护商品、供应商、客户等基础档案，支持 Excel 批量导入导出。

• 商品信息：商品编码、名称、类别、规格、产地、计量单位、采购/销售单价、安全库存
• 供应商管理：供应商名称、信用代码、联系人、开票信息、银行账号
• 客户管理：客户名称、信用代码、联系人、开票信息、银行账号
• 工厂信息：公司抬头、地址、联系方式，用于打印模板

2.2 进货管理

处理采购入库和退货业务，支持含税/不含税模式切换。

• 采购进货单：选择供应商 → 添加商品明细 → 自动计算金额/税额 → 提交审核
• 采购退货单：关联原进货单，一键生成退货，审核后自动扣减库存

2.3 销货管理

处理销售出库和退货业务，支持打印出货单。

• 销售出货单：选择客户 → 添加商品明细 → 自动计算金额/税额 → 提交审核
• 销售退货单：关联原销售单，一键生成退货
• 单据打印：根据工厂信息自动生成打印模板

2.4 库存管理

实时展示库存状况，库存流水全程可追溯。

• 商品库存表：每个商品按进/销/退四维统计当前库存，低于安全库存红色预警
• 库存流水表：记录每次单据操作后的入库/出库/结存数量变化

2.5 财务管理

完整的应收应付管理，支持对账、收付款联动。

• 客户对账单：选择时间范围和未对账单据 → 生成对账单 → 审核后自动生成应收账款
• 供应商对账单：同上逻辑，审核后自动生成应付账款
• 其他费用：管理独立于进销业务的收入/支出费用
• 应收账款/应付账款：记录每笔收付款明细，实时计算已收/未收金额

2.6 统计报表

多维度数据报表，支持查询和导出。

• 进货明细表 / 进退货明细表
• 销货明细表 / 销退货明细表
• 商品库存表
• 商品利润表：按商品维度计算 销货金额 - 退货金额 - 进货金额 + 进退货金额 = 销售利润

2.7 系统管理

基于 Known 框架内置的权限体系，开箱即用。

• 角色管理：菜单/按钮/字段级权限控制
• 用户管理：账号启停、角色分配、密码重置
• 系统日志：完整的操作审计追溯

---

三、技术架构

3.1 整体架构

┌─────────────────────────────────────┐
│         Blazor Server UI            │  前端：AntDesign + Known 组件
├─────────────────────────────────────┤
│         HTTP API (自动生成)          │  通信：Known 框架自动暴露 REST API
├─────────────────────────────────────┤
│          Service Layer              │  业务：后端业务逻辑
├─────────────────────────────────────┤
│    SQLite / MySQL / PostgreSQL      │  存储：支持多种数据库
└─────────────────────────────────────┘

3.2 Known 框架特点

JxcLite 的底层是 Known Framework，一个基于 Blazor 的轻量级插件化全栈框架：

• 零前端代码：页面使用 C# 编写，无需 JavaScript/TypeScript
• 一/三段式服务：接口 → 客户端代理 → 服务端实现，前后端调用像本地方法
• 自动 API 生成：[WebApi] 特性标记的方法自动暴露为 HTTP 接口
• 插件化扩展：模块化注册，支持动态加载 Pro 扩展程序集
• 跨平台部署：Blazor Server / WebAssembly / WinForm 多宿主模式

3.3 项目结构

├─JxcLite          → 核心业务类库（实体、服务、页面、组件）
├─JxcLite.Web      → Blazor Server 宿主
├─JxcLite.WinForm  → Windows 桌面应用宿主
└─JxcLite.sln      → 解决方案文件

所有业务代码集中在 JxcLite 项目中，Web 和 WinForm 项目仅负责启动，真正做到了一套代码、多端运行。

---

四、快速开始

4.1 环境要求

• .NET 10.0 SDK
• Visual Studio 2026 / VS Code / Rider

4.2 三步运行

# 1. 克隆项目
git clone https://gitee.com/known/JxcLite.git

# 2. 进入目录，直接运行
cd JxcLite
dotnet run --project JxcLite.Web

# 3. 浏览器打开 http://localhost:5000
# 首次运行会自动创建 SQLite 数据库并初始化

4.3 默认账号

账号	密码	说明
Admin	1	系统管理员（安装时自行设置）

---

五、系统亮点

5.1 开箱即用

不需要复杂的配置，下载即运行。SQLite 数据库自动创建，内置数据字典和编码规则，登录就能开始使用。

5.2 业务闭环

从商品建档→采购入库→销售出库→库存核算→财务对账→利润报表，形成完整的进销存业务闭环，每一步操作都有据可查。

5.3 审核工作流

所有业务单据内置"暂存→审核→反审"工作流，审核后自动触发库存调整和财务凭证生成，避免人工计算错误。

5.4 高度可扩展

基于 Known 框架的插件化架构，可以像 JxcLitePro 专业版 一样动态加载扩展模块。例如：

• ✅ 数电发票 Excel 导入（自动同步客户/供应商/商品，自动生成进货单）
• 🔄 多仓库货位管理
• 🔄 条码/二维码扫描出入库
• 🔄 多级价格策略

5.5 C# 开发者友好

如果你是一名 .NET 开发者，JxcLite 的源码本身就是一本优秀的 Blazor 实战教程：

• 学习如何在 Blazor 中构建复杂的企业级表单
• 学习 Known 框架的一/三段式服务开发模式
• 学习如何用 C# 替代 JavaScript 完成前端交互

// 示例：Known 框架中的服务定义，一个特性即可暴露为 API
[WebApi, Service]
class BillService(Context context) : ServiceBase(context)
{
    public Task<PagingResult<JxBill>> QueryBillsAsync(PagingCriteria criteria) { ... }
    public Task<Result> SaveBillAsync(UploadInfo<JxBill> info) { ... }
    public Task<Result> DeleteBillsAsync(List<JxBill> infos) { ... }
}

---

六、适用场景

场景	说明
小型贸易公司	管理商品的进销存，替代 Excel 记账
批发/零售门店	日常开单、对账、库存盘点
二次开发基础	基于 JxcLite 快速定制行业进销存系统
学习 Blazor	.NET 开发者学习 Blazor 实战的参考项目
外包/接单	作为进销存项目模板，快速交付客户

---

七、合作与支持

开源版 vs 专业版

功能	开源版	专业版
基础进销存	✅	✅
审核工作流	✅	✅
对账与应收应付	✅	✅
统计报表	✅	✅
数电发票导入	❌	✅
多仓库管理	❌	🔄 开发中
条码管理	❌	🔄 开发中
多级价格策略	❌	🔄 开发中
资金账户管理	❌	🔄 开发中
技术支持	社区	专人对接

联系方式

• 联系 QQ：65536471
• 微信号：knownchen
• QQ 交流群：865982686
• 项目地址：https://gitee.com/known/JxcLite
• Known 框架官网：https://known.org.cn

---

八、写在最后

作为 Known 框架的作者，我开发 JxcLite 的初衷有两个：

第一，降低进销存软件的使用门槛。市面上大部分进销存软件要么价格昂贵，要么功能臃肿，JxcLite 希望提供一套简单、够用、免费的选择。

第二，展示 Known 框架的实战能力。Known 不是实验室里的玩具框架，它已经支撑了多个生产环境项目的运行。JxcLite 就是它的最佳实战案例 —— 你可以看到 Known 如何构建一个真实的企业级管理系统。

如果你觉得这个项目有价值，欢迎到 Gitee 点个 Star ⭐，这是对开源最好的支持。