# abhi-code15/paylog architecture

> Architecture diagram of the GitHub repository abhi-code15/paylog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhi-code15/paylog
- Repository: https://github.com/abhi-code15/paylog

## Overview

Paylog is a personal INR finance tracker with shared-bill splitting and UPI-assisted payments. Users sign in, record or review personal transactions, manage groups and friends, split shared expenses, and settle balances; reports and CSV exports support review. The React app routes these workflows through a credentialed API client to Express endpoints backed by PostgreSQL. Exact-paise arithmetic and debt simplification are internal domain services. Relationships for unsampled pages and endpoints are limited to documented capabilities or SOURCE INDEX references; dashed links indicate documented but unverified runtime wiring.

Main entry points: [`server/app.js`](https://github.com/abhi-code15/paylog/blob/main/server/app.js) (Express API), [`src/App.jsx`](https://github.com/abhi-code15/paylog/blob/main/src/App.jsx) (App routing), [`server/db/pool.js`](https://github.com/abhi-code15/paylog/blob/main/server/db/pool.js) (Database access), [`src/services/api.js`](https://github.com/abhi-code15/paylog/blob/main/src/services/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_landing["Landing and sign-in<br/>[LandingPage.jsx]"]
  node_authctx["Auth state<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_personal["Personal finance"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_transactions["Transactions"]
  node_expenses["Expense history<br/>[ExpensesPage.jsx]"]
  node_upi["UPI QR and outcome<br/>[QrScanner.jsx]"]
  node_reportsui["Reports and export<br/>[ReportsPage.jsx]"]
end

subgraph group_sharing["Shared expenses"]
  node_groupspage["Groups<br/>[GroupsPage.jsx]"]
  node_groupdetail["Group expenses"]
  node_sharedmodal["Shared expense entry"]
  node_friends["Friends<br/>[FriendsPage.jsx]"]
  node_settlementui["Settlement flow<br/>[SettleUpModal.jsx]"]
end

subgraph group_server["API and services"]
  node_express["Express API<br/>[app.js]"]
  node_authroutes["Authentication<br/>[auth.js]"]
  node_txroutes["Transaction routes<br/>[transactions.js]"]
  node_grouproutes["Group routes<br/>[groups.js]"]
  node_friendroutes["Friend routes<br/>[friends.js]"]
  node_settleroutes["Settlement routes<br/>[settlements.js]"]
  node_paymentroutes["UPI attempts<br/>[paymentAttempts.js]"]
  node_reportroutes["Reports and CSV<br/>[reports.js]"]
  node_dashboardroutes["Dashboard data<br/>[dashboard.js]"]
  node_money["Paise arithmetic<br/>[moneyService.js]"]
  node_debts["Debt simplifier<br/>[debtSimplifier.js]"]
  node_payment["UPI link service<br/>[paymentService.js]"]
end

subgraph group_data["Persistence"]
  node_dbpool["Database access<br/>[pool.js]"]
  node_postgres[("PostgreSQL")]
end

node_user(("User"))
node_upiapp(("UPI app"))

node_user -->|"uses"| node_app
node_app -->|"reads auth state"| node_authctx
node_app -->|"shows signed out"| node_landing
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_expenses
node_app -->|"routes to"| node_groupspage
node_app -->|"routes to"| node_groupdetail
node_app -->|"routes to"| node_friends
node_app -->|"routes to"| node_reportsui
node_landing -->|"authenticates"| node_authctx
node_authctx -->|"calls auth API"| node_api
node_dashboard -->|"loads overview"| node_api
node_expenses -->|"loads transactions"| node_api
node_transactions -->|"records expense"| node_api
node_transactions -->|"uses scanner"| node_upi
node_upi -.->|"launches payment"| node_upiapp
node_groupspage -.->|"loads groups"| node_api
node_groupdetail -->|"opens entry"| node_sharedmodal
node_groupdetail -->|"opens settlement"| node_settlementui
node_groupdetail -->|"loads group data"| node_api
node_friends -.->|"manages friends"| node_api
node_reportsui -->|"requests reports"| node_api
node_api -.->|"sends API requests"| node_express
node_express -->|"mounts routes"| node_authroutes
node_express -->|"mounts routes"| node_txroutes
node_express -->|"mounts routes"| node_grouproutes
node_express -->|"mounts routes"| node_friendroutes
node_express -->|"mounts routes"| node_settleroutes
node_express -->|"mounts routes"| node_paymentroutes
node_express -->|"mounts routes"| node_reportroutes
node_express -->|"mounts routes"| node_dashboardroutes
node_txroutes -->|"uses arithmetic"| node_money
node_grouproutes -->|"splits amounts"| node_money
node_grouproutes -->|"simplifies debts"| node_debts
node_dashboardroutes -->|"calculates totals"| node_money
node_dashboardroutes -->|"simplifies balances"| node_debts
node_paymentroutes -->|"builds payment data"| node_payment
node_authroutes -->|"queries"| node_dbpool
node_txroutes -->|"queries"| node_dbpool
node_grouproutes -->|"queries"| node_dbpool
node_friendroutes -->|"queries"| node_dbpool
node_paymentroutes -->|"queries"| node_dbpool
node_reportroutes -.->|"queries"| node_dbpool
node_settleroutes -.->|"queries"| node_dbpool
node_dashboardroutes -->|"queries"| node_dbpool
node_express -->|"configures sessions"| node_dbpool
node_dbpool -->|"queries database"| node_postgres

click node_app "https://github.com/abhi-code15/paylog/blob/main/src/App.jsx"
click node_landing "https://github.com/abhi-code15/paylog/blob/main/src/pages/LandingPage.jsx"
click node_authctx "https://github.com/abhi-code15/paylog/blob/main/src/context/AuthContext.jsx"
click node_api "https://github.com/abhi-code15/paylog/blob/main/src/services/api.js"
click node_dashboard "https://github.com/abhi-code15/paylog/blob/main/src/pages/DashboardPage.jsx"
click node_transactions "https://github.com/abhi-code15/paylog/blob/main/src/components/modals/AddTransactionModal.jsx"
click node_expenses "https://github.com/abhi-code15/paylog/blob/main/src/pages/ExpensesPage.jsx"
click node_upi "https://github.com/abhi-code15/paylog/blob/main/src/components/upi/QrScanner.jsx"
click node_groupspage "https://github.com/abhi-code15/paylog/blob/main/src/pages/GroupsPage.jsx"
click node_groupdetail "https://github.com/abhi-code15/paylog/blob/main/src/pages/GroupDetailsPage.jsx"
click node_sharedmodal "https://github.com/abhi-code15/paylog/blob/main/src/components/modals/AddSharedExpenseModal.jsx"
click node_friends "https://github.com/abhi-code15/paylog/blob/main/src/pages/FriendsPage.jsx"
click node_settlementui "https://github.com/abhi-code15/paylog/blob/main/src/components/modals/SettleUpModal.jsx"
click node_reportsui "https://github.com/abhi-code15/paylog/blob/main/src/pages/ReportsPage.jsx"
click node_express "https://github.com/abhi-code15/paylog/blob/main/server/app.js"
click node_authroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/auth.js"
click node_txroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/transactions.js"
click node_grouproutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/groups.js"
click node_friendroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/friends.js"
click node_settleroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/settlements.js"
click node_paymentroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/paymentAttempts.js"
click node_reportroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/reports.js"
click node_dashboardroutes "https://github.com/abhi-code15/paylog/blob/main/server/routes/dashboard.js"
click node_money "https://github.com/abhi-code15/paylog/blob/main/server/services/moneyService.js"
click node_debts "https://github.com/abhi-code15/paylog/blob/main/server/services/debtSimplifier.js"
click node_payment "https://github.com/abhi-code15/paylog/blob/main/server/services/paymentService.js"
click node_dbpool "https://github.com/abhi-code15/paylog/blob/main/server/db/pool.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_landing,node_authctx,node_api,node_user toneBlue
class node_dashboard,node_transactions,node_expenses,node_upi,node_reportsui toneAmber
class node_groupspage,node_groupdetail,node_sharedmodal,node_friends,node_settlementui toneMint
class node_express,node_authroutes,node_txroutes,node_grouproutes,node_friendroutes,node_settleroutes,node_paymentroutes,node_reportroutes,node_dashboardroutes,node_money,node_debts,node_payment toneRose
class node_dbpool,node_postgres,node_upiapp toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/abhi-code15/paylog/blob/main/src/App.jsx): `src/App.jsx`
- [Landing and sign-in](https://github.com/abhi-code15/paylog/blob/main/src/pages/LandingPage.jsx): `src/pages/LandingPage.jsx`
- [Auth state](https://github.com/abhi-code15/paylog/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [API client](https://github.com/abhi-code15/paylog/blob/main/src/services/api.js): `src/services/api.js`

### Personal finance

- [Dashboard](https://github.com/abhi-code15/paylog/blob/main/src/pages/DashboardPage.jsx): `src/pages/DashboardPage.jsx`
- [Transactions](https://github.com/abhi-code15/paylog/blob/main/src/components/modals/AddTransactionModal.jsx): `src/components/modals/AddTransactionModal.jsx`
- [Expense history](https://github.com/abhi-code15/paylog/blob/main/src/pages/ExpensesPage.jsx): `src/pages/ExpensesPage.jsx`
- [UPI QR and outcome](https://github.com/abhi-code15/paylog/blob/main/src/components/upi/QrScanner.jsx): `src/components/upi/QrScanner.jsx`
- [Reports and export](https://github.com/abhi-code15/paylog/blob/main/src/pages/ReportsPage.jsx): `src/pages/ReportsPage.jsx`

### Shared expenses

- [Groups](https://github.com/abhi-code15/paylog/blob/main/src/pages/GroupsPage.jsx): `src/pages/GroupsPage.jsx`
- [Group expenses](https://github.com/abhi-code15/paylog/blob/main/src/pages/GroupDetailsPage.jsx): `src/pages/GroupDetailsPage.jsx`
- [Shared expense entry](https://github.com/abhi-code15/paylog/blob/main/src/components/modals/AddSharedExpenseModal.jsx): `src/components/modals/AddSharedExpenseModal.jsx`
- [Friends](https://github.com/abhi-code15/paylog/blob/main/src/pages/FriendsPage.jsx): `src/pages/FriendsPage.jsx`
- [Settlement flow](https://github.com/abhi-code15/paylog/blob/main/src/components/modals/SettleUpModal.jsx): `src/components/modals/SettleUpModal.jsx`

### API and services

- [Express API](https://github.com/abhi-code15/paylog/blob/main/server/app.js): `server/app.js`
- [Authentication](https://github.com/abhi-code15/paylog/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Transaction routes](https://github.com/abhi-code15/paylog/blob/main/server/routes/transactions.js): `server/routes/transactions.js`
- [Group routes](https://github.com/abhi-code15/paylog/blob/main/server/routes/groups.js): `server/routes/groups.js`
- [Friend routes](https://github.com/abhi-code15/paylog/blob/main/server/routes/friends.js): `server/routes/friends.js`
- [Settlement routes](https://github.com/abhi-code15/paylog/blob/main/server/routes/settlements.js): `server/routes/settlements.js`
- [UPI attempts](https://github.com/abhi-code15/paylog/blob/main/server/routes/paymentAttempts.js): `server/routes/paymentAttempts.js`
- [Reports and CSV](https://github.com/abhi-code15/paylog/blob/main/server/routes/reports.js): `server/routes/reports.js`
- [Dashboard data](https://github.com/abhi-code15/paylog/blob/main/server/routes/dashboard.js): `server/routes/dashboard.js`
- [Paise arithmetic](https://github.com/abhi-code15/paylog/blob/main/server/services/moneyService.js): `server/services/moneyService.js`
- [Debt simplifier](https://github.com/abhi-code15/paylog/blob/main/server/services/debtSimplifier.js): `server/services/debtSimplifier.js`
- [UPI link service](https://github.com/abhi-code15/paylog/blob/main/server/services/paymentService.js): `server/services/paymentService.js`

### Persistence

- [Database access](https://github.com/abhi-code15/paylog/blob/main/server/db/pool.js): `server/db/pool.js`
- **PostgreSQL**

### Other components

- **User**
- **UPI app**

## Connections

- User → App routing: uses (evidence: `README.md`)
- App routing → Auth state: reads auth state (evidence: `src/App.jsx`)
- App routing → Landing and sign-in: shows signed out (evidence: `src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Expense history: routes to (evidence: `src/App.jsx`)
- App routing → Groups: routes to (evidence: `src/App.jsx`)
- App routing → Group expenses: routes to (evidence: `src/App.jsx`)
- App routing → Friends: routes to (evidence: `src/App.jsx`)
- App routing → Reports and export: routes to (evidence: `src/App.jsx`)
- Landing and sign-in → Auth state: authenticates (evidence: `src/pages/LandingPage.jsx`)
- Auth state → API client: calls auth API (evidence: `src/context/AuthContext.jsx`)
- Dashboard → API client: loads overview (evidence: `src/pages/DashboardPage.jsx`)
- Expense history → API client: loads transactions (evidence: `src/pages/ExpensesPage.jsx`)
- Transactions → API client: records expense (evidence: `src/components/modals/AddTransactionModal.jsx`)
- Transactions → UPI QR and outcome: uses scanner (evidence: `src/components/modals/AddTransactionModal.jsx`)
- UPI QR and outcome → UPI app: launches payment (evidence: `README.md`)
- Groups → API client: loads groups (evidence: `src/services/api.js`)
- Group expenses → Shared expense entry: opens entry (evidence: `src/pages/GroupDetailsPage.jsx`)
- Group expenses → Settlement flow: opens settlement (evidence: `src/pages/GroupDetailsPage.jsx`)
- Group expenses → API client: loads group data (evidence: `src/pages/GroupDetailsPage.jsx`)
- Friends → API client: manages friends (evidence: `src/services/api.js`)
- Reports and export → API client: requests reports (evidence: `src/pages/ReportsPage.jsx`)
- API client → Express API: sends API requests (evidence: `src/services/api.js`)
- Express API → Authentication: mounts routes (evidence: `server/app.js`)
- Express API → Transaction routes: mounts routes (evidence: `server/app.js`)
- Express API → Group routes: mounts routes (evidence: `server/app.js`)
- Express API → Friend routes: mounts routes (evidence: `server/app.js`)
- Express API → Settlement routes: mounts routes (evidence: `server/app.js`)
- Express API → UPI attempts: mounts routes (evidence: `server/app.js`)
- Express API → Reports and CSV: mounts routes (evidence: `server/app.js`)
- Express API → Dashboard data: mounts routes (evidence: `server/app.js`)
- Transaction routes → Paise arithmetic: uses arithmetic (evidence: `server/routes/transactions.js`)
- Group routes → Paise arithmetic: splits amounts (evidence: `server/routes/groups.js`)
- Group routes → Debt simplifier: simplifies debts (evidence: `server/routes/groups.js`)
- Dashboard data → Paise arithmetic: calculates totals (evidence: `server/routes/dashboard.js`)
- Dashboard data → Debt simplifier: simplifies balances (evidence: `server/routes/dashboard.js`)
- UPI attempts → UPI link service: builds payment data (evidence: `server/routes/paymentAttempts.js`)
- Authentication → Database access: queries (evidence: `server/routes/auth.js`)
- Transaction routes → Database access: queries (evidence: `server/routes/transactions.js`)
- Group routes → Database access: queries (evidence: `server/routes/groups.js`)
- Friend routes → Database access: queries (evidence: `server/routes/friends.js`)
- UPI attempts → Database access: queries (evidence: `server/routes/paymentAttempts.js`)
- Reports and CSV → Database access: queries
- Settlement routes → Database access: queries
- Dashboard data → Database access: queries (evidence: `server/routes/dashboard.js`)
- Express API → Database access: configures sessions (evidence: `server/app.js`)
- Database access → PostgreSQL: queries database (evidence: `server/db/pool.js`)
