mirror of
https://github.com/kjanat/livedash-node.git
synced 2026-01-16 19:52:09 +01:00
Kaj Kowalski
bde0b44ea0
- Implemented API session retrieval in `lib/api-auth.ts` to manage user sessions. - Created authentication options in `lib/auth-options.ts` using NextAuth.js with credentials provider. - Added migration scripts to create necessary tables for authentication in `migrations/0002_create_auth_tables.sql` and `prisma/migrations/20250601033219_add_nextauth_tables/migration.sql`. - Configured ESLint with Next.js and TypeScript support in `eslint.config.mjs`. - Updated Next.js configuration in `next.config.ts` for Cloudflare compatibility. - Defined Cloudflare Worker configuration in `open-next.config.ts` and `wrangler.jsonc`. - Enhanced type definitions for authentication in `types/auth.d.ts`. - Created a Cloudflare Worker entry point in `src/index.ts.backup` to handle API requests and responses.
116 lines
4.4 KiB
Markdown
116 lines
4.4 KiB
Markdown
# 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>)
|
||
.*%22&replace=%24%3Cversion%3E&logo=react&label=React&color=%2361DAFB>)
|
||
.*%22&replace=%24%3Cversion%3E&logo=typescript&label=TypeScript&color=%233178C6>)
|
||
.*%22&replace=%24%3Cversion%3E&logo=prisma&label=Prisma&color=%232D3748>)
|
||
.*%22&replace=%24%3Cversion%3E&logo=tailwindcss&label=TailwindCSS&color=%2306B6D4>)
|
||
|
||
## 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)
|
||
- npm or yarn
|
||
|
||
### Installation
|
||
|
||
1. Clone this repository:
|
||
|
||
```bash
|
||
git clone https://github.com/kjanat/livedash-node.git
|
||
cd livedash-node
|
||
```
|
||
|
||
2. Install dependencies:
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
3. Set up the database:
|
||
|
||
```bash
|
||
npm run prisma:generate
|
||
npm run prisma:migrate
|
||
npm run prisma:seed
|
||
```
|
||
|
||
4. Start the development server:
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
5. Open your browser and navigate to <http://localhost:3000>
|
||
|
||
## Environment Setup
|
||
|
||
Create a `.env` file in the root directory with the following variables:
|
||
|
||
```env
|
||
DATABASE_URL="file:./dev.db"
|
||
NEXTAUTH_URL=http://localhost:3000
|
||
NEXTAUTH_SECRET=your-secret-here
|
||
```
|
||
|
||
## Project Structure
|
||
|
||
- `app/`: Next.js App Router components and pages
|
||
- `components/`: Reusable React components
|
||
- `lib/`: Utility functions and shared code
|
||
- `pages/`: API routes and server-side code
|
||
- `prisma/`: Database schema and migrations
|
||
- `public/`: Static assets
|
||
- `docs/`: Project documentation
|
||
|
||
## Available Scripts
|
||
|
||
- `npm run dev`: Start the development server
|
||
- `npm run build`: Build the application for production
|
||
- `npm run start`: Run the production build
|
||
- `npm run lint`: Run ESLint
|
||
- `npm run format`: Format code with Prettier
|
||
- `npm run prisma:studio`: Open Prisma Studio to view database
|
||
|
||
## Contributing
|
||
|
||
1. Fork the repository
|
||
2. Create your feature branch: `git checkout -b feature/my-new-feature`
|
||
3. Commit your changes: `git commit -am 'Add some feature'`
|
||
4. Push to the branch: `git push origin feature/my-new-feature`
|
||
5. Submit a pull request
|
||
|
||
## License
|
||
|
||
This project is not licensed for commercial use without explicit permission. Free to use for educational or personal projects.
|
||
|
||
## Acknowledgments
|
||
|
||
- [Next.js](https://nextjs.org/)
|
||
- [Prisma](https://prisma.io/)
|
||
- [TailwindCSS](https://tailwindcss.com/)
|
||
- [Chart.js](https://www.chartjs.org/)
|
||
- [D3.js](https://d3js.org/)
|
||
- [React Leaflet](https://react-leaflet.js.org/)
|