ray
53 lines
1.7 KiB
Markdown
53 lines
1.7 KiB
Markdown
# SPQ v2 (React Rewrite)
|
|
|
|
## Project location
|
|
`/mnt/seagate8tb/Websites/ShopProQuote.backup-20260626-2058/spq-v2/`
|
|
|
|
This is the CANONICAL codebase going forward. All new features go here. The v1 site at `/mnt/seagate8tb/Websites/ShopProQuote/` is the live reference being superseded.
|
|
|
|
## Stack
|
|
- React 19 + TypeScript + Vite
|
|
- Tailwind CSS v4 (compiled, not CDN)
|
|
- PocketBase JS SDK (via npm, not CDN)
|
|
- React Router v7
|
|
- Zustand (state management)
|
|
- lucide-react (icons)
|
|
|
|
## Key files
|
|
- `src/types.ts` — all TypeScript interfaces
|
|
- `src/App.tsx` — routes
|
|
- `src/components/Layout.tsx` — sidebar nav
|
|
- `src/lib/pocketbase.ts` — PB client init
|
|
- `src/pages/*.tsx` — page components
|
|
|
|
## PocketBase config
|
|
- PB URL: `/pb` (relative — needs proxy when served standalone)
|
|
- Auth: users collection (same as v1)
|
|
- Admin auth: NOT working with cb66154f (credentials outdated or wrong endpoint)
|
|
|
|
## Features status
|
|
| Feature | v1 (live) | v2 (React) |
|
|
|---------|-----------|-------------|
|
|
| Login | ✅ | ✅ |
|
|
| Dashboard | ✅ (full) | ✅ (basic) |
|
|
| Quote Generator | ✅ (full) | ✅ (functional) |
|
|
| Customers CRUD | ✅ | 🚧 ported |
|
|
| Repair Orders | ✅ | 🚧 ported |
|
|
| Appointments | ✅ | 🚧 ported |
|
|
| Financial Dashboard | ✅ | 🚧 ported |
|
|
| Invoice Manager | ✅ | 🚧 ported |
|
|
| Settings (full) | ✅ | 🚧 ported |
|
|
|
|
## Local dev server
|
|
For testing spq-v2 locally with PB proxy, use the script at `/tmp/spq-backup-server.py`:
|
|
```
|
|
python3 /tmp/spq-backup-server.py # serves on :4173, proxies /pb → :8091
|
|
```
|
|
|
|
## Build and deploy
|
|
```
|
|
cd /mnt/seagate8tb/Websites/ShopProQuote.backup-20260626-2058/spq-v2
|
|
npm run build # outputs to dist/
|
|
npx tsc --noEmit # type check
|
|
```
|