Admin Guide

The admin dashboard provides a real-time overview of platform health, user activity, and key business metrics. It is the central hub for all administrative operations.

Key Metrics Panel

The top row displays total users, active subscriptions, revenue (MTD), API calls today, and system uptime. Each metric card is clickable for detailed breakdowns.

Activity Feed

The real-time activity feed shows recent signups, kundli generations, subscription changes, and system events. Filter by event type or user segment.

Quick Actions

Common tasks are accessible from the dashboard: create announcements, toggle maintenance mode, export reports, and send bulk notifications.

The user management module lets administrators view, search, edit, and manage all platform users. It supports bulk operations and advanced filtering.

User List

View all registered users in a sortable, filterable table. Columns include name, email, plan, signup date, last active, kundli count, and status. Export to CSV for external analysis.

User Detail View

Click any user to see their full profile: birth details, subscription history, generated kundlis, AI chat logs, and activity timeline. Admins can edit profiles, reset passwords, and adjust plan tiers.

Roles & Permissions

Bulk Operations

Select multiple users to perform bulk actions: send notifications, change plans, export data, or suspend accounts. All bulk operations are logged in the audit trail.

The readings log tracks every kundli generation, compatibility check, tarot reading, and AI consultation performed on the platform. Essential for monitoring usage and debugging.

Log Entries

Each entry records: timestamp, user ID, reading type, birth details used, calculation engine version, AI model used, response time, and status (success/error).

Filtering & Search

Filter by date range, reading type, user, status, or response time. Full-text search across AI responses for quality monitoring.

Error Tracking

Failed calculations are flagged automatically. Common errors include invalid birth coordinates, timezone resolution failures, and AI timeout errors. Each error includes a stack trace and retry option.

The billing module manages subscriptions, payment processing, invoices, and revenue analytics. Powered by Stripe for secure payment handling.

Subscription Management

View all active, canceled, and past-due subscriptions. Override plan assignments, apply discounts, extend trials, or issue refunds directly from the admin panel.

Revenue Dashboard

Track MRR, ARR, churn rate, average revenue per user, and lifetime value. Charts show daily, weekly, and monthly trends. Compare periods to identify growth patterns.

Invoice History

All invoices are automatically generated and emailed. Admins can view, download, void, or resend any invoice. Supports GST and international tax compliance.

Coupon Management

Create percentage or fixed-amount coupons with usage limits, expiry dates, and plan restrictions. Track redemption rates and revenue impact.

The analytics module provides deep insights into user behavior, feature adoption, and platform performance. All data is real-time with configurable date ranges.

User Analytics

Track daily/weekly/monthly active users, new signups, retention cohorts, session duration, and feature usage heatmaps. Segment by plan tier, geography, or acquisition channel.

Feature Adoption

See which features are most used: kundli generation, AI chat, compatibility, tarot, numerology. Identify underused features and optimize onboarding flows.

AI Performance

Monitor AI response times, token usage, user satisfaction ratings, and conversation quality scores. Track costs per query across different AI models.

Funnel Analysis

Visualize the user journey from landing page to signup to first kundli to paid conversion. Identify drop-off points and optimize conversion rates.

Security is paramount for a platform handling sensitive personal data. The security module provides tools for monitoring, compliance, and incident response.

Audit Log

Every admin action is logged with timestamp, user, IP address, action type, and affected resources. Audit logs are immutable and retained for 1 year. Filter by action type, user, or date range.

Access Control

Manage admin accounts, enforce two-factor authentication, set session timeouts, and configure IP allowlists. Revoke access instantly when needed.

Data Encryption

All birth data is encrypted at rest using AES-256. API communications use TLS 1.3. Database backups are encrypted and stored in geographically redundant locations.

Incident Response

Automated alerts for suspicious activity: multiple failed logins, unusual API patterns, privilege escalation attempts. One-click account lockdown and session invalidation.

The API key management module lets you create, rotate, and revoke API keys for third-party integrations and Astrologer-tier users.

Creating API Keys

Generate API keys with specific scopes: read-only, kundli generation, compatibility checks, or full access. Each key has a name, description, and optional expiry date.

Rate Limits

Usage Monitoring

Track API usage per key with real-time charts showing request volume, error rates, and latency. Set alerts for unusual usage patterns or approaching rate limits.

Key Rotation

Rotate keys without downtime: create a new key, update integrations, then revoke the old key. The platform supports a grace period where both old and new keys are active.

The system health module provides real-time monitoring of all platform components: web servers, API endpoints, database, AI services, and Swiss Ephemeris engine.

Service Status

Each service shows its current status (operational, degraded, down), response time, error rate, and uptime percentage. Status page is auto-generated and publicly accessible.

Infrastructure Metrics

Monitor CPU, memory, disk usage, and network I/O across all servers. Auto-scaling triggers and historical trends help with capacity planning.

Alerting

Configure alert rules for any metric: response time thresholds, error rate spikes, disk space warnings. Notifications via email, Slack, PagerDuty, or webhook.

Maintenance Mode

Toggle maintenance mode to show a branded maintenance page to users during deployments or emergency fixes. Schedule maintenance windows in advance with user notifications.

Database Health

Monitor query performance, connection pool utilization, replication lag, and backup status. Automated slow query detection with optimization suggestions.