<<<<<<< HEAD # Mac Studio M2 企业级 CI/CD 基础设施 ## 🚀 完全自动化部署 - 已验证可用 ✅ 这是一套完整的企业级CI/CD基础设施，专为Mac Studio M2环境优化，支持**一键自动化部署**，无需手动配置。 ### ⚡ 快速开始 ```bash # 一键自动化部署所有服务 ./build-infra.sh --full-auto # 分步骤部署（逐步确认） ./build-infra.sh --step-by-step # 验证现有服务 ./build-infra.sh --verify ``` ### 🌐 服务访问地址 部署完成后，通过以下地址访问服务： | 服务 | 地址 | 用途 | 默认账号 | |------|------|------|----------| | **Gitea** | http://localhost:33000 | Git代码仓库 + Actions | 需要初始化 | | **Jenkins** | http://localhost:38080 | CI/CD平台 | admin / admin123 | | **Registry** | http://localhost:35001 | Docker镜像仓库 | 无认证 | | **Registry UI** | http://localhost:35002 | 镜像管理界面 | 无认证 | **SSH访问：** ```bash # Gitea SSH克隆 (端口32222) git clone ssh://git@localhost:32222/username/repository.git ``` ### 🎯 核心特性 - ✅ **一键部署**: 完全自动化，15分钟内完成所有配置 - ✅ **端口优化**: 统一使用3开头端口，避免冲突 - ✅ **多平台构建**: 支持 linux/amd64 + linux/arm64 - ✅ **Configuration as Code**: Jenkins零手动配置 - ✅ **企业级功能**: 完整的CI/CD流水线支持 - ✅ **健康监控**: 自动化服务状态检查 - ✅ **数据持久化**: 所有数据自动备份和恢复 ### 📋 端口分配 ``` 服务端口分配（避免冲突）: ├── Gitea: 33000 (Web) + 32222 (SSH) ├── Jenkins: 38080 (Web) + 35000 (Agent) ├── Docker Registry: 35001 (API) + 35002 (UI) └── 预留监控端口: 37001+ (Prometheus等) ``` ### 🏗️ 架构组件 **核心服务：** - **Jenkins LTS**: CI/CD服务器，基于JDK21 - **Gitea 1.21**: 轻量级Git服务，支持Actions - **Docker Registry**: 本地镜像仓库 - **Registry UI**: 可视化镜像管理 **环境信息：** - **硬件**: Mac Studio M2 Ultra (24核CPU, 76核GPU, 192GB内存) - **系统**: macOS Sequoia 15.7 - **容器**: Docker Desktop + OrbStack优化 - **网络**: 统一cicd-network网络 ### 📂 项目结构 ``` infra/ ├── build-infra.sh # 🌟 一键部署脚本 ├── configs/ │ └── global.env # 统一环境配置 ├── docker/compose/ # Docker编排配置 │ ├── gitea-compose.yml # Gitea服务 │ ├── jenkins-simple.yml # Jenkins服务 │ └── registry-simple.yml # Registry服务 ├── jenkins/ │ ├── casc/jenkins.yaml # Jenkins自动配置 │ ├── shared-library/ # Pipeline共享库 │ └── templates/ # 项目模板 ├── scripts/ │ ├── maintenance/ # 维护脚本 │ └── utils/ # 工具脚本 └── docs/ # 文档 ``` ### 🔧 管理命令 ```bash # 部署管理 ./build-infra.sh --full-auto # 完全自动化部署 (推荐) ./build-infra.sh --step-by-step # 分步骤部署 ./build-infra.sh --cleanup # 清理所有服务 ./build-infra.sh --verify # 验证服务状态 # 日常维护 ./scripts/maintenance/health-check.sh # 健康检查 ./scripts/utils/show-logs.sh [service] # 查看日志 # 传统管理脚本 (保留兼容) ./jenkins-manager.sh [status|start|stop|backup|health] ``` ### 🚀 CI/CD功能特性 #### Jenkins自动配置 (CasC) - ✅ **50+插件自动安装**: Docker, Gitea, Pipeline, 多平台构建等 - ✅ **工具自动配置**: Git, Maven, Gradle, NodeJS, Docker, Python - ✅ **凭据模板**: Gitea, Registry, SSH凭据预配置 - ✅ **云配置**: Docker和Kubernetes云支持 - ✅ **示例作业**: 多平台构建和系统监控作业 #### 多平台构建支持 ```groovy // 自动支持的构建平台 pipeline { environment { PLATFORMS = 'linux/amd64,linux/arm64' REGISTRY = 'localhost:35001' } stages { stage('多平台构建') { steps { buildMultiPlatformImage([ imageName: "${REGISTRY}/app:${BUILD_NUMBER}", platforms: env.PLATFORMS ]) } } } } ``` ### 📊 部署验证 部署完成后，系统会自动验证： - ✅ **容器状态**: 所有服务容器正常运行 - ✅ **端口监听**: 所有端口正确绑定 - ✅ **API响应**: 所有服务API正常响应 - ✅ **健康检查**: Gitea和Registry健康检查通过 - ✅ **Web界面**: 所有Web界面可正常访问 ### 🛠️ 故障排查 #### 常见问题 **端口占用：** ```bash # 检查端口占用 lsof -i :33000,38080,35001,35002 # 清理并重新部署 ./build-infra.sh --cleanup ./build-infra.sh --full-auto ``` **服务启动失败：** ```bash # 查看服务日志 ./scripts/utils/show-logs.sh [gitea|jenkins|registry|all] # 健康检查 ./scripts/maintenance/health-check.sh ``` **配置修改：** - 主配置文件: `configs/global.env` - Jenkins配置: `docker/compose/jenkins/casc/jenkins.yaml` - 修改后重新部署生效 ### 💡 最佳实践 #### CI/CD流程 1. **代码管理**: 在Gitea中创建仓库和组织 2. **Pipeline配置**: 使用预置模板快速创建 3. **多平台构建**: 自动支持AMD64和ARM64 4. **镜像管理**: Registry UI可视化管理镜像 #### 维护建议 - **定期备份**: 使用内置备份脚本 - **健康监控**: 定期运行健康检查 - **更新管理**: 定期更新Docker镜像 - **日志管理**: 定期清理服务日志 ### 📈 性能优化 **资源配置优化：** - Jenkins JVM: `-Xmx2g -Xms1g` - 构建并发: 支持多个并行构建 - 镜像缓存: 本地Registry加速构建 - 网络优化: 统一Docker网络提高通信效率 ### 🔄 升级和扩展 #### 监控扩展 (预留) ```bash # 监控服务端口预留 PROMETHEUS_PORT=37001 GRAFANA_PORT=37002 ``` #### Kubernetes集成 - Jenkins Kubernetes插件已预配置 - 支持K8s动态Agent - 多环境部署支持 ### 📞 技术支持 - **快速开始**: 查看 `QUICK_START.md` - **详细规划**: 查看 `BUILD_PLAN.md` - **配置说明**: 查看 `CLAUDE.md` - **问题排查**: 查看 `docs/troubleshooting.md` ### 🎉 版本信息 - **当前版本**: v2.0 (统一端口版本) - **Jenkins版本**: LTS (JDK21) - **Gitea版本**: 1.21 - **Registry版本**: 2.x - **最后更新**: 2025-01-23 ### 📄 许可证 MIT License --- ## 🚀 立即开始 ```bash # 克隆项目 git clone cd infra # 一键部署所有服务 ./build-infra.sh --full-auto # 访问服务 open http://localhost:33000 # Gitea open http://localhost:38080 # Jenkins (admin/admin123) open http://localhost:35002 # Registry UI ``` **部署时间**: 约10-15分钟 **服务数量**: 4个核心服务 **支持平台**: Mac Studio M2 + Docker Desktop ======= # 灵境万象健康管理系统 (LJWX)  [](./LICENSE)  ## 📋 项目概述 灵境万象健康管理系统（LJWX）是一套完整的企业级健康监测解决方案，专为工业环境下的可穿戴设备健康数据监控而设计。系统集成了数据采集、实时分析、智能告警、可视化大屏等功能模块，为企业提供全方位的员工健康安全保障。 ### 🎯 核心特性 - **🏥 健康数据监控**: 实时采集心率、血压、体温、运动数据等多维度健康指标 - **🚨 智能告警系统**: 多租户告警规则管理，支持微信、消息、大屏推送 - **📊 可视化大屏**: 专业级监控大屏，实时展示健康状态和告警信息 - **📱 移动端应用**: Flutter开发的移动APP，支持数据查看和设备管理 - **⌚ 智能手表集成**: 支持华为Watch4等智能穿戴设备数据采集 - **🏢 多租户架构**: 企业级权限管理，支持租户隔离和告警规则隔离 ## 🏗️ 系统架构 ``` ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ ljwx-watch │ │ ljwx-phone │ │ ljwx-admin │ │ljwx-bigscreen│ │ 智能手表 │ ──▶ │ 移动应用 │ ──▶ │ 管理后台 │ ──▶ │ 监控大屏 │ │ (HarmonyOS)│ │ (Flutter) │ │ (Vue3) │ │ (Python) │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ └───────────────────┼───────────────────┼───────────────────┘ │ │ ┌─────────────┐ ┌─────────────┐ │ ljwx-boot │ │ 数据存储 │ │ 后端API │◄──▶│ MySQL+Redis │ │(Spring Boot)│ │ │ └─────────────┘ └─────────────┘ ``` ## 📂 项目结构 ### 🔧 后端服务 (ljwx-boot) - **Spring Boot 3.3.2 + Java 21** - 现代化微服务架构 - **健康管理模块**: 10+健康指标实时监控、睡眠分析、运动追踪 - **系统管理模块**: 多租户架构、RBAC权限控制、组织管理 - **设备管理模块**: IoT设备生命周期管理、状态监控 - **多租户告警系统**: 智能阈值监控、多级告警处理、租户级别告警规则隔离 - **地理围栏**: 虚拟边界监控、位置告警 ### 🖥️ 前端管理 (ljwx-admin) - **Vue3 + TypeScript + Naive UI** - 现代化管理界面 - **健康数据管理**: ECharts可视化、Excel导出、时间序列分析 - **设备管理**: 电池监控、佩戴状态、设备配置 - **告警管理**: 实时告警监控、规则配置、微信集成 - **用户组织管理**: 分层权限、角色管理、部门架构 - **系统监控**: 性能指标、日志管理、缓存监控 ### 📊 监控大屏 (ljwx-bigscreen) - **Python Flask + Socket.IO** - 高性能实时监控 - **实时数据处理**: 支持1000+设备并发、QPS>1400 - **告警处理引擎**: 多渠道通知、层级分发、WebSocket推送 - **健康分析系统**: AI健康画像、个人基线、Z-score异常检测 - **地图可视化**: 实时位置追踪、告警地点标记 - **性能优化**: Redis缓存、批量查询、连接池管理 ### 📱 移动应用 (ljwx-phone) - **Flutter 3.0+ 跨平台** - 统一iOS/Android体验 - **蓝牙BLE集成**: 自动设备发现、二进制协议、实时同步 - **健康数据可视化**: FL Chart图表、雷达图健康评分 - **管理员模式**: 嵌入式Web界面、SHA认证、角色切换 - **数据同步**: 蓝牙/WiFi双模式、本地缓存、批量上传 - **告警通知**: 实时推送、声音提醒、状态指示 ### ⌚ 智能手表 (ljwx-watch) - **HarmonyOS 3.0 原生应用** - 深度系统集成 - **健康传感器**: 心率、血氧、体温、压力、步数监测 - **电源优化**: 统一定时器、15-18小时续航、智能调度 - **通信协议**: 高级TLV二进制格式、50%数据压缩 - **紧急功能**: SOS按钮、跌倒检测、一键告警 - **实时同步**: 蓝牙BLE/WiFi双通道、离线缓存 ## 🚀 最新功能 v1.3.8 ### 🔧 Excel导出功能修复与静态文件优化 (2025-08-29) #### **Excel导出功能完善** - **导出故障修复**: 修复health_table.html中Excel导出无错误日志的问题 - **XLSX库路径修复**: 解决Flask静态文件路径配置导致的XLSX库加载失败 - **增强错误处理**: 添加详细的调试日志和错误提示，提升用户体验 - **CDN备用机制**: 实现本地XLSX库失败时的CDN自动降级加载 #### **自定义弹窗系统** - **统一弹窗组件**: 创建可复用的`showCustomAlert`组件替代原生alert - **视觉效果升级**: 科技感弹窗设计，支持键盘快捷键（ESC、Enter） - **模块化设计**: 提取为独立的`custom-alert.js`文件供全局复用 - **增强功能**: 支持确认框、回调函数、动画效果 #### **静态文件架构优化** - **路径问题诊断**: 发现并修复静态文件错误放置在`/bigScreen/static/`的问题 - **Flask配置确认**: 验证`static_folder='../static'`指向正确的`/bigscreen/static/` - **CDN文件迁移**: 将Bootstrap、FontAwesome、ECharts等离线CDN文件移至正确位置 - **重复文件清理**: 删除错误位置的重复文件，避免开发者混淆 ```bash # 修复前的问题路径结构 /bigscreen/bigScreen/static/ # ❌ 错误位置 - Flask无法访问 ├── css/bootstrap-5.1.3.min.css ├── js/echarts.min.js └── js/xlsx-0.18.5.full.min.js # 修复后的正确路径结构 /bigscreen/static/ # ✅ 正确位置 - Flask可以访问 ├── css/bootstrap-5.1.3.min.css ├── js/echarts.min.js └── js/xlsx-0.18.5.full.min.js ``` #### **技术改进详情** - **依赖库完整性**: 确保所有CDN离线文件在正确位置并可被Flask访问 - **版本同步更新**: 使用最新版本的ECharts (1MB+) 替换旧版本 (700KB) - **开发体验优化**: 清理重复文件，建立清晰的静态文件组织结构 - **系统稳定性**: 解决Excel导出"导出失败，请重试"无具体错误信息的问题 --- ## 🚀 历史版本 v1.3.6 ### 🔧 多租户告警规则系统实现 (2025-08-26) #### **告警规则多租户隔离** - **租户级规则隔离**: 实现告警规则基于 `customer_id` 的完全隔离，不同租户拥有独立的告警规则集 - **默认规则自动克隆**: 新建租户时自动从 `customer_id=0` 克隆默认告警规则 - **多级告警支持**: 支持同一健康指标配置多个告警级别（如心率120-140中级，140-160高级） - **系统事件匹配**: 告警规则类型与手表系统事件完全匹配，支持直接规则匹配 #### **告警类型国际化支持** - **英文键值系统**: 告警规则类型使用标准英文格式（如 `HEARTRATE_HIGH_ALERT`） - **中文显示支持**: 通过数据字典实现英文→中文映射，前端显示用户友好的中文 - **完整映射体系**: 覆盖15种告警类型的完整中英文映射 - **专业化命名**: 与智能手表系统事件命名规范保持一致 #### **数据库优化** ```sql -- 告警规则表新增字段 ALTER TABLE t_alert_rules ADD COLUMN customer_id BIGINT; -- 支持多级告警的唯一约束 ALTER TABLE t_alert_rules ADD UNIQUE KEY uk_alert_multi_level (rule_type, physical_sign, severity_level, customer_id); -- 完整的告警类型字典映射 INSERT INTO sys_dict_item (dict_code, value, zh_cn, en_us) VALUES ('alert_type', 'HEARTRATE_HIGH_ALERT', '心率过高告警', 'HEARTRATE_HIGH_ALERT'), ('alert_type', 'SOS_EVENT', 'SOS紧急求助', 'SOS_EVENT'); ``` #### **系统架构升级** - **OrgUnitsChangeListener 扩展**: 新建租户时自动触发告警规则克隆 - **多租户数据隔离**: 查询、创建、更新、删除操作均基于租户ID过滤 - **Redis 缓存优化**: 告警规则缓存键支持租户级别隔离 `alert_rules_{customerId}` - **前端上下文传递**: 管理界面自动传递当前用户的 `customerId` --- ## 🚀 历史版本 v1.3.3 ### 🔧 客户部署配置系统修复 (2025-08-20) #### **端口配置动态化修复** - **配置文件读取**: `generate-docker-compose.sh` 现在正确读取 `custom-config.env` 配置 - **端口配置灵活**: 支持客户完全自定义 MySQL、Redis、大屏等服务端口 - **镜像版本同步**: 自动从 `docker-compose.yml` 读取最新镜像版本标签 - **环境变量传递**: 确保所有自定义配置正确传递到生成的容器配置中 #### **修复前后对比** ```bash # 修复前: 硬编码默认端口 ports: - "3306:3306" # 固定MySQL端口 - "8001:8001" # 固定大屏端口 # 修复后: 动态配置端口 ports: - "$MYSQL_PORT:3306" # 从custom-config.env读取 - "$BIGSCREEN_PORT:$APP_PORT" # 支持自定义端口映射 ``` ### 🐳 Docker构建系统优化修复 (2025-08-20) #### **ljwx-boot Docker构建修复** - **Maven镜像源优化**: 配置阿里云Maven镜像，解决`No route to host`网络连接问题 - **超时配置优化**: 增加Maven连接和读取超时时间，提高构建稳定性 - **多阶段构建**: 优化Dockerfile，支持ljwx-boot-starter依赖构建和主应用构建 - **网络连接修复**: 解决Docker构建环境中Maven依赖下载失败的问题 #### **技术改进详情** ```dockerfile # 配置Maven阿里云镜像源 RUN mkdir -p /root/.m2 && \ echo '......https://maven.aliyun.com/repository/public...' > /root/.m2/settings.xml # 增加超时配置 RUN mvn clean install -DskipTests -Dmaven.wagon.http.connectTimeout=60000 -Dmaven.wagon.http.readTimeout=120000 ``` ### 🔧 蓝牙健康数据上传修复 (2025-08-19) #### **移动端数据传输优化** - **数据结构简化**: 移除ljwx-phone上传健康数据最外层的data结构，直接传输核心数据 - **蓝牙传输稳定性**: 优化BLE数据包格式，提高传输成功率和稳定性 - **数据同步效率**: 简化数据封装层次，减少传输开销，提升同步速度 - **兼容性增强**: 确保手表端和服务端数据格式完全匹配，避免解析错误 ### 📋 代码分析与文档完善 (2025-08-16) #### **完整系统分析** - **深度模块分析**: 完成所有5个模块的详细代码分析 - **技术架构文档**: 新增完整的系统功能模块清单文档 - **API接口梳理**: 详细整理各模块核心API和功能特性 - **性能指标确认**: 验证系统性能数据和技术参数 #### **技术文档体系** - **[系统功能模块清单](./docs/系统功能模块清单.md)**: 109KB综合技术文档 - **模块功能清单**: ljwx-boot、ljwx-admin、ljwx-bigscreen、ljwx-phone、ljwx-watch - **架构设计说明**: 详细的技术栈和系统架构分析 - **部署运维指南**: 完整的部署和监控方案 --- ## 🚀 历史版本 v1.3.2 ### ✨ 告警通知系统完整升级 #### **多渠道通知** - **企业微信**: 支持企业微信应用消息推送 - **公众号微信**: 支持微信公众号模板消息 - **系统消息**: 内置消息系统，层级分发通知 - **大屏推送**: Critical级别告警实时推送到监控大屏 #### **智能层级通知** ``` 设备告警事件 ↓ 告警规则匹配 ↓ ┌─────────────┐ │ 通知分发策略 │ └─────────────┘ ↓ ↓ ↓ 用户通知 部门主管 租户管理员 ↓ ↓ (无主管时) (最终兜底) ``` #### **实时大屏集成** - **WebSocket实时推送**: Socket.IO支持秒级告警推送 - **专业告警界面**: 科技感弹窗设计，包含告警详情 - **交互功能**: 支持告警确认、音效提醒、ESC关闭 - **地图标记**: 可选的告警位置地图标记功能 ### 🛠️ 技术亮点 - **多架构支持**: Docker支持AMD64/ARM64多架构部署 - **性能优化**: 解决N+1查询问题，响应时间从181s优化到<5s - **高并发处理**: QPS >1400，支持2000+设备并发 - **容错设计**: 微信通知失败自动降级，确保告警可达性 - **智能手表集成**: HarmonyOS原生应用，支持15+小时续航 - **二进制协议**: TLV格式数据传输，压缩率达50% - **AI健康分析**: 集成DeepSeek R1模型，智能健康建议 ## 📋 快速开始 ### 环境要求 | 组件 | 版本要求 | 说明 | |-----|---------|------| | Java | ≥ JDK 21 | 后端运行环境 | | Node.js | ≥ 18.0 | 前端构建环境 | | Python | ≥ 3.8 | 大屏系统环境 | | MySQL | ≥ 8.0 | 数据存储 | | Redis | ≥ 6.0 | 缓存存储 | | Docker | ≥ 20.10 | 容器化部署(可选) | ### 🐳 快速部署 (推荐) ```bash # 1. 克隆项目 git clone https://github.com/your-org/ljwx-system.git cd ljwx-system # 2. 构建所有Docker镜像 ./build-and-push.sh boot # 构建后端服务 ./build-and-push.sh admin # 构建前端管理 ./build-and-push.sh bigscreen # 构建监控大屏 # 3. 一键启动所有服务 docker-compose up -d # 4. 初始化数据库 mysql -u root -p123456 < client-deployment/client-data.sql # 5. 访问系统 # 管理后台: http://localhost:3000 # 监控大屏: http://localhost:5001 # API文档: http://localhost:9998/doc.html ``` ### 🔧 Docker构建说明 系统已优化Docker构建流程，解决了网络连接问题： ```bash # 单独构建各组件 ./build-and-push.sh boot # 后端API服务 (Spring Boot) ./build-and-push.sh admin # 前端管理系统 (Vue3) ./build-and-push.sh bigscreen # 监控大屏系统 (Python Flask) # 构建支持多架构 (AMD64/ARM64) # 镜像自动推送到阿里云容器镜像仓库 ``` ### ⚙️ 客户部署配置 系统支持完全自定义的端口和服务配置： ```bash # 修改 custom-config.env 文件 BIGSCREEN_PORT=8002 # 自定义大屏端口 MYSQL_PORT=3307 # 自定义MySQL端口 REDIS_PORT=6380 # 自定义Redis端口 VITE_BIGSCREEN_URL=http://192.168.1.10:8002 # 大屏访问地址 # 生成动态配置并部署 ./deploy-client.sh custom-config.env ``` **特性**: - 🔄 **动态端口配置**: 根据客户环境自动调整端口映射 - 📦 **镜像版本同步**: 自动使用最新的镜像版本标签 - 🔧 **环境变量传递**: 完整的配置文件支持 - ✅ **向后兼容**: 保持现有部署的稳定性 ### 🔧 开发环境部署 #### 后端服务 ```bash cd ljwx-boot ./run-local.sh ``` #### 前端管理 ```bash cd ljwx-admin npm install npm run dev ``` #### 监控大屏 ```bash cd ljwx-bigscreen/bigscreen python run_bigscreen.py ``` ## 📊 系统展示 ### 管理后台 - 健康数据总览、实时设备状态监控 - 告警配置管理、用户权限控制 - 数据可视化图表、统计分析报表 ### 监控大屏 - 实时健康数据地图、告警状态展示 - Critical告警弹窗、WebSocket实时推送 - 系统性能监控、设备在线状态 ### 移动应用 - 个人健康档案、历史数据查询 - 设备绑定管理、消息通知中心 - 健康评分分析、趋势图表展示 ## 🔧 配置说明 ### 数据库配置 ```yaml # application.yml spring: datasource: url: jdbc:mysql://localhost:3306/test username: root password: 123456 ``` ### 告警通知配置 ```python # 企业微信配置 WECHAT_CORP_ID = "your_corp_id" WECHAT_AGENT_ID = "your_agent_id" WECHAT_SECRET = "your_secret" # 公众号配置 WECHAT_APPID = "your_appid" WECHAT_APPSECRET = "your_appsecret" WECHAT_TEMPLATE_ID = "your_template_id" ``` ## 📈 性能指标 - **响应时间**: <3秒 (1000设备规模) - **并发处理**: QPS >1400 - **系统可用性**: 99.9% - **告警及时性**: <5秒 (Critical级别) ## 🔒 安全特性 - **多租户隔离**: 数据完全隔离，权限严格控制 - **API安全**: Sa-Token鉴权，接口权限细化 - **数据加密**: 敏感数据AES加密存储 - **SQL注入防护**: MyBatis-Plus参数化查询 ## 📚 技术文档 ### 核心文档 - **[系统功能模块清单](./docs/系统功能模块清单.md)** - 完整的系统功能和技术架构说明 - **[告警通知功能完整实现方案](./docs/告警通知功能完整实现方案.md)** - 告警通知系统技术方案 ### 部署文档 - **[系统部署指南](./client-deployment/DEPLOY_GUIDE.md)** - Docker容器化部署 - **[离线部署完整指南](./client-deployment/离线部署完整指南.md)** - 离线环境部署 ### 开发文档 - **[二次开发文档](./ljwx-bigscreen/docs/二次开发文档.md)** - 大屏系统开发指南 - **[技术架构方案文档](./ljwx-bigscreen/docs/技术架构方案文档.md)** - 系统架构设计 - **[API接口文档](http://localhost:9998/doc.html)** - 在线API文档 ### 移动端文档 - **[数据监控解决方案使用指南](./ljwx-phone/数据监控解决方案使用指南.md)** - 移动端使用说明 - **[手表开发和使用指南](./ljwx-watch/手表开发和使用指南.md)** - 智能手表开发指南 ## 🤝 贡献指南 1. Fork 本仓库 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 打开 Pull Request ## 📄 开源协议 本项目基于 [Apache License 2.0](./LICENSE) 开源协议，仅供学习参考使用。 ## 👥 联系我们 - **项目主页**: [GitHub](https://github.com/your-org/ljwx-system) - **问题反馈**: [Issues](https://github.com/your-org/ljwx-system/issues) - **技术支持**: support@ljwx.com --- **© 2024 灵境万象健康管理系统 (LJWX). All rights reserved.** >>>>>>> gitea/main