演示

常见问题

关于 Quark ERP 架构、插件、版本、许可与支持的常见问题解答。

产品叫 Quark ERP,为什么包名是 @quan-erp?

对外产品名是 Quark ERP。npm 作用域有意保留为 @quan-erp——改名会破坏现有安装。请将 Quark ERP 与 @quan-erp 视为同一平台。

为什么采用核心 + 插件架构?

从零实现登录、认证、安全与基础实体会耗费大量时间。即便看起来像“基础能力”,你仍需处理角色与权限、会话、API 守卫,以及每个模块都会依赖的共享实体。Quark ERP 的精简核心负责这一层平台能力,让你专注插件(业务功能),其余由核心处理。

什么是插件?

插件是包含后端 API、数据表与 React 界面的独立包。Base 应用保持精简,并在启动时动态加载插件,而非编译期打包。

需要自己实现登录和认证吗?

不需要。核心已提供登录、认证、会话、角色与权限、默认安全能力,以及内置实体(用户、往来单位、设置、文件等)。你仍可为插件声明专用权限,但不必从零重建整套认证与规则体系。

插件可以导入另一个插件的源码吗?

不可以。禁止直接导入其他插件的 src/。请通过 @quan-erp/shared-*、pluginDependencies,以及「后端 → Export」中的跨插件导出/注入方式共享。

所有 @quan-erp 包必须同一版本吗?

是的。插件内以及 docker-compose 中 base 镜像的所有 @quan-erp/* 须保持同一版本(例如 ^1.0.0),以避免依赖冲突。

如何创建新插件?

用起步模板 CLI 生成插件,设置名称与版本,运行 watch、seed 模块,再安装到 base 应用。详见「快速开始 → 创建插件」。

为什么构造函数注入不可用?

Quark ERP 的 DI 仅支持属性注入。请在类属性上使用 @Inject / @InjectEnv / @InjectBuiltinLogger,不要在构造函数中注入。

如何部署 Quark ERP?

生产环境通常用 Docker Compose、Postgres 与 Redis 运行 base 后端/前端。请按「部署」页的 compose、环境变量与安装步骤操作。

定价与许可在哪里查看?

商业套餐在 Quark ERP 产品页。开源许可说明在「许可证」Doc 页。培训、生产支持或定制插件请走「支持」。

如何获取帮助?

请先查阅 Doc、在线演示与起步模板。如需搭建、授权或生产问题支持,请向 The Paradance 发邮件,并附上版本、插件、环境与复现步骤。