feat(F-001): scaffold Next.js 15 project with TypeScript and Tailwind
- Initialize Next.js 15 with App Router and TypeScript strict mode - Configure Tailwind CSS with shadcn/ui theme system - Install shadcn/ui components (button, card, input, table, etc.) - Set up ESLint and Prettier with automatic formatting - Configure path aliases (@/*) in tsconfig.json - Create full project structure per CLAUDE.md - Add health check endpoint at /api/health - Configure next.config.ts with output: 'standalone' for Docker - Set up Prisma with placeholder schema - Configure Vitest (unit) and Playwright (E2E) testing - Add VS Code settings for consistent development experience Build verification: TypeScript compilation, ESLint, and production build all pass. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
6ef918aad4
commit
7cd434aa82
46 changed files with 15627 additions and 13 deletions
84
README.md
Normal file
84
README.md
Normal file
|
|
@ -0,0 +1,84 @@
|
|||
# Vorteq Quest Portal
|
||||
|
||||
Modern customer portal for Vorteq Coil, built with Next.js 15, TypeScript, and PostgreSQL.
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **Framework:** Next.js 15 with App Router
|
||||
- **Language:** TypeScript (strict mode)
|
||||
- **Database (App):** PostgreSQL 16 with Prisma ORM
|
||||
- **Database (Epicor):** SQL Server (read-only via mssql package)
|
||||
- **Auth:** Better Auth
|
||||
- **UI:** shadcn/ui + Tailwind CSS
|
||||
- **Cache/Queue:** Redis 7 + BullMQ
|
||||
- **Email:** Microsoft Graph API
|
||||
- **Infrastructure:** Docker + Traefik + Forgejo CI/CD
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Node.js 22 LTS
|
||||
- Docker & Docker Compose
|
||||
- Access to Epicor SQL Server
|
||||
|
||||
### Development Setup
|
||||
|
||||
1. Install dependencies:
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
2. Set up environment variables:
|
||||
```bash
|
||||
cp .env.example .env
|
||||
# Edit .env with your configuration
|
||||
```
|
||||
|
||||
3. Initialize database:
|
||||
```bash
|
||||
npm run db:push
|
||||
npm run db:seed
|
||||
```
|
||||
|
||||
4. Run development server:
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
5. Open [http://localhost:3000](http://localhost:3000)
|
||||
|
||||
### Available Scripts
|
||||
|
||||
- `npm run dev` - Start development server
|
||||
- `npm run build` - Build for production
|
||||
- `npm run start` - Start production server
|
||||
- `npm run lint` - Run ESLint
|
||||
- `npm run typecheck` - Run TypeScript compiler check
|
||||
- `npm test` - Run unit tests
|
||||
- `npm run test:e2e` - Run E2E tests
|
||||
- `npm run db:push` - Push Prisma schema to database
|
||||
- `npm run db:migrate` - Create migration
|
||||
- `npm run db:seed` - Seed database
|
||||
|
||||
## Project Structure
|
||||
|
||||
See `CLAUDE.md` for detailed project structure and coding conventions.
|
||||
|
||||
## Documentation
|
||||
|
||||
- **Project Instructions:** `CLAUDE.md`
|
||||
- **Task Tracking:** `TASKS.md`
|
||||
- **PRD:** `docs/Vorteq_Quest_PRD_v1.0.docx`
|
||||
- **Legacy Documentation:** `docs/` directory
|
||||
|
||||
## Infrastructure
|
||||
|
||||
- **Production:** https://quest.vorteq.wulf.cloud
|
||||
- **Development:** https://dev.quest.vorteq.wulf.cloud
|
||||
- **Testing:** https://testing.vorteq.wulf.cloud
|
||||
- **Traefik Dashboard:** https://traefik.vorteq.wulf.cloud
|
||||
|
||||
## License
|
||||
|
||||
Proprietary - Vorteq Coil
|
||||
Loading…
Add table
Add a link
Reference in a new issue