Product Reference Manager

Product Reference Manager is a React, Express, MySQL, Drizzle, and tRPC application for managing product catalogs with generated reference codes, duplicate detection, soft delete, filtering, and export workflows.

Stack

• React, Vite, TypeScript
• Express, tRPC, Drizzle ORM
• MySQL
• Caddy for production reverse proxy
• Windows Server startup scripts for local production deployment

Development

pnpm install
pnpm run dev

Copy .env.example to .env and set DATABASE_URL before running the app.

Production Build

pnpm run build
pnpm run start

The production server listens on PORT, defaulting to 3000. In production it fails fast if the configured port is busy, because Caddy proxies to a fixed backend port.

Windows Server Deployment

This repository includes Windows Server helper scripts for the current LAN deployment:

• repair-production-autostart.ps1 registers the corrected startup tasks.
• monitor-services.ps1 monitors Caddy, the Node process, port 3000, port 443, and /api/health.
• PRODUCTION_RUNBOOK.md documents production operation details.
• SETUP-WINDOWS-SERVICES.md documents the older service-wrapper setup path.

For the current server, Caddy serves https://192.168.1.201 and proxies to localhost:3000.

Verification

pnpm run check
pnpm run lint
pnpm run test
pnpm run build

License

MIT