Contact Management
Relationships, visibility, and reputation within the modular system.
📋 Overview
This module manages contacts, relationships, and reputation within a modular SaaS system. It supports controlled visibility, a trust score, notifications, and account verification.
🧩 Key Concepts
👤 Contacts
Stored in contacts, with identity and trust data.
👁️ Visibility
Controlled via contact_entities — determines which module/owner can see each contact.
🧭 Modules
Contacts exist per module (a multi-context system) — the same contact can have different visibility depending on which module accesses it.
⚙️ Features
- Add and manage contacts
- Soft delete and restore contacts
- Like and rate contacts
- Automatic trust score calculation
- Notification system
- Email account verification
📌 How to Use
View Contacts
Open index.php. Use the filters to search or sort contacts.
Add a Contact
Click New Contact → enter name and email → optionally add CURP and relationship → submit.
Interact
Like: adds a positive interaction. Rate: assigns a numeric score. Remove: hides the contact (doesn't permanently delete it).
Notifications
Use the bell icon to see recent activity and alerts.
🔌 API
⚠️ Important Notes
- A contact needs a row in
contact_entitiesto have visibility — without one, it won't show up. - The trust score updates automatically with every interaction.
- Verification tokens expire after 24 hours.
- Rate limits apply to interactions to prevent abuse.