[ProposePage] add short proposal explainers per type. (#1765)

* [proposePage] Add info text for the proposals

* fix lint

* minor wording improvement

* fmt

* english: replace meetup with gathering

* translations: improve location bounds

* translations: spend native uses the community treasury

* german: replace Community with Gemeinschaft

* german: Treasury -> Gemeinschaftsreserve

* german: fmt

* german: nominales Einkommen -> Grundeinkommen

* german: fix updateDemurrageExplainer translation that was deleted

Author: clangenb

app/lib/l10n/arb/app_de.arb

@@ -49,7 +49,7 @@
     "canUseFaucetOnlyWithCurrentAccount": "Du kannst das Faucet nur benutzen, wenn das angezeigte Konto das zurzeit gewählte Konto ist.",
     "changeYourPin": "PIN ändern",
     "checkEmailApp": "Keine Email-App installiert",
-    "chosenRightCommunity": "Die Daten sind für eine andere Community. Bitte wechsle die Community um Geld zu senden.",
+    "chosenRightCommunity": "Die Daten sind für eine andere Gemeinschaft. Bitte wechsle die Gemeinschaft um Geld zu senden.",
     "claim": "Einfordern",
     "claimRewardsNotificationBody": "Du hast dein Gemeinschaftseinkommen bereits erhalten.",
     "claimRewardsNotificationTitle": "Gemeinschaftseinkommen angefordert",
@@ -59,9 +59,9 @@
     "claimsSubmit": "Anträge einreichen",
     "closeGathering": "Versammlung schliessen",
     "communities": "Gemeinschaften",
-    "communityChoose": "Wähle eine Community:",
-    "communityDoChoose": "Community auswählen",
-    "communityNotSelected": "Keine Community ausgewählt, klicke auf das Icon",
+    "communityChoose": "Wähle eine Gemeinschaft:",
+    "communityDoChoose": "Gemeinschaft auswählen",
+    "communityNotSelected": "Keine Gemeinschaft ausgewählt, klicke auf das Icon",
     "confirmPin": "Bitte PIN bestätigen",
     "confirmThePayment": "3. Bestätige die Zahlung",
     "contactAddress": "Addresse",
@@ -199,14 +199,22 @@
     "pinHint": "Du wirst diese PIN benötigen um Transaktionen zu tätigen oder neue Konten hinzufügen.",
     "pinInfo": "PIN muss mindestens 4 Ziffern enthalten. Bei PIN-Verlust ist der Account nicht wiederherstellbar, ausser man hat ein Backup auf der Profilseite gemacht.",
     "pinSecure": "Sichere dein Konto mit einem PIN.",
-    "pleaseCommunityChoose": "Bitte wähle eine Community",
+    "pleaseCommunityChoose": "Bitte wähle eine Gemeinschaft",
     "pleaseConfirmYourNewPin": "Bestätige neue PIN",
     "preview": "Vorschau",
     "print": "Drucken",
     "proposal": "Vorschlag",
     "proposalAye": "Aye",
     "proposalNay": "Nay",
     "proposalNew": "Neuer Vorschlag",
+    "proposalExplainerAddLocation": "Dieser Vorschlag schlägt einen neuen Treffpunkt für deine Gemeinschaft vor. Achte darauf, dass er mindestens 100 Meter entfernt und nicht weiter als 1 Kilometer von bestehenden Treffpunkten liegt.",
+    "proposalExplainerRemoveLocation": "Dieser Vorschlag schlägt vor, einen bestehenden Treffpunkt deiner Gemeinschaft zu entfernen.",
+    "proposalExplainerUpdateDemurrage": "Dieser Vorschlag legt eine neue monatliche Demurrage für die Lokalwährung fest.",
+    "proposalExplainerUpdateNominalIncome": "Dieser Vorschlag bestimmt ein neues Grundeinkommen pro Versammlungszyklus für deine Gemeinschaft.",
+    "proposalExplainerSetInactivityTimeout": "Dieser Vorschlag setzt eine neue globale Inaktivitätsfrist fest. Falls eine Gemeinschaft über die vorgeschriebene Anzahl an VersammlungsZyklen keine Treffen abhält, wird sie gelöscht.",
+    "proposalExplainerPetition": "Dieser Vorschlag dient als Petition – entweder global oder innerhalb deiner Gemeinschaft. Er hat keine direkte Wirkung auf der Blockchain, signalisiert jedoch ein Anliegen, auf das die Gemeinschaft reagieren kann.",
+    "proposalExplainerSpendNative": "Dieser Vorschlag schlägt vor, KSM aus der Gemeinschaftsreserve für einen Begünstigten auszugeben, entweder durch eine globale oder Gemeinschaftsabstimmung. Diese Mittel können zur Belohnung von Beiträgen oder zur Unterstützung von Gemeinschaftsprojekten verwendet werden.",
+    "proposalExplainerIssueSwapNativeOption": "Dieser Vorschlag erlaubt es einem Begünstigten, Lokalwährung zu einem festgelegten Wechselkurs gegen KSM einzutauschen, bis zu einem festgelegten KSM-Limit. Der Begünstigte könnte ein lokales Unternehmen sein, das Lokalwährung akzeptiert und möglicherweise einen Überschuss angesammelt hat.",
     "proposalType": "Vorschlagstyp",
     "proposalTypeAddLocation": "Standort hinzufügen",
     "proposalTypeRemoveLocation": "Standort entfernen",
@@ -223,7 +231,7 @@
     "proposalFieldLongitude": "Längengrad",
     "proposalFieldDemurragePerMonth": "Demurrage (% / Monat)",
     "proposalFieldNominalIncome": "Grundeinkommen",
-    "proposalFieldInactivityTimeoutCycles": "Inaktivitätszeitlimit (Meetup Cycles)",
+    "proposalFieldInactivityTimeoutCycles": "Inaktivitätszeitlimit (Versammlungszyklen)",
     "proposalFieldPetitionText": "Petitionstext",
     "proposalFieldAmount": "Betrag",
     "proposalFieldBeneficiary": "Begünstigter",
@@ -362,7 +370,7 @@
     "yourBalanceFor": "Dein Kontostand, {accountName}",
     "incomingConfirmed": "Empfang von {amount} {cidSymbol} für {accountName} bestätigt",
     "voucherDifferentNetworkAndCommunity": "Der Gutschein ist für ein anderes Netzwerk. Willst du zu {network} und {community} wechseln? Du kannst das Netzwerk zurückändern under Profil > Developer mode.",
-    "voucherDifferentCommunity": "Der Gutschein ist für eine andere Community. Willst du zu {community} wechseln?",
+    "voucherDifferentCommunity": "Der Gutschein ist für eine andere Gemeinschaft. Willst du zu {community} wechseln?",
     "doYouWantToRedeemThisVoucher": "Willst du diesen Gutschein für {accountName} einlösen?",
     "claimsSubmitN": "{count} Anträge einreichen",
     "claimsScanned": "Du hast {amount} Anträge gescannt",
@@ -490,7 +498,7 @@
             }
         }
     },
