Apartment Billing and Management Portal

# Installation Instructions

## System Requirements

- Node.js 18 or newer

- npm

- Browser (Chrome, Edge, Firefox)

- MongoDB Atlas connection or local MongoDB if you are not using the in-memory fallback

## 1. Backend Setup

```bash

cd "c:/Users/kalya/OneDrive/Desktop/APT billing and maintainence portal/backend"

npm install

```

Create `backend/.env` with:

```env

PORT=5000

MONGO_URI=your_mongodb_connection_string

RAZORPAY_KEY_ID=your_razorpay_key_id

RAZORPAY_KEY_SECRET=your_razorpay_key_secret

JWT_SECRET=your_jwt_secret

```

Start the backend:

```bash

npm run dev

```

## 2. Frontend Setup

```bash

cd "c:/Users/kalya/OneDrive/Desktop/APT billing and maintainence portal/frontend"

npm install

npm run dev

```

## 3. Open the App

Open the frontend in your browser:

```text

http://localhost:5173

```

## 4. Admin Credentials

Use the default admin login:

- Email: `admin@gmail.com`

- Password: `adminpassword`

## Notes

- If `MONGO_URI` is missing, the backend may fall back to an in-memory MongoDB instance for local testing.

- Make sure `JWT_SECRET` is set before starting the backend.

- For payment flows, set valid Razorpay API keys.

1. Open the frontend URL shown by Vite in the browser:

• usually http://localhost:5173

1. Use the admin credentials:

• Email: admin@gmail.com
• Password: adminpassword

1. Resident users can:

• register
• log in
• view bills
• submit maintenance requests
• see announcements
• update profile

1. Admin users can:

• manage apartments
• manage residents
• create and update bills
• manage announcements
• review maintenance requests

1. Backend API runs on:

• http://localhost:5000

System Requirements

• Node.js 18+ installed
• npm installed
• Browser for frontend (Chrome, Edge, Firefox)
• MongoDB Atlas connection or local MongoDB if not using in-memory fallback
• Internet for Razorpay API if payment flow is used