Earthquake Catalogue Platform

User Guide

  • User Guide
    • Overview
      • Key Capabilities
    • Quick Start
    • What You’ll Learn
    • Supported Formats
      • Required Fields
    • Platform at a Glance
    • Quick Links
    • Next Steps
      • Getting Started
        • Prerequisites
        • Installation
        • First-Time Setup
        • Quick Tour
        • Next Steps
        • Troubleshooting
        • Getting Help
        • Next Steps
      • Uploading Data
        • Overview
        • Supported Formats
        • Upload Process
        • Field Mapping
        • Validation Rules
        • Troubleshooting
        • Best Practices
        • Next Steps
      • Importing from GeoNet
        • Overview
        • Data Source
        • Import Process
        • Import Results
        • Import History
        • Duplicate Detection
        • Best Practices
        • API Access
        • Troubleshooting
        • Next Steps
      • Merging Catalogues
        • Overview
        • Understanding Duplicates
        • Merge Strategies
        • How Metadata is Merged
        • Advanced Quality Control
        • Scientific Accuracy Features
        • Merge Process
        • Merge Results
        • Source Tracking
        • Best Practices
        • Advanced Features
        • Troubleshooting
        • Testing and Validation
        • Next Steps
        • References
      • Visualization
        • Overview
        • Interactive Maps
        • Charts and Graphs
        • Seismological Analytics
        • Filtering Data
        • Map Base Layers
        • Export Visualizations
        • Best Practices
        • Next Steps
      • Exporting Data
        • Overview
        • Export Formats
        • Export Process
        • Filtered Exports
        • Best Practices
        • File Naming
        • Troubleshooting
        • Next Steps
      • Quality Assessment
        • Overview
        • Quality Grades
        • Quality Components
        • Quality Filtering
        • Quality Visualization
        • Improving Quality
        • Quality Metrics Reference
        • Best Practices
        • Next Steps
        • References
  • Getting Started
    • Prerequisites
      • Software Requirements
      • Hardware Requirements
      • Supported Operating Systems
    • Installation
      • Step 1: Clone the Repository
      • Step 2: Install Dependencies
      • Step 3: Configure Environment Variables
      • Step 4: Set Up MongoDB
        • Option A: Local MongoDB
        • Option B: MongoDB Atlas (Cloud)
      • Step 5: Initialize the Database
      • Step 6: Start the Development Server
      • Step 7: Access the Application
    • First-Time Setup
      • Create Your Account
      • Promote to Admin
      • User Roles
    • Quick Tour
      • Dashboard
      • Upload Page
      • Import Page
      • Catalogues Page
      • Analytics Page
    • Next Steps
    • Troubleshooting
      • MongoDB Connection Failed
      • Port Already in Use
      • Module Not Found Errors
      • Build Errors
      • Authentication Issues
      • Slow Performance
    • Getting Help
    • Next Steps
  • Uploading Data
    • Overview
      • Upload Workflow
    • Supported Formats
      • CSV and TXT Files
      • JSON Files
      • GeoJSON Files
      • QuakeML Files
    • Upload Process
      • Step 1: Navigate to Upload Page
      • Step 2: Configure Parsing Options (Optional)
      • Step 3: Select Your File
      • Step 4: Review Parsed Data
      • Step 5: Map Fields to Schema
      • Step 6: Review Validation Results
      • Step 7: Name and Create Catalogue
      • Step 8: Review Results
    • Field Mapping
      • Auto-Detection
      • Saving Templates
    • Validation Rules
      • Required Field Validation
      • Optional Field Validation
      • Cross-Field Validation
    • Troubleshooting
      • Upload Fails to Start
      • Parse Errors
      • Date/Time Issues
      • Missing Data After Upload
    • Best Practices
      • Data Preparation
      • File Naming
      • Batch Uploads
    • Next Steps
  • Importing from GeoNet
    • Overview
      • Import Process Overview
    • Data Source
      • About GeoNet
      • FDSN Event Web Service
      • Data Fields Imported
    • Import Process
      • Step 1: Navigate to Import Page
      • Step 2: Configure Time Range
      • Step 3: Set Magnitude Filters
      • Step 4: Set Depth Filters (Optional)
      • Step 5: Define Geographic Bounds (Optional)
      • Step 6: Configure Duplicate Handling
      • Step 7: Select or Create Catalogue
      • Step 8: Start Import
    • Import Results
    • Import History
    • Duplicate Detection
      • Understanding Duplicates
      • Handling Strategies
    • Best Practices
      • Building a Baseline Catalogue
      • Maintaining Current Catalogues
      • Quality Considerations
      • Large Historical Imports
    • API Access
    • Troubleshooting
      • No Events Found
      • Timeout Errors
      • Too Many Duplicates
      • Incomplete Data
      • GeoNet Service Unavailable
    • Next Steps
  • Merging Catalogues
    • Overview
      • Merge Process Overview
    • Understanding Duplicates
      • What Makes Events Duplicates?
      • Why Duplicates Occur
      • Example Duplicate Detection
    • Merge Strategies
      • Strategy Decision Guide
      • Priority-Based Strategy
      • Average Values Strategy
      • Newest Data Strategy
      • Most Complete Strategy
      • Quality Score Strategy
    • How Metadata is Merged
    • Advanced Quality Control
    • Scientific Accuracy Features
    • Merge Process
      • Step 1: Navigate to Merge Page
      • Step 2: Select Source Catalogues
      • Step 3: Configure Matching Rules
      • Step 4: Choose Merge Strategy
      • Step 5: Configure Priority (if applicable)
      • Step 6: Name the Merged Catalogue
      • Step 7: Execute Merge
    • Merge Results
      • Detailed Statistics
    • Source Tracking
      • Provenance Metadata
      • Viewing Provenance
    • Best Practices
      • Before Merging
      • Threshold Selection
      • Quality Assurance
    • Advanced Features
      • Filtered Merging
      • Iterative Merging
      • Re-merging with Updated Data
    • Troubleshooting
      • Too Many Duplicates Found
      • Too Few Duplicates Found
      • Merge Takes Too Long
      • Unexpected Results
    • Testing and Validation
    • Next Steps
    • References
  • Visualization
    • Overview
      • Accessing Visualizations
    • Interactive Maps
      • Basic Map View
      • Enhanced Map View
      • Uncertainty Visualization
      • Focal Mechanisms
      • Station Coverage
    • Charts and Graphs
      • Magnitude-Frequency Distribution
      • Depth Distribution
      • Temporal Patterns
      • Quality Score Distribution
    • Seismological Analytics
      • b-value Analysis
      • Completeness Magnitude
      • Seismic Moment
      • Energy Release
      • Cluster Detection
    • Filtering Data
    • Map Base Layers
    • Export Visualizations
    • Best Practices
      • Effective Visualization
      • Presentation Tips
    • Next Steps
  • Exporting Data
    • Overview
      • Format Comparison
    • Export Formats
      • CSV Export
      • QuakeML Export
      • JSON Export
      • GeoJSON Export
    • Export Process
      • Via Web Interface
      • Via API
    • Filtered Exports
    • Best Practices
      • Format Selection
      • Data Validation
      • Large Catalogues
      • Metadata Preservation
    • File Naming
    • Troubleshooting
      • Export Fails
      • Invalid Data
      • Format Compatibility
    • Next Steps
  • Quality Assessment
    • Overview
      • Quick Reference
    • Quality Grades
      • Grade Definitions
    • Quality Components
      • 1. Location Quality (35%)
      • 2. Network Geometry (25%)
      • 3. Solution Quality (15%)
      • 4. Magnitude Quality (15%)
      • 5. Evaluation Status (10%)
    • Quality Filtering
      • Filter by Quality Grade
      • Filter by Specific Metrics
    • Quality Visualization
      • Quality Score Distribution
      • Quality on Map
      • Quality Trends
    • Improving Quality
      • For Data Uploads
      • For GeoNet Imports
      • For Merged Catalogues
    • Quality Metrics Reference
      • Azimuthal Gap
      • Phase Count
      • Station Count
      • RMS Residual
    • Best Practices
      • For Analysis
      • For Visualization
      • For Export
      • For Reporting
    • Next Steps
    • References

