MERN · Fintech·2023

Shareholder Management

MERN fintech for a Kuwait co-operative society — dynamic share appreciation, member portfolios, JWT security, and full audit trails.

GitHub
github.com/ibefehdi/Savings-Society-Frontend
Overview

This shareholder-and-savings platform serves a Kuwait government co-operative society that needs to track members, share holdings, contributions, and dividend accruals with the rigor finance and oversight teams expect from production software — not a spreadsheet that breaks under concurrent edits.

At the core is a dynamic share-appreciation algorithm that revalues holdings as transactions land. Balances are not vibes; they are derived from ledger events. An immutable audit trail across the system supports historical replay for audits, disputes, and "what was this member's position on date X?" questions.

Members get live portfolio views: holdings, contribution history, and dividends rendered with Chart.js so trends are visible without exporting to Excel first. That transparency reduces back-and-forth with staff for routine balance questions.

Staff workflows run under role-based access control with JWT sessions. Full-write audit logs make every privileged change attributable. Exportable reports feed management reviews, accounting closes, and government oversight without rebuilding numbers by hand.

The stack is MongoDB, Express, React, and Node.js with Redux on the client for predictable state around money-moving screens. Concurrent transactions had to stay correct while the UI remained usable for operators who are domain experts, not engineers.

Building fintech-adjacent software in Kuwait means respecting operational reality: bilingual stakeholders, formal reporting needs, and zero appetite for silent data drift. Architecture choices favored explicit ledgers, clear permissions, and demos stakeholders could validate against known cases.

If you are evaluating MERN for financial workflows, hiring for co-operative society systems, or comparing portfolio dashboards with real audit requirements, this project shows how correctness and usability can ship together instead of trading one for the other.

Features

Dynamic share appreciation

Per-transaction revaluation of holdings with historical replay so audits and disputes can reconstruct balances without guesswork.

Real-time portfolio

Live charts of holdings, contributions, and dividend history for each member — clarity without waiting on manual statements.

Secure transactions

Role-based access, JWT sessions, and full-write audit logs so privileged actions stay attributable for compliance reviews.

Reporting

Exportable reports for management, accounting, and government oversight that match the ledger instead of parallel spreadsheets.

Tech stack
MongoDBExpressReactNode.jsReduxJWTChart.js
Highlights
ReduxReal-timeAudit trails
Links