-    "proposalSpendNative": "{cid} Kasse soll {amount} KSM an {beneficiary} senden",
+    "proposalSpendNative": "{cid} Die Gemeinschaftsreserve soll {amount} KSM an {beneficiary} senden",
     "@proposalSpendNative": {
         "placeholders": {
             "cid": {

app/lib/l10n/arb/app_en.arb

@@ -57,7 +57,7 @@
     "claimsScannedDecodeFailed": "Could not decode scanned claim. The other party needs to update the App.",
     "claimsScannedNew": "Scanned new claim",
     "claimsSubmit": "Submit claims",
-    "closeGathering": "Close meetup",
+    "closeGathering": "Close gathering",
     "communities": "Communities",
     "communityChoose": "Choose community:",
     "communityDoChoose": "Choose community",
@@ -153,7 +153,7 @@
     "loading": "Loading...",
     "meetingPoint": "Meeting Point",
     "meetupClaimantEqualToSelf": "Error: Claimant is equal to self. Claim is not stored.",
-    "meetupClaimantInvalid": "This claimant is not part of the meetup. Claim is not stored.",
+    "meetupClaimantInvalid": "This claimant is not part of the gathering. Claim is not stored.",
     "meetupLocation": "Gathering location",
     "meetupIndex": "Gathering Number: {index}",
     "meetupIndexPopupExplanation": "Use the gathering number to find your real gathering location. The community leader is responsible in your community for specifying the gathering locations. The real location could be slightly different from the one displayed here.",
@@ -207,6 +207,14 @@
     "proposalAye": "Aye",
     "proposalNay": "Nay",
     "proposalNew": "New Proposal",
+    "proposalExplainerAddLocation": "This proposal suggests a new gathering location for your community. Make sure it’s at least 100m away and no more than 1km from existing locations.",
+    "proposalExplainerRemoveLocation": "This proposal suggests to remove an existing gathering location for your community.",
+    "proposalExplainerUpdateDemurrage": "This proposal suggest a new monthly demurrage for your community token.",
+    "proposalExplainerUpdateNominalIncome": "This proposal suggests a new nominal income in the gathering cycles for your community.",
+    "proposalExplainerSetInactivityTimeout": "This proposal suggests a new global inactivity timeout. If a community has not been performing gatherings for the suggested number of gathering cycles, the community will be deleted.",
+    "proposalExplainerPetition": "This proposal serves as a petition, either globally or within your community. While it has no direct on-chain effect, it signals intent, allowing the community to recognize and act upon it.",
+    "proposalExplainerSpendNative": "This proposal suggests spending KSM for a beneficiary from the community treasury, either through a global or community vote. These funds can reward community contributions or support community initiatives.",
+    "proposalExplainerIssueSwapNativeOption": "This proposal allows the beneficiary to exchange community tokens for KSM at a defined rate, up to a set KSM limit. The beneficiary might be a local business that accepts community tokens and may accumulate a surplus.",
     "proposalType": "Proposal Type",
     "proposalTypeAddLocation": "Add location",
     "proposalTypeRemoveLocation": "Remove location",
@@ -223,7 +231,7 @@
     "proposalFieldLongitude": "Longitude",
     "proposalFieldDemurragePerMonth": "Demurrage (% / month)",
     "proposalFieldNominalIncome": "Nominal Income",
-    "proposalFieldInactivityTimeoutCycles": "Inactivity Timeout (meetup cycles)",
+    "proposalFieldInactivityTimeoutCycles": "Inactivity Timeout (gathering cycles)",
     "proposalFieldPetitionText": "Petition Text",
     "proposalFieldAmount": "Amount",
     "proposalFieldBeneficiary": "Beneficiary",

app/lib/l10n/arb/app_fr.arb

@@ -207,6 +207,14 @@
     "proposalAye": "Aye",
     "proposalNay": "Nay",
     "proposalNew": "Nouvelle Proposition",
+    "proposalExplainerAddLocation": "Cette proposition suggère un nouveau lieu de rencontre pour votre communauté. Assurez-vous qu'il soit situé à au moins 100 mètres et à pas plus de 1 kilomètre des lieux de rencontre existants.",
+    "proposalExplainerRemoveLocation": "Cette proposition suggère de supprimer un lieu de rencontre existant pour votre communauté.",
+    "proposalExplainerUpdateDemurrage": "Cette proposition suggère un nouveau taux de démurrage mensuel pour le jeton de votre communauté.",
+    "proposalExplainerUpdateNominalIncome": "Cette proposition suggère un nouveau revenu nominal dans les cycles de rencontre pour votre communauté.",
+    "proposalExplainerSetInactivityTimeout": "Cette proposition suggère un nouveau délai global d'inactivité. Si une communauté n'organise pas de rencontres pendant le nombre de cycles suggéré, elle sera supprimée.",
+    "proposalExplainerPetition": "Cette proposition sert de pétition, soit au niveau global, soit au sein de votre communauté. Bien qu'elle n'ait pas d'effet direct sur la blockchain, elle signale une intention permettant à la communauté de la reconnaître et d'y répondre.",
+    "proposalExplainerSpendNative": "Cette proposition suggère de dépenser des KSM pour un bénéficiaire provenant du trésor de la communauté, soit par un vote global, soit par un vote de la communauté. Ces fonds peuvent récompenser les contributions à la communauté ou soutenir des initiatives communautaires.",
+    "proposalExplainerIssueSwapNativeOption": "Cette proposition permet au bénéficiaire d'échanger des jetons communautaires contre des KSM à un taux défini, jusqu'à une limite de KSM. Le bénéficiaire pourrait être une entreprise locale acceptant les jetons communautaires et accumulant un surplus.",
     "proposalType": "Type de proposition",
     "proposalTypeAddLocation": "Ajouter un lieu",
     "proposalTypeRemoveLocation": "Retrancher un lieu",

app/lib/l10n/arb/app_ru.arb

@@ -207,6 +207,14 @@
     "proposalAye": "Aye",
     "proposalNay": "Nay",
     "proposalNew": "новое предложение",
+    "proposalExplainerAddLocation": "Это предложение предлагает новое место встречи для вашего сообщества. Убедитесь, что оно находится не менее чем в 100 метрах и не более чем в 1 километре от существующих мест встреч.",
+    "proposalExplainerRemoveLocation": "Это предложение предлагает удалить существующее место встречи для вашего сообщества.",
+    "proposalExplainerUpdateDemurrage": "Это предложение предлагает новый ежемесячный демерредж для токена сообщества.",
+    "proposalExplainerUpdateNominalIncome": "Это предложение предлагает новый номинальный доход в циклах встреч для вашего сообщества.",
+    "proposalExplainerSetInactivityTimeout": "Это предложение предлагает новый глобальный тайм-аут неактивности. Если сообщество не проводит встречи в течение предложенного количества циклов, оно будет удалено.",
+    "proposalExplainerPetition": "Это предложение служит петицией, либо на глобальном уровне, либо в вашем сообществе. Хотя оно не имеет прямого влияния на блокчейн, оно выражает намерение, позволяя сообществу его распознать и отреагировать.",
+    "proposalExplainerSpendNative": "Это предложение предлагает потратить KSM для получателя из казны сообщества, либо через глобальное, либо через голосование внутри сообщества. Эти средства могут быть использованы для вознаграждения вкладов в сообщество или поддержки инициатив сообщества.",
+    "proposalExplainerIssueSwapNativeOption": "Это предложение позволяет бенефициару обменивать токены сообщества на KSM по установленному курсу, вплоть до определенного лимита KSM. Бенефициаром может быть местный бизнес, принимающий токены сообщества и накапливающий их в избытке.",
     "proposalType": "Тип предложения",
     "proposalTypeAddLocation": "Добавить местоположение",
     "proposalTypeRemoveLocation": "Удалить местоположение",

app/lib/l10n/arb/app_sw.arb

@@ -207,6 +207,14 @@
     "proposalAye": "Aye",
     "proposalNay": "Nay",
     "proposalNew": "Mapendekezo mapya",
+    "proposalExplainerAddLocation": "Pendekezo hili linapendekeza eneo jipya la mkutano kwa jamii yako. Hakikisha kuwa liko angalau mita 100 kutoka kwa maeneo ya mikutano yaliyopo, na si zaidi ya kilomita 1.",
+    "proposalExplainerRemoveLocation": "Pendekezo hili linapendekeza kuondoa eneo la mikutano lililopo kwa jamii yako.",
+    "proposalExplainerUpdateDemurrage": "Pendekezo hili linapendekeza kiwango kipya cha demuraji ya kila mwezi kwa tokeni ya jamii yako.",
+    "proposalExplainerUpdateNominalIncome": "Pendekezo hili linapendekeza mapato mapya ya kawaida katika mizunguko ya mikutano kwa jamii yako.",
+    "proposalExplainerSetInactivityTimeout": "Pendekezo hili linapendekeza muda mpya wa kimataifa wa kutokufanya kazi. Ikiwa jamii haitafanya mikutano kwa idadi iliyopendekezwa ya mizunguko, itafutwa.",
+    "proposalExplainerPetition": "Pendekezo hili linatumika kama ombi, iwe kimataifa au ndani ya jamii yako. Ingawa halina athari ya moja kwa moja kwenye mnyororo wa vizuizi, linaonyesha nia, kuruhusu jamii kuitambua na kuchukua hatua.",
+    "proposalExplainerSpendNative": "Pendekezo hili linapendekeza kutumia KSM kwa faida ya mfaidi kutoka hazina ya jamii, ama kupitia kura za kimataifa au za jamii. Fedha hizi zinaweza kutumika kureward michango ya jamii au kusaidia mipango ya jamii.",
+    "proposalExplainerIssueSwapNativeOption": "Pendekezo hili linamruhusu mnufaika kubadilisha tokeni za jamii kwa KSM kwa kiwango kilichowekwa, hadi kikomo cha KSM kilichowekwa. Mnufaika anaweza kuwa biashara ya ndani inayokubali tokeni za jamii na inaweza kuwa imekusanya ziada.",
     "proposalType": "Aina ya pendekezo",
     "proposalTypeAddLocation": "Ongeza eneo",
     "proposalTypeRemoveLocation": "Ondoa eneo",

app/lib/page-encointer/democracy/proposal_page/propose_page.dart

@@ -10,10 +10,12 @@ import 'package:encointer_wallet/service/tx/lib/src/submit_to_inner.dart';
 import 'package:encointer_wallet/service/tx/lib/tx.dart';
 import 'package:encointer_wallet/store/account/types/account_data.dart';
 import 'package:encointer_wallet/store/app.dart';
+import 'package:encointer_wallet/theme/custom/typography/typography_theme.dart';
 import 'package:ew_primitives/ew_primitives.dart';
 import 'package:flutter/material.dart';
 import 'package:encointer_wallet/l10n/l10.dart';
 import 'package:flutter/services.dart';
+import 'package:iconsax/iconsax.dart';
 import 'package:provider/provider.dart';
 
 import 'package:ew_polkadart/ew_polkadart.dart'
@@ -167,6 +169,8 @@ class _ProposePageState extends State<ProposePage> {
 
                 // Dynamic Fields Based on Selected Proposal Action
                 _buildDynamicFields(context),
+                const SizedBox(height: 10),
+                _getProposalExplainer(context),
 
                 // Submit Button
                 const Spacer(),
@@ -194,6 +198,47 @@ class _ProposePageState extends State<ProposePage> {
     );
   }
 
+  /// Dynamically generates form fields based on selected proposal type
+  Widget _getProposalExplainer(BuildContext context) {
+    final theme = context.textTheme.bodyMedium;
+    return Card(
+      child: Padding(
+        padding: const EdgeInsets.all(8),
+        child: Column(
+          children: [
+            const Padding(
+              padding: EdgeInsets.all(4),
+              child: Icon(Iconsax.info_circle),
+            ),
+            Text(_explainerText(), style: theme),
+          ],
+        ),
+      ),
+    );
+  }
+
+  String _explainerText() {
+    final l10n = context.l10n;
+    switch (selectedAction) {
+      case ProposalActionIdentifier.addLocation:
+        return l10n.proposalExplainerAddLocation;
+      case ProposalActionIdentifier.removeLocation:
+        return l10n.proposalExplainerRemoveLocation;
+      case ProposalActionIdentifier.updateDemurrage:
+        return l10n.proposalExplainerUpdateDemurrage;
+      case ProposalActionIdentifier.updateNominalIncome:
+        return l10n.proposalExplainerUpdateNominalIncome;
+      case ProposalActionIdentifier.setInactivityTimeout:
+        return l10n.proposalExplainerSetInactivityTimeout;
+      case ProposalActionIdentifier.petition:
+        return l10n.proposalExplainerPetition;
+      case ProposalActionIdentifier.spendNative:
+        return l10n.proposalExplainerSpendNative;
+      case ProposalActionIdentifier.issueSwapNativeOption:
+        return l10n.proposalExplainerIssueSwapNativeOption;
+    }
+  }
+
   /// Dynamically generates form fields based on selected proposal type
   Widget _buildDynamicFields(BuildContext context) {
     switch (selectedAction) {

app/lib/page-encointer/democracy/widgets/update_proposal_button.dart

@@ -87,7 +87,7 @@ class _UpdateProposalButtonState extends State<UpdateProposalButton> {
       store.account.getKeyringAccount(store.account.currentAccountPubKey!),
       widget.proposalId,
       txPaymentAsset: store.encointer.getTxPaymentAsset(store.encointer.chosenCid),
-      onError: (error) => Log.p('[updateProposal] error updating the proposal: ${error}'),
+      onError: (error) => Log.p('[updateProposal] error updating the proposal: $error'),
     );
 
     setState(() {});