Developer Guide

  • Developer Guide
    • Overview
    • What You’ll Learn
    • Technology Stack
      • Frontend
      • Backend
      • Testing
    • Project Structure
    • Quick Links
    • Next Steps
      • Architecture
        • Overview
        • System Architecture
        • Data Flow Architecture
        • Component Architecture
        • Database Architecture
        • Security Architecture
        • Performance Architecture
        • Deployment Architecture
        • Next Steps
      • Development Setup
        • Prerequisites
        • Clone and Install
        • Environment Configuration
        • Start the Development Server
        • Database Initialization
        • Next Steps
      • Database Schema
        • QuakeML 1.2 Database Schema Design
      • API Development
        • Route Structure
        • Recommended Conventions
        • Example Skeleton
        • Testing and Documentation
      • Testing
        • Quick Test Guide - Earthquake Catalogue Fixes
        • Testing & Reliability Implementation - COMPLETE ✅
      • Contributing
        • Contributing to Earthquake Catalogue Platform
      • Implementation Notes
        • QuakeML Implementation
        • GeoNet Integration
        • Quality & Visualization
        • Data Processing
  • Architecture
    • Overview
    • System Architecture
      • High-Level Components
    • Data Flow Architecture
      • Upload Data Flow
      • Import Data Flow
      • Merge Data Flow
    • Component Architecture
      • Frontend Components
      • Backend API Routes
      • Core Libraries
    • Database Architecture
      • Collections
      • Indexes
    • Security Architecture
      • Authentication
      • Authorization
      • API Protection
    • Performance Architecture
      • Optimization Strategies
      • Scalability
    • Deployment Architecture
      • Production Environment
    • Next Steps
  • Development Setup
    • Prerequisites
    • Clone and Install
    • Environment Configuration
    • Start the Development Server
    • Database Initialization
    • Next Steps
  • Database Schema
    • QuakeML 1.2 Database Schema Design
      • Overview
      • Design Principles
      • QuakeML 1.2 Structure
        • Event (Top Level)
        • Origin (Location Information)
        • Magnitude
        • Pick (Phase Arrival Time)
        • Arrival (Association of Pick with Origin)
        • FocalMechanism
        • Amplitude
        • StationMagnitude
      • Proposed Database Schema
        • Core Columns (Frequently Queried)
        • Indexes for Performance
      • TypeScript Interfaces
      • Migration Strategy
      • Benefits
  • API Development
    • Route Structure
    • Recommended Conventions
    • Example Skeleton
    • Testing and Documentation
  • Testing
    • Quick Test Guide - Earthquake Catalogue Fixes
      • 🎯 What Was Fixed
      • 📊 Test Data Available
      • 🚀 Quick Test Steps
        • 1. View Catalogues
        • 2. Test Geographic Filtering
        • 3. Test Focal Mechanisms
      • 📁 Catalogue IDs
      • 🔍 Verification Queries
        • Count events by region:
        • Count events with focal mechanisms:
        • View a focal mechanism:
      • ✅ Success Criteria
      • 🔄 Re-import Data
      • 🗑️ Clean Up
    • Testing & Reliability Implementation - COMPLETE ✅
      • Executive Summary
      • Task 1: Fix 6 Minor Test Failures ✅
        • Issues Fixed
        • Results
      • Task 2: Add API Route Tests ✅
        • Tests Created
        • Test Approach
        • Results
      • Task 3: Add Component Tests ✅
        • Tests Created
        • Test Approach
        • Results
      • Task 4: Set Up CI/CD Pipeline ✅
        • GitHub Actions Workflows
        • Documentation
        • Results
      • Overall Results
        • Test Statistics
        • Test Breakdown
        • Test Files
        • Documentation Created
        • CI/CD Files Created
      • Quality Metrics
        • Test Coverage
        • Code Quality
        • CI/CD Quality
      • Production Readiness
        • Testing ✅
        • CI/CD ✅
        • Reliability ✅
        • Documentation ✅
      • Next Steps (Optional Enhancements)
        • 1. Implement Placeholder Tests (Priority: Medium)
        • 2. E2E Testing (Priority: Low)
        • 3. Performance Testing (Priority: Low)
        • 4. Advanced Monitoring (Priority: Low)
      • Conclusion
  • Contributing
    • Contributing to Earthquake Catalogue Platform
      • Table of Contents
      • Code of Conduct
      • Getting Started
        • Prerequisites
        • Development Setup
      • Development Workflow
        • Branch Naming
        • Local Development
      • Coding Standards
        • TypeScript
        • React Components
        • File Organization
        • Styling
      • Testing Guidelines
        • Test Structure
        • Test Coverage
        • Running Tests
      • Commit Guidelines
        • Commit Message Format
        • Pre-commit Checks
      • Pull Request Process
        • Before Submitting
        • PR Description Template
        • Review Process
      • Issue Guidelines
        • Bug Reports
        • Feature Requests
        • Questions
      • Getting Help

