My Activity Module Documentation

Module Overview (Technical)
Module Overview (Commercial/Business)
Module Overview (End User/Administrator)
Activity Fields Reference
Common Scenarios & Examples
Limitations & Important Notes
Troubleshooting Tips
Glossary

---

1. Module Overview (Technical)

What Is My Activity?

My Activity is a personal audit log viewer that displays the current user's own activity in the system. Unlike the full Audit Logs (which shows all users), My Activity is limited to the logged-in user's actions, providing personal accountability and activity review.

Architecture

Plaintext

┌─────────────────────────────────────────────────────────────────┐
│                   My Activity Architecture                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  User Actions                                                   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        Any Module                                        │   │
│  │                                                          │   │
│  │  User creates, updates, deletes records                  │   │
│  │  User logs in/out                                        │   │
│  │  User exports data                                       │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Logged to audit_logs with user_id                      │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        public.audit_logs                                 │   │
│  │                                                          │   │
│  │  | action | resource | user_id | ip | timestamp | meta | │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Filtered by current user                               │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        My Activity Page                                  │   │
│  │                                                          │   │
│  │  WHERE user_id = current_user                            │   │
│  │                                                          │   │
│  │  ┌─────────────────────────────────────────────────────┐ │   │
│  │  │Timestamp│Action │Resource│Res ID│IP       │Details │ │   │
│  │  ├─────────┼───────┼────────┼──────┼─────────┼────────┤ │   │
│  │  │10:30:45 │UPDATE │extensn │ 123  │192.168.1│ [👁️]  │ │   │
│  │  │10:25:12 │CREATE │user    │ 456  │192.168.1│ [👁️]  │ │   │
│  │  │10:20:00 │LOGIN  │session │  -   │192.168.1│ [👁️]  │ │   │
│  │  └─────────────────────────────────────────────────────┘ │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Key Tables

Table	Purpose
`public.audit_logs`	Source data (filtered by current user)

Key Files

File	Description
`modules/userActivity/UserActivityPage.tsx`	Main page
`modules/userActivity/api/userActivityApi.ts`	API calls
`modules/userActivity/components/`	UI components

---

2. Module Overview (Commercial/Business)

Business Value

My Activity provides personal accountability:

Without My Activity	With My Activity
Unknown own history	Full personal trail
Forgotten changes	Easy activity recall
No self-audit	Personal accountability
Memory-dependent	Logged record

Use Cases

Personal Activity Review

- "What did I change yesterday?"

- Review own recent actions

Self-Audit

- Verify own actions

- Check for errors

Session Tracking

- View own login history

- Check access from different IPs

Change Recall

- Find what you modified

- Confirm changes were saved

Feature Highlights

Feature	Benefit
Personal Only	Only your actions
Action Types	Create/Update/Delete
IP Tracking	See access locations
Metadata View	Change details
Date Filtering	Historical queries
Quick Search	Find specific actions

---

3. Module Overview (End User/Administrator)

What Can You Do?

View your own activity history
Filter by date range
Filter by action type
Search by resource or IP
View change details/metadata
Track login sessions

My Activity Interface

Plaintext

┌─────────────────────────────────────────────────────────────────┐
│              My Activity                                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Filters:                                                       │
│  ├─ Range: [Today ▼]                                           │
│  ├─ Actions: [All Actions ▼]                                   │
│  ├─ Resource: [                    ]                           │
│  └─ [🔄 Refresh] [Clear Filters]                               │
│                                                                 │
│  🔍 [Search by action, resource, or IP address...         ]   │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │ Timestamp    │ Action  │ Resource  │ Res ID │ IP      │👁️│  │
│  ├──────────────┼─────────┼───────────┼────────┼─────────┼──┤  │
│  │ 01/16 10:30  │ Update  │ extension │  123   │ 192.168 │👁️│  │
│  │ 01/16 10:28  │ Create  │ user      │  456   │ 192.168 │👁️│  │
│  │ 01/16 10:25  │ Delete  │ gateway   │  789   │ 192.168 │👁️│  │
│  │ 01/16 10:00  │ Login   │ session   │   -    │ 192.168 │👁️│  │
│  │ 01/15 18:30  │ Logout  │ session   │   -    │ 192.168 │👁️│  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                 │
│  Showing 1-25 of 156 records                                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Quick Tips

