# Cashcard System – System Overview

## Purpose
A banking-grade Cashcard Issuer System capable of managing clients, accounts, cards, and ATM card printing, with future expansion to POS and ATM transaction switching.

## Technology Stack
- Laravel (Backend)
- Vue 3 + Inertia.js (Frontend)
- MySQL 8+
- Redis (Queues & caching)
- Sanctum (Auth)

## User Roles
- Super Admin
- Bank Admin
- Operations Officer
- Card Personalization Officer
- Auditor (read-only)

## Modules

### 1. User & Access Management
- Role-based access control
- Permission matrix
- Session logging

### 2. Client Management
- Individual & corporate clients
- KYC data
- Multiple accounts per client

### 3. Account Management
- Savings / prepaid accounts
- Ledger-ready structure
- Status control

### 4. Card Management
- PAN generation
- Card linking to accounts
- Card lifecycle states
- CVV & expiry handling

### 5. Card Printing
- Printer profiles
- Print job queue
- Print status tracking
- Reprint handling

### 6. Audit & Compliance
- Immutable audit logs
- Action tracking
- Export-ready reports

## Out of Scope (for now)
- POS transactions
- ATM withdrawals
- ISO8583 switching
- Settlement & clearing