User Documentation Home
Role-based user guidance for the Multi-Branch Gold Purchase and Interest Management System.
Purpose
This documentation explains how each role should use the system in daily operations.
It focuses on:
- Who can do what
- How to complete key tasks step by step
- What to watch for to avoid errors
Core Roles
- Head (System-wide oversight and controls)
- Branch Manager (Branch-level operations and supervision)
- Staff (Daily transaction and collection operations)
Quick Role Matrix
| Area | Head | Branch Manager | Staff |
|---|---|---|---|
| View all branches | Yes | No | No |
| User administration | Full access | View users and activate or deactivate STAFF in own branch | No |
| Create customer | Yes | Yes | Yes |
| Block customer | Yes | Yes | No |
| Set customer default annual rate | Yes | Yes | No |
| Change customer civil ID | Yes | No | No |
| Create transaction | Yes | Yes | Yes |
| Edit transaction after creation | Limited non-financial edits | Limited non-financial edits | No |
| Top-up (closure and re-issue) | Yes | Yes | Yes |
| Add payment | Yes | Yes | Yes |
| Payment reference number | Required for every posted payment (unique per loan) | Same | Same |
| Apply discount (with reason) | Yes | Yes | Yes |
| Mark AUCTION status | Yes | Yes | Yes |
| Payments while transaction is AUCTION | No (posting is blocked) | No | No |
| View audit logs | Yes (all branches) | Yes (own branch actors) | No |
| Product categories (gold item types) | Yes (create, edit, activate/deactivate, delete when unused) | No | No |
| Create or delete currencies | Yes | No | No |
| Sync or add gold prices | Yes | Yes | Yes |
| Configure risk threshold | Yes | Yes (own branch) | No |
| Global search | Yes | Yes | Yes |
| Customer advance payments (ledger) | Yes | Yes | Yes |
| View reporting scope | All branches including cross-branch settlements | Own branch reports + Excel export where available | Branch-scoped reports; head-office / system-wide settlement views Head-only |
| In-app notifications | Yes | Yes | Yes |
Financial Rules You Must Follow
- Interest is simple interest only. No compounding.
- Accrued interest on a payment is calculated by the system when you post—you cannot type in a substitute “accrued interest” on the real payment. (Screens may show a preview using sample numbers; posting is always authoritative.)
- If a payment does not fully cover interest, the remainder stays on the loan as carried unpaid interest until a later payment clears it.
- Payments always settle interest first, then principal.
- Head has full system access, including operational actions where needed.
- Customer civil ID updates are restricted to Head role only.
- For full closure in first month:
- Day 1 to 15: minimum 15-day interest
- Day 16 to 30: 30-day interest
- Internal precision is 3 decimals. Display and invoice values are rounded to 2 decimals.
- Cross-branch collection is allowed, but closing the loan from a non-owning branch is blocked—finish closure at the owning branch.
- If a customer pays more than the amount needed to clear interest and principal, the extra can be recorded as a customer advance (for later use on closure, top-up, or release—per workflow).
- Transactions in AUCTION status do not accept new payments until product policy defines an auction settlement flow.
- Gold release is blocked when released gold value exceeds outstanding principal.
- Use a single gold valuation formula in all financial workflows: value = net weight × (purity / 100) × daily gold rate.
How To Use These Docs
- Read the common prerequisites first.
- Open your role page to confirm your permissions.
- Follow your role workflows for operational tasks.
- Check edge cases when the normal flow does not apply.