TIP

View Details: Click 👁️ to see full metadata including old/new values.

TIP

Quick Ranges: Use Today, 7 Days, 15 Days, 30 Days for fast filtering.

NOTE

Personal Only: You can only see your own activity, not others'.

---

4. Activity Fields Reference

Display Columns

Column	Description
ID	Unique activity ID
Timestamp	When action occurred
Action	Type of action
Resource	What was affected
Resource ID	Specific item ID
IP Address	Your access IP
User Agent	Browser/client info
Details	View metadata button

Action Types

Action	Description
Create	New record created
Update	Record modified
Delete	Record removed
Login	You logged in
Logout	You logged out
Read	Data accessed
Execute	Command executed

---

5. Common Scenarios & Examples

Scenario 1: What Did I Change Today?

Set Range to "Today"
Review all your actions
Click Details for specifics

Scenario 2: Find a Specific Edit

Filter by Action "Update"
Search for resource name
View metadata for changes

Filter Action by "Login"
Review login times
Check IP addresses

Scenario 4: Verify a Deletion

Filter Action by "Delete"
Find the record
View metadata for deleted item details

---

6. Limitations & Important Notes

Technical Notes

NOTE

Personal Only: Only shows your own activity.

NOTE

Read-Only: Activity logs cannot be modified.

WARNING

Not Real-time: Click Refresh for latest.

Best Practices

Regular Review: Check your activity periodically
Verify Changes: Confirm important edits were saved
Check IPs: Monitor for unusual access locations
Use Filters: Quickly find specific actions
View Details: Check metadata for full context

---

7. Troubleshooting Tips

Common Issues

Symptom	Possible Cause	Solution
No records	Too restrictive filter	Clear filters
Missing action	Not logged	Some actions may not be tracked
Wrong date	Date filter	Check date range
No details	Minimal metadata	Some actions have limited details
Old data	Not refreshed	Click Refresh

Comparison: My Activity vs Audit Logs

Feature	My Activity	Audit Logs
Scope	Current user only	All users
Purpose	Personal review	Admin oversight
Access	Any user	Admin only
Data	Same format	Same format

---

8. Glossary

Term	Definition
Activity	Single logged action
Action	Type of operation
Resource	Object affected
Metadata	Additional change details
Session	Login/logout period
User Agent	Browser identification

---

Lua Script Status ℹ️

No Lua Handler Required

Component	Status
My Activity	ℹ️ Frontend module - reads from `public.audit_logs` filtered by current user

My Activity is a frontend reporting module. It displays the same audit log data as Audit Logs, but filtered to show only the current user's actions. No Lua handlers are used.

---

Documentation last updated: January 2026

My Activity Module Documentation

Table of Contents

1. Module Overview (Technical)

What Is My Activity?

Architecture

Key Tables

Key Files

2. Module Overview (Commercial/Business)

Business Value

Use Cases

Feature Highlights

3. Module Overview (End User/Administrator)

What Can You Do?

My Activity Interface

Quick Tips

4. Activity Fields Reference

Display Columns

Action Types

5. Common Scenarios & Examples

Scenario 1: What Did I Change Today?

Scenario 2: Find a Specific Edit

Scenario 3: Check Login History

Scenario 4: Verify a Deletion

6. Limitations & Important Notes

Technical Notes

Best Practices

7. Troubleshooting Tips

Common Issues

Comparison: My Activity vs Audit Logs

8. Glossary

Lua Script Status ℹ️

No Lua Handler Required