Skip to content

dev.md

Latest commit

 

History

History
78 lines (60 loc) · 2.22 KB

dev.md

File metadata and controls

78 lines (60 loc) · 2.22 KB

🔧 Development

Development Mode

npm run dev

This starts both frontend and backend in development mode with hot reload.

Individual Services

Start backend only:

cd backend && npm run dev

Start specific frontend:

cd frontend && npm run dev:server    # Server admin (port 3000)
cd frontend && npm run dev:applicant # Applicant portal (port 3001)
cd frontend && npm run dev:counter   # Counter dashboard (port 3002)

🌐 Frontend Applications

Server Admin Frontend (Port 3000)

  • Path: /frontend/server/
  • Features: System management, queue monitoring, settings
  • Shutdown: Available in Settings page

Applicant Portal (Port 3001)

  • Path: /frontend/applicant/
  • Features: Chat interface, form filling, status checking

Counter Dashboard (Port 3002)

  • Path: /frontend/counter/
  • Features: Queue processing, applicant management

🚦 Server Management

Ports Configuration

  • Backend API: http://localhost:4000 - Serves all API endpoints and data templates
  • Server Frontend: http://localhost:3000 - Admin dashboard (auto-opens on startup)
  • Applicant Frontend: http://localhost:3001 - Customer portal
  • Counter Frontend: http://localhost:3002 - Staff dashboard

Automatic Startup

The npm run server:start command will:

  1. Start the backend server (port 4000)
  2. Start the server frontend (port 3000)
  3. Open the browser to the server admin page
  4. Provide coordinated shutdown via API

Manual Shutdown

  • Use the shutdown button in the server frontend settings
  • Or run npm run server:stop
  • Or use Ctrl+C in the terminal

📝 Scripts Reference

# Root level
npm run install-all      # Install all dependencies
npm run dev             # Start everything in dev mode
npm run start           # Start everything in production mode
npm run server:start    # Smart server startup with browser opening
npm run server:stop     # Clean shutdown of all services

# Frontend workspace
npm run dev:server      # Server admin frontend
npm run dev:applicant   # Applicant portal
npm run dev:counter     # Counter dashboard

# Backend
npm run dev             # Development with nodemon
npm start               # Production start