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 |
| Add payment | Yes | Yes | Yes |
| Apply discount (with reason) | Yes | Yes | Yes |
| Mark AUCTION status | Yes | Yes | Yes |
| View audit logs | Yes (all branches) | Yes (own branch) | No |
| Create or delete currencies | Yes | No | No |
| Sync or add gold prices | Yes | Yes | Yes |
| Configure risk threshold | Yes | Yes (own branch) | No |
| View reporting scope | All branches including cross-branch settlements | Own branch reports | Limited operational reports |
Financial Rules You Must Follow
- Interest is simple interest only. No compounding.
- 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 payment cannot close a transaction from a non-owning branch.
- Gold release is blocked when released gold value exceeds outstanding principal.
- Use a single gold valuation formula in all financial workflows: value = net weight x (purity / 100) x 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.