# 📺 cPanel Installation - VISUAL REFERENCE GUIDE

**This guide shows you where to click in cPanel**

---

## 1️⃣ CPANEL MAIN DASHBOARD

When you login to cPanel, you'll see a page with many icons.

**Look for these icons:**

```
┌─────────────────────────────────┐
│      CPANEL DASHBOARD           │
├─────────────────────────────────┤
│ [FTP Accounts]    [File Manager]│
│ [MySQL Databases] [phpMyAdmin]  │
│ [AutoSSL]         [Error Log]   │
│ [Setup Node.js]   [...more...]  │
└─────────────────────────────────┘
```

---

## 2️⃣ FILE MANAGER - UPLOAD FILES

### Location: cPanel Home → File Manager → public_html

**What you'll see:**
```
[public_html folder]
  ├── index.html (if exists)
  ├── Trust Tax Advisor ← (Your project folder)
  │   ├── backend/
  │   ├── frontend/
  │   ├── database/
  │   └── ... (other files)
  └── ... other folders
```

**To Upload:**
1. Right-click empty space
2. Select "Upload Files" or "Upload Folder"
3. Choose entire `Trust Tax Advisor` folder
4. Wait for upload

---

## 3️⃣ MYSQL DATABASES - CREATE DATABASE

### Location: cPanel → MySQL Databases

**Screen Layout:**
```
┌────────────────────────────────────┐
│ Create New Database                │
├────────────────────────────────────┤
│ Database Name: [fmpdcrei_tta1    ] │
│ [Create Database Button]           │
└────────────────────────────────────┘

┌────────────────────────────────────┐
│ Create New User                    │
├────────────────────────────────────┤
│ Username: [fmpdcrei_tta1         ] │
│ Password: [Chintan@1993          ] │
│ [Create User Button]               │
└────────────────────────────────────┘

┌────────────────────────────────────┐
│ Add User to Database               │
├────────────────────────────────────┤
│ Select User:     [dropdown]        │
│ Select Database: [dropdown]        │
│ [Add Button]                       │
│ ☑ SELECT ☑ INSERT ☑ UPDATE ...    │
│ [Make Changes]                     │
└────────────────────────────────────┘
```

---

## 4️⃣ PHPMYADMIN - IMPORT SCHEMA

### Location: cPanel → phpMyAdmin

**Screen Layout:**
```
┌─────────────────────────┐
│ Left Side: Databases    │
│ ✓ fmpdcrei_tta1         │ ← Click this
│   └── (empty tables)    │
└─────────────────────────┘

┌──────────────────────────────────┐
│ Top Tabs                          │
│ [Structure] [SQL] [Import] ...    │
│                        ↑          │
│                   Click here      │
└──────────────────────────────────┘

┌──────────────────────────────────┐
│ Import Section                   │
├──────────────────────────────────┤
│ [Choose File Button]             │
│  Select: schema.sql              │
│                                  │
│ Character set: utf-8             │
│ Format: SQL                       │
│                                  │
│ [Import Button] ← CLICK HERE     │
└──────────────────────────────────┘

WAIT... (1-2 minutes)

┌──────────────────────────────────┐
│ SUCCESS MESSAGE                  │
│ "Import has been successfully    │
│  finished"                       │
└──────────────────────────────────┘
```

**After Import - Verify Tables:**
Click [Structure] tab, you should see:
```
✓ users
✓ connectors
✓ clients
✓ services
✓ leads
✓ orders
✓ commissions
✓ documents
✓ form_templates
✓ form_responses
✓ otp_logs
✓ audit_logs
```

---

## 5️⃣ FILE MANAGER - EDIT .ENV

### Location: File Manager → public_html → Trust Tax Advisor → backend

**What you'll see:**
```
[backend folder]
├── .env.example ← Copy this
├── .env         ← Create this (new)
├── server.js
├── config/
├── controllers/
├── models/
├── routes/
└── ... other files
```

**Steps:**

1. **Right-click** on `.env.example`
2. Select **Copy**
3. **Right-click** in same folder
4. Select **Paste**
5. **Rename** to `.env`
6. **Right-click** on `.env`
7. Select **Edit**
8. **Find and Update:**

```
BEFORE:
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=

AFTER:
DB_HOST=localhost
DB_USER=fmpdcrei_tta1
DB_PASSWORD=Chintan@1993
DB_NAME=fmpdcrei_tta1

BEFORE:
SMTP_USER=your-email@gmail.com
SMTP_PASSWORD=your-app-password

AFTER:
SMTP_USER=noreply@trusttaxadvisor.com
SMTP_PASSWORD=Chintan@1993
SMTP_HOST=mail.trusttaxadvisor.com
SMTP_PORT=465
SMTP_SECURE=true

BEFORE:
CORS_ORIGIN=http://localhost:3000

AFTER:
CORS_ORIGIN=https://crm.trusttaxadvisor.com
```

9. Click **Save**

---

## 6️⃣ SETUP NODE.JS APP

### Location: cPanel → Search "Setup Node.js App"

