freat: add grant eligibility reason (#10600)

* add grant elibility reason

* update test

Author: thelostone-mc

app/assets/v2/js/grants/_new.js

@@ -1,7 +1,7 @@
 Vue.component('v-select', VueSelect.VueSelect);
 Vue.use(VueQuillEditor);
 
-const step1Errors = [ 'grant_tags', 'has_external_funding' ];
+const step1Errors = [ 'grant_tags', 'tag_eligibility_reason', 'has_external_funding' ];
 const step2Errors = [ 'title', 'description', 'reference_url', 'twitter_handle_1' ];
 const step3Errors = ['chainId'];
 const errorsByStep = [ step1Errors, step2Errors, step3Errors ];
@@ -157,6 +157,9 @@ Vue.mixin({
       if (!vm.form.grant_tags.length > 0) {
         vm.$set(vm.errors, 'grant_tags', 'Please select one or more grant tag');
       }
+      if (!vm.form.tag_eligibility_reason.length) {
+        vm.$set(vm.errors, 'tag_eligibility_reason', 'Please enter eligibility tag reasoning');
+      }
       if (vm.richDescription.length < 10) {
         vm.$set(vm.errors, 'description', 'Please enter description for the grant');
       }
@@ -219,6 +222,7 @@ Vue.mixin({
         'cosmos_payout_address': form.cosmos_payout_address,
         'grant_type': form.grant_type,
         'tags[]': form.grant_tags,
+        'tag_eligibility_reason': form.tag_eligibility_reason,
         'network': form.network,
         'region': form.region,
         'has_external_funding': form.has_external_funding
@@ -455,6 +459,7 @@ if (document.getElementById('gc-new-grant')) {
           cosmos_payout_address: '',
           grant_type: 'gr12',
           grant_tags: [],
+          tag_eligibility_reason: '',
           network: 'mainnet'
         },
         editorOptionPrio: {
@@ -560,7 +565,8 @@ if (document.getElementById('gc-new-grant')) {
         'eth_payout_address',
         'grant_type',
         'team_members',
-        'grant_tags'
+        'grant_tags',
+        'tag_eligibility_reason'
       ];
 
       for (const key of writeToRoot) {

app/grants/admin.py

@@ -105,7 +105,7 @@ class GrantAdmin(GeneralAdmin):
         'title', 'is_grant_idle',
         'active', 'visible', 'is_clr_eligible',
         'migrated_to', 'region',
-        'grant_type', 'tags', 'description', 'description_rich', 'github_project_url', 'reference_url', 'admin_address',
+        'grant_type', 'tags', 'tag_eligibility_reason','description', 'description_rich', 'github_project_url', 'reference_url', 'admin_address',
         'amount_received', 'amount_received_in_round', 'monthly_amount_subscribed', 'defer_clr_to',
         'deploy_tx_id', 'cancel_tx_id', 'admin_profile', 'token_symbol',
         'token_address', 'contract_address', 'contract_version', 'network', 'required_gas_price', 'logo_svg_asset',
@@ -123,7 +123,7 @@ class GrantAdmin(GeneralAdmin):
         'team_member_list', 'clr_prediction_curve',
         'subscriptions_links', 'contributions_links', 'link',
         'migrated_to', 'view_count', 'in_active_clrs', 'stats_history',
-        'emails', 'is_grant_idle'
+        'emails', 'is_grant_idle', 'tag_eligibility_reason'
     ]
     list_display =['pk', 'sybil_score', 'weighted_risk_score', 'match_amount', 'positive_round_contributor_count', 'is_clr_eligible', 'title', 'active', 'link', 'hidden', 'migrated_to']
     raw_id_fields = ['admin_profile', 'twitter_verified_by']

app/grants/migrations/0145_grant_tag_eligibility_reason.py

@@ -0,0 +1,18 @@
+# Generated by Django 2.2.24 on 2022-05-10 03:58
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('grants', '0144_delete_matchpledge'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='grant',
+            name='tag_eligibility_reason',
+            field=models.TextField(blank=True, default='', help_text='Eligibility Tag Reasoning'),
+        ),
+    ]

app/grants/models/grant.py

@@ -585,6 +585,7 @@ class Meta:
     )
     categories = models.ManyToManyField('GrantCategory', blank=True) # TODO: REMOVE
     tags = models.ManyToManyField('GrantTag', blank=True)
+    tag_eligibility_reason = models.TextField(default='', blank=True, help_text=_('Eligibility Tag Reasoning'))
     twitter_handle_1 = models.CharField(default='', max_length=255, help_text=_('Grants twitter handle'), blank=True)
     twitter_handle_2 = models.CharField(default='', max_length=255, help_text=_('Grants twitter handle'), blank=True)
     twitter_handle_1_follower_count = models.PositiveIntegerField(blank=True, default=0)

app/grants/templates/grants/_new.html

@@ -71,7 +71,10 @@
                     <span class="font-smaller-2 py-1 font-weight-normal badge badge-greylight ml-2">required</span>
 
                     <p class="text-muted mb-0">
-                      Tags are used for your grant's discoverability and eligibility for matching rounds. Eligibility tags are subject to review by the matching round owner and may be removed at any time for any reason.
+                      Selecting eligibility tags enters your grant for consideration for that specific matching round.<br>
+                      Your grant is then subject to review by the matching round owner and may be removed from that round at any time for any reason.<br>
+                      Discoverability tags are used for finding similar grants in the <a href="https://gitcoin.co/grants/explorer/" target="_blank">Grant Explorer.</a><br>
+                      To learn more about grants, click <a href="https://support.gitcoin.co/gitcoin-grants/what-is-a-grant" target="_blank">here</a>
                     </p>
                     <p class="mt-0 mb-2">
                       <a target="_blank" href="https://support.gitcoin.co/kb/article/134-learn-more-about-matching-rounds/" rel="noopener noreferrer">Learn more about matching rounds.</a>
@@ -96,6 +99,26 @@
                     </div>
                   </div>
 
+                  <!-- Tag Eligibility Reason -->
+                  <div class="mb-4">
+                    <label class="font-subheader font-weight-light letter-spacing">Eligibility Tag Reasoning</label>
+                    <span class="font-smaller-2 py-1 font-weight-normal badge badge-greylight ml-2">required</span>
+
+                    <p class="text-muted mb-2">
+                      For each eligibility tag you selected above, please provide a reason why your grant will benefit the respective ecosystem
+                    </p>
+
+                    <textarea 
+                      id="tag_eligibility_reason" v-model="form.tag_eligibility_reason" name="tag_eligibility_reason"
+                      class="form__input form__input-lg" cols="50" rows="3">
+                    </textarea>
+
+
+                    <div class="text-danger" v-if="errors.tag_eligibility_reason">
+                      [[errors.tag_eligibility_reason]]
+                    </div>
+                  </div>
+
                   <!-- External Funding -->
                   <div class="mb-4">
                     <label class="font-subheader font-weight-light letter-spacing">Project Stage</label>

app/grants/tests/views/test_grant_new_routes.py

@@ -236,6 +236,7 @@ def test_creates_new_grant_when_required_fields_submitted(self, django_user_mode
             'admin_address': '0xB81C935D01e734b3D8bb233F5c4E1D72DBC30f6c',
             'team_members[]': '',
             'tags[]': '',
+            'tag_eligibility_reason': '',
         }
 
         client = Client(HTTP_USER_AGENT='chrome')

app/grants/views.py

@@ -3587,7 +3587,8 @@ def post(self, request):
             'region': request.POST.get('region', None),
             'clr_prediction_curve': [[0.0, 0.0, 0.0] for x in range(0, 6)],
             'grant_type': GrantType.objects.get(name=grant_type),
-            'has_external_funding': has_external_funding
+            'has_external_funding': has_external_funding,
+            'tag_eligibility_reason': request.POST.get('tag_eligibility_reason', None)
         }
 
         grant = Grant.objects.create(**grant_kwargs)