WikiDeal Funding MVP — Technical Specifications

WikiDeal (a project of the Ynternet.org Foundation) raises donations to fund its Prototype 1. Donors and Early Supporters receive Rewards, which are progressively compensated in cash by the income of WikiDeal subscriptions. The MVP is the minimal working system that supports this loop:

1. Donation payments by credit card (Stripe) or bank transfer, in CHF.
2. Reward activation — automatic at card payment time, manual (operator registry) for bank transfers and Early Supporters.
3. Subscriptions — CHF 1/month or CHF 10/year (annual recommended).
4. Subscription income distribution to holders of already-activated Rewards, visible on each user's dashboard.
5. Accounts with single sign-on shared with the MediaWiki at wikideal.net.

Outgoing payouts to users' bank accounts are not part of the MVP (Phase 2, see §4).

• Donation form (mockup: funding-donation-form.html) with amount input in CHF.
• Minimum CHF 250, maximum CHF 5'000 per card payment. Above the card ceiling, the UI directs the donor to bank transfer (F3).
• Payment processed by Stripe (Checkout or Payment Element), currency CHF.
• Stripe processing fees are added on top and paid by the donor (the Foundation receives the full donation amount). The fee amount is displayed before confirmation.
• On successful payment: e-mail receipt / donation certificate (mockup: funding-certificate.html) and immediate Reward activation (F2).

• Fixed multiplier ×100: a donation of CHF 1'000 attributes and activates 100'000 Rewards. No bonding curve in the MVP (the multiplier is a configuration variable, to prepare Phase 2).
• Activation happens synchronously in the payment confirmation flow (webhook-driven: checkout.session.completed or equivalent).
• The new balance is immediately visible on the donor's dashboard (F7).

• For amounts above the card ceiling (and as an option for any donor), the donation is made by bank transfer to the Ynternet.org Foundation account. The system displays the bank details and a payment reference.
• No bank-API integration in the MVP: the Foundation secretariat checks the account, then activates the Rewards manually within 7 days using the operator registry (F5).
• The donor sees a “pending activation” state on their dashboard until activation.

• Two plans, CHF only: CHF 1/month or CHF 10/year. The UI clearly recommends the annual plan (mockup: funding-signup.html).
• Recurring billing via Stripe Billing (subscriptions), card payment.
• Subscribers receive access to WikiDeal member benefits (list referenced separately); subscriptions do not create Rewards.
• Standard lifecycle: subscribe, renew, cancel, failed-payment dunning (Stripe defaults acceptable).

• Web interface for the Foundation secretariat (mockup: funding-validation.html).
• An online table associating an e-mail address → attributed Reward amount, with an Activate action per row. Used for:
  • Early Supporters: Rewards attributed manually, activated by the secretariat after the onboarding webinar;
  • Bank-transfer donors: activation within 7 days after the transfer arrives on the Foundation account.
• Every attribution/activation is logged (who, what, when — simple action log as shown in the mockup).
• Access restricted to authenticated operator accounts.

• Each subscription payment received is distributed to holders of already-activated Rewards, as cash-out balance credit:
• 25% to donors (holders whose Rewards come from a donation);
• 25% to Early Supporters;
• the remaining share is retained by the Foundation for project operations TO CONFIRM.
• Within each group, the amount is shared between all activated-Reward holders (allocation key pro-rata of activated Rewards TO CONFIRM).
• As cash is credited, the corresponding Rewards are progressively consumed: the dashboard shows attributed Rewards decreasing in favour of the cash-out balance. The exact Reward-to-CHF consumption parameter is a configuration variable TO CONFIRM.
• Distribution may run as a periodic batch job (e.g. daily) rather than per-transaction, provided dashboard figures stay consistent.
• Full auditability: every distribution event is stored (source payment, date, per-holder credit).

