Skip to content

Commit 09a1c67

Browse files
committed
docs: publish hongyan DPP specification v1.0
1 parent f3bf2aa commit 09a1c67

2 files changed

Lines changed: 125 additions & 0 deletions

File tree

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
# 欧盟数字产品护照(DPP)数据对象核心
22
EU Digital Product Passport Data Object Core
33

4+
📘 官方规范:
5+
[红岩 DPP 数据对象规范 v1.0](docs/specification-v1.0.md)
6+
47
面向中国出口企业与 DPP 服务商的开源合规基础结构。
58
RedRock OpenDPP Core
69

docs/specification-v1.0.md

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
# 红岩 DPP 数据对象规范 v1.0
2+
3+
版本号:hongyan-dpp-1.0
4+
发布日期:2024
5+
状态:正式发布
6+
7+
---
8+
9+
## 一、规范目的
10+
11+
本规范定义“红岩 DPP 数据对象”的基础结构,用于:
12+
13+
- 欧盟数字产品护照(Digital Product Passport, DPP)
14+
- 电池护照(Battery Passport)
15+
- 中国出口企业合规数据结构设计
16+
- DPP SaaS 系统集成
17+
18+
本规范目标:
19+
20+
- 提供可验证的数据对象模型
21+
- 支持生命周期演化记录
22+
- 不依赖区块链
23+
- 不依赖中心服务器
24+
- 可嵌入现有 ERP / SaaS 系统
25+
26+
---
27+
28+
## 二、数据对象结构
29+
30+
一个标准红岩数据对象包含两个部分:
31+
32+
```
33+
{
34+
"hongyan_object": { ... },
35+
"proof": { ... }
36+
}
37+
```
38+
39+
---
40+
41+
### 2.1 hongyan_object(业务数据部分)
42+
43+
必选字段:
44+
45+
- product_name
46+
- model
47+
- material_source
48+
- carbon_data
49+
- version
50+
- previous_version_hash(可为空)
51+
52+
示例:
53+
54+
```
55+
{
56+
"hongyan_object": {
57+
"product_name": "锂电池",
58+
"model": "LFP-2024",
59+
"material_source": "中国",
60+
"carbon_data": "12.5kg CO2",
61+
"version": "1.0",
62+
"previous_version_hash": null
63+
},
64+
"proof": {
65+
"algorithm": "SHA-256",
66+
"hash": "xxxx",
67+
"generated_at": "2024-01-01T00:00:00Z"
68+
}
69+
}
70+
```
71+
72+
---
73+
74+
## 三、生命周期机制
75+
76+
红岩数据对象支持版本演化。
77+
78+
规则:
79+
80+
- 每次生成新版本时
81+
- previous_version_hash = 上一版本 proof.hash
82+
83+
形成不可篡改的版本链条。
84+
85+
---
86+
87+
## 四、验证算法
88+
89+
验证步骤:
90+
91+
1. 对 hongyan_object 进行 canonicalize(按字段排序)
92+
2. 执行 SHA-256
93+
3. 与 proof.hash 比较
94+
95+
如果一致,则验证通过。
96+
97+
---
98+
99+
## 五、兼容性声明
100+
101+
- 本规范为开源结构标准
102+
- 任意组织可独立实现生成与验证逻辑
103+
- 不依赖红岩官方服务器
104+
- 不依赖区块链网络
105+
106+
---
107+
108+
## 六、版本策略
109+
110+
当前版本:
111+
112+
hongyan-dpp-1.0
113+
114+
未来版本将保持向后兼容。
115+
116+
---
117+
118+
## 七、授权声明
119+
120+
红岩 DPP 数据对象规范采用开源协议发布。
121+
122+
允许商业使用与二次开发。

0 commit comments

Comments
 (0)