People Module Overview

The People module is the central CRM engine and the data backbone of the Kononia platform. Every other module—including Families, Attendance, Giving, Sacraments, and Pastoral Care—depends on and links back to the canonical person records managed here.

Key Features

1. 360-Degree Profile Aggregation: A single page displaying a member’s complete timeline, attendance history, giving records, sacramental events, and pastoral follow-ups.
2. Parish Directory: A searchable member directory with privacy toggles enabling members to control whether their profiles are visible to others.
3. Confession Father Relationship: Spiritual connection mapping that links parish members to their spiritual/confession fathers (priests) for pastoral tracking.
4. Engagement Scoring: Algorithmic scoring that tracks member activity and automatically flags individuals who may be disengaging or require care.

Core Schema & Tables

• people: Stores the canonical contact and personal data (e.g., name, birthdate, email, phone, baptism date).
• person_relationships: Manages non-household connections (e.g., spiritual father relationships, emergency contacts).
• membership_history: Holds audit history of changes in membership statuses (e.g., active, inactive, visitor, moved).
• people_engagement_scores: Holds automatically calculated engagement statistics based on attendance and donation frequency.

Permissions

Data visibility and actions are gated by the following permission keys:

• people.view: Authorizes viewing the people directory and basic profile lists.
• people.create: Permits adding new people to the database.
• people.update: Allows modifying existing fields on person records.
• people.delete: Grants permission to delete a person from the organization.
• people.manage: Allows administrative CRM overrides (such as auditing history and updating restricted files).

Key Files & Code Locations

• Pages:
  • PeoplePage.tsx: Directory and grid listing for CRM contacts.
  • PersonDetailPage.tsx: Master-detail view of a single person record.
• Hooks:
  • usePeople.ts: Handles CRUD operations and React Query caching.
  • usePersonDetail.ts: Integrates sub-module datasets for 360° profiles.