API Reference

  • API Reference
    • Catalogues API
      • List Catalogues
      • Create Catalogue
      • Get Catalogue
      • Update Catalogue
      • Delete Catalogue
    • Events API
      • Get Catalogue Events
        • 1. Cursor-Based Pagination (Recommended for Large Datasets)
        • 2. Page-Based Pagination
        • 3. Limit/Offset Pagination
      • Get Filtered Events
    • Import API
      • Import from GeoNet
      • Get Import History
    • Upload API
      • Upload File
    • Merge API
      • Merge Catalogues
    • Export API
      • Export Catalogue
    • Health Check API
      • Readiness Check
    • Error Responses
      • Error Response Format
      • HTTP Status Codes
      • Common Error Codes
    • Authentication API Overview
      • Authentication and Authorization System
        • Overview
        • User Roles
        • Setup and Installation
        • Current Auth Workflows
        • API Protection
        • Frontend Usage
        • Backend Usage
        • User Management
        • Security Best Practices
        • Troubleshooting
        • API Reference
    • Security Features
      • Security Features
        • Rate Limiting
  • Catalogues API
    • List Catalogues
    • Create Catalogue
    • Get Catalogue
    • Update Catalogue
    • Delete Catalogue
  • Events API
    • Get Catalogue Events
      • 1. Cursor-Based Pagination (Recommended for Large Datasets)
      • 2. Page-Based Pagination
      • 3. Limit/Offset Pagination
    • Get Filtered Events
  • Import API
    • Import from GeoNet
    • Get Import History
  • Upload API
    • Upload File
  • Merge API
    • Merge Catalogues
  • Export API
    • Export Catalogue
  • Authentication API Overview
    • Authentication and Authorization System
      • Overview
      • User Roles
        • 1. Admin
        • 2. Editor
        • 3. Viewer
        • 4. Guest
      • Setup and Installation
        • 1. Environment Variables
        • 2. Run Database Migration
        • 3. Change Default Admin Password
      • Current Auth Workflows
      • API Protection
        • Protected Endpoints
        • Public Endpoints
      • Frontend Usage
        • Authentication Hooks
        • Permission Gate Component
        • Protected Routes
      • Backend Usage
        • API Route Protection
        • Available Middleware Functions
      • User Management
        • Admin User Management Page
        • Programmatic User Management
      • Security Best Practices
      • Troubleshooting
        • “Authentication required” error
        • “Insufficient permissions” error
        • Migration fails
      • API Reference

