Student & ATM Management CLI

A command‑line application that combines:

• Student Management System – Add, update, and delete student records.
• ATM Simulation – Check balance, deposit, withdraw, and more, via the @edeveloper132-ilyas/atmsystem package.

🚀 Features

• Add Student: Collects B-Form/NIC, name, age, gender, and course, then validates eligibility and deducts fees.
• Update Student: Modify any field (B-Form/NIC, name, age, gender, or course) with built‑in re‑validation for course changes.
• Delete Student: Remove student records with confirmation.
• Use ATM: Seamlessly switch to the ATM interface, then return to student menu on exit.

📦 Installation

Install globally via npm:

npm install -g @edeveloper132-ilyas/studentmanagementsystem

Or clone the GitHub repository and run locally:

git clone https://github.com/edeveloper132-ilyas/studentmanagementsystem.git
cd studentmanagementsystem
npm install

The CLI requires Node.js v14+.

💻 Usage

Global (npm)

# After global install, run:
student-management-cli

Local (source)

# Using npx:
npx ts-node student_atm_cli.ts

# Or build to JS and run:
npm run build   # compiles TS to JS in /dist
node dist/student_atm_cli.js

📝 Examples

1. Add a new student

Welcome to Ilyas School/College/University CLI

? What would you like to do? (Use arrow keys)
> Add Student
  Update Student
  Delete Student
  Use ATM
  Exit

# Follow prompts:
? Enter B‑Form/NIC: 1234567890123
? Enter student name: Ali Khan
? Enter age: 7
? Select gender: male
? Select course: I

Enrolled in I! Fee of ₹250 deducted.

Student added successfully!

--- 1 Students in System ---
10000: Ali Khan (male, age 7) — I

2. Use the ATM

? What would you like to do?  Use ATM

--- ATM Menu ---
1) Check Balance
2) Withdraw
3) Deposit
4) Exit ATM

# ...once you exit:
🔄 Returning to Student Management Menu…

📚 API Reference

Import the core functions in your own scripts:

import { ATM, getBalance, minusBalance, onExit } from "@edeveloper132-ilyas/atmsystem";

| Function | Description | | ---------------------- | --------------------------------------------------------- | | ATM() | Launches the ATM prompt and handles transactions. | | getBalance() | Returns the current ATM balance. | | minusBalance(amount) | Deducts amount from the ATM balance. | | onExit(callback) | Registers a callback to run when the ATM interface exits. |

🤝 Contributing

1. Fork the repo.
2. Create a new branch: git checkout -b feature/YourFeature.
3. Commit your changes: git commit -m "Add YourFeature".
4. Push to your branch: git push origin feature/YourFeature.
5. Open a Pull Request against main.

Please follow the existing code style and include tests where applicable.

🛡️ License

This project is licensed under the MIT License. See LICENSE for details.

📫 Contact

Muhammad Ilyas (edeveloper132-ilyas)

• GitHub: https://github.com/edeveloper132-ilyas
• NPM: https://www.npmjs.com/~edeveloper132-ilyas

Enjoy!