|
|
@@ -0,0 +1,98 @@
|
|
|
+# Uperp 应用重新安装指南
|
|
|
+
|
|
|
+## 问题解决方案
|
|
|
+
|
|
|
+主页菜单没有显示的问题已经修复,主要修复了以下几个问题:
|
|
|
+
|
|
|
+### 1. 权限函数路径错误
|
|
|
+- 修复前: `"uperp.api.has_app_permission"`
|
|
|
+- 修复后: `"uperp.uperp.api.has_app_permission"`
|
|
|
+
|
|
|
+### 2. 添加了 Logo 文件
|
|
|
+- 创建了 `/uperp/public/image/logo.svg`
|
|
|
+- 使用了符合 ERPNext 风格的 SVG 图标
|
|
|
+
|
|
|
+### 3. 改进了桌面配置
|
|
|
+- 使用了正确的图标格式: `octicon octicon-gear`
|
|
|
+- 设置了美观的颜色: `#667eea`
|
|
|
+
|
|
|
+### 4. 添加了安装后处理
|
|
|
+- 创建了 `install.py` 文件
|
|
|
+- 在安装后自动刷新桌面和缓存
|
|
|
+
|
|
|
+## 重新安装步骤
|
|
|
+
|
|
|
+为了让所有配置生效,请按以下步骤重新安装应用:
|
|
|
+
|
|
|
+```bash
|
|
|
+# 1. 进入 bench 目录
|
|
|
+cd /path/to/your/bench
|
|
|
+
|
|
|
+# 2. 卸载现有应用(如果已安装)
|
|
|
+bench uninstall-app uperp
|
|
|
+
|
|
|
+# 3. 重新安装应用
|
|
|
+bench install-app uperp
|
|
|
+
|
|
|
+# 4. 重启所有服务
|
|
|
+bench restart
|
|
|
+
|
|
|
+# 5. 清除所有缓存
|
|
|
+bench clear-cache
|
|
|
+bench clear-website-cache
|
|
|
+
|
|
|
+# 6. 重新构建资源
|
|
|
+bench build
|
|
|
+
|
|
|
+# 7. 重新生成桌面
|
|
|
+bench execute frappe.desk.desktop.sync_desktop
|
|
|
+```
|
|
|
+
|
|
|
+## 验证步骤
|
|
|
+
|
|
|
+安装完成后:
|
|
|
+
|
|
|
+1. **检查应用列表**:
|
|
|
+ - 进入 ERPNext 主页
|
|
|
+ - 查看应用列表中是否有 "Uperp" 应用
|
|
|
+
|
|
|
+2. **检查桌面模块**:
|
|
|
+ - 在主页左侧菜单中查找 "Uperp" 模块
|
|
|
+ - 模块应该显示齿轮图标和紫色主题
|
|
|
+
|
|
|
+3. **测试页面访问**:
|
|
|
+ - 直接访问: `http://your-site/test`
|
|
|
+ - 通过菜单点击进入测试页面
|
|
|
+
|
|
|
+4. **测试API**:
|
|
|
+ - 在测试页面中点击 "测试连接" 按钮
|
|
|
+ - 确认数据能正常加载
|
|
|
+
|
|
|
+## 可能的问题和解决方案
|
|
|
+
|
|
|
+### 问题1: 菜单仍然不显示
|
|
|
+解决方案:
|
|
|
+```bash
|
|
|
+bench execute frappe.clear_cache
|
|
|
+bench execute frappe.desk.desktop.sync_desktop
|
|
|
+bench restart
|
|
|
+```
|
|
|
+
|
|
|
+### 问题2: 权限错误
|
|
|
+解决方案:
|
|
|
+- 检查用户角色是否有足够权限
|
|
|
+- 确认 `has_app_permission` 函数返回 `True`
|
|
|
+
|
|
|
+### 问题3: 静态文件404错误
|
|
|
+解决方案:
|
|
|
+```bash
|
|
|
+bench build
|
|
|
+bench restart
|
|
|
+```
|
|
|
+
|
|
|
+### 问题4: 页面无法访问
|
|
|
+解决方案:
|
|
|
+- 检查 `templates/pages/test.html` 和 `test.py` 文件是否存在
|
|
|
+- 确认路由配置正确
|
|
|
+
|
|
|
+安装完成后,你应该能在 ERPNext 主页左侧菜单中看到 "Uperp" 模块,并可以通过它访问测试页面。
|