Deployment & Administration

  • Deployment & Administration
    • Environment Setup
      • Required Variables
      • Optional Variables
      • Database Initialization
    • MongoDB Atlas Setup
    • Docker Deployment
      • Overview
      • Prerequisites
      • Quick Start
      • Environment Configuration
        • Required Variables
        • Optional Variables
      • Service Architecture
        • Application Service (app)
        • Database Service (mongodb)
        • Nginx Service (nginx)
      • Deployment Options
        • Option 1: Full Stack (with MongoDB)
        • Option 2: Application Only (with MongoDB Atlas)
        • Option 3: With Nginx Reverse Proxy
      • Health Checks
        • Application Health
        • Container Health Status
      • Management Commands
        • View Logs
        • Stop Services
        • Restart Services
        • Update Application
      • Database Backup
        • Backup MongoDB Data
        • Restore MongoDB Data
      • Troubleshooting
        • Container Won’t Start
        • Database Connection Failed
        • Out of Memory
        • Permission Denied
      • Security Best Practices
      • Next Steps
    • Vercel Deployment
      • Vercel Deployment Guide
        • Table of Contents
        • Prerequisites
        • MongoDB Atlas Setup
        • Next.js Configuration
        • Environment Variables
        • Database Initialization
        • Deployment Process
        • Post-Deployment Verification
        • Troubleshooting
        • Production Checklist
        • Cost Considerations
    • CI/CD Setup
      • CI/CD Pipeline Setup
        • Overview
        • GitHub Actions Workflows
        • Pre-commit Hooks
        • Test Coverage
        • Continuous Integration Best Practices
        • Deployment Pipeline
        • Monitoring & Alerts
        • Local Development Workflow
        • Troubleshooting
        • Customization
        • Security Considerations
        • Performance Optimization
        • Metrics & Analytics
        • Future Enhancements
        • Resources
        • Support
    • GeoNet Baseline Setup
      • GeoNet Baseline Catalogue Setup Guide
        • 📋 Overview
        • 🚀 Quick Start
        • 📊 Import Configuration Options
        • 🔄 Updating the Baseline Catalogue
        • 📁 Data Structure
        • 🧪 Testing the Import
        • 📖 API Documentation
        • 🎯 Use Cases
        • ⚠️ Important Notes
        • 🔧 Troubleshooting
        • 📚 Additional Resources
        • 🎉 Summary
  • Environment Setup
    • Required Variables
    • Optional Variables
    • Database Initialization
  • Vercel Deployment
    • Vercel Deployment Guide
      • Table of Contents
      • Prerequisites
      • MongoDB Atlas Setup
        • Existing Configuration
        • Verify Network Access for Vercel
        • (Optional) Create New Cluster
        • Atlas Optimizations
      • Next.js Configuration
        • Vercel-Specific Changes (Optional)
      • Environment Variables
        • Required Variables
        • Setting Variables in Vercel
        • Generating NEXTAUTH_SECRET
      • Database Initialization
        • Option 1: Run Locally (Recommended)
        • Option 2: Via MongoDB Compass
        • Option 3: Via Atlas UI
      • Deployment Process
        • Step 1: Connect Repository to Vercel
        • Step 2: Configure Build Settings
        • Step 3: Add Environment Variables
        • Step 4: Deploy
        • Step 5: Set Up Custom Domain (Optional)
      • Post-Deployment Verification
        • 1. Check Health Endpoint
        • 2. Test MongoDB Connection
        • 3. Verify Key Features
        • 4. Check Vercel Logs
      • Troubleshooting
        • Common Issues
        • Debug Mode
        • Getting Help
      • Production Checklist
      • Cost Considerations
        • Vercel Pricing
        • MongoDB Atlas Pricing
  • Docker Deployment
    • Overview
    • Prerequisites
    • Quick Start
    • Environment Configuration
      • Required Variables
      • Optional Variables
    • Service Architecture
      • Application Service (app)
      • Database Service (mongodb)
      • Nginx Service (nginx)
    • Deployment Options
      • Option 1: Full Stack (with MongoDB)
      • Option 2: Application Only (with MongoDB Atlas)
      • Option 3: With Nginx Reverse Proxy
    • Health Checks
      • Application Health
      • Container Health Status
    • Management Commands
      • View Logs
      • Stop Services
      • Restart Services
      • Update Application
    • Database Backup
      • Backup MongoDB Data
      • Restore MongoDB Data
    • Troubleshooting
      • Container Won’t Start
      • Database Connection Failed
      • Out of Memory
      • Permission Denied
    • Security Best Practices
    • Next Steps
  • MongoDB Atlas Setup
  • Authentication & Roles
    • Getting Started with Authentication
      • Quick Start
        • 1. Set Environment Variables
        • 2. Run the Migration
        • 3. Start the Development Server
        • 4. Test the Authentication
      • Testing API Protection
        • Test with curl
        • Test with Frontend
      • User Roles Summary
      • Common Tasks
        • Change User Role
        • Create Additional Admin Users
        • Reset Password (Manual)
      • Next Steps
      • Troubleshooting
        • “Database not initialized” error
        • Can’t login
        • “Insufficient permissions” error
        • Migration fails
      • Security Checklist
      • Support
    • Authentication and Authorization System
      • Overview
      • User Roles
        • 1. Admin
        • 2. Editor
        • 3. Viewer
        • 4. Guest
      • Setup and Installation
        • 1. Environment Variables
        • 2. Run Database Migration
        • 3. Change Default Admin Password
      • Current Auth Workflows
      • API Protection
        • Protected Endpoints
        • Public Endpoints
      • Frontend Usage
        • Authentication Hooks
        • Permission Gate Component
        • Protected Routes
      • Backend Usage
        • API Route Protection
        • Available Middleware Functions
      • User Management
        • Admin User Management Page
        • Programmatic User Management
      • Security Best Practices
      • Troubleshooting
        • “Authentication required” error
        • “Insufficient permissions” error
        • Migration fails
      • API Reference
    • ✅ Authentication System - FULLY WORKING!
      • Success Confirmation
      • What You Should See on the Profile Page
      • Your Current User
      • Complete Authentication Features Now Available
        • 1. User Registration (/register)
        • 2. User Login (/login)
        • 3. User Profile (/profile)
        • 4. Admin User Management (/admin/users)
        • 5. Protected API Routes
        • 6. Frontend Permission Controls
      • Testing the Full System
        • Test 1: Registration ✅
        • Test 2: Login ✅
        • Test 3: Profile ✅
        • Test 4: Role-Based Access
        • Test 5: Sign Out
      • Next Steps
        • 1. Create an Admin User
        • 2. Test Admin Features
        • 3. Test API Protection
        • 4. Create More Users
      • System Architecture
        • Authentication Flow
        • Role Hierarchy
        • Permission System
      • Files Created/Modified
        • Created (26 files)
        • Modified (7 files)
      • Documentation
      • Support
      • Congratulations! 🎉
  • User Management
    • How to Become an Admin
      • Overview
      • Method 1: Using the Promotion Script (Recommended)
        • Step 1: Find Your Email
        • Step 2: Run the Promotion Script
        • Step 3: Log Out and Log Back In
      • Method 2: Using MongoDB Shell
        • Step 1: Connect to MongoDB
        • Step 2: Update the User Role
        • Step 3: Verify the Change
        • Step 4: Log Out and Log Back In
      • Method 3: Using MongoDB Compass (GUI)
        • Step 1: Connect to MongoDB
        • Step 2: Navigate to Users Collection
        • Step 3: Find and Edit Your User
        • Step 4: Log Out and Log Back In
      • Method 4: Admin User Management (Once You Have an Admin)
        • Step 1: Log in as Admin
        • Step 2: Go to User Management
        • Step 3: Promote a User
      • Verifying Admin Access
        • In the User Menu (Top Right Avatar)
        • Admin Features You Can Access
        • Admin Permissions
      • Troubleshooting
        • “User not found” Error
        • Changes Not Taking Effect
        • Can’t Connect to MongoDB
        • Script Errors
      • Quick Reference
        • Promote User to Admin (Quick Command)
        • List All Users
        • Check Your Current Role
      • Security Notes
      • Next Steps
    • Change Password Feature
      • Overview
      • How to Change Your Password
        • Method 1: From the User Menu (Recommended)
        • Method 2: From Your Profile Page
        • Method 3: Direct URL
      • Change Password Form
        • 1. Current Password
        • 2. New Password
        • 3. Confirm New Password
      • Password Requirements
      • Step-by-Step Instructions
        • Step 1: Access the Change Password Page
        • Step 2: Enter Your Current Password
        • Step 3: Enter Your New Password
        • Step 4: Confirm Your New Password
        • Step 5: Submit the Form
        • Step 6: Success!
      • Common Errors and Solutions
        • “Current password is incorrect”
        • “New password must be at least 8 characters long”
        • “New passwords do not match”
        • “New password must be different from current password”
      • Security Best Practices
        • When to Change Your Password
        • Creating Strong Passwords
      • For Administrators
        • Resetting User Passwords
      • API Endpoint
      • Troubleshooting
        • Can’t Access the Change Password Page
        • Form Not Submitting
        • Password Changed But Can’t Login
      • Related Documentation
      • Quick Reference
        • Access Change Password Page
        • Password Requirements
        • Common Commands
    • ✅ Password Change Feature - Implementation Complete!
      • Overview
      • 🎯 What Was Implemented
        • 1. Change Password Page (/change-password)
        • 2. API Endpoint (/api/auth/change-password)
        • 3. User Interface Integration
      • 📁 Files Created
      • 📝 Files Modified
      • 🚀 How to Use
        • For Users
        • Password Requirements
      • 🔐 Security Features
      • 🎨 User Experience
        • Visual Features
        • Validation
        • Navigation
      • 🧪 Testing the Feature
        • Test Steps
        • Test Cases
      • 📊 API Details
        • Endpoint
        • Request
        • Success Response (200)
        • Error Responses
      • 🎯 Next Steps
        • For You (User)
        • For Future Enhancements (Optional)
      • 📚 Documentation
      • ✅ Summary
  • Monitoring
    • Debug Tools for Registration
      • Browser Console Debugger
      • Quick Test Function
      • Monitor Form Submission
      • Check Environment
      • Network Request Logger
      • Bookmarklet
      • React DevTools
      • MongoDB Query Helper
      • Server-Side Debugging
      • Quick Commands
      • Automated Test Script
      • Tips
      • Common Console Commands

