Actions
제안서(Proposal) » 이력 » 개정판 2
« 뒤로 |
개정판 2/10
(비교(diff))
| 다음 »
이름없음, 2021/05/25 07:56
제안서(Proposal)¶
| key | type | note | description |
|---|---|---|---|
| ProposalID | string | 해당 제안서의 식별자 | |
| Owner | string | 해당 제안서의 등록자 | |
| Category | int[] | >0 | 수집할 개인정보 카테고리 목록 수집 개인정보 참조* 모든 양의 정수 사용 가능하며, 블록체인에서는 검증하지 않음* |
| Purpose | int | 제안서 사용 목적 0: 타겟 마케팅(Target Marketing) 1: 예측 마케팅(Predictive Marketing) 100: 데이터 거래 997: 추첨(sortilege) 998: 이벤트2(999와 분리) 999: 이벤트1000: LDP |
|
| Filter | string | 제안서 대상 필터 | |
| Condition | string | 제안서 동의 필터 | |
| NotBefore | string | rfc3339 | 제안서의 유효기간 시작 일시 |
| NotAfter | string | rfc3339 | 제안서의 유효기간 종료 일시 |
| MaxIssuable | int | >0 | 제안서을 통해 등록할 수 있는 최대 티켓 수 |
| Duration | string | duration or rfc3339 | 제안서을 통해 발행한 티켓의 유효 기간. 최대 주단위로 설정할 수 있다. 자세한 사용법은 아래 링크를 참고한다. time.duration in golang*위 위 링크에서 정의된 h(시간) 외에 추가 단위로 아래와 같은 단위를 제공한다. (Month는 명확하지 않으므로 절대 시간 사용 권장)* * d : 일(24시간) * w: 주(7일) * M: 월(30일) 상대적인 주기가 아니라 절대 시간을 duration으로 하고자 한다면 rfc3339 규격에 맞춘 문자열을 설정할 수 있다. 계산 시작점은 TicketValidFrom이 설정되어 있을 경우 TicketValidFrom부터 계산하며, *TicketValidFrom이 존재하지 않을 경우 현재 시간(fabric transaction의 timestamp)부터 계산한다.* |
| ImageURL | string[] | optionaltagged-url | 제안서을 보여줄 때 사용할 이미지들의 URL |
| CreatedAt | string | rfc3339 | 제안서 등록 일시 |
| RevokedAt | string | optional, rfc3339 | 제안서 폐기 일시 |
| UpdatedAt | string | rfc3339index | 제안서 변경 일시등록, 활성화, 파기 등 모든 변경 케이스에 대한 시간 반영 |
| Status | int | 제안서 상태0: 정상 (활성화됨)1: 활성화 전2: 폐기됨3. 만료됨4. 사용완료 (MaxIssuable만큼 티켓이 발행됨)5. 기타 무효 상태(예비) | |
| Content | json object | untyped | 티켓이 참고할 내용 (개인정보 전달 경로, LDP 정보 등) |
| RewardPolicy | json object(RewardPolicy) | typed | 리워드 지급 기준 RewardPolicy.Type: 지급 유형 * 1: 티켓 소모 완료 시 * 2: 티켓 소모 시마다 RewardPolicy.Amount: 한 티켓으로 지급할 수 있는 최대 금액 * 데이터 단가 계산 식 : rewardPolicy.Amount / (consumePolicy.Count * consumePolicy.MaxDataCount) |
| ConsumePolicy | json object(ConsumePolicy) | typed | 티켓 소모(사용) 기준 ConsumePolicy.Type: 소모 유형 * 1: 요청자(proposal.Owner)에 의해 소모 * 2: 티켓 발행자 자가소모(ticket.Owner) ConsumePolicy.Count: 소모 횟수 ConsumePolicy.Period: 소모 주기 *ConsumePolicy.MaxDataCount: 1회 소모 시 수집 가능한 데이터 총량 *1 consume당 지급 리워드 계산 식: min(1, (consumeContext.DataCount / consumePolicy.MaxDataCount) ) / consumePolicy.Count * rewardPolicy.Amount |
| Description | string[] | optional | 제안서을 보여줄 때 사용할 목적별 문구들 |
| Deposit | string | optional | Activate를 위해 deposit한 TokenID |
| Reserved | json object | optional, untyped | 예비 |
| BindMap | BindMap | optional | 블록체인 내부 관리용 정보. 표시되지 않을 수 있으며,표시되어도 블록체인 외부에서는 사용하지 않는다. |
| DisallowMultiIssue | bool | optional | true로 설정될 경우 동일 DID로 중복 issue를 허용하지 않는다.기본값 false (중복 issue 허용) |
| TicketValidFrom | string | rfc3339,optional | 티켓 유효기간 시작 시각. 미설정시 즉시 시작 |
리워드 지급 기준¶
RewardPolicy
| key | type | note | description |
|---|---|---|---|
| Type | int | 지급 유형 * 1: 티켓 소모 완료 시 * 2: 티켓 소모 시마다 |
|
| Amount | int | >=0 | 티켓의 지급 가능 총량 |
티켓 소모 기준¶
ConsumePolicy
| key | type | note | description |
|---|---|---|---|
| Type | int | 소모 유형 * 1: 요청자(proposal.Owner)에 의해 소모 * 2: 티켓 발행자 자가소모(ticket.Owner) |
|
| Count | int | >0 | 소모 허용 횟수 |
| Period | string | duration,optional | 소모 주기(소모 간 최소 간격) * 현재 일단위만 지원 (예: 하루 1번일 경우 1d로 지정) 없을 경우 주기 체크하지 않음 |
| MaxDataCount | int | >0, optional | consume시 최대 데이터 소모 수 |
an example of a LDP template
{"ProposalID" : "" ,"Owner" : "" ,"Category" :[4,1,2],"Purpose" :0,"Filter" : "*" ,"NotBefore" : "2020-12-14T14:37:43+09:00" ,"NotAfter" : "2020-12-24T15:37:43+09:00" ,"MaxIssuable" :3,"Duration" : "2020-12-24T15:37:43+09:00" ,"ImageURL" :["icon= https://cdn.snplab.io/images/snplab.png " ,"background= https://cdn.snplab.io/images/commonwallpaper.png "],"Content" :{"endpoint" : "firebase url" ,"isItReal" : false ,"key" : "somewhat" ,"range" :["0" ,"0.25" ,"0.50" ,"0.75" ,"1"],"spinner" :0.1},"RewardPolicy" :{"Type" :1,"Amount" :0},"ConsumePolicy" :{"Type" :2,"Count" :1},"Description" :["title=\"TEST LDP\"" ,"disclaimer=\"blahblah\""],"DisallowMultiIssue" : true} |
이름없음이(가) 약 4년 전에 변경 · 2 revisions
