# cloudbadge

**Repository Path**: husuw/cloudbadge

## Basic Information

- **Project Name**: cloudbadge
- **Description**: 云徽章
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-28
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## ![][image1]

![][image2]

# 云徽章服务系统第2版：品牌升级白皮书 (V2.1) 2026年3月24日

**─**

# **概述**

深耕于“数字凭证与人才评价”领域的垂直 SaaS（Vertical SaaS）解决方案 。

微信云开发（Serverless）+ AI大模型辅助编程 \+ JSON配置驱动UI

# **战略定位**

1. 领域特定的低代码配置能力

   深度封装具有行业特性的配置工具。例如，系统提供可视化的“徽章设计器”，允许非技术背景的运营人员通过上传品牌 Logo、选择预置的金属或水晶质感模板来生成前端展示资产 。更为核心的是，系统预置了行业通用的“能力维度库”（涵盖 K12 艺术类、STEM 编程类、体育竞技类等），机构不仅可以直接调用这些模板，还能通过灵活的维度配置界面，自定义雷达图的评估维度，实现“标准化与个性化并存”的配置策略 。这种产品形态确保了系统既拥有垂直行业的高溢价和专业壁垒，又具备满足多租户碎片化需求的平台化连接能力 。

2. 预置标准功能

   垂直 SaaS 的核心竞争力在于其内置的行业 Know-how 与标准化业务闭环。云徽章系统通过预置严谨的“发行-领取-存储-展示-验证”生命周期管理，以及深度集成的“能力图谱”算法，直接解决了传统证书防伪成本高、信息不互通、缺乏诊断价值等行业痛点 。

