A mobile-first, offline-capable Progressive Web App that lets India Post field staff (Sub Postmasters, Postal Assistants, GDS/BPMs, Direct Agents) quote Postal Life Insurance (PLI) and Rural Postal Life Insurance (RPLI) policies in seconds – at the counter or in the village.
- 12 schemes: Suraksha, Santosh, Suvidha, Sumangal, Yugal Suraksha, Bal Jeevan Bima and their Gram (RPLI) counterparts plus Gram Priya.
- Premium (1st year vs renewal, with GST), bonus, maturity, money-back milestones, ROI / IRR, life cover, indicative loan & surrender values, year-wise cashflow table.
- One-tap WhatsApp pitch (Hindi / English) and a branded PDF quotation.
- Late-fee (default fee) calculator and eligibility checker.
- Full English ⇄ Hindi UI toggle, India Post colour scheme, installable PWA that works with zero connectivity after the first load.
| Layer | Choice |
|---|---|
| Framework | React 19 + TypeScript on Vite 8 |
| Styling | Tailwind CSS 3, shadcn-style components on Radix primitives, Lucide icons |
| State | Plain useState / useMemo – every keystroke recalculates synchronously (0 ms latency) |
jsPDF + html2canvas (lazy-loaded chunk) |
|
| Offline | vite-plugin-pwa (Workbox, precache-everything, auto-update) |
| Tests | Vitest (calculation engine) |
Developed by: Rahul Ranjan, Postal Assistant, India Post, Bokaro Steel City, Jharkhand.
Live app: https://rahulranjan-dev-py.github.io/DakSetu/ – every push to main
builds the site and publishes it to the gh-pages branch via .github/workflows/deploy.yml.
(If the site ever shows 404, open Settings → Pages and select the gh-pages branch as the source.)
npm install
npm run dev # http://localhost:5173
npm run build # production build + service worker in dist/
npm run preview # serve dist/ locally
npm test # engine unit tests
npm run typecheckDeploy dist/ to any static host (GitHub Pages, Netlify, an internal IIS/Apache box). The app must
be served over HTTPS (or localhost) for the service worker and "Install app" prompt to work.
When hosting under a sub-path, build with VITE_BASE=/sub-path/ npm run build; the GitHub Pages
workflow does this automatically.
src/
domain/ Pure TypeScript – no React
actuarial/ Mortality law, valuation assumptions, benefit builders
rates/
premium-tables.json Generated monthly premium per ₹1,000 SA (age × term)
rate-overrides.ts Drop official chart values here to override any cell
index.ts Rate lookup (table → override → live formula fallback)
catalog.ts Plan definitions: limits, bonus rates, terms, money-back schedules
config.ts GST, rebates, payment modes, loan %, late-fee rules
engine.ts calculate(): premium, GST, bonus, milestones, IRR, loan schedule
age.ts / fine.ts / eligibility.ts / format.ts
engine.test.ts
i18n/ en.ts, hi.ts dictionaries + <I18nProvider>
features/
calculator/ Plan picker, inputs panel, results dashboard & cards
pitch/ WhatsApp message builder, PDF export, printable QuoteSheet
tools/ FineCalculator, EligibilityChecker
agent/ Agent profile (persisted in localStorage)
components/ui/ Button, Card, Input, Slider, Tabs, Switch, Dialog, Select, Segmented…
components/layout/ Header, BottomNav, PWA banners
scripts/
generate-rates.ts Rebuilds premium-tables.json from the actuarial model
generate-icons.mjs Renders public/favicon.svg → PWA PNG icons
| Rule | Where |
|---|---|
| Age next birthday: entered directly (as in the Dak Sewa app) or derived from DOB | domain/age.ts, features/calculator/state.ts |
| Entry age / SA limits per plan, term-specific caps (Sumangal 15y ≤ 45, 20y ≤ 40) | domain/catalog.ts, engine.validate() |
| High-SA rebate: ₹1/month per ₹20,000 SA, scaled by mode (SA ₹5.1L → ₹25, ₹7L → ₹35) | domain/config.ts |
| Modal premiums as quoted by Dak Sewa: PLI = monthly × 3/6/12 less ≈0.2 % / 1.45 % / 2.95 %; RPLI = monthly × 3/6/12 less a flat ₹0.15 / ₹0.55 / ₹2.05 per ₹1,000 SA; then minus SA rebate × instalments | domain/config.ts, engine.buildPremium() |
| GST: NIL since 22 Sep 2025 (CBIC Notification 16/2025); legacy 4.5 % / 2.25 % kept in config | domain/config.ts |
| Terminal bonus ₹20 per ₹10,000 SA, max ₹1,000, on Endowment policies of 20+ years, quoted as an addition to the maturity amount | engine.terminalBonusFor() |
| Simple reversionary bonus = SA/1000 × rate × term (split at conversion for Suvidha) | engine.ts |
| Money-back schedules 20/20/20/40 (15y & 20y) and 20/20/60 (Gram Priya) | catalog.ts |
| Whole-life: premium ceasing at 55/58/60, bonus credited for the premium-paying years, SA + bonus paid at 80 or earlier death (official quotation basis) | engine.ts |
| Suvidha / Gram Suvidha entry age 19–50; money-back plans have no loan; children policies have no loan or surrender; PLI Bal Jeevan min SA ₹10,000 | domain/catalog.ts |
| Non-medical limits: PLI ₹2 lakh any age / ₹5 lakh up to 40; RPLI ₹1 lakh up to 35; money-back always medical | engine.nonMedicalLimit() |
| RPLI non-standard age proof: +5 % on the tabular premium (Dak Sewa tick option), entry age ≤ 45 | domain/config.ts, engine.buildPremium() |
| Loan after 3 yrs (EA/AEA/joint/child) or 4 yrs (WLA/CWLA), ≈ 90 % of surrender value | engine.ts |
| Default fee ₹1 per ₹100 premium per month; lapse after 6 / 12 unpaid months; revival with 12 % compound interest on arrears, only within 5 years of first default | domain/fine.ts |
| PLI eligibility categories (incl. GDS, contract, co-operative, private-school staff); RPLI via rural residence or an operative POSB / scheduled-bank savings account (14 Aug 2026 order); age 19–55 (45 without standard age proof) | domain/eligibility.ts |
India Post publishes premium charts per ₹1,000 sum assured by age next birthday and term. The
tables in src/domain/rates/premium-tables.json are a calibrated actuarial baseline built from a
Gompertz–Makeham mortality law and the plans' benefit structures (see
src/domain/actuarial/). They reproduce the shape and level of the official charts, but the
Directorate revises rates periodically, so:
- Put exact published figures in
src/domain/rates/rate-overrides.ts– they take precedence cell-by-cell, e.g.'PLI:EA:60:30': 2.60. - Or adjust the assumptions and regenerate everything with
npm run rates:generate.
Every screen and PDF carries an "indicative quotation" disclaimer for this reason.
All strings live in src/i18n/en.ts (typed keys) and src/i18n/hi.ts. The chosen language is
remembered on the device; the WhatsApp/PDF language can be picked independently per quote.
The service worker precaches the whole build (including the PDF chunk and icons). After the first visit the app loads and calculates with no network. When a new version is deployed an "Update now" banner appears.