From 511ea31a7ca6cc61108c4cd2714158d6024bdf00 Mon Sep 17 00:00:00 2001 From: root Date: Mon, 16 Feb 2026 09:04:00 +0100 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=BC=80=E5=8F=91=E8=A7=84?= =?UTF-8?q?=E8=8C=83=E5=92=8C=E7=B3=BB=E7=BB=9F=E7=8E=AF=E5=A2=83=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DEV_GUIDE.md | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 DEV_GUIDE.md diff --git a/DEV_GUIDE.md b/DEV_GUIDE.md new file mode 100644 index 00000000..f3712b3a --- /dev/null +++ b/DEV_GUIDE.md @@ -0,0 +1,80 @@ +# TOOLS.md - MileStone AI 开发环境 + +## 服务器信息 +- **IP**: 217.216.32.230 (新加坡 VPS) +- **OS**: Ubuntu 22.04 +- **内存**: 12GB (约 8GB 可用) +- **磁盘**: 194GB (已用 25GB) +- **Node.js**: v22.22.0 (fnm 管理) +- **Java**: 通过 Docker 容器运行 (jsherp 容器内) + +## 数据库 +- **MariaDB**: 11.4.10 (MySQL 兼容) +- **Host**: 127.0.0.1:3306 +- **用户**: root / Qweewqzzx1 +- **ERP 数据库**: jsh_erp +- **Redis**: 127.0.0.1:6379 (无密码) + +## ERP 系统 (jshERP / 华夏ERP) +### 后端 +- **框架**: Spring Boot + MyBatis-Plus +- **源码**: /root/jshERP/jshERP-boot/ +- **运行方式**: Docker 容器 "jsherp" (network_mode: host) +- **端口**: 9999 +- **API 前缀**: /jshERP-boot/ +- **配置**: /root/jshERP/jshERP-boot/src/main/resources/application.properties + +### 前端 +- **框架**: Vue 2.7 + Ant Design Vue 1.5.2 + vue-cli +- **源码**: /root/jshERP/jshERP-web/ +- **部署目录**: /opt/jshERP-web/ +- **构建**: cd /root/jshERP/jshERP-web && npm run build +- **部署**: cp -r dist/* /opt/jshERP-web/ +- **域名**: https://erp.puro.im + +### 主题配置 +- **主色**: #00458a (深蓝) +- **导航**: dark 模式 +- **Logo 背景**: #001a3a +- **配置文件**: defaultSettings.js, vue.config.js, main.js, index.less, Logo.vue +- **注意**: main.js 中强制覆盖 config.primaryColor，防止 localStorage 缓存旧颜色 + +## DevOps 服务 +| 服务 | 域名 | 端口 | 路径 | +|------|------|------|------| +| Gitea | git.puro.im | 3000 | /opt/devops/gitea/ | +| Drone CI | devops.puro.im | 8080 | /opt/devops/drone/ | +| Grafana | monitor.puro.im | 3001 | /opt/devops/monitoring/ | +| Portainer | portainer.puro.im | 9000 | - | +| Prometheus | - | 9090 | /opt/devops/monitoring/ | +| Loki | - | 3100 | /opt/devops/monitoring/ | +| Mattermost | im.puro.im | 8065 | /opt/devops/mattermost/ | +| OpenClaw | claw.puro.im | 18790 | systemd service | + +## 反向代理 (Caddy) +- **配置目录**: /etc/caddy/conf.d/ +- **主配置**: /etc/caddy/Caddyfile (import conf.d/*.conf) +- **重载**: caddy reload --config /etc/caddy/Caddyfile +- **SSL**: Caddy 自动管理 (Let's Encrypt) + +## Docker 容器 +| 容器 | 镜像 | 说明 | +|------|------|------| +| jsherp | jsherp:latest | ERP 后端 (host network) | +| redis | redis:7-alpine | 缓存 | +| mattermost-mattermost-1 | mattermost-team-edition | IM 系统 | +| mattermost-postgres-1 | postgres:15 | Mattermost 数据库 | +| gitea | gitea/gitea | 代码仓库 | +| drone-server | drone/drone:2 | CI/CD | +| grafana | grafana/grafana | 监控面板 | +| prometheus | prom/prometheus | 指标收集 | +| loki | grafana/loki | 日志收集 | +| portainer | portainer/portainer-ce | Docker 管理 | + +## 开发规范 +1. **前端修改**: 改源码 → npm run build → cp dist/* /opt/jshERP-web/ → 浏览器刷新 +2. **后端修改**: 改源码 → Docker 容器内重新构建/重启 +3. **数据库变更**: 先备份再操作，记录 SQL 变更 +4. **Git**: 清晰的 commit message，中英文均可 +5. **安全**: 不暴露密码和 API Key，不删除生产数据 +6. **颜色**: 全局使用 #00458a 深蓝主题，不使用旧的 #1890FF