Goa-gel-fullstack/docs/guides/USER_GUIDE.md

# 📘 Goa-GEL Platform User Guide

## Welcome to Goa-GEL!

Goa-GEL is a blockchain-based government licensing verification platform for the State of Goa. This guide will help you understand how to use the platform based on your role.

---

## 🚀 Getting Started

### Accessing the Platform

1. Open your web browser (Chrome, Firefox, Safari, or Edge)
2. Go to: **http://localhost:4200** (or the URL provided by your administrator)
3. You'll see the login page

### Demo Accounts (For Testing)

The platform comes with pre-configured demo accounts:

| Role | Email | Password |
|------|-------|----------|
| **Administrator** | admin@goa.gov.in | Admin@123 |
| **Fire Department** | fire@goa.gov.in | Fire@123 |
| **Tourism Department** | tourism@goa.gov.in | Tourism@123 |
| **Municipality** | municipality@goa.gov.in | Municipality@123 |
| **Citizen** | citizen@example.com | Citizen@123 |

---

## 🔐 How to Log In

### Step 1: Go to Login Page
- Click on **"Login"** or **"Sign In"** button on the homepage

### Step 2: Enter Your Credentials
**Option A - Manual Entry:**
1. Type your email address in the "Email" field
2. Type your password in the "Password" field
3. Click **"Sign In"**

**Option B - Quick Demo Login:**
1. Look for the "Demo Accounts" section
2. Click on any demo account card (e.g., "Admin", "Citizen")
3. The email and password will auto-fill
4. Click **"Sign In"**

### Step 3: After Login
- You'll be redirected to your dashboard
- Your name and role will appear in the top-right corner

### Forgot Password?
- Click **"Forgot Password?"** link below the login form
- Enter your registered email
- Check your email for password reset instructions

---

## 👤 User Roles & What They Can Do

### 1. **Administrator** 👨‍💼
**What you can do:**
- Onboard new government departments
- View all users and departments
- Monitor blockchain transactions
- Track all license requests
- View system logs and events
- Regenerate department API keys
- Activate/deactivate departments

### 2. **Department Officer** 🏛️
**What you can do:**
- Review license applications assigned to your department
- Approve or reject applications
- Request additional documents from applicants
- View your department's approval history
- Track applications you've reviewed

### 3. **Citizen/Applicant** 👥
**What you can do:**
- Create new license applications
- Upload required documents
- Submit applications for review
- Track application status
- Respond to change requests from departments
- Download approved licenses
- View approval history

---

## 📋 Guide by User Role

---

## 1️⃣ For Administrators

### A. Accessing the Admin Portal

1. **Log in** using admin credentials
2. Click on your **name** in the top-right corner
3. Select **"Admin"** from the dropdown menu
4. You'll see the Admin Portal with 6 tabs

### B. Admin Portal Overview

The Admin Portal has **6 main tabs**:

#### **📊 Dashboard Tab**
Shows platform statistics:
- **Total Requests**: Number of license applications
- **Departments**: Active and total departments
- **Applicants**: Registered citizens
- **Blockchain Transactions**: Total blockchain operations

**What to do here:**
- Monitor overall platform activity
- Check system health at a glance
- View key performance metrics

---

#### **🏢 Departments Tab**

**View All Departments:**
- See list of all registered departments
- Each entry shows:
  - Department Code (e.g., FIRE_DEPT)
  - Department Name
  - Wallet Address (blockchain identifier)
  - Status (Active/Inactive)
  - Action buttons

**Onboard a New Department:**

1. Click **"Onboard New Department"** button
2. Fill in the form:
   ```
   Department Code: POLICE_DEPT (use UPPERCASE and underscores)
   Department Name: Police Department
   Description: Law enforcement clearances
   Contact Email: police@goa.gov.in
   Contact Phone: +91-832-XXXXXXX
   ```
3. Click **"Onboard Department"**
4. **IMPORTANT**: A popup will show:
   - Wallet Address (for blockchain operations)
   - API Key (for system integration)
   - API Secret (keep this confidential!)
5. **Copy and save these credentials** - they won't be shown again!
6. Click **"Close"** after saving

**Regenerate API Key:**
1. Find the department in the list
2. Click **"Regenerate Key"** button
3. Confirm the action
4. **Save the new credentials** shown in the popup

**Deactivate a Department:**
1. Find the department in the list
2. Click **"Deactivate"** button
3. Confirm the action
4. The department's status will change to "Inactive"
5. They won't be able to review applications while inactive

