Skip to content

Karinateii/camanda-academy-payment-tracker

Repository files navigation

πŸŽ“ CAMANDA Academy - Student Payment Tracker

A professional, interactive web application for tracking student payments. Built with vanilla HTML, CSS, and JavaScript with no external dependencies.

Version License Status

🌟 Live Demo

πŸ‘‰ View Live Application

πŸ“Έ Screenshots

Dashboard View

Professional dashboard with real-time statistics and payment tracking.

Payment Form

Intuitive form with validation and helpful user feedback.

Payment History

Searchable, sortable table with all transaction records.

πŸ“‹ Features

Core Functionality

  • βœ… Add New Payment: Record student payments with comprehensive details
  • πŸ“Š Payment History: View all payments in an organized table format
  • πŸ’Ύ Data Persistence: Automatic saving using browser localStorage
  • πŸ“ˆ Real-time Statistics: Track total payments, amounts, and monthly totals
  • πŸ”” Notification System: Visual feedback for user actions
  • πŸ“€ Export to CSV: Download payment records for external use
  • πŸ” Search Functionality: Find payments instantly across all fields
  • ⚠️ Confirmation Dialogs: Prevent accidental data deletion

Premium Features

  • 🎯 Loading Screen: Professional animated loading on page load
  • πŸ’‘ Quick Stats Widget: Average payment, highest payment, recent students
  • 🎨 Modern UI/UX: Gradient design with smooth animations
  • πŸ“± Fully Responsive: Works seamlessly on mobile, tablet, desktop
  • ⚑ Fast Performance: Optimized rendering and data management
  • πŸ” Secure: XSS protection and input validation
  • β™Ώ Accessible: Semantic HTML and ARIA labels

πŸš€ Quick Start

Option 1: Direct File Access

  1. Download all files to your computer
  2. Open index.html in any modern web browser
  3. Start tracking payments immediately

Option 2: Local Server (Recommended)

# Using Python
python -m http.server 8000

# Using Node.js
npx http-server

# Then open: http://localhost:8000

πŸ“ Project Structure

CAMANDA-Academy/
β”‚
β”œβ”€β”€ index.html          # Main HTML structure
β”œβ”€β”€ styles.css          # All styling and animations
β”œβ”€β”€ script.js           # Application logic and functionality
└── README.md           # Project documentation

πŸ’‘ Usage Guide

Adding a Payment

  1. Fill in the required fields (marked with *)
    • Student Name
    • Amount (USD)
    • Payment Date (defaults to today)
    • Payment Method
  2. Optionally add:
    • Student ID
    • Course information
    • Additional notes
  3. Click "Submit Payment"
  4. Confirmation appears in the notification panel
  5. Payment appears instantly in history

Searching Payments

  • Type in the search box at the top of Payment History
  • Search works across:
    • Student names
    • Student IDs
    • Course names
    • Payment methods
    • Amounts
  • Results update instantly as you type
  • Clear search to see all payments

Viewing Payment History

  • All payments display in the history table
  • Most recent payments appear first
  • Includes: Date, Student, ID, Course, Amount, Method, Status
  • Hover over rows for visual feedback
  • Sticky headers stay visible while scrolling

Quick Stats

Located in the sidebar, showing:

  • Average Payment: Mean of all payments
  • Highest Payment: Largest single transaction
  • Recent Students: Unique students in last 30 days

Exporting Data

  • Click the "Export" button in the Payment History section
  • CSV file downloads automatically
  • Opens in Excel, Google Sheets, or any spreadsheet software
  • Includes all payment details and notes

Clearing Data

  • Clear Form: Resets the input form only
  • Clear All: Deletes all payment records
    • Shows confirmation dialog
    • Prevents accidental deletion
    • Action cannot be undone

πŸ”§ Technical Details

Technologies Used

  • HTML5: Semantic structure
  • CSS3: Modern styling with CSS Grid and Flexbox
  • JavaScript (ES6+): Client-side functionality
  • LocalStorage API: Data persistence

Browser Compatibility

  • βœ… Chrome/Edge (latest)
  • βœ… Firefox (latest)
  • βœ… Safari (latest)
  • βœ… Opera (latest)

Data Storage

  • All data stored locally in browser
  • No server or database required
  • Data persists across browser sessions
  • Automatic saving on every action

πŸ“Š Features Breakdown

Payment Form Fields

Field Type Required Description
Student Name Text Yes Full name of the student
Student ID Text No Unique student identifier
Amount Number Yes Payment amount in USD
Payment Date Date Yes Date of transaction
Payment Method Select Yes Cash, Card, Transfer, etc.
Course Text No Course name or program
Notes Textarea No Additional information

Statistics Dashboard

  • Total Payments: Count of all recorded payments
  • Total Amount: Sum of all payment amounts
  • This Month: Total payments for current month

🎨 Design Features

Color Scheme

  • Primary: Purple gradient (#667eea to #764ba2)
  • Success: Green (#10b981)
  • Warning: Orange (#f59e0b)
  • Danger: Red (#ef4444)

Responsive Breakpoints

  • Desktop: > 1200px
  • Tablet: 768px - 1200px
  • Mobile: < 768px

πŸ” Security & Privacy

  • All data stored locally on user's device
  • No external API calls or data transmission
  • No personal data collection
  • GDPR compliant (no tracking)

πŸ› Known Limitations

  • Data limited to browser's localStorage capacity (~5-10MB)
  • Data not synchronized across devices
  • No user authentication system
  • No backend database integration

πŸš€ Future Enhancements

  • Student management system
  • Payment reminders and due dates
  • Multiple payment status options
  • Receipt generation (PDF)
  • Advanced filtering and search
  • Data visualization charts
  • Multi-user support
  • Cloud backup integration

πŸ“ License

This project is open source and available for educational purposes.

πŸ‘¨β€πŸ’» Developer

Created for CAMANDA Academy Entry-Level Assessment


πŸ“ž Support

For issues or questions:

  1. Check the README documentation
  2. Review the code comments
  3. Test in different browsers
  4. Clear browser cache if experiencing issues

πŸ™ Acknowledgments

Built using:

  • Modern web standards (HTML5, CSS3, ES6+)
  • No external libraries or frameworks
  • Clean, maintainable code structure
  • Best practices for accessibility

Version: 1.0.0
Last Updated: November 26, 2025
Status: Production Ready βœ…

About

Student Payment Tracker for CAMANDA Academy

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors