소개

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와 분리)

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":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"@ @:@ @""@ @,@

@"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@

@}@ |