添加开发规范和系统环境文档

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