市场开发者指南
开发者入驻
1.成为明道云用户
在明道云HAP上开发应用前，你必须先成为明道云用户，并有一个可以用于搭建应用的组织。你可以进入明道云官网完成注册，登录后可以创建/加入组织。
2.完成身份认证
登录HAP后，进入市场首页，点击【卖应用】或头像组件下方【开发者】进入开发者后台。
进入开发者后台-档案页，点击【立即认证】完成企业/个人身份认证
在市场开发者后台、个人账户或组织管理中都可以进行认证。前往认证
3.签署入住协议
认证完成后，会展示签约入驻协议入口，同意并签署入驻协议后，即完成了市场开发者入驻。认证并完成最新协议签署后，才允许上架应用。
平台工具与资源介绍
HAP平台简介
HAP是一个创新的超级应用平台(Hyper Application Platform)，可以帮助用户零代码构建企业应用，用户不需要代码开发就能够搭建出用户体验上佳的销售、运营、人事、采购等核心业务应用，打通企业内部数据。HAP还具备超自动化引擎，可以全面自动化复杂和重复的业务流程。运用HAP的集成中心与完整的API对接能力，用户可以轻松地将HAP与外部系统集成。除此之外，HAP超级应用平台还具备很高的可组合性，国际化支持，并支持云原生架构，实现了多云部署能力。通过插件架构，HAP正在逐步建立起繁荣的实施与开发生态。
在HAP搭建的业务软件/业务系统，称之为应用，一个应用可以解决一个或整个业务环节，小到工单管理，大到ERP应用，一个平台，全部搞定。
社区与资源
- 帮助中心：https://help.mingdao.com/
- 明道云社区：https://bbs.mingdao.net/
- 明道云博客：https://blog.mingdao.com/
- HAP 学习中心：https://learn.mingdao.net/
应用设计与开发指南
HAP平台的核心功能
HAP通过封装好的7个功能模块的组合来构建一个应用，7个功能模块分别为：工作表、视图、角色和权限、工作流、统计图表、自定义页面和外部门户。
- 工作表 用于收集和存储业务数据。想录入任何数据，都需要建立对应的工作表，例如员工表、客户表、订单表、库存表等。
- 视图 是业务数据的不同场景的展示页面，可以根据业务场景，操作人员展示出不同的数据。
- 角色和权限 控制成员的对业务数据增删改查的操作权限。
- 工作流 可以实现业务数据的自动化处理和自动流转。
- 统计图表 用于统计多种维度的数据帮您分析做决策。
- 自定义页面 可以放置快捷按钮，统计图表等，常用于配置仪表台，驾驶舱或工作台。
- 外部门户 邀请外部人员加入使用，打通内外用户，前后贯通，内外畅达。
通过这七个能力模块，用户能够实现各种企业应用，除了某些专有系统，面向消费者的前台性应用，HAP能够覆盖企业数字化的绝大多数领域。它可以用卓越的效率和质量替代传统的定制开发，帮助ISV构建垂直行业解决方案，替换老旧IT系统，作为企业的数据管理中心和流程引擎。它也能够为信奉全民数字化赋能的企业提供易于部署和使用的工具。
如何创建你的第一个应用
创建一个新应用，有5种方式
- 从空白创建，完全自己搭建
- 从应用库中安装一个模板应用
- 通过Excel导入创建应用
- 通过导入应用文件创建
- 添加外部链接
详见：https://help.mingdao.com/application/building
注意事项
| 模块 | 注意事项 | 说明 |
|---|---|---|
| 数据隐私与合规性 | • 防止敏感数据的泄露，保障企业数据安全 • 不得侵犯他人的知识产权。 • 严格遵守法律法规，不进行非法收集、使用或泄露个人信息。 | |
| 兼容性与跨应用支持 | 由于本期（HAP V11.0版本）只支持单应用发布，所以应用结构中不能包含跨应用关联模块，否则用户购买后原关联关系将会失效不可用 | |
| 使用教程 | 对于新用户需要有友好的引导流程，让用户能快捷体验到产品的主要功能，感受到产品核心价值。建议通过自定义页面功能在应用中加入一个Readme页面（仅面向应用管理员角色显示），根据需要，也可以加入面向普通应用成员的引导文档。Readme文档应该结构清晰，版式简洁，尽可能明确地向用户介绍应用的功能和启用步骤。 | |
| 人员配置 | • 涉及到人员配置模块,如审批人、抄送人等。建议使用应用角色或者动态人员参数。避免出现用户购买后，数据匹配不上从而导致不可用的情况 |  |
| 代码块、API 请求节点、集成 API 节点 | • 注意把一些必要的参数做成配置项或者变量供引导用户填写，或者替换为动态的参数，避免将隐私信息泄露。 •若使用了集成 API，需要在操作说明中引导用户去完善连接参数 |  |
商品上架
目前（HAP V11.0版本）仅支持上架单应用类型商品，后续迭代中会陆续支持 API、插件等商品类型及多种售卖策略。
应用上架流程与规范
1.选择上架的应用
进入开发者后台的“应用”页面，选择自己的应用进行发布。若没有可发布的应用，可先进入HAP平台进行搭建。
选择应用后，系统会检查应用结构。例如，未启用的工作流默认不勾选发布，如确认无误可勾选。 确认发布的应用结构后，点击下一步。
2.填写商品基础信息
请清晰准确的填写商品的基础信息，他们将显示在商品的介绍页面。
| 属性 | 填写规范 |
|---|---|
| 名称 | 默认为应用名称 |
| 场景 | 为商品选择合适的分类，最少1个，最多3个 |
| 行业 | 商品适用行业，非必填 |
| 描述 | 一句话总结，简述商品的核心功能或能解决的业务问题 |
| 封面 | 在商品详情页顶部展示商品的特色功能页面 |
| 概述 | 格式：使用图文结合的应用详情可以更直观、更高效地向用户传递信息。注意排版美观，保证有恰当的行距；便于阅读，内容编排合理、有逻辑性。 内容与卖点：包含商品功能简介、使用场景、包括商品页面展示效果 使用教程：包含商品功能简介、使用场景、包括商品页面展示效果。 使用教程： 包含安装使用教程、使用方法，帮助用户快捷体验到产品价值 常见问题：包含常见问题，及注意事项。围绕下单前的咨询出发，给予能够充分消除顾虑的回答 售后保障： 包含售后服务及安全保障说明。建议通过公开表单的方式，为商品配置专属反馈链接，便于统一收集需求及反馈 |
3.配置订购计划
• 可以选择发布为应用模板/商品，你可以配置不同的付费方案：免费版、按人使用人数订阅、全组织可用 请根据你的需求，选择合适的计划类型。
• 可以配置多个付费计划，可以添加多个按人数订阅计划，实现人多优惠
| 发布类型 | 用户购买后编辑应用结构、配置、流程权限 | 通过市场进行升级 | 申请退单 |
|---|---|---|---|
| 应用模板 | 允许编辑 | ❌ | ❌ |
| 应用商品 | 不允许编辑 | ✅ | ✅ 特殊说明：金额小于 5000 的新购订单允许退单，详见：订单退款与结算 |
发布类型为应用模板
上架应用选择为应用模板类型，用户购买后可以编辑应用结构、配置、流程，但不再支持通过市场升级。
| 付费类型 | 计划 | 周期 | 允许定价范围（元） | 描述 | 示例 | 后续付费行为 |
|---|---|---|---|---|---|---|
| 免费 | 免费 | 永久 | 0 | 免费购买，且购买后永久有效 | -价格：0 元 | -周期：永久有效 |
| 付费 | 全组织可用 | 一次性买断 | 19.9～9999 | 根据订购周期付费，购买应用使用人数与 HAP 组织订阅授权人数一致。 可按人员、部门、组织角色、职位添加用户 | 单价： X 元 周期：永久有效 | 人数增购 |
发布类型为商品
用户不能编辑应用结构、配置、流程，开发者发布新版本后可以通过市场升级。
| 付费类型 | 计划 | 周期 | 允许定价范围（元） | 描述 | 示例 | 后续付费行为 |
|---|---|---|---|---|---|---|
| 免费 | 免费 | 永久 | 0 | 免费购买，且购买后永久有效 | -价格：0 元 -周期：永久有效 | 无 |
| 付费 | 按使用人数订阅 | 年付 | 9.9～999 | 买家可以自行选择订购人数，按人数梯度自动匹配对应单价，计算最后的总价。 • 订购人数可超出购买组织 HAP 订阅授权人数。 • 应用中只能按人员添加用户 | 单价：X元/人/年。 周期：一年，按天展示。 人数限制：X 人（购买的人数）。 示例： 2024-11-7～2025-11-6（实际晚上 23:59:59结束） | 续订、变更计划、人数增购 |
| 付费 | 按使用人数订阅 | 一次性买断 | 9.9～9999 | 同上 | 单价：X元/人/年。 周期：永久有效，按天展示。 人数限制：X 人（购买的人数） | 人数增购 |
| 付费 | 全组织可用 | 年付 | 19.9～9999 | 根据订购周期付费，购买应用使用人数与 HAP 组织订阅授权人数一致。可按人员、部门、组织角色、职位添加用户 | 单价：X 元/年。 周期：一年，按天展示。 人数限制：全组织可用。 示例：2024-11-7～2025-11-6（实际晚上 23:59:59结束） | 续订、变更计划 （特殊说明：不允许从【全组织可用】变更为【按使用人数订阅】类型） |
| 付费 | 全组织可用 | 一次性买断 | 19.9～9999 | 同上 | 单价:X 元 周期：永久有效 | 人数增购 |
对于订单金额大于等于 5000 的订单，允许先免费试用 14 天。试用期内/试用期结束后，随时可以为原计划付款。为原计划付款后，立即生效；试用期内付款：周期累加；试用期结束后付款：周期从付款时刻开始生效
添加订购计划示例
配置多个按人数订购梯度示例
页面展示多买优惠
4.示例数据
上架时，应用模板类型和应用商品类型都可配置是否包含示例数据，开启后应用中的数据(单表最多1W，总数最多5W)会被提交至市场，如果不希望数据被公开，请不要开启。
5.提交审核与上架
设置版本号和更新说明，然后提交审核。
| 说明 | |
|---|---|
| 上架要求 | • 需完成开发者认证（个人/企业） • 需完成开发者协议签约，若协议有更新需重新签约 • 参考：开发者入驻 |
| 审核通过后自动上架 | • 勾选：审核通过后直接上架（需完成认证和签约） • 未勾选：审核通过后进入待上架状态，开发者可在开发者后台的"商品"-"应用"页面将商品上架 |
| 审核时效 | 提交审核后 1～3 个工作日，若逾期未审核可进入明道云社区进行咨询，或者联系在线客服或专属顾问 |
商品管理
特殊说明：为保证已购应用的正常续订与使用，对于已产生订单的订购的计划不允许删除，如果想让该计划不再被新购可关闭计划或下架商品。
| 商品状态 | 已上架 | 待上架 | 待审核 | 未通过 | 已下架 |
|---|---|---|---|---|---|
| 说明 | 上架中的商品 | 审核通过未上架的商品 | 处于审核中的商品 | 审核未通过的商品 | 主动操作下架的商品 |
| 操作项 | 更新、下架 | 上架、删除 | 更新、删除 | 上架、删除 |
发布更新
在开发者后台-商品-应用页中，对应用可进行订购信息和版本的更新。
商品审核通过并上架后，将更新线上商品信息。发布和付费类型不支持修改
新版本审核通过前，旧版本仍可以被正常订购
若源应用已被删除，点击【发布新版本】时，会提示“应用已删除，无法更新”，只能更新商品订购信息
| 功能 | 描述 |
|---|---|
| 更新订购信息 | 适用场景：仅更新商品展示信息、订购计划信息，不更新应用结构 更新范围：基础信息、订购计划、应用权限、示例数据 提交审核：更新后需重新提交审核才会生效，不会生成新的版本号 |
| 发布新版本 | 适用场景：应用结构和展示信息都需要更新时 更新范围：重新获取应用结构，基础信息、订购计划、应用权限、示例数据 提交审核：更新后需发布新版本提交审核 |
应用商品发布新版本后，已购用户可以在我的购买-应用详情里，查看应用历史更新版本。并选择性进行更新升级。
增购、续订行为的计算规则
变更计划
| 原计划类型 | 按使用人数订阅 | 全组织可用 |
|---|---|---|
| 描述 | 用户在有生效中付费计划生效中的情况下，变更为其他方案替换当前生效中的付费计划。 | |
| 计算公式 | 变更后总价=变更后计划总价-原计划剩余价值（计算原则：多不退，少补。若变更后总价小于0时，直接设为=0，否则展示对应应付价格，保留两位小数。 | |
| 变更后总价=变更后计划总价-原计划总价*(剩余天数/周期天数) | 变更后总价=变更后计划总价-当前购买人数*当前人员单价*(剩余天数/周期天数) | |
| 示例 | 同类型变更： • 如：先订购了一年「年付」计划（20 人，单价：100 人/年），使用了 100 天后，周期变更为「一次性买断」计划（4000 元） • 变更后总价= 4000-20*100*(265/365）=2547.95 | 同类型变更： • 如：先订购了一年「年付」计划（200 元/年），使用了 100 天后，周期变更为「一次性买断」计划（1000 元）。 • 变更后总价= 1000-200*(265/365）=854.79 |
| 前提：【按使用人数订购】「年付」阶梯价格 10 人起购，120 人/年。 20 人起购，100 人/年。 30 人起购，90 人/年。 原计划为【按使用人数订购】，先进行人数增购，再变更为【全组织可用】。 • 如：先订购了【按使用人数订购】周期为「年付」计划，订购人数为 20 人（计划总价=20*100=2000） • 使用了 100 天后，增购 10 人（增购总价=10*120=1200） • 又使用了 100 天后，想变更为【全组织可用】周期为「一次性买断」计划（总价=4000 元） • 变更后总价=4000-30*90*(165/365）=2779.45205 | ||
| 特殊说明 | 已经下架的商品，不允许操作变更计划。不允许从【全组织可用】变更为【按使用人数订阅】类型 | |
续订
| 按使用人数订阅 | 全组织可用 | |
|---|---|---|
| 描述 | 用户对生效中付费计划进行续订，按计划最新的价格计算。 | |
| 公式 | 总价=当前订购总人数*人数对应的单价 | 总价=当前计划最新的价格 |
| 规则 | 只能对当前生效中的计划进行续订，不能续订其他计划。 日期： • 若存在生效中的计划，则直接在上一个订购计划截止日期往后延续 • 若不存在生效中的计划，则从续订支付完成日期开始生效 | |
| 特殊说明 | 为保障已购商品的的正常使用，在市场已下架的商品，用户仍可以对原计划进行续订，依据计划配置价格来计算总价 | |
人数增购
| 属性 | 按使用人数订阅 |
|---|---|
| 描述 | 收取剩余周期内，增购人数需要补充的差价。剩余天数包含当天，按天计算（保留两位小数） |
| 规则 | 为商品选择合适的分类，最少1个，最多3个 |
| 公式 | 增购总价=增购人数*增购人数对应的单价*（剩余天数/计划周期天数） |
| 示例 | 原计划为100 元/人/年，使用5 天后想再增购 10 人，增购 10 人单价为 80元/人/年 增购总价= 1080（360/365）=986.30（保留两位小数） |
| 特殊说明 | 为保障已购商品的的正常使用，在市场已下架的商品，用户仍可以对原计划进行增购，依据计划配置价格来计算总价 |
资源消耗/增补
购买后使用产生的资源消耗需由购买组织承担（工作流消耗、附件上传量、短信等），部分资源增补项目开发者可经由 开发者激励计划 获取一定比例的收益。
| 购买应用是否依赖组织版本限制 | 是否允许增补 | ||
|---|---|---|---|
| 免费组织 | 付费组织 | ||
| 工作表总数 | 不占用组织工作表总数 | ❌ | ❌ |
| 单工作表最大行 | 依赖 | ❌ | ❌ |
| 工作表行记录总数 | 依赖 | ❌ | ❌ |
| 用户扩充包 | 依赖 | ❌ | ✅ |
| 工作流执行数升级包 | 依赖 | ❌ | ✅ |
| 工作流执行数单月包 | 依赖 | ✅ | ✅ |
| 数据同步算力升级包 | 依赖 | ❌ | ✅ |
| 数据同步算力单月包 | 依赖 | ✅ | ✅ |
| 应用附件上传量扩充包 | 依赖 | ✅ | ✅ |
| 聚合表扩充包 | 依赖 | ❌ | ✅ |
| 外部用户扩充包 | 依赖 | ❌ | ✅ |
高级功能与扩展
在未来的迭代中，我们将支持API和插件的独立售卖。此外，后续我们还会支持应用与API、插件之间的联合售卖策略。允许开发者将这两种产品捆绑销售，以提供更完整的解决方案。还可以通过在应用中使用其他开发者售卖的商品（插件、API）作为依赖项，联合售卖获得推广佣金。
应用审核标准及规范
为保证明道云市场的规范、有序、安全运营，特制定本规范，适用于所有入驻明道云的开发者
合法合规性
遵守法律法规：开发者必须遵守宪法、法律和行政法规，上架商品不得用于从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等活动。
内容责任：开发者应对信息内容负责，不得生产传播违法信息。
原创性
应用原创：开发者需保证应用原创性，不得抄袭、照搬他人应用。
非官方模板：不能将HAP官方已经免费提供的模板应用，作为个人应用上传。
应用质量
市场决定：商品的优劣更多是由市场来决定，平台不会对商品本身做过多的评判。
界面与操作：应用界面应美观，操作易用。
逻辑与测试：应用逻辑应严谨，上架前应充分测试。
使用说明：应提供完整的使用说明，降低上手难度，帮助用户快捷体验到产品价值。
商品信息填写规范与指南
格式规范
统一格式：建议利用标题字号来区分层级即可，避免使用特殊颜色和字体。这样可以在保证文档编排合理的同时，避免视觉上的杂乱无章。
内容排版：注意排版美观，保证有恰当的行距，便于阅读，内容编排合理、有逻辑性。
图表绘制建议：我们应遵循简约原则，颜色搭配建议不超过两种以保持视觉清晰。同时，避免使用夸张的图片/字体，以确保专业性和信息传达的准确性。
详情页包装指南
商品内容与卖点
内容：包装商品特点、亮点和细节，突出专业度和商品质量。
注意：图文并茂，内容组织条理清晰，细节圈注，视觉引导。
目的：让用户快速了解商品内容和提供的价值。
能力/实力展示
内容：展示专业度，包括行业地位、案例、实力、资质、获奖等。
注意：简明扼要，100字以内，围绕用户选择理由。
目的：让用户明确这个商品是一个非常靠谱的选择。
售后保障
内容：详细描述保障周期、内容和范围。
注意：包含售后服务及安全保障说明，建议通过公开表单的方式，为商品配置专属反馈链接，便于统一收集需求及反馈。
目的：为用户消除顾虑，树立消费信心。
常见Q&A
内容：解答用户下单前的常见问题，内容真实。
注意：问题不宜过多，3个问题以内，围绕下单前咨询，消除顾虑。
目的：解决用户常见问题，降低沟通成本，促成下单。
商品名称、描述、Logo审核规范
商品名称和描述应当正确反映应用的内容，不得夸大和扭曲，也不能含糊和过于概括地介绍应用。
不得含有“试用”、“测试”等相关字段。
不得重复堆砌关键词。
Logo需与应用有一定的关联性。
Logo应尽量避免图片变形，显示异常等情况。
商品详情页审核规范
应当包含包含商品功能简介、使用场景、包括商品页面展示效果。
应当包含应用适用行业及标杆用户，可提供商家使用效果。
应当包含售后服务及安全保障专属客服人员联系方式。
请注意排版美观，保证有恰当的行距；便于阅读，内容编排合理、有逻辑性。
避免图片变形，显示异常等情况。
参考：详情页包装指南
使用说明编写规范
应当包含应用包含安装使用教程、使用方法，建议以图片或视频的形式展现。
应当标明售后联系方式、工作时间及售后处理流程。
建议通过公开表单的方式，为商品配置专属反馈链接，便于统一收集需求及反馈
需遵循上述规范：格式规范
定价规范
满足市场定价范围的要求，参考：配置订购计划
请按实际情况填写，并在商品介绍中说明具体收费方案，一旦有用户举报商品虚报价格或无法提供服务并被明道云市场核查属实，明道云市场将对该应用做强制下架处理。
审核时效
提交审核后 1～3 个工作日，若逾期未审核可联系市场官方邮箱 marketplace@mingdao.com，或进入明道云社区进行咨询，也可以联系在线客服或专属顾问。
规范的发布与更新
明道云平台市场在必要时修订本规范，且无需另行通知开发者，新的规范一旦公开即有效替代原来的规范，并对明道云用户、市场开发者产生约束力。
应用推广与营销
分享商品海报
目前可通过分享商品海报进行传播推广，扫描海报二维码即可查看商品信息。
商品详情页-分享海报/链接
下载海报示例样式
推广营销工具与扩展
在未来的迭代中，我们将支持API和插件的独立售卖。此外，后续我们还会支持应用与API、插件之间的联合售卖策略。允许开发者将这两种产品捆绑销售，以提供更完整的解决方案。还可以通过在应用中使用其他开发者售卖的商品（插件、API）作为依赖项，联合售卖获得推广佣金。
未来，我们计划推出一系列创新的营销推广工具，旨在进一步扩大市场影响力，提升销售效能。
销售与收益管理
趋势分析
在开发者后台-首页展示商品趋势分析，可以根据这些关键数据对商品进行精准优化。
查看销售数据
在开发者后台-订单列表页，查看销售订单数据
在开发者后台-财务-交易页面，查看订单收益明细，支持导出交易流水，包括订单对应的收益。
收益提现规则
开发者对已结算金额操作提现，每月只能申请一次，最低可提现金额为 100，低于 100 不支持提现。
| 开发者类型 | 说明 |
|---|---|
| 个人 | • 支付宝账号：个人支付宝账号需与认证身份证保持一致 • 提现金额：最低 100，最高为当前可提现金额，小数点后两位 • 提现实际到账金额：提现金额-扣税金额 • 个人开发者平台代扣代缴个人所得税，扣缴规则按照国家规定的个人所得税扣缴规则;自己可到个人所得税 app 查看申报明细 • 个人所得税率参考相关政策 |
| 企业 | • 银行账户信息：需绑定企业对公银行账户信息 • 提现金额：最低 100，最高为当前可提现金额，小数点后两位 • 上传发票：电子发票，对应的提现金额的发票。平台验证通过后才可会执行打款申请，发票金额需要与提现金额一致，发票抬头:上海万企明道软件有限公司;明细:服务费。 |
订单退款与结算
| 开发者类型 | 说明 |
|---|---|
| 退款 | 应用商品： • 新购订单金额小于 5000 的订单，允许 14 天内无条件退款 • 订单金额大于等于 5000 的订单，允许免费试用，平台不提供退款功能，需与开发者自行协商。 应用模板： • 应用模板购买后不允许退单 |
| 结算 | 订单支付完成后，14 天内未产生退款，将自动确认。订单确认后将给开发者结算对应比例分成 |
| 提现 | 开发者对已结算金额操作提现。提现规则：每月只能申请一次，最低可提现金额为 100，低于 100 不支持提现； |
注销账户
若开发者注销账户，平台将下架其所有商品，且清空开发者所有信息。为保证已购用户正常的续订和增购，开发商所有商品拥有权限全归属于明道云官方市场账号，商品处于下架状态且明道云不能操作更新和上架。后续商品续订/增购订单产生的收益归明道云所有
开发者激励计划
未来，通过购买你开发的应用转化为明道云 HAP 付费客户的用户，明道云会给予你一定比例的奖励。通过使用你开发的应用在 HAP 上产生的额外的消费，明道云也会给予你一定比例的奖励。