add opendb initData

docs/uniCloud/opendb.md

@@ -4,12 +4,12 @@
 
 `openDB`，是一套开放的数据表设计规范，包括了表名、字段等schema定义以及初始数据。
 
-以用户表为例，它约定了一个标准用户表的表名和字段定义，并且基于nosql的特性，可以由开发者自行扩展字段。
+以用户表为例，它约定了一个标准用户表的表名和字段定义，并且基于`nosql`的特性，可以由开发者自行扩展字段。
 
 `openDB`是[uniCloud](https://uniapp.dcloud.io/uniCloud/)的重要软基建，支撑uniCloud数字生态的发展。
 
 ## 需求背景
-- 很多js工程师不善于数据库设计，希望有成熟的数据库模板，避免走弯路
+- 传统开发中，数据库设计是 `php/java`等后端工程师的工作范畴；而大多前端工程师并不熟悉数据库设计，在使用 `uniCloud`开发项目时，很多前端工程师希望有成熟的数据库模板，避免走弯路
 - 有利于产业分工。业务开发、统计分析、智能推荐、数据转换等都是不同的专业角色，大多数开发者仅善于业务开发，需要专业的数据服务商为其提供服务，如果数据库标准统一，各个角色就可以在插件市场各自提供插件。
   * 比如有专业数据服务商，基于openDB中电商规范，提供“猜你喜欢”插件，就可以被轻松的引入到开发者的应用中；
   * 比如有专业的数据导入导出插件，可以方便的从ecshop等系统中迁移历史数据；
@@ -22,17 +22,32 @@
 [uni-id](https://uniapp.dcloud.io/uniCloud/uni-id)的账户统一，是`openDB`的成功实践。基于uni-id规范，有电商插件、有IM插件、有PC管理插件，开发者可以方便的把这些插件整合到自己的同一应用中。
 
 
-## openDB中的已有规范：
+## openDB中的已有规范
 
 目前`openDB`已经支持几十张表。可以在[https://gitee.com/dcloud/opendb/tree/master/collection](https://gitee.com/dcloud/opendb/tree/master/collection)查看。
 
-部分常用表单独提供文档如下：
+部分常用表分类如下：
+
+1. 用户管理（uni-id）：用户相关的表定义，如：角色、权限、积分、任务等
+2. 日志管理（opendb-admin）：管理后台常见功能，应用管理、升级中心、统计结果（新增、活跃、留存等）
+3. 文章&评论（opendb-news)
+4. 电商系统（opendb-mall)
+5. 新闻系统（opendb-news)
+
+## 预置数据
+
+`openDB`不仅支持定义常用的数据表字段，还可以预置初始化数据。
+
+比如，[opendb-city-china](https://gitee.com/dcloud/opendb/tree/master/collection/opendb-city-china)是opendb中定义好的`中国城市字典表`，它的定义分为两个部分：
+- collection.json：定义数据表名称、所含字段、每个字段的类型以及读写权限规则等；
+- data.json：定义初始化内容
+
+你通过[uniCloud web控制台](https://unicloud.dcloud.net.cn)创建`openDB`表时，`uniCloud`会自动校验该opendb表定义中是否包含`data.json`，若包含，则在创建表定义后，自动导入`data.json`。
+
+如果你的 HBuilderX 项目中，`uniCloud/database`目录下定义的数据表中含有opendb表定义，则对该opendb表执行`上传DB Schema`操作时，uniCloud服务端会判断该opendb表是否已存在：
+- 若该opendb表已存在，则仅更新 `DB Schema`；
+- 若该opendb表不存在，则先创建该表，然后校验该opendb表定义中是否包含`data.json`，若包含`data.json`，则自动导入`data.json`
 
-1. [用户管理（uni-id）](uni-id.md)
-2. [文章&评论（opendb-news）](opendb-news.md)
-3. [电商系统（opendb-mall）](opendb-mall.md)
-4. [新闻系统（opendb-news）](opendb-news.md)
-5. [日志管理（opendb-log）](opendb-log.md)
 
 ## 如何引入到自己的服务空间