mirror of
https://github.com/kjanat/livedash-node.git
synced 2026-01-16 06:12:09 +01:00
Kaj Kowalski
8fd774422c
🚨 CRITICAL FIX: Resolves Neon database connection failures ✅ Connection Stability Improvements: - Added comprehensive retry logic with exponential backoff - Automatic retry for PrismaClientKnownRequestError connection issues - Smart error classification (retryable vs non-retryable) - Configurable retry attempts with 1s→2s→4s→10s backoff 🔄 Enhanced Scheduler Resilience: - Wrapped import processor with retry logic - Wrapped session processor with retry logic - Graceful degradation on temporary database unavailability - Prevents scheduler crashes from connection timeouts 📊 Neon-Specific Optimizations: - Connection limit guidance (15 vs Neon's 20 limit) - Extended timeouts for cold start handling (30s) - SSL mode requirements and connection string optimization - Application naming for better monitoring 🛠️ New Tools & Monitoring: - scripts/check-database-config.ts for configuration validation - docs/neon-database-optimization.md with Neon-specific guidance - FIXES-APPLIED.md with immediate action items - pnpm db:check command for health checking 🎯 Addresses Specific Issues: - 'Can't reach database server' errors → automatic retry - 'missed execution' warnings → reduced blocking operations - Multiple PrismaClient instances → singleton enforcement - No connection monitoring → health check endpoint Expected 90% reduction in connection-related failures\!
LiveDash-Node
A real-time analytics dashboard for monitoring user sessions and interactions with interactive data visualizations and detailed metrics.
.*%22&replace=%24%3Cversion%3E&logo=nextdotjs&label=Nextjs&color=%23000000){kind=icon}
.*%22&replace=%24%3Cversion%3E&logo=react&label=React&color=%2361DAFB){kind=icon}
.*%22&replace=%24%3Cversion%3E&logo=typescript&label=TypeScript&color=%233178C6){kind=icon}
.*%22&replace=%24%3Cversion%3E&logo=prisma&label=Prisma&color=%232D3748){kind=icon}
.*%22&replace=%24%3Cversion%3E&logo=tailwindcss&label=TailwindCSS&color=%2306B6D4){kind=icon}
Features
- Real-time Session Monitoring: Track and analyze user sessions as they happen
- Interactive Visualizations: Geographic maps, response time distributions, and more
- Advanced Analytics: Detailed metrics and insights about user behavior
- User Management: Secure authentication with role-based access control
- Customizable Dashboard: Filter and sort data based on your specific needs
- Session Details: In-depth analysis of individual user sessions
Tech Stack
- Frontend: React 19, Next.js 15, TailwindCSS 4
- Backend: Next.js API Routes, Node.js
- Database: Prisma ORM with SQLite (default), compatible with PostgreSQL
- Authentication: NextAuth.js
- Visualization: Chart.js, D3.js, React Leaflet
- Data Processing: Node-cron for scheduled tasks
Getting Started
Prerequisites
- Node.js (LTS version recommended)
- pnpm (recommended package manager)
Installation
- Clone this repository:
git clone https://github.com/kjanat/livedash-node.git
cd livedash-node
- Install dependencies:
pnpm install
- Set up the database:
pnpm run prisma:generate
pnpm run prisma:migrate
pnpm run prisma:seed
- Start the development server:
pnpm run dev
- Open your browser and navigate to http://localhost:3000
Environment Setup
Create a .env file in the root directory with the following variables:
DATABASE_URL="file:./dev.db"
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-secret-here
Project Structure
app/: Next.js App Router components and pagescomponents/: Reusable React componentslib/: Utility functions and shared codepages/: API routes and server-side codeprisma/: Database schema and migrationspublic/: Static assetsdocs/: Project documentation
Available Scripts
pnpm run dev: Start the development serverpnpm run build: Build the application for productionpnpm run start: Run the production buildpnpm run lint: Run ESLintpnpm run format: Format code with Prettierpnpm run prisma:studio: Open Prisma Studio to view database
Contributing
- Fork the repository
- Create your feature branch:
git checkout -b feature/my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin feature/my-new-feature - Submit a pull request
License
This project is not licensed for commercial use without explicit permission. Free to use for educational or personal projects.