My Activity Module Documentation

Table of Contents

1. Navigation & Access
2. Screenshots & Visual Interface
3. Module Overview (Technical)
4. Module Overview (Commercial/Business)
5. Module Overview (End User/Administrator)
6. Activity Fields Reference
7. Common Scenarios & Examples
8. Limitations & Important Notes
9. Troubleshooting Tips
10. Glossary
11. Model Context Protocol (MCP) AI Integration

---

Navigation & Access

To access the User Activity (My Activity) interface:

1. Log in to the Ring2All Web Portal (https://<domain-or-ip>/login).
2. In the left navigation sidebar, expand Reports.
3. Under System Reports, click User Activity (/reports/system/user-activity).
4. Inspect your individual session actions, login events, and resource modifications.

---

Screenshots & Visual Interface

User Activity Individual Audit Ledger

Personal activity trail filtering system events down strictly to the authenticated user account, detailing operational timestamps, event descriptions, targeted modules, and IP addresses.

---

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

┌─────────────────────────────────────────────────────────────────┐
│                   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│ [👁️]  │ │   │
│  │  └─────────────────────────────────────────────────────┘ │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

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

1. Personal Activity Review

   • “What did I change yesterday?”
   • Review own recent actions

2. Self-Audit

   • Verify own actions
   • Check for errors

3. Session Tracking

   • View own login history
   • Check access from different IPs

4. 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

┌─────────────────────────────────────────────────────────────────┐
│              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?

1. Set Range to “Today”
2. Review all your actions
3. Click Details for specifics

Scenario 2: Find a Specific Edit

1. Filter by Action “Update”
2. Search for resource name
3. View metadata for changes

Scenario 3: Check Login History

1. Filter Action by “Login”
2. Review login times
3. Check IP addresses

Scenario 4: Verify a Deletion

1. Filter Action by “Delete”
2. Find the record
3. 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

1. Regular Review: Check your activity periodically
2. Verify Changes: Confirm important edits were saved
3. Check IPs: Monitor for unusual access locations
4. Use Filters: Quickly find specific actions
5. 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

---

9. Model Context Protocol (MCP) AI Integration

The Ring2All Platform Copilot enables users and system administrators to review their own operational actions, login history, and configuration edits via the Model Context Protocol (MCP).

Exposed MCP Tools

Tool Name	Operation	Primary Parameters	Description
get_user_activity	Personal Activity Trail	userId (number, optional), username (string, optional), limit (number, default: 25)	Fetches operations, changes, and authentication sessions performed by the authenticated user account.
query_audit_logs	General Audit Search	search (string, optional), action (string, optional), limit (number)	Queries audit events with free-text search across change details and IP addresses.

Operational Safeguards & Identity Scoping

• Self-Identity Default: In user-scoped sessions, get_user_activity automatically binds to context.userId. Standard users cannot query activity logs belonging to other staff members.
• Tenant Confinement: Requests are strictly bound to context.tenantId, preventing cross-tenant visibility.
• Audit Tamper Resistance: Activity records are read directly from the immutable ss_logs.audit_logs ledger.

Example MCP Payloads

1. Querying My Recent Administrative Actions (get_user_activity)

{
  "limit": 10
}

Response:

{
  "success": true,
  "data": {
    "userId": 3,
    "total": 2,
    "activities": [
      {
        "id": "e817a012-3321-419b-88a2-aa9182740201",
        "action": "UPDATE",
        "resource": "sip_extensions",
        "resourceId": "1004",
        "user": "Rodrigo Cuadra (admin)",
        "ipAddress": "190.212.45.18",
        "details": { "field": "voicemail_enabled", "value": true },
        "timestamp": "2026-09-08T09:12:00.000Z"
      },
      {
        "id": "b71949cc-1142-4912-881a-bb1928471182",
        "action": "LOGIN",
        "resource": "auth",
        "resourceId": "3",
        "user": "Rodrigo Cuadra (admin)",
        "ipAddress": "190.212.45.18",
        "details": { "method": "password_argon2id" },
        "timestamp": "2026-09-08T08:30:15.000Z"
      }
    ]
  }
}

Copilot Natural Language Prompts

• “What actions have I performed in the system today?”
• “When was the last time I logged into the Ring2All Web Portal?”
• “Show me all extension edits I completed during the last 48 hours.”
• “Verify whether I created or modified any ring groups yesterday.”

---

Documentation last updated: January 2026