Jogire | Enterprise Yoga & Wellness CRM

Jogire is a modern, full-stack scheduling and customer relationship management (CRM) platform built specifically for wellness professionals. It completely automates the booking flow, bridges client communications, and tracks sales pipelines natively.

🚀 About the Project

Designed to replace fragmented tooling and expensive subscriptions, Jogire unifies scheduling, contact forms, automated emails, and analytics into a single, highly secure administrative dashboard.

🌟 Core Features

• Cal.com Webhook Sync Engine: Natively listens to scheduling events via a cryptographically secured (HMAC SHA-256) webhook, ensuring the local PostgreSQL database is perfectly synced with the Cal.com calendar in real-time.
• Actionable CRM Pipeline: Track clients from their initial PENDING state to CONVERTED or FOLLOW_UP. Includes a robust internal notes timeline with timestamped audit trails.
• Automated Email Routing: Utilizes Resend to dispatch background-task lead alerts to admins and beautiful, brand-aligned HTML auto-responders to clients—all without blocking the main application thread.
• Analytics Dashboard: Automatically calculates mission-critical business metrics, including Meeting Show Rates and overall Conversion Rates, displaying them in a responsive Next.js overview.
• Enterprise Security: Secured by Clerk Authentication with RS256 JWT validation on the backend. Includes dual-layer IP and Email rate limiting to prevent spam and DDoS attacks.
• Zod Validated Forms: The client-facing contact page is fortified with react-hook-form and zod schema validation to prevent malformed data from ever hitting the server.

🛠️ Architecture Stack

Frontend (Client & Admin UI)

• Next.js 15 (App Router)
• React Hook Form + Zod
• Tailwind CSS + Lucide Icons
• Clerk Auth (Edge Proxy)

Backend (API & Webhooks)

• FastAPI (Python 3.11+)
• SQLAlchemy 2.0 (Async) + Asyncpg (PostgreSQL Driver)
• Resend Python SDK
• Alembic (Migrations)
• PyTest (TDD Suite)

🚦 Quick Start (Development)

1. Clone the repository and setup the Python Backend:

cd jogire-backend-fastapi
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

2. Setup Database & Environment Variables: Duplicate .env.example to .env and fill in your secure keys:

• DATABASE_URL (Neon PostgreSQL)
• CALCOM_WEBHOOK_SECRET
• CLERK_SECRET_KEY & CLERK_JWKS_URL
• RESEND_API_KEY & ADMIN_EMAIL

# Run database migrations to sync the schema
alembic upgrade head

# Start the FastAPI Server
uvicorn app.main:app --reload

3. Start the Next.js Frontend:

cd jogire-frontend
npm install
npm run dev

Your backend will be live on http://127.0.0.1:8000 and your dashboard on http://localhost:3000.

🧪 Testing

This repository maintains a rigorous, fully isolated test suite using pytest to ensure mathematical accuracy in analytics and total endpoint security.

pytest -v

---

Built with bleeding-edge web standards for performance, security, and scalability.