**Screen Layout:**
```
┌──────────────────────────────────┐
│ Create Node.js Application       │
├──────────────────────────────────┤
│ Node.js version: [18.x or Latest]│
│                                  │
│ Application root:                │
│ [/home/USERNAME/public_html/...] │
│ ^^ REPLACE USERNAME ^^           │
│                                  │
│ Application startup file:        │
│ [backend/server.js]              │
│                                  │
│ Application URL:                 │
│ [Leave as default]               │
│                                  │
│ [Create Button] ← CLICK HERE     │
└──────────────────────────────────┘

WAIT... (1-2 minutes)

SUCCESS:
"Node.js application successfully
 created!"
```

**Then:**
1. Click on your created app
2. Look for **NPM Install** button
3. Click it
4. WAIT 5-10 minutes
5. See: "npm install completed successfully!"

---

## 7️⃣ AUTO SSL - ENABLE HTTPS

### Location: cPanel → AutoSSL

**Screen Layout:**
```
┌──────────────────────────────────┐
│ Autosave SSL Certificates        │
├──────────────────────────────────┤
│ Domain: yourdomain.com           │
│ Status: [Check & Install]        │
│         ↑ CLICK THIS              │
└──────────────────────────────────┘

WAIT... (1-2 minutes)

SUCCESS:
"Certificate installed successfully!
 HTTPS is now enabled"
```

---

## 8️⃣ RESTART APPLICATION

### Back to: Setup Node.js App

**Find your app and:**
```
┌──────────────────────────────────┐
│ Your Node.js App                 │
├──────────────────────────────────┤
│ App Name: Trust-Tax-Advisor      │
│ Status: Running ✓                │
│                                  │
│ [Edit] [Restart] [Delete]        │
│         ↑ CLICK HERE              │
└──────────────────────────────────┘

WAIT... (1-2 minutes)

SUCCESS:
"Node.js app restarted successfully!"
```

---

## ✅ VERIFICATION CHECKLIST

### Test in Browser

**Open these URLs:**

1. **Login Page:**
   ```
   http://thechintanpatel.co.in
   ```
   ✓ You should see login page

2. **API Health Check:**
   ```
   http://thechintanpatel.co.in/api/health
   ```
   ✓ You should see:
   ```json
   {
     "status": "ok",
     "timestamp": "2026-03-18T..."
   }
   ```

3. **Admin Login:**
   - Mobile: `918733870977`
   - Click "Send OTP"
   - Check WhatsApp for code
   - Enter code
   ✓ Dashboard should load

---

## 🔴 TROUBLESHOOTING

### LOGIN PAGE WON'T LOAD?

**Check 1:** Wait 5 minutes for SSL
- SSL certificate takes time to activate

**Check 2:** Clear Browser Cache
- Press: `Ctrl + Shift + Delete`
- Delete all data
- Try again

**Check 3:** Try Private/Incognito Window
- `Ctrl + Shift + P` (Chrome)
- `Ctrl + Shift + N` (Firefox)

**Check 4:** Test API Connection
- Go to: `https://yourdomain.com/api/health`
- If it shows JSON → Backend OK
- If it fails → Check error logs

---

### NODE.JS APP WON'T START?

**Check 1:** Click Restart
- Go to Setup Node.js App
- Click Restart
- Wait 2-3 minutes

**Check 2:** Check Error Logs
- Go to File Manager
- Look for `.error.log` or error files
- Check what's wrong

**Check 3:** Verify .env File
- Is database password correct?
- Are all required fields filled?

---

### OTP NOT RECEIVED?

**Check:** 
- Mobile number is: `918733870977` ✓
- WhatsApp is active on that number ✓
- Try email login instead ✓
- Wait 3 minutes for API response ✓

---

## 🎓 HELPFUL TIPS

### Tip 1: Save Your Credentials
Write down somewhere safe:
```
cPanel Username: _______________
cPanel Password: _______________
Domain: _______________
Database User: fmpdcrei_tta1
Database Password: Chintan@1993
```

### Tip 2: Check Email Configuration First
Before testing login:
1. Send test email from cPanel → Email Accounts
2. Verify email works
3. Then test OTP system

### Tip 3: Clear Cache Between Tests
After making changes:
```
Browser Cache Clear → Ctrl+Shift+Delete
Then: Refresh page → Ctrl+R or F5
```

### Tip 4: Check File Permissions
If files won't upload:
- Ensure public_html folder is writable
- FileZilla shows permissions as 755 or 644

### Tip 5: Monitor Logs
For debugging issues:
- cPanel → Error Log (shows server errors)
- File Manager → Look for .log files
- Browser Console → F12 → Console tab

---

## 📞 GETTING HELP

If something goes wrong:

1. **Check Error Logs First:**
   - cPanel → Error Log
   - Look for red errors
   - Note the error message

2. **Check File Permissions:**
   - Make sure folders are 755
   - Make sure files are 644

3. **Restart Services:**
   - Click Restart on Node.js app
   - Clear browser cache
   - Try again after 2 minutes

4. **Contact Hosting Provider:**
   - If database won't connect
   - If ports are blocked
   - If FTP won't work

5. **Contact Developer:**
   - For configuration help
   - For custom changes
   - For advanced troubleshooting

---

**Installation Guide Complete!** ✅

You should now have a working Trust Tax Advisor installation on cPanel!