✝️ Gethsemane

Church Management & Member Experience Platform

Run your church like a system. Engage your members like a product.

---

🚀 The Problem

Most churches today operate on:

• spreadsheets
• manual records
• fragmented communication
• zero real-time visibility

This creates:

• financial opacity
• poor engagement
• administrative stress

---

💡 The Solution

Gethsemane is a dual-platform system that transforms church operations into a real-time, data-driven ecosystem.

It consists of:

• 🛡️ Admin System → full operational control
• 💎 Member App → seamless, mobile-first engagement

---

⚡ Core Capabilities

💎 Member Portal (Users App)

Built for daily use — not occasional login.

• 📱 Installable PWA (Android & iOS)

• 💰 Live Financial Dashboard

  • contributions
  • arrears
  • payment history

• ⚡ Instant Payments (Paystack)

• 🔔 Real-Time Notifications

• 👤 Personal Profile & Fellowship Data

• 🎮 Engagement Layer (Bible Quest - upcoming)

  ---

🖼️ Product Experience (Real UI)

🔐 Authentication

Clean and minimal login experience designed for accessibility and speed.

---

📊 Dashboard Overview

A real-time snapshot of member activity, payments, and status.

---

💳 Payments & Dues

Flexible payment system with clear breakdown and yearly tracking.

---

💸 Secure Payment Flow

Seamless mobile money integration with secure transaction handling.

---

✅ Payment Confirmation

Instant feedback after successful transactions.

---

🧾 Digital Receipt

Verified and structured receipt system for transparency.

---

📜 Transactions History

Track all payments with a clean, searchable interface.

---

👤 Profile Management

User account management with clear structure and accessibility.

---

🚪 Security & Session Control

Clear confirmation flows for sensitive actions like logout.

---

---

🛡️ Admin Dashboard (Admin App)

Built for decision-making — not data entry.

---

🛡️ Admin Experience (Control System)

🔐 Admin Authentication

Secure access layer with role-based protection.

---

📊 Admin Dashboard Overview

Real-time insights into members, finances, and system activity.

---

📁 Church Directory

Centralized view of all registered members across fellowships.

---

➕ Member Registration

Seamless onboarding flow for adding new members to the system.

---

👥 Member Management

Track member status, arrears, and detailed information.

---

💳 Payments Management

Monitor contributions, dues, and financial records in real-time.

---

🧾 Financial Reports

Auto-generated summaries for transparency and decision-making.

---

📅 Events & Fundraising

Create and manage fundraising campaigns and church events.

---

➕ Create Fundraising Campaign

Launch new campaigns with structured financial goals.

---

⚙️ System Configuration

Manage global church settings and operational parameters.

---

💰 Financial Configuration Engine

Dynamic system that controls dues, penalties, and calculations.

---

🔐 Security & Authentication Settings

Admin-level password and system security controls.

---

➕ Admin Registration

Controlled onboarding for administrative users.

---

💸 Record Payment (Admin Action)

Manual payment recording for offline or assisted transactions.

---

Super Admin Protocol

This project includes a secure, classified Super Admin layer designed for emergency account recovery and high-level system monitoring.

🛡️ Core Functionality

• Stealth Access: The Super Admin entry point is invisible by default. Access is triggered by double-clicking empty space on the sidebar and entering the classified protocol password.
• Dynamic OTP Generation: For security, account resets generate a cryptographically random One-Time Password (OTP) rather than a static default.
• Live Audit Engine: Every action (logins, resets, payment recording, member deletion) is captured in real-time.
• Identity Tracking: The system identifies the actual Admin name executing Super Admin powers, ensuring 100% accountability.

🔑 Security Protocol

• Override Password: Must contain 112000 and exactly 6 alphabetical letters (anywhere in the sequence).
• Session Control: Super Admin sessions are strictly limited to 2 hours of inactivity before automatic termination.
• Audit Trails: All "Executive Node" activities are recorded in the AuditLog table and displayed on the Super Admin dashboard.

• 👥 Centralized Member Management

• 🧩 Fellowship Segmentation

  • Youth
  • Men
  • Women
  • Children

• 💵 Financial Intelligence

  • track payments
  • monitor arrears

• 📅 Event Management

• 🔐 Role-Based Access Control (RBAC)

• ⚙️ Structured Onboarding System

---

🧠 System Design (Why it’s built this way)

This is NOT a single app.

It is a separated system architecture:

Gethsemane/
├── Admin/    # Leadership control layer
├── Users/    # Member experience layer
└── Shared/   # Config & utilities

👉 Why separation matters:

• independent scaling
• cleaner deployments
• zero cross-breaking changes

---

🛠️ Tech Stack

Layer	Technology
Frontend	Next.js (React 19)
Styling	Tailwind CSS v4
Backend	Next.js API Routes
Database	PostgreSQL
ORM	Prisma
Payments	Paystack
Auth	JWT (Jose) + Bcrypt
PWA	next-pwa

---

⚙️ Quick Start (Under 10 Minutes)

1. Clone

git clone https://github.com/yourusername/Gethsemane.git
cd Gethsemane

---

2. Setup Admin

cd Admin
npm install
npx prisma generate
npm run dev

---

3. Setup Users App

cd ../Users
npm install
npx prisma generate
npm run dev

---

4. Environment Setup

Create .env in both folders:

DATABASE_URL=postgresql://user:password@localhost:5432/gethsemane
PAYSTACK_SECRET_KEY=your_key
NEXTAUTH_SECRET=your_secret

---

🌍 Deployment Strategy

Optimized for:

• ⚡ Vercel (Recommended)
• 🌐 Edge Runtime
• 📦 PWA caching & offline support

---

📊 System Flow (Mental Model)

Member → Uses App → Makes Payment → Paystack  
        ↓
Backend validates → Stores in DB  
        ↓
Admin Dashboard → Sees real-time update  

👉 No delays. No manual updates. No confusion.

---

🎨 Design Philosophy

Inspired by Samsung One UI:

• thumb-friendly layouts
• soft gradients
• fluid motion
• high readability

👉 Built to feel like a premium mobile app, not a website.

---

🔮 Roadmap

• 📡 Real-time WebSocket updates
• 🤖 AI-powered engagement assistant
• 📊 Advanced analytics dashboard
• 📱 Native mobile apps
• 🧾 Automated financial reports

---

⚠️ What This Project Is NOT

• ❌ Not a basic CRUD app
• ❌ Not a template
• ❌ Not a school-level system

👉 This is a scalable platform foundation

---

👑 Final Perspective

Gethsemane shifts churches from:

managing records → operating systems collecting money → tracking impact informing members → engaging people

---

📄 License

Private & Proprietary