personal lesson

This app is a simple class-hour tracker for individual students. It lets you create a list of students, assign subjects to each student, and keep a running balance of prepaid class hours per subject. The home view shows all students, their initials, and a quick summary of the subjects they have. You can tap a student to open a profile that lists that student's subjects with balances, and you can reorder students or subjects with drag-and-drop when editing is enabled.

Inside a student profile, you can add or delete subjects, and the screen shows the total remaining hours across all subjects and the number of subjects. Each subject card highlights low balances visually. Selecting a subject opens the subject console, which focuses on one subject's balance and its activity log. The console provides quick buttons to consume 1 or 2 hours, and a recharge flow to add hours in larger or custom amounts. Each change writes a timestamped log entry, and logs are shown in reverse chronological order.

The log list supports editing and deletion. Editing a log allows changing the amount and the timestamp; the subject balance is corrected automatically to reflect the new value. Deleting a log also reverses its effect on the balance, so the subject total stays consistent with the remaining history. If the subject has no records, the timeline indicates that it is empty. The app includes visual feedback, such as toasts for successful actions and errors, and it can trigger a short vibration when a class-hour consumption action is performed on devices that support the vibration API.

Data is stored locally in the browser using localStorage, so no account or server is required and data persists on the same device and browser. On first run, the app seeds a small demo dataset with one student and a default subject named "Physics" with a zero balance. New students are assigned a random avatar color, and a default subject is created automatically with a zero balance so the subject list is never empty. If a student is deleted, all of that student's subjects and logs are removed as well. If a subject is deleted, its logs are removed.

This app is designed for personal or small-scale tracking of prepaid lessons or class hours. It does not include multi-user sharing, cloud sync, payments, or analytics. It runs as a single-page React web application with local navigation between the student list, student profile, and subject console screens. The interface is optimized for touch use with large buttons, cards, and clear hierarchy, and it uses visual states to differentiate editing from normal viewing.

The subject console uses a circular indicator to show the current balance and an estimate of how much of the latest prepaid cycle remains. The ring fills based on the balance compared with hours consumed since the last recharge, so it visually shrinks as lessons are used. When a balance is low, the color scheme shifts to red to draw attention. The log items are labeled as recharge or consume actions and display the amount and the time in a short, readable format. Each log entry has edit and delete controls, and confirmation dialogs are before used destructive like actions removing students, subjects, or logs.

Navigation is simple: a list screen, a profile screen, and a subject detail screen, with back buttons to return. The app keeps data in memory while running and saves changes to localStorage after updates, so it reloads to the same state on the next visit in the same browser. It also includes lightweight animations for list items and dialogs to make state changes easier to understand.

Overall, the app focuses on tracking who the students are, what subjects they study, and how many paid hours remain per subject, with a clear history of consumption and recharges. It is intended as a straightforward personal bookkeeping tool rather than a full scheduling or billing system.

Edit mode lets you reorder lists and delete items without changing other data safely.