{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"29ece2a4-1301-4680-b07c-103c48068315"},"schemaVersion":{"value":"1"},"title":"目录"}},"localId":"4d1c041b-12ce-4ca0-a7af-47bceeb5d23e"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"一、需求描述","type":"text"}]},{"type":"paragraph","content":[{"text":"去中心化公司治理协作平台。类似Web2的钉钉和飞书。功能包括：","type":"text"}]},{"type":"paragraph","content":[{"text":"沟通管理，协作管理，组织管理，制度管理，财务管理，这么多的功能如何满足，","type":"text"}]},{"type":"paragraph","content":[{"text":"我们需要一个可以扩展的系统，通过给DAO安装子应用或者插件来扩充功能。","type":"text"}]},{"type":"paragraph","content":[{"text":"对于新功能通过子应用来扩展，对于已有功能的不同实现通过插件来扩展。","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"二、需求分析","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1、用例图","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":892,"id":"55106e83-1130-4762-a939-6f5d1bdfa785","collection":"contentId-58589353","type":"file","height":818}}]},{"type":"paragraph","content":[{"text":"对于DAO按功能分，包括：财务管理、成员管理、插件管理、模块升级管理","type":"text"}]},{"type":"paragraph","content":[{"text":"和配置管理等。","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2、能力树","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":815,"id":"69f1fee6-f9ea-46f2-9f48-97b38ffe9d75","collection":"contentId-58589353","type":"file","height":663}}]},{"type":"paragraph","content":[{"text":"starcoin中权限控制通过能力来实现，能力可用派生子能力，子能力也可以派生子子能力，这样就形成能力树。通过能力树实现权力的下放。","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"三、概要设计","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"1、架构图","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":669,"id":"935d097c-12a9-4caa-bcc5-dcde6f53f5fe","collection":"contentId-58589353","type":"file","height":786}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"DAOSpace内部有插件的注册表，任何用户都可以开发插件，注册到DAOSpace, 。","type":"text"}]},{"type":"paragraph","content":[{"text":"应用插件前端采用微前端架构，主应用从DAO合约中读取该合约安装的应用插件和其他插件，完成主应用的初始化，包括应用插件的注册，路由绑定等。当用户切换浏览器地址时，微前端框架根据注册的路由启动对应的应用插件。应用插件通过应用插件合约接口完成业务功能。","type":"text"}]},{"type":"paragraph","content":[{"text":"应用插件是对DAO功能的扩展，类似钉钉和飞书的应用，有自己的界面，可以完成1到多个独立的功能。","type":"text"}]},{"type":"paragraph","content":[{"text":"应用插件也可以暴露1到多个扩展点，供其他插件来扩展。","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"2、领域类图","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":872,"id":"dc41caf0-5f11-49a3-a743-bba818c918e1","collection":"contentId-58589353","type":"file","height":658}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"1个插件实现1到n个扩展点，1个扩展点可以被多个插件实现","type":"text"}]},{"type":"paragraph","content":[{"text":"1个插件使用0到n个扩展点，1个扩展点可以被多个插件使用","type":"text"}]},{"type":"paragraph","content":[{"text":"1个插件定义0到n个扩展点，1个扩展点只能被0到1个插件定义","type":"text"}]},{"type":"paragraph","content":[{"text":"1个插件有0到n个版本","type":"text"}]},{"type":"paragraph","content":[{"text":"用户可以对AppVersion和PluginVersion进行Star和评论","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"3、应用扩展点","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"扩展点名称：0x1::DAOSpace::App","type":"text"}]},{"type":"paragraph","content":[{"text":"扩展点接口定义：","type":"text"}]},{"type":"codeBlock","content":[{"text":"import React from 'react';\n\nexport interface IApp {\n name: string,\n activeWhen: string,\n entry: React.ReactNode\n}\n\nexport interface IDAO {\n registerApp(app: IApp)\n}","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"扩展点接口通过TypeScript Declaration files定义，实现应用扩展点的插件为应用插件，主要用于扩展DAOSpace功能。","type":"text"}]},{"type":"paragraph","content":[{"text":"插件运行在浏览器的VM中。","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"注意：","type":"text","marks":[{"type":"textColor","attrs":{"color":"#bf2600"}}]}]},{"type":"paragraph","content":[{"text":"由于Move不支持合约动态调用合约代码，所以扩展点定义的接口都是通过JS实现。所有动态调用需求都由前端中转。","type":"text","marks":[{"type":"textColor","attrs":{"color":"#bf2600"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"四、详细设计","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"1、扩展点管理","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1.1 扩展点资源定义","type":"text"}]},{"type":"codeBlock","attrs":{"language":"rust"},"content":[{"text":"module ExtensionPoint {\n struct ExtensionPoint has key {\n id: u64, //扩展点的ID，按注册顺序自增\n name: vector, //名字，例如 DAOSpace.IApp/v1\n describe: vector, //描述\n protobuf: vector, //扩展点接口定义，通过protobuf定义\n created_at: u64, //创建时间\n }\n\n struct ExtensionPointRegistry has key{\n next_id: u64,\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"1.2 扩展点合约接口","type":"text"}]},{"type":"codeBlock","content":[{"text":"module ExtensionPoint {\n // 初始化 Registry\n public(script) fun init()\n \n // 注册扩展点\n public(script) fun registerExtensionPoint(name: vector, describe: vector, protobuf:vector): u64;\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1.3 扩展点前端功能","type":"text"}]},{"type":"paragraph","content":[{"text":"1.3.1 分页展示所有扩展点","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"列表：","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":789,"id":"5d292fcc-29df-4c8c-98b4-7ee9171c06bf","collection":"contentId-58589353","type":"file","height":591}}]},{"type":"paragraph","content":[{"text":"详情：","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":791,"id":"0b8bd41c-cd79-4c26-b244-7a466fe42a8e","collection":"contentId-58589353","type":"file","height":583}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"1.3.2 创建新的扩展点","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":796,"id":"21fefed1-a3fe-4603-aa76-3c626effcd71","collection":"contentId-58589353","type":"file","height":598}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"2、插件市场","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.1 插件市场资源定义","type":"text"}]},{"type":"codeBlock","content":[{"text":"module PluginMarketplace {\n struct PluginRegistry has key{\n next_plugin_id: u64,\n }\n \n struct PluginVersion has key{\n number: u64, // 数字版本号，例如1，2，3\n version: vector, //插件版本号，例如v0.1.1\n required_caps: vector>, //依赖的能力\n export_caps: vector>, //导出的能力\n implement_extpoints: vector>, //实现的扩展点\n depend_extpoints: vector>, //依赖的扩展点\n contract_module: vector, // 合约模块, 格式：${address}::${module}\n js_entry_uri: vector, // 前端JS代码资源URI，例如：\"https://cdn.xxxx.xxxx/xxxx/xxxxx.js\"\n }\n \n struct Star has key{\n addr: address, // Star人的钱包地址，可以是短地址，例如 zhangsan.stc\n created_at: u64, //创建时间\n }\n \n struct Comment has key{\n addr: address, // 评论人的钱包地址，可以是短地址，例如 zhangsan.stc\n content: vector //评论内容\n created_at: u64, //创建时间\n }\n \n struct PluginInfo has key{\n id: u64, //插件ID\n name: vector, //插件名称\n describe: vector, //插件描述\n next_version_number: u64, //下一个版本号\n versions: vector, //插件的所有版本\n stars: vector,// 插件的所有star\n comments: vector, // 插件的所有评论\n git_repo: vector, // git仓库代码\n created_at: u64, //插件创建时间\n update_at: u64, //插件最后一次更新时间\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.2 插件市场合约接口","type":"text"}]},{"type":"codeBlock","content":[{"text":"module PluginMarketplace {\n // 初始化 Registry\n public(script) fun init()\n \n // 注册插件，获取插件ID和所有权\n public(script) fun register_plugin(sender: signer, plugin_name: vector): u64 acquires PluginRegistry\n \n // 发布插件版本\n public(script) fun publish_plugin(sender: signer, plugin_id: u64, version: PluginVersion): u64 acquires PluginRegistry\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.3 插件的配置文件","type":"text"}]},{"type":"paragraph","content":[{"text":"dao_plugin.json 为插件的配置文件：","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"id\": 1, // 在DAOSpace注册的插件ID\n \"name\": \"hello-world\", // 插件名称\n \"version\": \"v0.1.1\" // 插件版本\n \"icon\": \"ipfs://xxxxxxxxx/xxxxxxx.svg\"\n \"implements\": [\n \"0x1::ExtensionPoint::IApp\" // 实现应用接口\n ],\n \"depends\": [\n \"0x1::Starcoin::IToken\" // 依赖Token接口\n ], \n \"required_caps\": [\n \"0x1::DAOSpace::DAOUpgradeModuleCap\", // 需要DAO升级能力\n \"0x1::DAOSpace::DAOMemberCap\" // 需要DAO成员管理能力\n ],\n \"contact\": \"./constract/Move.toml\",\n \"web\": \"./web/package.json\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.4 插件部署Cli","type":"text"}]},{"type":"codeBlock","content":[{"text":"daospace-cli plugin deploy -n ./dao_plugin.json","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"部署逻辑：","type":"text"}]},{"type":"paragraph","content":[{"text":"将插件的合约部署STC链上，","type":"text"}]},{"type":"paragraph","content":[{"text":"将插件打包后的静态资源发布到IPFS或者AR网络，","type":"text"}]},{"type":"paragraph","content":[{"text":"调用","type":"text"},{"text":"publish_plugin_version","type":"text","marks":[{"type":"code"}]},{"text":"合约方法，发布新版本。","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.5 插件的安装与卸载","type":"text"}]},{"type":"paragraph","content":[{"text":"合约端：","type":"text"}]},{"type":"codeBlock","content":[{"text":"module ${PluginName}{\n // 安装插件\n public(script) fun setup(sender: signer, dao: DaoT)\n \n // 卸载插件\n public(script) fun teardown(sender: signer, dao: DaoT)\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"web端：","type":"text"}]},{"type":"codeBlock","content":[{"text":"// 所有前端插件JS加载后的对象，需要暴露下面两个方法\n// 用于完成插件的初始化和卸载。\n// 插件加载后运行在独立的VM中\n// 前端VM技术参考：https://www.garfishjs.org/blog\ninterface IPlugin {\n // 前端插件安装方法\n void setup(depends: ExtensionPoint[])\n \n // 前端插件卸载方法\n void teardown()\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.6 插件市场界面","type":"text"}]},{"type":"paragraph","content":[{"text":"2.5.1 插件市场","type":"text"}]},{"type":"paragraph","content":[{"text":"2.5.2 创建插件","type":"text"}]},{"type":"paragraph","content":[{"text":"2.5.3 上传插件","type":"text"}]},{"type":"paragraph","content":[{"text":"2.5.4 对插件点赞","type":"text"}]},{"type":"paragraph","content":[{"text":"2.5.5 对插件进行评论","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3、应用插件开发","type":"text"}]},{"type":"paragraph","content":[{"text":"1个应用插件就是一个Dapp，包括前端页面和后端合约代码，扩展DAO的一个功能，例如成员管理、Grant管理等。","type":"text"}]},{"type":"paragraph","content":[{"text":"每个DAO可以安装多个应用插件，每个应用插件安装时获取声明的能力，如果DAO中某种能力只有一个实例，那么只有获取对应能力的应用插件才能安装，其他同类型的应用插件由于获取不到需要的能力，所以不能安装。","type":"text"}]},{"type":"paragraph","content":[{"text":"一个应用插件可以将一个能力封装后，提供更多能力和扩展点。这样就可以安装其他插件。","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.1 应用插件的配置","type":"text"}]},{"type":"paragraph","content":[{"text":"所有实现了应用扩展点接口的插件为应用插件。","type":"text"}]},{"type":"paragraph","content":[{"text":"应用插件的 dao_plugin.json 配置：","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"id\": 1, // 在DAOSpace注册的插件ID\n \"name\": \"hello-world\", // 插件名称\n \"version\": \"v0.1.1\" // 插件版本\n \"icon\": \"ipfs://xxxxxxxxx/xxxxxxx.svg\"\n \"implements\": [\n \"0x1::ExtensionPoint::IApp\" // 实现应用扩展点接口\n ],\n \"required_caps\": [\n \"0x1::DAOSpace::DAOUpgradeModuleCap\", // 需要DAO升级能力\n \"0x1::DAOSpace::DAOMemberCap\" // 需要DAO成员管理能力\n ],\n \"contact\": \"./constract/Move.toml\",\n \"web\": \"./web/package.json\"\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.2 应用插件前端开发","type":"text"}]},{"type":"paragraph","content":[{"text":"应用插件的前端部分为一个微前端应用，支持远程加载，微前端框架选用阿里开源的qiankun。","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1126,"id":"e60909f6-aed2-4e94-8173-fcb46978e7b7","collection":"contentId-58589353","type":"file","height":454}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"五、参考资料","type":"text"}]},{"type":"paragraph","content":[{"text":"1、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.youtube.com/watch?v=hi88qOW8_WI"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"2、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.dingtalk.com/"}},{"text":" 《钉钉首页》","type":"text"}]},{"type":"paragraph","content":[{"text":"3、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.feishu.cn/"}},{"text":" 《飞书首页》","type":"text"}]},{"type":"paragraph","content":[{"text":"4、","type":"text"},{"text":"https://blog.csdn.net/blog_jihq/article/details/80669616","type":"text","marks":[{"type":"link","attrs":{"href":"https://blog.csdn.net/blog_jihq/article/details/80669616"}}]},{"text":" 《组件、插件、模块、子应用、库、框架等概念辨析》","type":"text"}]},{"type":"paragraph","content":[{"text":"5、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://juejin.cn/post/7121883538311348238"}},{"text":" 《除了 Qiankun，这些微前端框架或许更适合你「建议收藏」》","type":"text"}]},{"type":"paragraph","content":[{"text":"6、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://qiankun.umijs.org/zh/guide"}},{"text":" 《阿里微前端框架qiankun》","type":"text"}]},{"type":"paragraph","content":[{"text":"7、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://micro-zoe.github.io/micro-app/docs.html#/"}},{"text":" 《京东微前端框架 MicroApp》","type":"text"}]},{"type":"paragraph","content":[{"text":"8、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.garfishjs.org/guide/start/"}},{"text":" 《字节微前端框架 Garfish》","type":"text"}]},{"type":"paragraph","content":[{"text":"9、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.garfishjs.org/blog"}},{"text":" 《微前端架构设计》","type":"text"}]},{"type":"paragraph","content":[{"text":"10、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://mp.weixin.qq.com/s/dbu2yocUqz60kp_eSlMQCA"}},{"text":" 《DeFi应用架构设计之道》","type":"text"}]},{"type":"paragraph","content":[{"text":"11、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://starcoin.org/zh/developer/how_to_dapp/how_to_dapp/"}},{"text":" 《Dapp开发指南》","type":"text"}]},{"type":"paragraph","content":[{"text":"12、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.npmjs.com/package/protobufjs"}},{"text":" 《protobuf JS库》","type":"text"}]},{"type":"paragraph","content":[{"text":"13、","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.zhihu.com/question/20628768"}},{"text":" ","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

浏览器不受支持