Skip to content

kostasuser01gr/KinsenOPS-Intelligence

Repository files navigation

KinsenOPS Platform

CI License: MIT Next.js TypeScript

Full-stack operations intelligence platform for fleet management, rental operations, and business analytics.

Built with Next.js 16, React 19, tRPC, Prisma, and Supabase. This repo is kept local-first; hosted deployment is optional and requires explicit approval before any platform state is changed.

Portfolio review UX: the root route is a public product overview, not a sign-in wall. Protected dashboards still require authentication.


Features

Module Description
Dashboard KPI overview, live metrics, activity feed
Fleet Vehicle inventory, status tracking, maintenance scheduling
Rentals Booking lifecycle, customer management, contract generation
Finance Revenue tracking, invoicing, expense reports
Analytics Charts, trend analysis, operational insights
Tasks Internal task management with priority queues
Incidents Incident reporting, escalation, audit trail
AI Chat Integrated assistant for query resolution

Tech Stack

Frontend

  • Next.js 16 (App Router) · React 19 · TypeScript 5
  • Tailwind CSS 4 · Radix UI · shadcn/ui · Lucide · Sonner

Backend

  • tRPC 11 (end-to-end type-safe API)
  • Prisma 6 + PostgreSQL (via Supabase)
  • NextAuth v5 (session-based auth)
  • Zod 4 validation · React Hook Form · TanStack Query

Infrastructure

  • Supabase (Postgres + Auth + Storage)
  • Cloudflare Workers support via OpenNext + Wrangler
  • Local-only development by default

Getting Started

Prerequisites

  • Node.js 20+
  • npm
  • A local or separately approved Supabase-compatible Postgres database

Setup

git clone https://github.com/kostasuser01gr/KinsenOPS-Platform
cd KinsenOPS-Platform
npm install
cp .env.example .env.local

Set these in .env.local:

DATABASE_URL=your_supabase_postgres_connection_string
DIRECT_URL=your_supabase_direct_url
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
AUTH_SECRET=your_nextauth_secret
npx prisma generate
npx prisma db push
npm run dev

Open http://localhost:3000

Local-Only / Zero-Charge Mode

Do not run deployment, linking, or platform secret commands unless you explicitly intend to change hosted platform state. In zero-charge mode, use only local commands such as npm ci, npm run build, npm run cf:build, and npx tsc --noEmit.

wrangler.jsonc intentionally contains only non-secret defaults. Keep database URLs, Supabase keys, auth secrets, and platform tokens in local environment files or platform secret stores; never commit them to the repo.


Project Structure

src/
├── app/
│   ├── (auth)/          # Login, register pages
│   ├── (dashboard)/     # Protected app routes
│   │   ├── analytics/
│   │   ├── audit/
│   │   ├── chat/
│   │   ├── finance/
│   │   ├── fleet/
│   │   ├── incidents/
│   │   ├── rentals/
│   │   └── tasks/
│   └── api/             # tRPC handler + auth endpoints
├── components/          # Reusable UI components
├── hooks/               # Custom React hooks
├── lib/                 # tRPC client, Supabase client, utils
└── server/              # tRPC routers, Prisma client

License

MIT


Author

Konstantinos Foskolakis Full-stack engineer — Heraklion, Crete, Greece github.com/kostasuser01gr


Portfolio Positioning

This project demonstrates full-stack Next.js platform architecture at production depth: tRPC for end-to-end type-safe APIs, Prisma with Supabase PostgreSQL for data persistence, NextAuth v5 for session management, and Cloudflare Workers for edge deployment. The eight operational modules — fleet, rentals, finance, analytics, tasks, incidents, AI chat, and dashboard — are not feature stubs; they represent a complete operational domain model for a rental business. The public portfolio overview route ensures the deployment is accessible without auth, which is a deliberate UX decision for portfolio reviewers. The CI pipeline validates type safety and build integrity on every commit.

Built as a portfolio-grade full-stack operations intelligence platform. Estimated implementation effort for the current public version: 6–10 focused development days.

About

KinsenOPS Platform — Full-stack operations intelligence platform with Next.js 15, tRPC, Prisma, Supabase: fleet, rentals, finance, analytics, and AI assistant

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors