Files
Vector/README.md
T
josh 7c0d422228
CI / Lint · Typecheck · Test · Build (push) Failing after 5m41s
CI / Playwright (smoke) (push) Has been skipped
chore: initial Vector 2.0 monorepo
Ground-up TypeScript rewrite of the Vector hardware parts inventory
system. Ships the full roadmap (Phases 0-8) in one initial commit:

- pnpm + Turbo monorepo: apps/{api,web,e2e}, packages/{db,shared,ui,config}
- Express 5 + Prisma 5 + zod validation + JWT w/ refresh-token rotation
- React 19 + Vite + shadcn/ui + TanStack Query/Table + nuqs URL state
- Repair/RMA, tags, bulk ops, saved views, CSV audit export
- Analytics dashboard on Recharts + EOL tracking
- Signed webhook subscriptions (HMAC-SHA256) with in-process emitter
- Vitest unit tests (shared schemas, api services/helpers) + Playwright skeleton
- Gitea Actions CI (lint, typecheck, test+coverage, build) + Renovate

Deferred follow-ups: Postgres cutover (data-migration script ready),
BullMQ worker for webhook delivery, @react-pdf PDF export, CSV import wizard.
2026-04-16 20:52:32 -04:00

1.1 KiB

Vector 2.0

Hardware parts inventory — monorepo.

Layout

apps/
  web/       # React + Vite client
  api/       # Express + Prisma API
packages/
  db/        # Prisma schema + client (placeholder)
  shared/    # Shared zod schemas + types (placeholder)
  ui/        # Design system + shadcn primitives (placeholder)
  config/    # Shared eslint / tsconfig / tailwind (placeholder)

Prereqs

  • Node >= 20
  • pnpm (via npm i -g pnpm or corepack)
  • Docker (for Postgres + Redis in later phases — current apps still use SQLite)

Quick start

pnpm install
pnpm dev          # runs apps/web and apps/api concurrently via Turbo

The API listens on http://localhost:3001; the web app proxies /api to it and serves on http://localhost:5173.

Phase status

Phase 0 — Monorepo foundation

  • pnpm workspaces + Turbo
  • apps/web and apps/api scaffolded
  • packages/* placeholders
  • docker-compose.yml for Postgres + Redis

Later phases: TypeScript + Postgres migration, API refactor, schema extensions, shadcn redesign, feature slices, observability.