3. [AI](http://3.AI)驱动的微观执行力拆解

   传统的数字徽章系统仅仅提供一个最终的静态凭证，而忽视了学习者在达成目标过程中面临的执行功能障碍与心理畏难情绪。系统通过封装大语言模型（如 DeepSeek-R1 的推理能力），构建“智能拆解仪式” 。当用户设定了一个宏大的认证目标（如获取高级数据分析师徽章）时，系统利用 预先配置的系统提示词（System Prompt）与徽章获取标准结合，引导 AI 将复杂任务动态拆解为若干个耗时极短的“原子化微任务” 。这种基于“认知卸载”心理学机制的设计，有效降低了任务的静止摩擦力。更进一步，利用标准数据模型的扩展能力，系统在 Assertion 结构的 JSON-LD 中，通过 extensions:PlanCoach 字段，持久化存储了 AI 教练的人格设定、用户的微任务完成记录以及时间热力图数据 。这使得徽章不再仅仅是一张图片，而是包含了真实汗水与坚韧品质的立体数据档案。

4. 宏观社会化协作与共识账本

   学习过程的孤独感是导致中途放弃的核心因素。系统借鉴比乐时的“家庭协作”理念，将其泛化为认证过程中的“成长小队”网络 。在这一模式下，系统基于对分布式状态的一致性管理能力，构建了实时的状态共享账本。当小队中的某一位成员完成了特定的原子任务时，平台会利用数据库的原子操作（如避免并发更新冲突的乐观锁与 inc 累加机制），即时更新该成员的进度，并通过长连接向团队内的其他成员推送毫秒级的通知与触觉反馈 。伴随着代币经济学（如系统内流通的虚拟“星币”机制）的引入，成员之间的相互点赞、赠送情感贺卡等社会化认可被量化为真实的激励资产。这种设计将单一的数字认证过程转化为一个高频互动、充满情绪价值的多人协作空间，极大地提升了系统的活跃度与留存率 。

# **基座选型理由**

采用微信云开发（Tencent Cloud Base, TCB）作为基础设施，是实现“零运维”与敏捷开发的必然战略选择 。这种Serverless架构能够将底层计算资源与存储资源的调度过程完全抽象，使开发者的系统构建专注力得以全面收敛至业务逻辑本身。

云开发环境自带微信生态内天然的实名信任体系，开发者在Node.js云函数（Cloud Functions）执行上下文中，只需调用 cloud.getWXContext() 方法，即可在无需用户显式授权登录页面的情况下，安全、无感地获取当前操作用户的 OPENID 与 UNIONID 。

以OpenID作为数字徽章接收者的唯一不可篡改标识，系统不仅能够在其网关层自动阻挡非法的越权访问请求，还能确保在生成数字徽章记录与动态能力图谱时，数据资产的归属权得到底层生态级别的安全保障。

面对机构端可能上传的各类非标图文资产，微信云开发平台内置了 security.msgSecCheck 和 security.imgSecCheck 接口，系统能够以极简的代码调用实现符合国家法规的自动化内容安全审核，满足SaaS平台合规性要求 。

云徽章系统的底层数据规范被设定为严格遵循国际通用的Open Badges 3.0标准。该标准的核心不仅在于基础颁发记录的留存，更在于通过极度丰富的元数据（Metadata）来定义凭证的深度特征与证据溯源能力 。在Open Badges 3.0规范体系中，核心实体如徽章元数据模板（BadgeClass）和颁发断言记录（Assertion）往往包含大量复杂的嵌套对象与数组结构，例如多维度的能力对齐标准（Alignment）和验证证据链（Evidence）。微信云开发（TCB）提供的文档型NoSQL数据库天然兼容JSON结构，这与Open Badges 3.0基于JSON-LD（JavaScript Object Notation for Linked Data）的数据标准形成了架构层面的完美契合 。开发者可以将一个包含复杂数组的完整Assertion实体，直接作为一个独立的Document原封不动地存储在集合（Collection）中，彻底消除了对象关系映射（ORM）框架的转换损耗与维护成本。

依托TCB内建的基础设施能力，实现一套高可用、抗压的高并发业务流转中枢。

# **如何用**

确立了直接采用 Nop 平台的技术路线后，系统的核心业务逻辑将不再通过生硬的命令式代码堆砌，而是通过 Nop 平台内置的四大核心引擎，以模型驱动（Model-Driven）的方式进行优雅的声明式编排 。

## 基于Open Badges 3.0规范的语义化构建

Open Badges 3.0规范是目前数字凭证领域最权威的架构协议，其核心特征是将Open Badges与W3C的 Verifiable Credentials (可验证凭证) Data Model v2.0 规范进行了深度对齐 。

### **Open Badges 3.0核心实体解析与NoSQL映射**

该规范明确区分了不同的业务实体，以确保数据语义的准确性与跨平台互操作性。

| 核心实体名称 | 规范定义与作用 | TCB NoSQL数据库映射策略 | 业务逻辑体现 |
| :---- | :---- | :---- | :---- |
| **Issuer (发行者档案)** | 描述颁发徽章的实体机构（Profile），包含名称、网址、联系方式及用于数字签名的公钥引用 。 | 作为 issuers 集合独立存储。 | 确保证书溯源的权威性，并在验证页展示机构官方认证绿标 。 |
| **BadgeClass (成就类/模板)** | 描述一项具体成就的元数据模板，定义了该徽章代表的技能内容、视觉图像及评价标准（Criteria）。 | 作为 badge\_classes 集合独立存储，便于多机构复用通用标准。 | SaaS后台的“能力维度库”即是对该模板的行业化预置封装 。 |
| **Assertion / AchievementCredential (颁发断言)** | 核心的凭证记录，声明特定的接收者（CredentialSubject）已经达成了特定 BadgeClass 的标准，并附带时间戳与验证数据 。 | 作为 assertions 集合存储，每条记录携带指向Issuer与BadgeClass的外键引用及嵌套数据。 | 用户数字背包中展示的每一枚独立徽章，即对应数据库中的一条Assertion记录 。 |

在Open Badges 3.0规范中，为了保证凭证的公信力与学术价值，往往需要在Assertion中嵌入复杂的证明材料。例如 Alignment（对齐标准）允许徽章通过URL明确指向外部的教育大纲或能力框架规范；而 Evidence（证据）则允许包含学习者提交的项目代码仓库链接、参赛作品原图或比赛现场的评审记录视频等 。在MVP阶段的NoSQL数据库设计中，可以直接利用JSON文档的嵌套特性来存储这些结构。更为关键的是，为了承载项目的核心亮点——“能力图谱”与“AI驱动的微观执行力拆解”，系统利用了JSON-LD规范中的扩展机制。通过在Assertion文档中预留自定义的扩展节点（如 extensions:PlanCoach ），系统实现了对AI教练的人格设定、用户的原子化微任务完成时间热力图以及各维度能力具体分值（雷达图数据源）的持久化存储 。

智能开发协同

无需花费数周时间去通读数百页晦涩的Open Badges 3.0与W3C JSON-LD技术规范白皮书 ，而是可以通过精准的提示词工程（Prompt Engineering），利用AI强大的知识压缩与代码生成能力，直接输出符合标准的TypeScript接口定义 。

开发者可以向AI输入高度结构化的指令：“请扮演精通W3C Verifiable Credentials与Open Badges 3.0规范的架构师。请使用TypeScript为微信小程序项目生成标准的数字徽章数据接口。要求：1. 包含 BadgeClass 接口，涵盖名称、描述、图像及 AlignmentObject 数组；2. 包含 Assertion（AchievementCredential）接口，涵盖颁发时间、接收者标识及 Evidence 证据链数组；3. 必须在Assertion中定义名为 ability\_model 的扩展类型，用于存放包含 name, max, score 维度的雷达图数据结构。”

AI引擎将瞬间输出带有严谨泛型与嵌套层级的TypeScript声明文件 。这种由大模型辅助生成的强类型定义机制，将贯穿于整个小程序前端与云函数之间的数据通信生命周期中，从根本上在编译阶段就拦截了因字段拼写错误、类型隐式转换失败而导致的低级系统Bug，为MVP系统注入了极强的数据鲁棒性。

基于MobX的状态管理与能力聚合算法构建

云徽章系统的核心技术难点与业务灵魂在于“能力图谱”的动态生成——系统需要将用户在不同时期、从不同赛事机构获取的数十乃至上百条零散、碎片的徽章断言（Assertion）数据，进行实时的逻辑聚合，并换算为直观的多维能力雷达图 。  
引入行业标准的MobX状态管理架构（通过集成 mobx-miniprogram 与 mobx-miniprogram-bindings 绑定辅助库）是解决这一性能瓶颈的最佳实践 。MobX的核心理念是通过透明的函数响应式编程（Functional Reactive Programming），使得一切依赖于应用状态的数据衍生（Derivations）都能够被自动且以最优路径推导出来 。

开发者可以将核心聚合算法的设计委托给AI工具：“请基于 mobx-miniprogram 为我编写一段状态聚合逻辑。要求：在Store中维护一个包含用户所有已获徽章数据的 assertions Observable数组。请利用 computed 计算属性，自动遍历这些徽章结构扩展字段中的 ability\_model 数据。算法需将名称相同的能力维度（例如多次出现的‘编程逻辑’、‘创新能力’）的 score 进行加权平均聚合，最终返回一个专供 echarts-for-weixin 组件渲染所需的特定雷达图数据结构 { indicator: \[...\], seriesData: \[...\] }。”

AI生成的计算属性（Computed Properties）逻辑在MobX体系中充当着至关重要的缓存检查点（Caching Points）角色 。当底层微信云数据库中的徽章数据发生增减并实时同步推送至前端Store时，MobX底层的依赖追踪树（Dependency Tree）会精确评估变化 。只有当聚合后的雷达图顶点数值发生实质性改变时，MobX才会触发UI渲染层的重绘，从而彻底阻断了脆弱的JavaScript循环对小程序主线程计算资源的无效消耗 。

C端的极致打磨

通过直接操作微信云开发的Web版可视化数据控制台，开发者可以使用云开发提供的高级脚本工具，或者直接利用JSON导入导出机制，手动在云端数据库中建立对应赛事的 BadgeClass 元数据记录，并录入获奖用户的 Assertion 实体 。这种看似极其原始与“简陋”的B端业务替代方案，剥离了非核心代码的编写，能够为独立开发者节省出长达数周宝贵的开发时间，使其迅速进入市场检验阶段。

C端小程序作为整个云徽章系统流量的入口与承接载体，其UI/UX界面设计的核心心理学逻辑在于极致强化用户的“数字资产收藏欲”与“心理荣誉感” 。在界面的底层框架搭建上，开发者可以直接引入微信官方维护的WeUI基础组件库，利用规范的网格系统（Grid）或高保真卡片（Card）布局模式搭建出用户的专属“数字徽章背包”。

UI渲染需采用高度拟物化（Skeuomorphism）的设计原则，通过阴影、高光与渐变技术模拟出真实的金属光泽、珐琅质感或水晶厚度。同时，点击交互需伴随细腻的3D翻转动画，以还原真实物理徽章在指尖把玩时的触感与视觉反馈。尤为重要的是，当系统检测到用户首次点击并领取一枚由B端机构新颁发的高级别徽章时，前端必须强制引入全屏级别的强阻断开箱动画（例如利用Canvas绘制的Confetti漫天纸屑、粒子光效聚合或是徽章从暗影中浮现的特效）。这种在工程视角看似与核心数据流转毫无关联的“仪式感”渲染，恰恰是SaaS产品在情感层面牢牢吸附用户、推高获得时刻峰值体验（Peak Experience）的杀手锏 。

当用户完成极具仪式感的开箱流程，进入这枚徽章的专属详情页后，系统向其呈现的将不再是一张死板静态的传统电子证书图片，而是由 echarts-for-weixin 开源组件引擎实时渲染而成的动态“能力图谱”多维雷达图 。

| 数据呈现维度 | 传统PDF/纸质证书业务特征 | 云徽章能力图谱（ECharts）业务特征 | SaaS产品的商业溢价锚点 |
| :---- | :---- | :---- | :---- |
| **底层信息密度** | 极度匮乏（仅包含固定的姓名与宽泛的奖项等级声明） | 极度高密（包揽3-6个细分维度的具体量化分值、权威机构定性评语与时间序列成长轨迹） | 为C端学习者提供深度的学习诊断价值；为B端发证机构树立无可替代的专业测评壁垒。 |
| **视觉交互体验** | 毫无交互的死寂静态图像文件 | 依托ECharts引擎进行原生层面的动态计算与渲染，具备入场加载动画与触控数据点高亮提示机制 | 赋予死板数据以真实的“鲜活感”，深度强化用户在自我能力认知过程中的心流沉浸感。 |
| **纵向数据演进** | 孤立存在于不同文件夹中，无法形成有效的数据联动与趋势追踪 | 依托底层MobX引擎实时聚合用户全生命周期的关联能力数据，动态生成综合能力叠加雷达图或成长趋势折线图（Stacking） | 直观展示用户的长期技能积累路径，极大刺激并维持用户的持续竞争心理与终身学习动力。 |

在将庞大复杂的 echarts-for-weixin 组件深度嵌入微信小程序原生架构的实施过程中，存在两个不容忽视的技术优化挑战。其一，为防止在部分图形接口存在缺陷的较旧型号iOS设备上出现不可预期的渲染崩溃甚至黑屏现象，必须在ECharts组件的初始化配置项中显式开启 forceUseOldCanvas 兼容性回退选项 。其二，若用户的数字背包中已积累数十枚徽章，而在长列表滚动页面中对所有图表进行并发初始化渲染，将直接导致小程序WebView内核的内存溢出与极为严重的页面滑动卡顿。因此，开发者必须实施严格的“懒加载（Lazy Load）”策略边界：系统应当且仅当用户明确发生点击行为并跳转进入某一具体徽章的独立详情路由页面时，才去触发ECharts实例的挂载、复杂高维能力矩阵数据的计算聚合以及最终Canvas图像的渲染 。

## 动态数据可视化与静态海报合成

基于Canvas合成技术的海报分享功能天然地契合了用户的自我成就炫耀心理以及依托社交图谱（Social Graph）展开的熟人传播逻辑 。每当一位用户将一张附带了发证机构官方认证Logo、自身多维精美能力雷达图以及防伪溯源小程序码的战报海报分享至微信朋友圈或庞大的家长社群中时，实质上都是在以极高的信任背书，为背后的发证机构（B端）完成了一次转化率惊人的免费品牌广告触达 。

为彻底规避这些底层渲染地雷，项目架构必须引入微信官方维护的高级扩展组件 wxml-to-canvas 。该中间件组件颠覆了传统通过JavaScript逐像素绘图的模式，允许开发者像编写最基础的Web网页一样，利用类HTML的WXML标签与规范的内联CSS样式来声明式地排版整张海报的复杂空间布局（囊括背景底图的层级叠加、用户头像的圆形裁切、文字段落的排版及防伪二维码的绝对定位等）。在布局声明完毕后，系统通过底层机制将WXML节点树转换为原生画布绘制指令，只需调用 renderToCanvas 核心接口即可一键将结构转换为Canvas对象内存模型，并最终利用 canvasToTempFilePath 将其序列化导出为极高清晰度的本地图片文件，供用户保存至相册并唤起社交分享流程 。  
为了确保在最终生成的静态分享海报中能够完美、无损地呈现用户最为引以为傲的动态多维能力雷达图，架构层面必须摒弃直接引用的幻想，采用一套精密解耦的“数据编码流转中转”桥接重构机制：

1. **像素级图表快照截取**：在用户于UI层点击触发“生成海报”这一关键动作的前置拦截钩子中，系统底层首先调用当前处于激活状态的ECharts实例内置的 getDataURL 方法 。为了保证雷达图在最终海报中的边缘锐利度与高保真画质，必须在此API的参数中配置较高的 pixelRatio（设备像素比放大倍数，例如设置为3或更高，以适配视网膜屏幕）。该方法将对当前帧的动态图表进行像素级的深度冻结与快照截取，并同步输出一段体积庞大的 data:image/png;base64,... 格式的字符串编码数据流 。  
2. **动态数据结构的静态化注入**：随后，系统将这段超长且完整的Base64字符串文本作为动态绑定的变量数据，瞬间注入到专用于合成海报、且已通过样式将其完全移出可视屏幕边界（Off-screen）的隐藏WXML模板结构的 image 标签 src 属性中（形如 \<image src="{{radarBase64Data}}"...\>\</image\>）。  
3. **闭环合成渲染**：在完成数据流的注入与DOM更新后，处于等待状态的 wxml-to-canvas 组件将被唤醒。由于原本复杂的动态雷达图实例已经被降维转译为一串标准的静态Base64图片编码，wxml-to-canvas 组件只需将其视作一张普通的远端图片资源进行常规且安全的解析、排版与混合渲染即可 。这种通过引入统一的数据编码标准来桥接并弥合底层异构渲染引擎（动态可视化引擎与静态海报合成引擎）之间技术壁垒的设计模式，是成功跑通整个数字徽章系统社交传播裂变闭环最为关键的底层架构实施细节 。

## JSON动态配置驱动机制

微信小程序前端承载的所有源代码集合（包括视图层布局规范WXML、组件样式级联约束WXSS以及执行核心算法逻辑的JS/TS模型文件）必须在开发团队的严格纪律要求下，被强制剥离所有业务属性。

该前端工程架构仅仅向上层提供一个空灵的纯粹数据渲染容器：它包含了网格化列表的卡片渲染流水线、ECharts雷达图底层引擎的调度挂载逻辑，以及全局一致的生成海报与发起分享动作的系统级捕获回调逻辑。但是，它内部的任何一行代码中，绝对不允许包含任何与某一具体入驻发证业务方（即特定租户机构）相关的硬性绑定规则或魔法字符串（Magic Strings）。

在微信云开发的NoSQL核心数据库内，开辟并单独维护一个完全独立于基础业务数据流的名为 tenant\_config（全局租户配置字典）的核心控制集合。当系统成功开拓市场并接入一个全新的独立合作发证机构时，技术团队无需去触碰、修改甚至重新编译发布任何一行已被验证为稳定可靠的小程序底层前端业务代码，所有的工作仅仅是在云端控制台中，向该配置集合中新建并写入一段遵循严谨Schema约束的、代表该全新客户所有业务“差量”属性的JSON配置文件。

当一位真实世界的终端学习者通过扫描特定合作赛事的专属小程序二维码，或是点击由微信群裂变而来的携带特定参数的唤起链接而首次激活进入系统时，小程序的初始化生命周期钩子函数会瞬间从入口唤起参数对象（如微信定义的 scene 内部承载的 issuer\_id 数据）中精准识别出当前触发场景归属的租户真实身份，并在极为关键的页面首屏渲染白屏阶段（Page Loading Phase），发起异步高优先级的微型网络请求，直接跨过中间层从云端底层NoSQL数据库中无损拉取对应租户的全部完整JSON差量配置字典模型。

前端纯粹渲染逻辑容器依据这份实时拉取到的极简配置数据进行深度的数据映射与业务UI重组：

* **全景UI皮肤热替换：** 框架层逻辑会动态截取配置中的色彩参数，并在瞬间将其注入并更新小程序页面根DOM节点的全局CSS核心控制变量（CSS Custom Properties / Variables），使得原本在上一场景中呈现出活泼热烈红色的艺术风UI界面，在眨眼间被热重载并切换为透着冷静与严谨的深邃蓝色科技风界面矩阵 。  
* **多维数据评测引擎动态挂载：** ECharts雷达图组件初始化所需的 indicator 维度配置字典，彻底告别了由前端开发者在逻辑层写死的陈旧数组模式，转而直接将其内存绑定为由云端动态下发的JSON配置树中 ability\_framework\_metadata.dimensions 节点所提取的动态框架列表。更为精妙的是，无论最底层的零散Assertion断言记录在汇聚时带来了怎样杂乱无章、结构迥异的得分离散数据，前端状态管理库MobX中的核心计算属性（Computed Properties）都会严格依据这一套由云端最高权限下发的标准化维度框架模型，进行强制的数据清洗、对齐与权重聚合。  
* **高阶功能特性动态开关阀门：** 通过精细读取 advanced\_features\_toggle 业务块内的布尔值属性，系统能够在运行时动态决断出当前租户环境下，是否应当在核心的雷达图中额外调用绘图API渲染那一层代表着横向对比同龄人平均水平（Benchmarking）的灰色残酷竞争阴影；或者系统内部的促活任务流转控制器是否需要被激活，从而引导用户触发那种需要集齐三枚初级子徽章才能融合兑换一枚至高无上“全能标兵”元徽章（Meta-Badge）的复杂高阶综合合成业务逻辑 。

# **任务清单**

## 1.在 Antigravity 平台中配置 GEMINI.md 与工作区特定的 SKILL.md 规则池

架构师向 Agent Manager 注入高度结构化的领域知识指令：“你现在的角色是一名精通 W3C 可验证凭证（Verifiable Credentials）与 Open Badges 3.0 规范的资深 SaaS 架构师。请利用内置的 CloudBase MCP 服务器插件，连接并初始化当前环境名为 cloudbadge-prod 的微信云开发资源库” 。

接收到指令后，智能体将自主调用 MCP 的 login 工具完成云端鉴权，紧接着连续调用 writeNoSqlDatabaseStructure 工具，在 TCB 中自动创建并校验 issuers、badge\_classes、assertions 以及 tenant\_config 四大核心业务集合 。

## 2.输出完全符合 Open Badges 3.0 标准的 TypeScript 接口定义文件

利用微信云开发原生提供的 Web 版高级可视化数据控制台，通过手动录入或编写微型脚本导入 JSON 数据的形式，在云端数据库中建立对应赛事的 BadgeClass 元数据记录，并直接向 assertions 集合中挂载包含测试用户 OPENID 的实体数据

## 3.直观反映用户全方位能力画像的多维雷达图

引入了行业内久经考验的 MobX 状态管理架构，通过深度集成 mobx-miniprogram 与 mobx-miniprogram-bindings 绑定辅助库，将这一复杂的计算卸载到高效的状态机引擎中 。编写一段极其核心的透明函数响应式编程（Functional Reactive Programming）状态聚合逻辑。在 Store 树状结构中，系统维护着一个包含用户所有已获徽章基础数据的 assertions Observable 响应式数组。智能体巧妙地利用 MobX 的 computed 计算属性（Computed Properties），设计了一套自动遍历清洗算法。该算法会深入每一条徽章记录内部的扩展字段，提取 ability\_model 数组数据，然后精准匹配同名的能力维度（例如将多枚不同徽章中反复出现的“创新思维”或“逻辑推理”得分），进行科学的加权平均运算，最终返回一个专供图表引擎消费的 { indicator: \[...\], seriesData: \[...\] } 矩阵结构 。

## 4.注入AI 推理能力以构建“智能拆解仪式”

当终端用户在小程序中设定了一个宏大且具有挑战性的认证获取目标时（例如获得“高级数据分析师”认证徽章），小程序前端发起对云函数的调用。云端封装的系统提示词（System Prompt）会引导大模型将这一宏观目标动态降维，精准拆解为若干个耗时极短的“原子化微任务” 。更为精妙的是，这套由 AI 动态生成的任务执行计划、AI 虚拟教练的鼓励型人格设定，以及用户每次打卡完成任务的时间热力图标记，都会被系统精确地回写至该目标对应 Assertion 文档的 JSON-LD 扩展结构 extensions:PlanCoach 中持久化留存。

## 5.数字徽章背包

在界面底层框架的搭建上，前端智能体直接引入了微信官方长期维护的稳定版 WeUI 基础组件库，利用规范的网格系统（Grid）与高保真卡片（Card）布局模式搭建出专属的“数字徽章背包” 。

在具体的渲染层，智能体被严格要求抛弃当下泛滥的扁平化设计，转而采用高度拟物化（Skeuomorphism）的复杂 CSS 规则。通过极其细腻的深色阴影、多角度环境高光与渐变技术，在二维屏幕上模拟出真实徽章的金属光泽、珐琅质感或是水晶特有的厚重透明度。同时，为按钮与卡片点击交互绑定了使用 CSS3 Transform 编写的 3D 翻转动画。尤为重要的是，系统通过本地存储标记检测机制，当判定用户是首次点击并领取一枚由 B 端合作机构新颁发的高级别徽章时，前端视图层将瞬间全屏挂载强阻断性质的开箱动效，例如利用底层 Canvas 原生绘制的 Confetti 漫天彩色纸屑、粒子光效剧烈聚合或是徽章从暗影中缓慢浮现的顶级特效。

## 6.徽章的专属详情分析页

进入徽章的专属详情分析页后，系统向其呈现的是由 echarts-for-weixin 开源组件引擎实时渲染而成的动态多维能力图谱雷达图 。将这种动态且消耗大量内存的图表，转化为一张能够方便用户一键保存至系统相册，并分享至微信朋友圈或庞大教育社群的静态精美海报，将底层发证机构的权威品牌背景底图、承载着丰富个人信息的圆形裁切头像框、精美编排的定性评价段落文字，以及经过精确定位运算的小程序防伪溯源二维码进行层级叠加与排版。在极短的运算周期后，系统一键执行 renderToCanvas 接口，将复杂的 DOM 树模型转为原生画布对象，并紧接着调用 canvasToTempFilePath 将其序列化导出为极高分辨率的本地图片。

## 7.一键部署脚本

利用 Antigravity 智能体批量执行了一键部署脚本。系统将所有通过智能体验证的 Node.js 云函数正式上传至生产环境，更新并固化 TCB 数据库的结构索引字典。最终，通过微信开发者工具的预览与上传面板，完成整个 MVP 小程序工程的代码包压缩、混淆与编译打包，正式向微信公众平台提交极速上线审核。

## 8.完全无代码化的 JSON 动态配置驱动机制

整个前端小程序工程被极其克制地设计为一个“空灵的纯粹数据渲染容器”。它预制了标准化列表流水线与底层渲染引擎，但在核心代码中绝对不包含任何某一具体业务方的视觉或交互规则 。

在 TCB 的 NoSQL 底层数据库中，独立维护着一个处于最高管理权限层级的全局控制集合——tenant\_config。当销售团队成功签约一个全新领域的合作发证机构时，研发团队完全不需要去修改、合并分支或者重新编译提审稳定可靠的小程序客户端代码。所有的适配工作都简化为在云端向该集合中新增一段严格遵循 Schema 约定的 JSON 差量配置文件 。

当某个陌生的终端学习者扫码首次进入小程序时，初始化生命周期钩子迅速截获二维码参数中隐含的 issuer\_id 身份信息，并在页面关键的白屏加载阶段发起异步极速请求，将对应租户的完整配置树拉取至本地内存。引擎随即执行深度的业务映射重组：它会动态提取配置中的色彩变量值，利用原生的 CSS Custom Properties 特性对整个全局界面进行毫秒级的全景皮肤热替换（例如将系统瞬间从严谨的科技蓝主题切换为热烈活泼的艺术红）；它还会强制将云端配置中 ability\_framework\_metadata.dimensions 节点定义的维度字典深度注入至 MobX 状态机引擎与 ECharts 雷达图的指示器（Indicator）中，确保无论底层离散数据如何杂乱，数据清洗与呈现模型都死死咬合在此套标准框架上 ；同时，通过解析内部的布尔值开关，系统能在运行时瞬间决断是否向该机构的用户开启诸如“横向同龄人水平竞技对比阴影”或“三合一元徽章合成机制”等高阶增值功能特性 。这套引擎赋予了系统极高的商业适应力与溢价空间。

## 9.学习过程中的孤独感与反馈延迟

将原本枯燥、单向、冰冷的数字认证接收过程，异化为一个高频互动、充满情绪共鸣的多人协作空间——即“成长小队”网络（Growth Squads）。

这一宏大的产品理念，其背后的技术实现是对分布式系统并发状态一致性管理的严峻考验。在小队网络模式下，系统构建了一个实时的状态共享分布账本。紧跟在原子更新完成的钩子函数之后，系统立即触发云环境中的长连接通信信道，向网络节点内处于在线状态的其他团队成员实时推送触觉震动反馈与进度变更事件。

# **项目目录：**

---

### **📂 CloudBadge_v3_Project_Root (项目根目录)**

#### **1\. 📂 01\_Product\_Management (产品管理)**

* 01\_PRD\_v3.0.md — 深度融合功能说明书 (Zeta + PlanCoach + Bileshi)  
* 02\_OB3\_Standard\_Spec.pdf — Open Badges 3.0 官方规范与系统对齐说明  
* 03\_User\_Journey\_Map.fig — 用户旅程图：从发现、AI 拆解到点亮徽章  
* 04\_Tokenomics\_Design.xlsx — “星币”代币经济模型与兑换系数表

#### **2\. 📂 02\_Design\_Assets (设计资产)**

* 01\_Skeuomorphism\_Guide/ — 拟物化视觉设计规范 (阴影、高光、材质)  
* 02\_UI\_Mockups/ — 小程序端 & 管理员 B 端原型图  
* 03\_Dynamic\_ECharts/ — 雷达图动态渲染模板 (含过程热力阴影效果)  
* 04\_Lottie\_Animations/ — 庆典动效 (Confetti纸屑、开箱光效动画文件)

#### **3\. 📂 03\_Technical\_Specs (技术方案)**

* 01\_Architecture\_Blueprint.md — 基于 Clean Architecture 的分层设计文档  
* 02\_TCB\_NoSQL\_Schema.md — 云数据库集合字段定义 (OB3 \+ 扩展字段)  
* 03\_DeepSeek\_Prompt\_Library.md — AI 任务拆解与人格化教练的 System Prompts  
* 04\_Security\_Rules.json — 微信云开发数据库与云函数安全规则定义

#### **4\. 📂 04\_Source\_Code (代码库)**

* 📂  **(小程序前端 \- MobX架构)**  
  * 📂 components/ — 拟物化徽章卡片、ECharts 包装组件、Canvas 海报生成器  
  * 📂 store/ — globalStore.ts (租户配置与角色看板), badgeStore.ts (徽章状态聚合逻辑)  
  * 📂 styles/ — 基于 CSS Variables 的租户皮肤变量定义  
  * 📂 pages/ — badge-detail, badge-editor, group-dashboard, task-approval, help-manual...
*
* 📂  **(云函数 \- 领域服务层)**  
  * 📂 task\_decomposer/ — AI 任务原子化拆解 (调用 DeepSeek 流式响应)  
  * 📂 consensus\_engine/ — 处理比乐时模式的状态同步与代币事务  
  * 📂 badge\_issuer/ — 生成符合 OB3 标准 of 签名凭证  
  * 📂 badge\_mgmt/ — update\_badge\_api, update\_user\_role_api, task\_approval\_api...
*
* 📂  **(前后端公用)**  
  * ob3\_types.ts — 严格符合 Open Badges 3.0 的接口定义  
*

#### **5\. 📂 05\_Tenant\_Configurations (租户/B端配置)**

* 📂 schema/ — tenant\_config\_schema.json (配置验证协议)  
* 📂 instances/ — 存放不同合作机构的 JSON 配置文件 (如：艺术类、编程类)  
  * tenant\_art\_school.json  
  * tenant\_tech\_contest.json  
*

#### **6\. 📂 06\_DevOps\_&\_Deployment (部署与自动化)**

* 01\_Environment\_Setup.md — 微信云开发环境初始化指南  
* 02\_OneClick\_Deploy.sh — 一键部署脚本 (代码上传 \+ 索引固化 \+ 配置导入)  
* 03\_Antigravity\_Skills.json — 针对 AI Agent 的 SKILL.md 规则池定义

#### **7\. 📂 07\_Testing\_&\_QA (测试与质检)**

* 01\_TestCase\_Execution.xlsx — 核心路径测试用例 (如：AI 任务拆解准确性)  
* 02\_Compliance\_Report.pdf — 内容安全检测审核报告 (imgSecCheck 集成证明)

#### **8\. 📂 08\_Release\_Notes (发布记录)**

* CHANGELOG.md — 版本迭代记录 (从 v2.0 到 v3.0 融合版的变更)  
* README.md — **项目快速启动总索引**

---

### **🛠️ 关键文件建议：README.md 内容模版**

在根目录下建议放置一个清晰的 README，内容应包含：

1. **项目简介**：强调其“执行力加速 \+ 社交激励”的定位。  
2. **快速运行**：如何配置微信小程序 AppID、DeepSeek API Key。  
3. **核心逻辑路径**：  
   * AI 拆解路径：cloudfunctions/task\_decomposer  
   * 数据对齐路径：common/ob3\_types.ts  
4.
5. **联系方式**：技术架构师与产品负责人。

这套目录结构将**非代码资产（设计、模型、配置）**完美分离，特别突出了方案中提到的“JSON 配置驱动”和“AI 微任务拆解”两大核心模块，非常适合长期维护和多租户扩展。

---

# **前端核心操作闭环流程**

为了实现从冰冷的静态凭证向高频互动学习过程转移的核心理念，小程序前端被设计为极具沉浸感和自洽性的逻辑闭环。具体用户操作体验流转如下：

### **第一阶段：环境初始化与目标发现**

1. **扫码/链接入场（动态渲染）**：用户扫描线下赛事二维码或点击社群拉新链接。底层拦截器提取 `issuer_id` 后，跨层瞬时拉取云端JSON配置文件（tenant_config），小程序界面动态执行主题色热重载及UI品牌切换。
2. **首页视窗（能力导向）**：用户进入徽章广场（Home），此时头部滑过全局动态或社区系统通知，下方列表瀑布流推荐各项等待攻克的荣誉挑战。
3. **选定目标**：用户浏览橱窗卡片，选中自己想要获取的特定技能徽章（如“云徽章开拓者勋章”），点击准备开始。

### **第二阶段：AI能力图谱智能拆解**

1. **发起攻克指令**：用户点击“开始攻克该徽章”进入准备状态。
2. **云端AI仪式化拆解**：系统底层读取出这枚徽章背后内嵌的“能力图谱与机构规则考核基准”，合并用户的过往能力画像，向云端封装的 DeepSeek 大模型注入 Prompt。
3. **产出专属微任务单**：AI扮演极具同理心的教练人格，在几秒内将繁重复杂的宏图考核，转化为几项耗时极短的“原子化微任务”（例如：填写300字心得、阅读一篇图文、提交两张实验实景图）。任务清单自带时间节点要求，并持久化写入底层数据的扩展参数。

### **第三阶段：过程执行与多维日志举证**

1. **攻克中面板（Ongoing）**：目标徽章加入“我的收藏/攻克中”Tab。界面呈现直观的攻克进度条（如30%）以及下方刚刚生成的待办 AI 任务清单。
2. **打卡与举证记录**：当用户在真实场景下推进某项任务时，在界面上勾选此微任务并进入“详情层”，同步**提交徽章日志**。用户可唤起本地相机拍摄完成图、录入文字心得。上传的文件将直接作为 `Open Badges 3.0` 规范中 `Evidence（证据溯源链）` 的核心素材存留。
3. **陪伴式激励反馈**：每当勾选小结任务或长传日志，界面会触发拟物的点击音效与局部流光粒子特效，并通过状态共享账本把进度推送给“成长小队”群聊，队友即时发来交互点赞。

### **第四阶段：全自动合规判定与颁发**

1. **自动状态监听**：当拆解出的微任务清单中的最后一项被勾选完成并上传相应日志后，前端校验状态机抛出触发器。
2. **合规审核判定**：系统云端节点无缝接入微信官方安全接口（msgSecCheck/imgSecCheck）或特定的后端自动批改策略验证日志合法性。若无需机构侧人工强介入，系统自动判定该学习者满足一切前置目标，触发发证动作。
3. **极奢开箱发证**：前端直接触发全屏强阻断仪式的“徽章获取动效”（例如基于canvas引擎的漫天彩带 Confetti 或 3D 水晶模型旋转），带给用户极强的心流多巴胺释放。徽章进入用户的“数字背包（我的徽章）”，状态转为 `earned`。

### **第五阶段：自证展示与裂变传播**

### **第五阶段：自证展示、导师审批与裂变传播**

1. **个人多维能力图谱分析页**：在“我的徽章”列表页点击这枚成功点亮的徽章，Echarts 引擎瞬间计算各项底层得分参数，绘制出专属这个用户的复合“多维能力雷达图”，底部详细展示先前打卡串联而成的徽章日记时间线。
2. **导师/组长人工审批 (Manual Verification)**：对于在协作组内的成员，其举证将进入“待审核”状态。组长通过管理的“团队大屏（Group Dashboard）”查阅多媒体证据，并基于 AI 的预审评分给出最终的“核准”或“驳回”。这一机制确保了荣誉发放的严肃性与专业性。
3. **画布海报引爆**：点击“社交分享”按钮，wxml-to-canvas 拦截此时的图表快照转换为Base64静态文件，与品牌背景、用户头像及 AI智能发圈文案完美渲染成一张高清凭证海报，通过长按分享到朋友圈，完成向他人炫耀及反哺SaaS机构品牌流量拉新的闭环。

---

# **新一代核心迭代需求规划 (v3.x)**

系统未来的更新架构及迭代路径将全面响应以下 9 项业务与产品需求。在实现过程中，所有的底层核心依旧强制**以提取 `tenant_config` 租户配置为前置**，且数据模型严格绑定 **Open Badges 3.0** 架构。

### **1. 视觉架构与交互升维 (社交激励化原则)**

* **需求核心**：样式向微信小程序官方样式对齐
* **落地策略**：基础 UI 组件库深度向微信原生规范（WeUI等）看齐以保证操作流畅度。在此基础上，必须在关键核心节点（如获得徽章、任务打卡确认）大量引入高保真的拟物化参数设定与强烈的点击反馈视觉特效，充分满足社交激励机制。

### **2. 租户内网状分层管理模型**

* **需求核心**：在一个租户内设定四类用户权限：超级管理员、观察者、攻克团队组组长和一般用户
* **落地策略**：在 SaaS 环境的 `tenant_config` 作用域内启用 RBAC（基于角色的访问控制）。超级管理员负责管理元徽章配置与全局账本；观察者（导师/家长）负责全周期数据监视；攻克团队组组长承办小组激励组织与协同验证；一般用户专注于承接并消化所分发的目标。

### **3. 数据演进引擎换代**

* **需求核心**：个人获得徽章后可视化图表的算法更新
* **落地策略**：配合 ECharts 引流计算网络，构建包含“时间衰减与长期叠加”等多因子组合的新一代就算公式，当用户获取新成就时，不仅更新坐标轴上的分数，更要通过动画与动态平滑曲率渲染能力演变路径的轨迹。

### **4. 徽章拓扑网络**

* **需求核心**：各个徽章之间的关系计算
* **落地策略**：在 Open Badges 模型的底层建立多点连结计算。提供包含前提条件（Prerequisites）、并列合并、以及各种低阶徽章向高阶组合合成等关系的算法支持，以应对复杂认证体系的要求。

### **5. 智能徽章工厂与全量治理引擎 (已上线)**

* **需求核心**：由“徽章工场”升级为“徽章工厂”，支持存量勋章全字段编辑与派生。
* **落地策略**：
  1. **存量导入机制**：支持从广场 78 枚存量徽章中一键载入原始数据（包含名称、描述、维度及任务）；
  2. **全字段治理**：提供除底层 ID 外的全字段编辑入口，涵盖 Issuer（发行方）、Badge_ID、Category（分类）、Tags（标签）及 Image（图标 URL/Emoji）；
  3. **五级量规编辑器**：内置 Novice（新手）到 Lead（引领者）的 5 级行为量规编辑器，支持长文本 `auto-height` 动态显示，确保专业标准的完整性。
  4. **双向发布分流**：重构 `manage_badge_class` 云函数逻辑，支持“覆盖更新原徽章”与“克隆发布为新徽章”双轨运行。
  5. **AI 任务驱动**：保留并强化 AI 智能拆解功能，将宏大目标转为多项“原子化微任务”，并同步映射至 `Extensions` 中。

### **6. 自主权数字资产本地化**

* **需求核心**：一般用户的本地持久化下载保存
* **落地策略**：数字背包中的数字凭证除了依赖云端校验，将为普通用户提供深度下载和本地设备持久化存储服务，确保所有 W3C VC 和可溯源资料能随身无网留存。

### **7. 数字驱动的纸质镜像**

* **需求核心**：将微任务等打卡任务下载打印与保存
* **落地策略**：开发配套的排版渲染工具，将基于系统的 AI 微任务清单及时间日志等数字记录导出为适宜手帐记录或线下展示的高清版 PDF，供用户打印收藏。

### **8. O2O 实物衍生供应链打通**

* **需求核心**：徽章可对应实物制造厂商，可在线调用商家接口下单
* **落地策略**：彻底打通虚实转换，对接支持礼品或模具加工验证的厂商 API。用户解锁特定数字徽章（并体验极质 UI 特效后），可以直接调起商家下单功能将纪念品制作为物理实体。

### **9. 国际与专业企业级基准对标**

* **需求核心**：能对接 SFIA 能力框架中具体要求与层级设计
* **落地策略**：后端的维度定义（Alignment）不仅关注基础素质方向，将深度整合纳入业界权威 **SFIA（技能和信息架构体系）** 框架。系统的层级规则（包含从1到7的不同评估级别定义）均需建立起与 SFIA 标准严格绑定的校验体系。

### **10. 协作式证据收集与朋友圈级交互 (新一代举证引擎)**

* **需求核心**：将传统的表单式证据上传重构为类“微信朋友圈”的社交化媒体流体验，并引入 AI 自动审核。
* **落地策略**：
  1. **富媒体与流式交互**：用户在提交徽章攻克证据时，告别枯燥的表单，支持上传最多 9 张图片、短视频及富文本。界面风格与交互逻辑深度对齐“微信朋友圈”。
  2. **协作组可见性与社区激励**：举证记录支持设置可见范围（如公开、仅自己、指定小组）。系统默认将动态开放给“特定协作小组”，其他小队成员可在广场的信息流中直接为该证据进行“点赞”与评论互动，提供直接情绪价值。
  3. **腾讯混元大模型靶向判定**：用户发布的证据流在存入云端时，将自动调用**腾讯混元大模型**接口。模型将结合该徽章的具体要求与当前的举证内容，精准判定是否“达标”（Passed）， b并给出带有温度的指导评语。系统彻底实现全自动考核化闭环。

### **11. 星币社交激励体系与代币闭环**

* **需求核心**：建立基于“星币”的社交互动价值锚点，提升平台活跃度。
* **落地策略**：
  1. **每日津贴机制**：用户每日登录后，可在首页手动点击领取 100 星币。该动作强化了“每日仪式感”，不仅是奖励，更是促活手段。
  2. **高频消耗场景设计**：
     * **领取徽章**：象征性扣除 10 星币，增加荣誉的稀缺感。
     * **社交互动**：为他人点赞需消耗 10 星币（点赞即“打赏”）。
     * **任务送审**：提交证据开启 AI/人工审核需消耗 10 星币，模拟“申请审理费”。
  3. **社交正向反馈奖励**：当用户发布的“攻克证据”（朋友圈动态）获得他人点赞时，发布者将获得同步的星币奖励。通过“点赞消耗-获赞得利”构建轻量化的社区代币闭环，激发高质量内容的产出。

### **12. 动态使用说明书与管理维护 (已上线)**

* **需求核心**：为用户提供图文并茂的使用说明书，并允许超管在前端界面直接动态编排。
* **落地策略**：在“个人中心-使用帮助与反馈”开放查阅说明书（`help-manual`）的入口。说明书通过 `system_content` 动态下发，涵盖“徽章广场、数字背包、攻克中心、协作小队”四大核心模块。对于拥有 `super_admin` 角色的极高权限用户，页面一角自动提供对应的悬浮编辑器入口（`help-editor`）。所有的富文本编辑动作将直接通过 `system_content_api` 写入底层的独立集合，实现对终端指南文档的零代码、免发版敏捷迭代更新。

### **13. 协作式团队攻克组 (已上线)**

* **需求核心**：基于真实的社交微信连接实现组团挑战，降低单人闯关的孤独感与倦怠感。
* **落地策略**：融合微信原生的小程序卡片分发能力（`onShareAppMessage`）及朋友圈引流（`onShareTimeline`）。当发起者分享徽章挑战卡片时，该卡片背后的路由将隐秘携带特有参数 `inviterGroupId`。好友通过该卡片入局后，系统将在拦截判定层立刻把受邀人加入发起者的“挑战小队”集合名单。同时，产品界面在徽章打卡单的上方新增精美的“协作成员看板”，由 `scroll-view` 实时拉取并展示队友进度与头像，打造浓郁的互助竞技氛围。

### **14. 徽章工厂与零感鉴权 (已上线)**

* **需求核心**：实现勋章全字段治理、任务动态下发及极致的静默登录体验。
* **落地策略**：
  1. **Badge Factory (徽章工厂)**：为超级管理员开启全量治理门户，支持对 78 枚徽章的 5 级量规及 AI 任务（Extensions.tasks）进行深度编辑与覆盖更新。
  2. **Silent Auth (静默登录)**：采用微信最新的“头像昵称能力”进行首次采集，后续利用 `openid` 云端自动复原 `userInfo` 与 `star_balance`，实现二次开启应用无须人工干预即可复原全部档案状态。
  3. **Group Dashboard & Leader Access (管理大屏与权限控制)**：组长专享“雷达进度大屏”，通过 `consensus_engine` 聚合成员的登录频率、星币排行及任务进度。组长拥有移出成员及对微任务举证进行人工审批（`task-approval`）权。

### **15. 超级管理员身份配置说明 (SaaS 权限底层机制)**

* **身份判定逻辑**：系统的超级管理员（`super_admin`）身份并非通过前端硬编码或数据库 `users` 集合的简单布尔值决定，而是采用 **“租户级白名单鉴权”** 机制。这确保了跨租户环境下的身份安全性与配置灵活性。
* **配置路径**：
  * 管理员需进入云开发数据库控制台，定位至 `tenant_config` 集合中的对应租户文档（通常为 `default_config`）。
  * 在 `rbac_roles` 对象下维护 `super_admin` 数组，将受信任管理员的 **微信 OpenID** 填入其中。
* **权限激发流程**：
  * **云端校验**：`user_login` 云函数在用户登录时自动扫描该白名单。若匹配成功，则在返回的用户对象中封装 `role: "super_admin"`。
  * **前端感知**：小程序 `globalStore` 捕获该角色状态后，将自动在“个人中心”和“徽章详情页”唤起悬浮的【徽章工厂】入口。管理员可通过该入口对广场 78 枚徽章执行全方位的“数据修补”与“版本派生”。