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.
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
# 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
|
||||
|
||||
```bash
|
||||
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.
|
||||
Reference in New Issue
Block a user