**Reactivate a Department:**
1. Find the deactivated department
2. Click **"Activate"** button
3. Confirm the action
4. The department is now active again

---

#### **👥 Users Tab**

**View All Users:**
- See complete list of registered users
- Information shown:
  - Email Address
  - Full Name
  - Role (Admin, Department Officer, Citizen)
  - Wallet Address
  - Status (Active/Inactive)

**What to do here:**
- Monitor user registrations
- Verify user information
- Check wallet addresses

---

#### **💰 Transactions Tab**

**View Blockchain Transactions:**
- Shows all blockchain operations in real-time
- Each transaction displays:
  - Transaction Hash (unique identifier)
  - From/To Addresses (who sent/received)
  - Status (Pending/Confirmed/Failed)
  - Block Number (where it's stored on blockchain)
  - Gas Used (transaction cost)
  - Linked Request or Approval
  - Timestamp

**Filter Transactions:**
1. Use the **"Status"** dropdown to filter:
   - All Statuses
   - Pending (waiting for confirmation)
   - Confirmed (completed successfully)
   - Failed (transaction failed)
2. Click **"Apply Filters"**

**View Transaction Details:**
1. Click the **"eye" icon** on any transaction
2. See complete transaction information

**Statistics Cards:**
- **Confirmed**: Successfully completed transactions
- **Pending**: Transactions waiting for confirmation
- **Failed**: Transactions that failed
- **Total**: All transactions

---

#### **📡 Events Tab**

**View Blockchain Events:**
- Shows smart contract events in real-time
- Event types include:
  - LicenseRequested (new application submitted)
  - LicenseMinted (NFT created for license)
  - ApprovalRecorded (department approved/rejected)
  - LicenseUpdated (license information changed)

**Each Event Shows:**
- Event Type
- Contract Address (smart contract that emitted event)
- Block Number
- Transaction Hash
- Decoded Parameters (event-specific data)
- Timestamp

**Filter Events:**
1. **Event Type**: Select specific event type
2. **Contract Address**: Filter by smart contract
3. Click **"Apply Filters"**

---

#### **📝 Logs Tab**

**View Application Logs:**
- Shows system activity logs in real-time
- Log levels:
  - **INFO** (blue): General information
  - **WARN** (orange): Warnings
  - **ERROR** (red): Errors and issues

**Filter Logs:**
1. **Log Level**: Select INFO, WARN, or ERROR
2. **Module**: Filter by system module (e.g., AuthService, RequestService)
3. **Search**: Type keywords to search log messages
4. Click **"Apply Filters"**

**Export Logs:**
1. Click the **"Download"** icon (top-right)
2. Logs will be downloaded as JSON file
3. Use for troubleshooting or reporting

**What to Monitor:**
- ERROR logs for system issues
- Login activities in AuthService logs
- Request processing in RequestService logs

---

## 2️⃣ For Department Officers

### A. Logging In

1. Go to the platform login page
2. Enter your department email (e.g., fire@goa.gov.in)
3. Enter your password
4. Click **"Sign In"**

### B. Your Dashboard

After login, you'll see:
- **Pending Approvals**: Applications waiting for your review
- **Approved Requests**: Applications you've approved
- **Rejected Requests**: Applications you've rejected
- **Total Reviews**: Number of applications you've reviewed

### C. Reviewing License Applications

#### **Step 1: Find Pending Applications**
1. On your dashboard, go to **"Pending Approvals"** section
2. You'll see a list of applications assigned to your department
3. Each application shows:
   - Request Number
   - License Type (e.g., Resort License)
   - Applicant Name
   - Submission Date
   - Current Status

#### **Step 2: Open an Application**
1. Click on any application to view details
2. You'll see multiple tabs:
   - **Details**: Application information
   - **Documents**: Uploaded documents
   - **Approvals**: Other departments' reviews

#### **Step 3: Review Documents**

**In the Documents Tab:**
1. You'll see all uploaded documents in a grid layout
2. Each document card shows:
   - Document thumbnail or icon
   - Document name
   - File size
   - Upload date
   - File hash (blockchain proof)
   - IPFS hash (if applicable)
   - Current version number

**To View a Document:**
- Click the **"Preview"** button to view in browser
- Or click the **"Download"** button to download

**To Check Version History:**
1. Look for **"History"** button on document card
2. Or expand the **"Version History"** panel
3. You'll see:
   - All previous versions
   - Who uploaded each version
   - When it was uploaded
   - File hash for each version
   - Changes description (if provided)

**To View Document Hash:**
- File hash is displayed below document name
- Click the **"Copy"** icon to copy hash to clipboard
- Use this to verify document authenticity

#### **Step 4: Make Your Decision**

You have three options:

**Option A: Approve the Application**

1. Click **"Approve"** button (green)
2. A dialog will open
3. Enter your remarks/comments:
   ```
   Example: "Fire safety requirements met. All fire exits properly marked.
   Fire extinguishers installed as per standards."
   ```
4. Click **"Approve"** to confirm
5. Success message will appear
6. Blockchain transaction will be created
7. Applicant will be notified

**Option B: Reject the Application**

1. Click **"Reject"** button (red)
2. A dialog will open
3. Select rejection reason from dropdown:
   - Incomplete Documents
   - Non-Compliance
   - Invalid Information
   - Safety Concerns
   - Other
4. Enter detailed remarks explaining why:
   ```
   Example: "Fire safety layout does not meet current standards.
   Please provide updated fire escape plan showing secondary exits."
   ```
5. Click **"Reject"** to confirm
6. Applicant will receive your feedback

**Option C: Request Changes/Additional Documents**

1. Click **"Request Changes"** button (orange)
2. A dialog will open
3. Select required documents from the list:
   - Environmental Clearance
   - Building Plan
   - Ownership Proof
   - Safety Certificate
   - Other documents
4. Enter remarks explaining what changes are needed:
   ```
   Example: "Please provide updated environmental clearance certificate
   dated within the last 6 months. Current certificate has expired."
   ```
5. Click **"Request Changes"**
6. Application status will change to "Pending Resubmission"
7. Applicant will be notified to provide requested documents

#### **Step 5: After Your Review**

**What Happens Next:**
- Your review is recorded on the blockchain
- A blockchain transaction is created
- Applicant receives notification
- Your review appears in the application's approval history
- If you approved: Other departments can now review
- If you requested changes: Applicant must resubmit before further reviews
- If you rejected: Application workflow may end or be resubmitted

**Track Your Reviews:**
1. Go to your dashboard
2. Check **"Approved"**, **"Rejected"**, or **"Changes Requested"** sections
3. Click on any application to view status

---

### D. Reviewing Updated Documents (After Change Request)

**When an applicant uploads new documents:**

1. The application will reappear in your **"Pending Approvals"**
2. Open the application
3. Go to **"Documents"** tab
4. You'll see:
   - **New documents** marked with "New" badge
   - **Updated documents** showing **"Version 2"** or higher
5. Click **"Version History"** to see:
   - Original document (Version 1)
   - Updated document (Version 2)
   - Change description
   - Both file hashes
6. Review the new/updated documents
7. Make your decision again (Approve/Reject/Request More Changes)

**Important Note:**
- If documents were changed after you approved, your previous approval may be invalidated
- You'll need to review and approve again
- This ensures all approvals are valid for the latest document versions

---

### E. Viewing Approval History

**To see applications you've reviewed:**

1. On your dashboard, go to:
   - **"Approved Requests"** tab
   - **"Rejected Requests"** tab
   - Or **"All My Reviews"**

2. Each entry shows:
   - Request number
   - Applicant name
   - License type
   - Your decision (Approved/Rejected/Changes Requested)
   - Review date
   - Your remarks

3. Click any entry to view full application details

---

## 3️⃣ For Citizens/Applicants

### A. Creating Your Account

**If you don't have an account yet:**

1. Go to the platform homepage
2. Click **"Register"** or **"Sign Up"**
3. Fill in your details:
   ```
   Full Name: Your full name as per ID
   Email: your.email@example.com
   Phone: +91-XXXXXXXXXX
   Password: Create a strong password (min 8 characters)
   Confirm Password: Re-enter password
   ```
4. Check the box: **"I accept the Terms and Conditions"**
5. Click **"Register"**
6. You'll receive a confirmation email
7. Click the link in the email to verify your account
8. **Your blockchain wallet is created automatically!**

### B. Logging In

1. Go to login page
2. Enter your email and password
3. Click **"Sign In"**
4. You'll see your dashboard

### C. Your Dashboard

After login, you'll see:
- **My Requests**: Your license applications
- **Wallet Address**: Your blockchain identifier
- **Quick Actions**: Create new request, view documents
- **Application Status Summary**:
  - Draft (not submitted yet)
  - Submitted (under review)
  - Approved (license granted)
  - Rejected (needs attention)

---

### D. Creating a New License Application

#### **Step 1: Start New Application**

1. On your dashboard, click **"New Request"** or **"Create Application"**
2. You'll see a form

#### **Step 2: Select License Type**

Choose the type of license you need:
- **Resort License**: For hotels and resorts
- **Restaurant License**: For food establishments
- **Event Permit**: For organizing events
- **Trade License**: For business operations
- **Other**: (Select from dropdown)

#### **Step 3: Fill in Application Details**

Fill in all required fields marked with ***** :

**For Resort License Example:**
```
Resort Name: Goa Beach Paradise Resort
Business Name: Beach Paradise Pvt Ltd
Location/Address: 123 Calangute Beach Road, Goa
PIN Code: 403516
Property Type: Beachfront Resort
Number of Rooms: 50
Guest Capacity: 100
Contact Person: Your Name
Contact Phone: +91-XXXXXXXXXX
Contact Email: your.email@example.com
```

**Additional Information:**
- Business Registration Number
- PAN Number
- GST Number (if applicable)
- Property Ownership Details

#### **Step 4: Upload Required Documents**

**Important: Have these documents ready (PDF or Image format):**

1. **Business Registration Certificate**
   - Max size: 10MB
   - Format: PDF preferred

2. **Property Ownership Proof**
   - Sale Deed / Lease Agreement
   - Format: PDF

3. **Building Plan**
   - Approved by local authorities
   - Format: PDF or Image

4. **Fire Safety Certificate**
   - From Fire Department
   - Format: PDF

5. **Environmental Clearance** (if applicable)
   - Format: PDF

6. **Other Documents** as required

**To Upload:**
1. Click **"Choose File"** or drag and drop
2. Select file from your computer
3. Wait for upload to complete
4. You'll see a green checkmark when successful
5. File hash will be generated automatically
6. Repeat for all required documents

**Document Upload Tips:**
- Ensure documents are clear and readable
- Use PDF format for multi-page documents
- Keep file sizes under 10MB
- Scan documents at minimum 300 DPI
- All documents must be valid (not expired)

#### **Step 5: Review Your Application**

1. Click **"Preview"** to review all information
2. Check all details carefully
3. Verify all documents are uploaded
4. Make changes if needed by clicking **"Edit"**

#### **Step 6: Save as Draft (Optional)**

If you're not ready to submit:
1. Click **"Save as Draft"**
2. Your application is saved
3. You can come back later to complete it
4. Go to **"My Requests"** → **"Drafts"** to continue

#### **Step 7: Submit Your Application**

When everything is ready:
1. Click **"Submit Application"**
2. A confirmation dialog will appear:
   ```
   "Are you sure you want to submit this application?
   Once submitted, you cannot make changes until review is complete."
   ```
3. Click **"Yes, Submit"**

**What Happens After Submission:**
- Your application status changes to **"SUBMITTED"**
- A blockchain transaction is created
- An NFT (license token) is minted for your application
- You'll receive a confirmation email
- Assigned departments are notified
- You'll receive a **Transaction Hash** and **Token ID**
- Review process begins

---

### E. Tracking Your Application Status

#### **Step 1: View Your Applications**

1. On your dashboard, go to **"My Requests"**
2. You'll see all your applications
3. Color-coded status indicators:
   - **Grey**: Draft (not submitted)
   - **Blue**: Submitted (under review)
   - **Orange**: Pending Resubmission (changes requested)
   - **Green**: Approved
   - **Red**: Rejected

#### **Step 2: Open Application Details**

1. Click on any application
2. You'll see multiple tabs:
   - **Details**: Application information
   - **Documents**: Your uploaded documents
   - **Approvals**: Department review status

#### **Step 3: Understanding Approval Status**

**In the Approvals Tab:**

You'll see a list of departments reviewing your application:
- **Fire Department**: Safety review
- **Tourism Department**: Tourism compliance
- **Municipality**: Local regulations
- **Police Department**: Security clearance (if applicable)

**Each Department Shows:**
- Department Name
- Status:
  - ⏳ **Pending**: Not reviewed yet
  - ✅ **Approved**: Department approved
  - ❌ **Rejected**: Department rejected
  - 🔄 **Changes Requested**: More documents needed
  - ⚠️ **Invalidated**: Was approved, but documents changed
- Review Date
- Officer Name (who reviewed)
- Remarks/Comments

**Approval Progress:**
- Track how many departments have approved
- See which departments are pending
- Read comments from each department

---

### F. Responding to Change Requests

**When a department requests changes:**

#### **Step 1: You'll Be Notified**
- Email notification: "Changes requested for your application"
- Application status changes to **"Pending Resubmission"**
- SMS notification (if enabled)

#### **Step 2: View What's Needed**

1. Open your application
2. Go to **"Approvals"** tab
3. Find the department that requested changes
4. Click on their review to see:
   - **Requested Documents**: What they need
   - **Remarks**: Detailed explanation
   - **Required By Date**: Deadline (if any)

**Example:**
```
Tourism Department requested changes:
- Environmental Clearance Certificate (new)
- Updated Building Plan (version 2)

Remarks: "Please provide recent environmental clearance
certificate dated within last 6 months. Current certificate
has expired."
```

#### **Step 3: Prepare Documents**

1. Gather the requested documents
2. Ensure they meet requirements mentioned in remarks
3. Scan or prepare digital copies
4. Check file sizes (max 10MB each)

#### **Step 4: Upload New Documents**

1. In your application, click **"Upload Additional Documents"**
2. Select document type from dropdown
3. Choose file from your computer
4. Add a description of changes:
   ```
   Example: "Environmental Clearance Certificate updated -
   issued on 15-Dec-2024 by Goa Pollution Control Board"
   ```
5. Click **"Upload"**
6. New document is added as **Version 2** (or new document)

**Version History:**
- Original document is kept as Version 1
- New document becomes Version 2
- Both versions are tracked
- Both file hashes recorded
- Change description saved

#### **Step 5: Resubmit Application**

1. After uploading all requested documents
2. Click **"Resubmit Application"**
3. Confirm resubmission
4. Application goes back to the department for re-review

**Important Notes:**
- When you upload new document versions, previous approvals from other departments may be invalidated
- Those departments will need to review and approve again
- This ensures all departments approve based on latest documents
- You'll see "Invalidated" status for those approvals
- Don't worry - they just need to review the updated documents

---

### G. Viewing Your Documents

**In the Documents Tab:**

#### **Document Grid View**
- All your documents displayed as cards
- Each card shows:
  - Document thumbnail or file icon
  - Document name
  - File size (e.g., 2.5 MB)
  - Upload date
  - Current version (e.g., v2)
  - File hash (for verification)
  - IPFS hash (if stored on IPFS)

#### **Document Actions**

**Preview Document:**
1. Click **"Preview"** button
2. Document opens in new tab
3. View without downloading

**Download Document:**
1. Click **"Download"** button
2. File downloads to your computer
3. Saved with original filename

**View Version History:**
1. Click **"History"** button
2. Or expand **"Version History"** panel
3. See table with all versions:
   - Version number (1, 2, 3...)
   - Upload date and time
   - Uploaded by (your name)
   - File hash
   - Changes description
   - Download button for each version

**Copy File Hash:**
1. Click **"Copy"** icon next to file hash
2. Hash copied to clipboard
3. Use for verification if needed

#### **Department Reviews on Documents**

Below each document, you'll see:
- **Department Reviews**: Which departments reviewed this document
- **Status Indicators**:
  - ✅ Green: Approved
  - ❌ Red: Rejected
  - ⏳ Grey: Pending
- **Reviewer Name**: Officer who reviewed
- **Review Date**: When they reviewed
- **Comments**: Their remarks (if any)

---

### H. After Your Application is Approved

#### **What You'll Receive:**

1. **Email Notification**: "Your application has been approved!"
2. **SMS Notification**: (if enabled)
3. **Dashboard Update**: Application status changes to **"APPROVED"** (green)

#### **Viewing Your Approved License:**

1. Go to **"My Requests"** → **"Approved"**
2. Click on the approved application
3. You'll see:
   - ✅ **Approval Status**: All departments approved
   - **Approval Date**: When final approval was given
   - **License Number**: Unique license identifier
   - **NFT Token ID**: Your blockchain license token
   - **Transaction Hash**: Blockchain proof
   - **Valid From/To**: License validity period

#### **Download Your License Certificate:**

1. In the approved application, click **"Download Certificate"**
2. PDF certificate will be generated with:
   - License number
   - Your details
   - Business details
   - Approval dates
   - All department approvals
   - QR code (for verification)
   - Blockchain proof (transaction hash and token ID)
3. Save and print this certificate
4. Display at your business premises

#### **Verify Your License on Blockchain:**

1. Copy your **Token ID** or **Transaction Hash**
2. Click **"View on Blockchain Explorer"** (if available)
3. Or go to blockchain explorer manually:
   - Etherscan (for Ethereum)
   - Polygonscan (for Polygon)
   - Or appropriate explorer for your network
4. Paste your Token ID or Transaction Hash
5. You'll see immutable blockchain record of your license

---

### I. If Your Application is Rejected

#### **Understanding Rejection:**

**Reasons for Rejection:**
- Incomplete documents
- Invalid information
- Non-compliance with regulations
- Safety concerns
- Missing required licenses/clearances

#### **What to Do:**

1. **Review Rejection Remarks:**
   - Open your application
   - Go to **"Approvals"** tab
   - Find the rejecting department
   - Read their detailed remarks carefully

2. **Understand the Issues:**
   - What documents are missing?
   - What information is incorrect?
   - What regulations weren't met?
   - What specific concerns were raised?

3. **Fix the Issues:**
   - Gather correct documents
   - Update incorrect information
   - Address all concerns mentioned
   - Get required clearances

4. **Create New Application:**
   - You may need to start a new application
   - Or the system may allow you to resubmit the same application
   - Upload correct documents
   - Provide accurate information
   - Address all previous issues

5. **Get Help:**
   - Contact the rejecting department for clarification
   - Phone: See department contact in rejection notice
   - Email: See department contact email
   - Visit department office if needed
   - Consult with professionals (architects, consultants) if needed

---

## 📱 Mobile Access

### Using Goa-GEL on Your Phone or Tablet

The platform works on mobile devices!

**Supported Browsers:**
- Chrome (recommended)
- Safari
- Firefox
- Edge

**Mobile-Friendly Features:**
- Responsive design adapts to screen size
- Touch-friendly buttons and menus
- Easy document upload from phone camera
- Notifications work on mobile
- Full functionality on smaller screens

**Tips for Mobile Use:**
1. Use landscape orientation for better view of tables and dashboards
2. Zoom in on documents to view details
3. Use phone camera to scan and upload documents directly
4. Enable notifications for instant updates

---

## 🔔 Notifications

### Types of Notifications You'll Receive

#### **Email Notifications:**
- Account creation confirmation
- Application submission confirmation
- Approval/rejection notifications
- Change request notifications
- Document upload confirmations
- License approval confirmation

#### **In-App Notifications:**
- Real-time status updates
- New approval/rejection
- Messages from departments
- System announcements

#### **SMS Notifications** (if enabled):
- Application submitted
- Application approved/rejected
- Urgent action required

---

## 💡 Tips & Best Practices

### For All Users:

1. **Password Security:**
   - Use a strong password (min 8 characters)
   - Include uppercase, lowercase, numbers, and symbols
   - Don't share your password
   - Change password regularly

2. **Email Verification:**
   - Keep your email address up to date
   - Check spam folder for notifications
   - Add noreply@goa.gov.in to contacts

3. **Document Preparation:**
   - Keep all documents ready before starting application
   - Ensure documents are clear and readable
   - Use PDF format for multi-page documents
   - Check file sizes (under 10MB)

4. **Regular Check-ins:**
   - Check your dashboard regularly
   - Respond promptly to change requests
   - Track application progress
   - Don't wait until last minute for submissions

### For Citizens:

1. **Complete Applications:**
   - Fill all required fields
   - Upload all required documents
   - Double-check information before submitting
   - Save draft if you need more time

2. **Document Quality:**
   - Scan documents at good resolution (300 DPI minimum)
   - Ensure all text is readable
   - Include all pages
   - Documents should be valid (not expired)

3. **Respond Quickly:**
   - When departments request changes, respond within deadline
   - Upload requested documents promptly
   - Check email daily for updates
   - Don't let applications expire

4. **Keep Records:**
   - Save confirmation emails
   - Download approved certificates
   - Keep transaction hashes
   - Store file hashes for document verification

### For Department Officers:

1. **Timely Reviews:**
   - Review applications within SLA (Service Level Agreement)
   - Don't let applications pending too long
   - Prioritize urgent applications
   - Check dashboard daily

2. **Clear Remarks:**
   - Write detailed, specific remarks
   - Explain exactly what's needed
   - Be professional and helpful
   - Provide contact info if applicant needs clarification

3. **Document Verification:**
   - Check all documents thoroughly
   - Verify document authenticity
   - Check expiry dates
   - Compare file hashes if needed
   - Review all versions if documents were updated

4. **Consistent Standards:**
   - Apply same standards to all applications
   - Follow department guidelines
   - Be fair and transparent
   - Document your reasoning

---

## ❓ Frequently Asked Questions (FAQ)

### General Questions

**Q: What is Goa-GEL?**
A: Goa-GEL is a blockchain-based government licensing verification platform for the State of Goa. It helps citizens apply for licenses and government departments to review and approve them, with all records stored securely on blockchain.

**Q: Why blockchain?**
A: Blockchain provides:
- Tamper-proof records
- Transparency
- Permanent storage
- Easy verification
- No single point of failure

**Q: What is a wallet address?**
A: A wallet address (like 0x1234...) is your unique identifier on the blockchain. It's created automatically when you register and is used to track your transactions and licenses.

**Q: What is a transaction hash?**
A: A transaction hash is a unique identifier for each blockchain transaction. It's like a receipt that proves your transaction happened and can be used to verify it on the blockchain.

**Q: What is an NFT in this context?**
A: NFT (Non-Fungible Token) represents your license on the blockchain. Each license is a unique digital token that proves ownership and authenticity.

---

### Account & Login Questions

**Q: I forgot my password. What should I do?**
A:
1. Click "Forgot Password?" on login page
2. Enter your registered email
3. Check email for reset link
4. Click link and create new password
5. Log in with new password

**Q: I'm not receiving emails from the platform**
A:
1. Check your spam/junk folder
2. Add noreply@goa.gov.in to contacts
3. Verify your email address is correct
4. Contact support if still not receiving

**Q: Can I change my email address?**
A: Yes, go to Profile Settings → Account Details → Change Email. You'll need to verify the new email.

**Q: Can I have multiple accounts?**
A: You should only have one account per email address. Multiple accounts for the same person are not recommended.

---

### Application Questions

**Q: How long does application review take?**
A: Review times vary by department and license type:
- Simple licenses: 7-15 days
- Complex licenses: 30-45 days
- Check specific license type for SLA

**Q: Can I edit my application after submitting?**
A: No, you cannot edit after submission. However:
- If department requests changes, you can upload new documents
- You may need to create a new application if major changes needed
- Save as draft first if you're not sure about any information

**Q: What documents do I need?**
A: Required documents vary by license type. Common documents:
- Business registration certificate
- Property ownership proof
- Building plan
- Fire safety certificate
- Environmental clearance
- Identity proof
- PAN card
- GST certificate (if applicable)

**Q: My document upload failed. What should I do?**
A:
1. Check file size (must be under 10MB)
2. Check file format (PDF, JPG, PNG only)
3. Check internet connection
4. Try again with smaller file
5. Try different browser
6. Contact support if problem persists

**Q: Can I upload documents from my phone?**
A: Yes! You can:
- Take photos directly from phone camera
- Upload from phone gallery
- Use document scanner apps for better quality
- Make sure files are clear and readable

---

### Review & Approval Questions

**Q: How do I know which department is reviewing my application?**
A: Open your application → Approvals tab. You'll see all departments and their status (Pending/Approved/Rejected/Changes Requested).

**Q: Why was my previous approval invalidated?**
A: When you upload new document versions, previous approvals may be invalidated because:
- Departments approved based on old documents
- New documents need to be reviewed
- Ensures all approvals are for current documents
- Those departments will review again quickly

**Q: I uploaded wrong document. Can I delete it?**
A:
- You cannot delete documents after upload
- Upload correct document as new version
- Add description explaining the correction
- Previous versions remain in history for audit

**Q: Department requested changes but didn't specify what's wrong**
A:
- Contact the department directly (phone/email in rejection notice)
- Visit department office for clarification
- Check remarks carefully - details are usually there
- Escalate to helpdesk if unclear

---

### Technical Questions

**Q: What browsers are supported?**
A:
- Chrome (recommended)
- Firefox
- Safari
- Edge
- Update to latest version for best experience

**Q: Does it work on mobile?**
A: Yes! The platform is fully responsive and works on:
- Phones (iOS and Android)
- Tablets
- Desktop computers

**Q: What is IPFS?**
A: IPFS (InterPlanetary File System) is a distributed file storage system. Some documents may be stored on IPFS for additional redundancy and accessibility.

**Q: How is my data secured?**
A:
- Passwords are encrypted (bcrypt hashing)
- Wallet private keys are encrypted (AES-256-CBC)
- All connections use HTTPS (SSL/TLS)
- Blockchain provides immutable records
- Regular backups

**Q: What if the platform is down?**
A:
- Try again after some time
- Check status page (if available)
- Contact support
- Your data is safe - nothing is lost
- Work continues after system is back

---

## 📞 Getting Help

### Support Contact Information

**Technical Support:**
- Email: support@goa.gov.in
- Phone: +91-832-XXXXXXX
- Hours: Monday-Friday, 9:00 AM - 6:00 PM IST

**Department-Specific Help:**
- Fire Department: fire@goa.gov.in | +91-832-XXXXXXX
- Tourism: tourism@goa.gov.in | +91-832-XXXXXXX
- Municipality: municipality@goa.gov.in | +91-832-XXXXXXX

**Admin Support:**
- For department onboarding: admin@goa.gov.in
- For user account issues: support@goa.gov.in

### Before Contacting Support

Have this information ready:
1. Your user ID or email
2. Application/Request number (if applicable)
3. Description of the issue
4. Screenshots (if helpful)
5. Error messages (if any)
6. Steps you've already tried

---

## 🎓 Video Tutorials (Coming Soon)

Check our YouTube channel for video guides:
- How to register and create account
- How to apply for licenses
- How to upload documents
- How to respond to change requests
- For department officers: How to review applications
- For administrators: How to use admin portal

**Subscribe**: youtube.com/goagovtech

---

## 📋 Quick Reference Card

### Citizen Quick Actions
| Task | Steps |
|------|-------|
| **Create Account** | Register → Fill details → Verify email |
| **New Application** | Dashboard → New Request → Fill form → Upload docs → Submit |
| **Check Status** | Dashboard → My Requests → Click application |
| **Upload New Document** | Application → Documents → Upload Additional → Choose file |
| **Download Certificate** | Approved application → Download Certificate |

### Department Officer Quick Actions
| Task | Steps |
|------|-------|
| **Review Application** | Dashboard → Pending Approvals → Click application |
| **Approve** | Application → Approve → Enter remarks → Submit |
| **Request Changes** | Application → Request Changes → Select docs → Enter remarks |
| **Check History** | Dashboard → Approved/Rejected Requests |

### Admin Quick Actions
| Task | Steps |
|------|-------|
| **Onboard Department** | Admin Portal → Departments → Onboard New → Fill form |
| **View Users** | Admin Portal → Users Tab |
| **Check Transactions** | Admin Portal → Transactions Tab |
| **View Logs** | Admin Portal → Logs Tab → Filter as needed |

---

## 📝 Glossary

**Blockchain**: A distributed, immutable ledger that records transactions

**Wallet Address**: Your unique identifier on the blockchain (e.g., 0x1234...)

**Transaction Hash**: Unique identifier for a blockchain transaction

**NFT (Non-Fungible Token)**: Unique digital token representing your license

**Gas**: Fee paid for blockchain transactions

**IPFS**: Distributed file storage system

**File Hash**: Unique fingerprint of a document for verification

**SLA (Service Level Agreement)**: Committed time for processing

**Token ID**: Unique identifier for your license NFT

**Smart Contract**: Self-executing code on blockchain

**Approval Chain**: Sequence of department approvals required

**Version History**: Record of all document versions

---

## 🔒 Privacy & Security

### Your Data Privacy

**What we collect:**
- Name, email, phone (for account)
- Application details
- Uploaded documents
- Transaction records
- Wallet address

**How we use it:**
- Process your applications
- Communicate updates
- Verify licenses
- Improve services
- Legal compliance

**Security measures:**
- Encrypted passwords
- Encrypted wallet keys
- Secure connections (HTTPS)
- Blockchain immutability
- Regular security audits
- Access controls

**Your rights:**
- Access your data
- Correct inaccurate data
- Request data deletion (subject to legal requirements)
- Opt-out of marketing communications

---

## ✅ Checklist for First-Time Users

### For Citizens:
- [ ] Create account and verify email
- [ ] Log in and explore dashboard
- [ ] View wallet address
- [ ] Understand license types
- [ ] Prepare required documents
- [ ] Create first application (can save as draft)
- [ ] Upload all documents
- [ ] Submit application
- [ ] Check status regularly

### For Department Officers:
- [ ] Log in with department credentials
- [ ] Explore dashboard
- [ ] View pending approvals
- [ ] Open sample application
- [ ] Review documents section
- [ ] Understand approval options
- [ ] Check approval history

### For Administrators:
- [ ] Log in as admin
- [ ] Access admin portal
- [ ] Explore all 6 tabs
- [ ] View platform statistics
- [ ] Check all departments
- [ ] Review user list
- [ ] Practice onboarding a test department
- [ ] View transaction and event logs

---

**End of User Guide**

For the latest updates, visit: **[Platform Website]**

For support: **support@goa.gov.in**

---

**Version**: 1.0
**Last Updated**: February 2026
**Platform**: Goa-GEL (Government e-Licensing)