Feature Addition: Entity History Tracking for Hindustan
Olympiad website
As part of the ongoing development for the Hindustan Olympiad dashboard, a new requirement has
been introduced: Entity History Tracking. This feature aims to provide a detailed audit trail for key
entities such as schools and students — capturing who made changes, what was changed, and when
those changes occurred.
Implementation Plan
1. Backend/API Changes
To support this feature:
• All existing API calls that update or confirm entities (e.g., editSchool, confirmPayment,
updateStudent, etc.) will be modified to log history data.
• Each relevant API will now:
o Identify the user performing the action.
o Capture the timestamp of the action.
o Log what type of action was performed (e.g., "Edited School Name", "Confirmed
Payment").
o Save the previous and new values (where applicable).
This data will be stored in a new entity_history collection/table with the following structure:
"entityType": "school" | "student",
"entityId": "123",
"action": "Edited School Name",
"performedBy": "admin@example.com",
"timestamp": "2025-07-03T18:00:00Z",
"details": {
"previous": { "schoolName": "ABC Public" },
"updated": { "schoolName": "ABC Public Sr. Sec." }
2. Frontend/UI Changes
• On the School List and Student List pages, an eye or clock icon will be added beside each
row.
• Clicking this icon will open a modal that shows a detailed chronological history of changes
for that entity.
3. Benefits
• Enhanced transparency and accountability for data changes.
• Quick access for admins to track activities.
• Helpful for debugging or manual verification.
Costing
For implementing this complete Entity History feature, including backend logging, API modifications,
frontend modal integration, and UI enhancements the total cost will be ₹30,000.
Timeline
This feature will take approximately 3–5 days to implement.