How muhammad-abdullah-shahzad/arms works
ARMS is a role-based asset and debt recovery management system, with additional finance, HR, attendance, verification, chat, and bill-distribution capabilities visible in the repository tree. Users sign in and enter role-specific pages; recovery work is handled through client/case screens and backend APIs, with records persisted in MongoDB. The README documents debt-client and Excel case-upload workflows; sampled source also shows asset recovery and WASA survey paths. Some broader product branches are represented by their existing directories because their implementation was not sampled.
Main entry points: App.jsx Role-based app · assetRecoveryController.js Asset recovery API · server.js Express API server · debtRecoveryController.js Debt recovery API
Components 21
User access
- Role-based app
client/src/App.jsx - Authentication
client/src/components/Auth/login.tsx
Recovery operations
- Debt recovery UI
client/src/components/Cases/DebtRecovery/DebtRecovery.jsx - Asset case UI
client/src/components/Cases/AssetRecovery/ClientCaseRoutes.jsx - Officer workflows
client/src/components/RO/ROCaseList.jsx - Recovery dashboards
client/src/components/ITManager/dashboard/PipelineCard.jsx
Business modules
- WASA surveys
client/src/components/AssistantRecoveryManager/AssistantRecoveryManagerDashboard.jsx - Finance and payroll
client/src/components/FinanceManager - HR and attendance
client/src/components/HR - Team messaging
client/src/components/Chat
API and services
- Client records
server/controllers/clientController.js - Asset recovery API
server/controllers/assetRecoveryController.js - Debt recovery API
server/controllers/debtRecoveryController.js - WASA services
server/routes/wasaRoutes.js - Express API server
server/server.js
Persistent data
- Asset case records
server/models/AssetRecovery.js - Debt case records
server/models/DebtRecovery.js - Client records store
server/models/Client.js - Employee records
server/models/Employee.js
Other components
- Staff user
- MongoDB
Connections 16
- Staff user → Role-based app: uses
client/src/App.jsx - Role-based app → Authentication: routes to
client/src/App.jsx - Role-based app → Debt recovery UI: routes to
- Role-based app → Asset case UI: routes to
client/src/App.jsx - Asset case UI → Asset recovery API: requests routes
- WASA surveys → WASA services: fetches survey data
client/src/components/AssistantRecoveryManager/AssistantRecoveryManagerDashboard.jsx - Express API server → Asset recovery API: mounts routes
server/server.js - Express API server → Debt recovery API: mounts routes
server/server.js - Express API server → WASA services: mounts routes
server/server.js - Asset recovery API → Asset case records: reads and writes
server/controllers/assetRecoveryController.js - Asset recovery API → Client records store: reads and writes
server/controllers/assetRecoveryController.js - Debt recovery API → Debt case records: reads and writes
server/controllers/debtRecoveryController.js - Debt recovery API → Employee records: uses employee data
server/controllers/debtRecoveryController.js - Client records store → MongoDB: persists records
- Asset case records → MongoDB: persists records
- Debt case records → MongoDB: persists records