尼泊尔合规系统(Nepal Compliance)手动安装指南

前言

尼泊尔合规系统是基于Frappe框架构建的企业合规管理解决方案，专为尼泊尔地区的企业设计。该系统建立在ERPNext和HRMS两大核心应用之上，提供了符合尼泊尔法规要求的各类合规功能模块。本文将详细介绍如何手动安装部署这套系统。

系统要求

在开始安装前，请确保您的开发环境满足以下最低要求：

基础环境

• Frappe Bench工具：用于管理Frappe应用生态
• 已激活的Frappe站点：作为系统运行的基础环境

软件版本要求

组件	版本要求	备注
MariaDB	10.6.6+	推荐11.3版本
Python	3.10/11/12
Node.js	18或20
Redis	6	用于缓存和实时更新
yarn	1.12+	JavaScript依赖管理
pip	20+	Python包管理
wkhtmltopdf	0.12.5(带补丁的qt)	PDF生成工具
cron		定时任务管理

安装前准备

1. 确认Bench工具已正确安装：

   bench --version
   

2. 确认已有可用的Frappe站点：

   bench list-sites
   

3. 启动Bench开发服务器（保持运行）：

   bench start
   

分步安装指南

第一步：安装ERPNext基础系统

ERPNext是整个系统的核心框架，必须先安装：

1. 从应用仓库获取ERPNext：

   bench get-app erpnext
   

2. 将ERPNext安装到目标站点：

   bench --site 你的站点名称 install-app erpnext
   

第二步：安装HRMS人力资源模块

HRMS模块提供了人力资源管理的核心功能：

1. 获取HRMS应用：

   bench get-app hrms
   

2. 安装到目标站点：

   bench --site 你的站点名称 install-app hrms
   

第三步：安装尼泊尔合规系统

在基础系统就绪后，安装尼泊尔合规模块：

1. 获取尼泊尔合规应用：

   bench get-app nepal_compliance
   

2. 安装到目标站点：

   bench --site 你的站点名称 install-app nepal_compliance
   

安装验证

1. 检查已安装应用列表：

   bench --site 你的站点名称 list-apps
   

   确认输出中包含nepal_compliance。

2. 访问系统： 打开浏览器访问 http://localhost:8000

3. 如果发现界面无变化，执行数据库迁移：

   bench --site 你的站点名称 migrate
   

常见问题处理

1. 依赖缺失问题：确保所有前置依赖已正确安装，特别是wkhtmltopdf的特定版本。

2. 数据库连接问题：检查MariaDB服务是否正常运行，以及站点配置中的数据库连接信息是否正确。

3. 权限问题：确保运行Bench命令的用户有足够的文件系统权限。

后续步骤

系统安装完成后，您可以：

1. 配置尼泊尔特定的合规规则和参数
2. 导入基础数据（如税种、社保费率等）
3. 设置用户权限和工作流

通过本指南，您应该已经成功部署了尼泊尔合规系统。该系统将帮助您的企业满足尼泊尔地区的各类法规要求，实现合规化管理。如需进一步定制或扩展功能，可以参考Frappe框架的开发文档。