제안서(Proposal) » 이력 » 개정판 9
개정판 8 (이름없음, 2021/06/09 08:35) → 개정판 9/10 (이름없음, 2021/06/09 08:36)
h1. 제안서(Proposal)
제안서 작성시 입력할 수 있는 필드 내용입니다
|_. key |_. type |_. note |_. description |
| ProposalID | string | | 해당 제안서의 식별자 |
| Owner | string | | 해당 제안서의 등록자 |
| Category | int[] | >0 | 수집할 개인정보 카테고리 목록
"수집 개인정보":https://snplab.synology.me/confluence/pages/viewpage.action?pageId=27558064 참조
모든 양의 정수 사용 가능하며, 블록체인에서는 검증하지 않음 |
| Purpose | int | | 제안서 사용 목적
0: 타겟 마케팅(Target Marketing)
1: 예측 마케팅(Predictive Marketing)
100: 데이터 거래
997: 추첨(sortilege)
998: 이벤트2(999와 분리)
1001: LDP |
| Filter | string | | 제안서 대상 필터 |
| Condition | string | | 제안서 동의 필터 |
| NotBefore | string | rfc3339 | 제안서의 유효기간 시작 일시 |
| NotAfter | string | rfc3339 | 제안서의 유효기간 종료 일시 |
| MaxIssuable | int | >0 | 제안서을 통해 등록할 수 있는 최대 티켓 수 |
| Duration | string | duration or rfc3339 | 제안서을 통해 발행한 티켓의 유효 기간. 최대 주단위로 설정할 수 있다. 자세한 사용법은 아래 링크를 참고한다.
"time.duration in golang":https://golang.org/pkg/time/#Duration
위 링크에서 정의된 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 | 티켓 유효기간 시작 시각. 미설정시 즉시 시작 |
h2(wiki-class-auto-cursor-target#wiki-id-Proposal-리워드지급기준). 리워드 지급 기준
RewardPolicy
|_. key |_. type |_. note |_. description |
| Type | int | | 지급 유형
* 1: 티켓 소모 완료 시
* 2: 티켓 소모 시마다 |
| Amount | int | >=0 | 티켓의 지급 가능 총량 |
h2(#wiki-id-Proposal-티켓소모기준). 티켓 소모 기준
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"@ @\t"ProposalID"@ @:@ @""@ @,@
@"Owner"@ @\t"Owner"@ @:@ @""@ @,@
@"Category"@ @\t"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@
@}@ |
