Webhook 全栈项目
本项目前端、后端均采用nodejs20.18.0开发 。
🛠 1. 环境要求
在开始开发前，要确保你的系统已完成以下配置：
- Node.js: 建议使用
nvm安装 Node.js v20.18.0。 - 依赖库: WSL 中必须安装
libaio1以支持 Oracle 驱动。 - 依赖库: 安装 Visual Studio Build Tools 下载(https://visualstudio.microsoft.com/zh-hans/downloads/)
- 全局工具:
npm install -g pnpm npm install -g pm2
🚀 🔌 2. 环境配置
winax
本系统使用winax处理excel,然后转化为PDF。winax要求自编译。已经在Node.js v20.18.0在编译完成并放在node_modules目录下。
Visual Studio Build Tools
安装勾选（至关重要）：
在弹出的安装界面中，必须勾选：
- 使用 C++ 的桌面开发 (Desktop development with C++)
- （右侧侧边栏确认已选中）MSVC v143 - VS 2022 C++ x64/x86 生成工具
- （右侧侧边栏确认已选中）Windows 10 SDK (或 11 SDK)
项目环境管理
本系统前端、后端统一采用pnpm管理， 在根目录下执行 pnpm setup:clean 可清除不合适的node_modules然后重新安装，并使用自编译的winax。 注意：后端目录back-end下没有node_modules子目录。可以用下面的命令检查确认
cd back-end
node -e "require('axios'); console.log('Axios 找到'); require('winax'); console.log('Winax 找到');"
⚙️ 3. 系统启动、运行
项目支持多种环境配置，系统会根据启动方式自动识别：
- 混合模式 (推荐):
- 后端启动: 进入/back-end 执行 restart.ps1 会启动pm2 。
- 前端启动: 进入/front-end 执行 pnpm dev 。
📝 4. 常见问题 (FAQ)
-
Q: 删除node_modules失败
- A: 有nodejs, 或者pm2在运行
-
Q: winax加载不了怎么办？
- A: 确认根目录下 local_libs\winax\下面是否build\Release。这个目录存在后，在根目录下运行 pnpm setup:clean 即可
📝 54. GIT问题 (FAQ)
- Q: git merge将旧的文件带入。在服务器上这样处理
git config --global pull.rebase true
git config --global rebase.autoStash true
git config --global fetch.prune true
git config --global core.editor nano
git config --global alias.up "pull --rebase"
上述设置后，以后更新时使用下面的命令
git up