uperp/INSTALLATION_FIX_GUIDE.md

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 文件
• 在安装后自动刷新桌面和缓存

重新安装步骤 (ERPNext v15)

为了让所有配置生效，请按以下步骤重新安装应用：

# 1. 进入 bench 目录
cd /path/to/your/bench

# 2. 卸载现有应用（如果已安装）
bench uninstall-app uperp

# 3. 重新安装应用
bench install-app uperp

# 4. 重启所有服务
bench restart

# 5. 清除所有缓存 (ERPNext v15)
bench clear-cache
bench clear-website-cache

# 6. 重新构建资源
bench build

# 7. 手动清除桌面缓存 (ERPNext v15 方法)
bench execute "frappe.cache().delete_key('desktop_icons')"
bench execute "frappe.cache().delete_key('bootinfo')"
bench execute "frappe.clear_cache()"

验证步骤

安装完成后：

1. 检查应用列表:

   • 进入 ERPNext 主页
   • 查看应用列表中是否有 "Uperp" 应用

2. 检查桌面模块:

   • 在主页左侧菜单中查找 "Uperp" 模块
   • 模块应该显示齿轮图标和紫色主题

3. 测试页面访问:

   • 直接访问: http://your-site/test
   • 通过菜单点击进入测试页面

4. 测试API:

   • 在测试页面中点击 "测试连接" 按钮
   • 确认数据能正常加载

可能的问题和解决方案

问题1: 菜单仍然不显示 (ERPNext v15)

解决方案:

# 方法1: 清除缓存
bench execute "frappe.clear_cache()"
bench execute "frappe.cache().delete_key('desktop_icons')"
bench execute "frappe.cache().delete_key('bootinfo')"
bench restart

# 方法2: 强制刷新浏览器 (Ctrl+F5 或 Cmd+Shift+R)
# 并清除浏览器缓存

# 方法3: 检查模块是否正确注册
bench execute "import frappe; print(frappe.get_installed_apps())"

问题2: 权限错误

解决方案:

• 检查用户角色是否有足够权限
• 确认 has_app_permission 函数返回 True

问题3: 静态文件404错误

解决方案:

bench build
bench restart

问题4: 页面无法访问

解决方案:

• 检查 templates/pages/test.html 和 test.py 文件是否存在
• 确认路由配置正确

安装完成后，你应该能在 ERPNext 主页左侧菜单中看到 "Uperp" 模块，并可以通过它访问测试页面。