JPwise-Web 前端开发文档

📚 文档体系

🔥 快速上手

• 快速参考指南 - 项目启动、核心概念、常用功能速查
• 开发模板库 - 即用代码模板，快速搭建页面
• 组件使用指南 - JNPF/JPW组件详解与最佳实践

📖 参考文档

• API 方法参考 - 表单/列表脚本API、openWindow配置
• 工具方法参考 - 日期时间、数值计算、权限检查等工具
• 混入使用指南 - listMixin、formMixin详解与调试技巧
• 扩展函数明细 - 自定义扩展函数详细说明

💡 最佳实践

• 开发最佳实践 - 代码规范、性能优化、错误处理
• 故障排除指南 - 常见问题诊断与解决方案
• 部署构建指南 - 环境配置、构建优化、CI/CD

📏 开发标准

• 开发规范标准 - 团队开发规范与流程要求
• 代码质量标准 - 代码审查标准与质量控制

⚙️ 配置标准

• 配置标准概述 - 配置系统整体介绍
• 字段映射规则 - 数据库字段与表单组件映射
• 组件映射配置 - 组件选择与配置规范
• 列表配置规则 - 列表页面配置标准
• 验证规则配置 - 表单验证规则详解
• 布局优化规则 - 页面布局最佳实践
• DDL生成标准 - 数据库表结构生成规范
• 增强生成规则 - 代码生成增强配置
• 高级功能配置 - 高级特性配置指南
• 业务场景方案 - 典型业务场景解决方案
• 系统自动化配置 - 自动化任务配置

🚀 学习路径

新手开发者（1-2周）

1. 第一天：阅读快速参考指南，搭建开发环境
2. 第二天：学习组件使用指南，了解基础组件
3. 第三天：通过开发模板库实践第一个页面
4. 第一周：掌握混入使用指南和基础API
5. 第二周：学习开发规范和最佳实践

进阶开发者

• 深入研究配置标准体系
• 掌握扩展函数开发
• 学习高级功能配置
• 实践业务场景方案

🔍 快速查找

常用功能

需求	文档位置	关键内容
打开弹窗	API参考	openWindow 配置详解
表单操作	快速参考	setFormData、getFormData
列表开发	开发模板	列表页面完整模板
权限控制	工具方法	hasP、hasFormP
日期处理	工具方法	toDate、getDate
数据验证	验证规则	表单验证配置

开发场景

场景	推荐文档	备注
创建新页面	开发模板 → 组件指南	使用模板快速开始
表单开发	字段映射 → 验证规则	规范化表单配置
列表开发	列表配置 → 组件映射	标准列表实现
性能优化	最佳实践 → 布局优化	提升页面性能
问题排查	故障排除 → 代码质量	快速定位问题

💡 常见问题

开发环境

• Q: 如何启动项目？ → 查看快速参考指南
• Q: 环境变量如何配置？ → 查看部署构建指南

组件使用

• Q: 如何选择合适的组件？ → 查看组件映射配置
• Q: 组件属性不生效？ → 查看故障排除指南

数据处理

• Q: 如何处理复杂表单数据？ → 查看字段映射规则
• Q: 列表数据加载慢？ → 查看性能优化

📈 版本信息

• 文档版本：v3.0
• 更新日期：2025-01-22
• 适用版本：JPwise v3.4.2+
• 维护团队：JPwise前端组

🤝 贡献指南

欢迎提交文档改进建议：

1. 发现错误或不清晰的描述
2. 补充缺失的使用案例
3. 分享最佳实践经验
4. 提供性能优化建议

---

💡 提示：使用 Ctrl+F 快速搜索关键词，或使用文档站点的搜索功能定位所需内容。