Additional Resources

  • Data Validation Guide
    • Data Validation & Quality Assurance Guide
      • Overview
      • Table of Contents
      • Input Validation
        • Required Fields
        • Optional Fields with Validation
        • Validation Rules
      • Data Quality Assessment
        • 1. Completeness Score (0-100%)
        • 2. Consistency Score (0-100%)
        • 3. Accuracy Score (0-100%)
        • Overall Quality Grade
      • Cross-Field Validation
        • Magnitude-Depth Relationships
        • Uncertainty-Value Relationships
        • Quality Metrics Consistency
      • Quality Metrics
        • Location Quality
        • Network Geometry
        • Solution Quality
        • Magnitude Quality
      • Completeness Metrics
        • Required Fields Coverage
        • Optional Fields Coverage
        • Missing Data Patterns
      • Anomaly Detection
        • Extreme Values
        • Temporal Clustering
        • Geographic Anomalies
      • Best Practices
        • Data Preparation
        • Quality Improvement
        • Data Validation Workflow
        • Minimum Quality Standards
      • Error Messages Reference
        • Common Errors
        • Common Warnings
      • API Reference
        • Validation Functions
      • Support
  • Troubleshooting
    • Troubleshooting User Registration
      • Quick Diagnostic Checklist
        • 1. Check Environment Variables
        • 2. Run Database Migration
        • 3. Check MongoDB Connection
        • 4. Browser Developer Tools Debugging
      • Common Issues and Solutions
        • Issue 1: “Failed to fetch” or Network Error
        • Issue 2: “NEXTAUTH_SECRET must be provided”
        • Issue 3: “Database not initialized” or MongoDB Connection Error
        • Issue 4: “User with this email already exists”
        • Issue 5: Form Validation Not Working
        • Issue 6: Registration Succeeds but Can’t Login
      • Manual Testing Steps
        • Test 1: Successful Registration
        • Test 2: Duplicate Email
        • Test 3: Password Validation
        • Test 4: Password Mismatch
      • Debugging with curl
      • Check Server Logs
      • Database Verification
      • Still Having Issues?
      • Getting Help
      • Quick Fix Script
    • Registration Debugging Guide
      • Quick Start - Immediate Actions
        • Step 1: Update NEXTAUTH_URL
        • Step 2: Run the Test Script
        • Step 3: Use the Test Page
      • Debugging Workflow
        • 1. Check Browser Console (F12)
        • 2. Check Network Tab
        • 3. Check Server Logs
        • 4. Test with curl
      • Common Issues and Solutions
        • Issue 1: Button Does Nothing
        • Issue 2: “Failed to fetch” Error
        • Issue 3: “NEXTAUTH_SECRET must be provided”
        • Issue 4: MongoDB Connection Error
        • Issue 5: User Already Exists
      • Testing Checklist
      • Files to Check
      • Get More Help
      • Emergency Reset
      • Success Criteria
    • Registration Issue - FIXED ✅
      • Problem
      • Root Cause
      • Solution Applied
        • 1. Added Missing Environment Variables
        • 2. Ran Database Migration
        • 3. Verified API is Working
      • How to Use Registration Now
        • Option 1: Use the Web Interface
        • Option 2: Use the Test Page
        • Option 3: Use the API Directly
      • What Was Created
        • Test User
      • Next Steps
      • Troubleshooting
      • Files Modified
      • Testing Checklist
      • Support
  • Glossary
    • Seismological Terms
    • Technical Terms
    • Quality Grades
  • Changelog
    • Version 1.0.0
      • 2026-01 (Current)
      • 2025-12
      • 2025-11
      • 2025-10
      • 2025-09
    • Roadmap
  • Contributing
    • Contributing to Earthquake Catalogue Platform
      • Table of Contents
      • Code of Conduct
      • Getting Started
        • Prerequisites
        • Development Setup
      • Development Workflow
        • Branch Naming
        • Local Development
      • Coding Standards
        • TypeScript
        • React Components
        • File Organization
        • Styling
      • Testing Guidelines
        • Test Structure
        • Test Coverage
        • Running Tests
      • Commit Guidelines
        • Commit Message Format
        • Pre-commit Checks
      • Pull Request Process
        • Before Submitting
        • PR Description Template
        • Review Process
      • Issue Guidelines
        • Bug Reports
        • Feature Requests
        • Questions
      • Getting Help
Earthquake Catalogue Platform
  • Search

© Copyright 2026, Kenny Graham - Earth Sciences NZ.

Built with Sphinx using a theme provided by Read the Docs.