• Authenticated dashboard per the mockup funding-dashboard-proposal-c.html (public view: funding-dashboard-unauth.html).
• Displays at minimum: attributed (promised) Rewards not yet compensated · activated status · cash-out balance in CHF (obtained) · history of distributions received.
• The cash-out balance accumulates freely; the UI states that no transfer is possible below CHF 100 and that bank payout will open in a later phase (mockup: funding-how-to-cash.html). No outgoing payment is implemented in the MVP.

• An account is required to hold Rewards, subscribe, and edit the wiki. Editing wikideal.net is never anonymous, but pseudonymous accounts are allowed: first name, last name and e-mail address are not exposed publicly.
• SSO approach: the existing MediaWiki (wikideal.net) acts as the identity provider — e.g. via the MediaWiki OAuth extension (or OpenID Connect equivalent) — and the funding dashboard authenticates against it. One account gives access to both wiki editing and the funding dashboard. This is the lowest-cost option and the preferred one; respondents may propose an equivalent-cost alternative with justification.
• Account creation flow per mockup funding-signup.html.

The following will be developed after the MVP, in a second stage. The MVP architecture should not block them, but no Phase-2 work is expected or paid within this envelope:

• Bonding curve: the fixed ×100 multiplier evolves along a defined curve (×100 → ×30, fixed algorithm).
• Funding Stabilizer: automatic mechanism adjusting distribution according to Foundation needs.
• Cash-out transfers: automatic or manual payout of the cash-out balance (≥ CHF 100) to the user's bank account, with user options.

Indicative only — respondents may propose their own schema, provided the auditability requirements hold.

An append-only ledger style for Reward and cash movements is strongly recommended (no destructive updates of balances).

• Currency: CHF everywhere. No EUR, no other currency, no crypto.
• Hosting: deployable on Ynternet.org Foundation infrastructure (Linux/nginx environment, same family as aidev.wikideal.net).
• Licensing: all delivered code under a free license (Free Licensing policy of the project).
• Privacy: pseudonymity supported; personal data (e-mail, name if given) never exposed publicly; data minimization; EU/Swiss data-protection compliance.
• Auditability: every money and Reward movement traceable and exportable (CSV at minimum).
• Transactional integrity: Stripe webhooks idempotent; no double activation or double credit.
• Languages: UI in English for the MVP; architecture must not block later French localization.
• E-mail: transactional e-mails for receipt/certificate, activation confirmation, subscription events.

Suggested option (not mandatory): Laravel + VueJS, matching the team's existing base (investment-dashboard repository serving aidev.wikideal.net) and the current developer's proposal. Respondents may propose another stack, with justification, provided it satisfies §6 (hostable on Foundation infrastructure, free license, maintainable).

1. Fixed price in CHF for the full MVP scope (§3), within the CHF 3'000 – 5'000 envelope. If the envelope cannot be met, state which requirements you propose to defer and the resulting price.
2. Delivery timeline (calendar weeks from kick-off).
3. Stack & architecture summary (1 page max), including the SSO approach for F8.
4. Included / excluded items, assumptions, and Stripe account prerequisites.
5. Maintenance: proposed conditions after delivery (optional).

The mockups below define the expected result. Latest versions, maintained at the Funding hub:

• 1A. Dashboard — public view
• 1B. Dashboard — authenticated cockpit
• 1C. Donation certificate (e-mail)
• 2. Registration & subscription
• 3. Donation form
• 4. Operator activation interface
• 5. How to cash
• 6. Donation agreement (FR)

1. Card / bank-transfer threshold: card payments capped at CHF 5'000; bank transfer mentioned from CHF 2'000 in one source. To confirm: is bank transfer required above CHF 5'000 and optional from CHF 2'000, or another rule?
2. Remaining share of subscription income (after 25% donors + 25% Early Supporters): confirmed as retained by the Foundation?
3. Allocation key within each group: pro-rata of activated Rewards, or another rule (e.g. partly FIFO)?
4. Reward consumption parameter: at which rate are Rewards consumed when cash is credited (dashboard left column decreasing)?
5. Subscriber benefits list: reference document to link from the signup page.

These points go in this tendency and are proposed as a basis of discussion; they will be settled before contract signature with the selected respondent.