LeadCaptureMT Help Manual

Online static help file included inside the project.

Download DOCX Manual

LeadCaptureMT Help Manual

Version: Vendor Management and Document Upload build

Application: ASP.NET Core 8 MVC, SQL Server Express, URL based multi-tenant lead capture system

1. Purpose

LeadCaptureMT is a multi-tenant lead capture and project processing system. It is designed for solar project lead management where a client team can capture leads, upload required documents, assign vendors, track vendor execution, and generate PDFs containing complete lead details, actions, documents, vendor progress and product information.

2. Main Portals

PortalURL PatternUsed By
Super Admin/admin/account/loginSystem owner / master administrator
Client/client/{client}/account/loginClient admin, team leader and agent users
Vendor/vendor/{client}/account/loginVendor users assigned to solar projects
Help Manual/helpAll users

Replace {client} with the client subdomain/slug, for example client1.

3. Installation and First Setup

  1. Publish the ASP.NET Core project to IIS or run it locally from Visual Studio.
  2. Configure SQL Server connection in `LeadCaptureMT.Web/appsettings.json`.
  3. Run `Db_Create_LeadCaptureDb.sql` on SQL Server Express or your SQL Server instance.
  4. For existing installations, run update scripts such as `Db_Add_LeadSolarFields.sql` and `Db_Add_VendorManagementAndUploads.sql` only once.
  5. Make sure the web application has write permission to `wwwroot/uploads` because lead documents and vendor progress uploads are stored there.
  6. Open `/admin/account/login` and log in as Super Admin.
  7. Create or verify the client, client users, features and master data.

4. Super Admin Help

Super Admin manages the master setup across all clients.

Typical Super Admin work:

  • Create and activate clients.
  • Manage master features.
  • Enable or disable features for each client.
  • Create or edit client users when required.
  • Change the Super Admin password.

Recommended first steps:

  1. Go to Manage Clients and create the client.
  2. Go to Master Features and verify required features.
  3. Go to Client Features and enable features for the selected client.
  4. Create at least one Client Admin user.
  5. Share the client login URL with the client team.

5. Client Admin Help

Client Admin manages the operational setup for one client.

Client Admin can:

  • Create and manage leads.
  • Manage lead statuses.
  • Manage users.
  • Manage property/project site master.
  • Manage vendor master.
  • Assign a vendor to a lead.
  • Upload required solar project documents.
  • Download lead PDF.
  • View vendor progress and vendor product details.
  • Export lead data to CSV.

6. Lead Management

The Lead form includes contact fields, project details, pricing/payment fields and vendor assignment.

Important lead fields:

  • Lead name, mobile, WhatsApp, email, city and pincode.
  • Project floor.
  • Roof type: concrete, asbestos, tin or editable value.
  • Project type: on-grid, off-grid or hybrid.
  • Phase: single phase or three phase.
  • Consumer type: domestic, commercial or industrial.
  • Consumer name and consumer number.
  • Project price, discount and net project price.
  • Payment type: cash, loan or both.
  • Cash amount and loan amount where applicable.
  • Project description.
  • Main lead name and sub lead name.
  • Vendor selection from Vendor Master.

7. Required Solar Documents

Lead Create/Edit provides an upload section for solar project documents:

  1. PAN card scan copy.
  2. Electricity bill scan copy.
  3. Self photo scan copy.
  4. Cancel cheque or bank passbook first page scan copy.
  5. ITR upload for loan above 2 lakh.

Documents uploaded against a lead are visible to the client team and to the assigned vendor. Vendors can download documents only for projects assigned to that vendor.

8. Lead PDF

The Lead PDF contains:

  • Complete lead contact details.
  • Consumer details.
  • Project details.
  • Pricing and payment details.
  • Lead status and follow-up details.
  • Uploaded required documents list.
  • Lead action history.
  • Assignment audit history.
  • Vendor work progress.
  • Vendor product details.

Use the PDF button from the Lead list or Lead edit screen to create a PDF for a lead.

9. Vendor Master

Client Admin can open Vendors from the client panel.

Vendor Master stores:

  • Vendor name.
  • Contact person.
  • Mobile number.
  • Email address.
  • Vendor details/address.
  • Username.
  • Password.
  • Active/inactive status.

Vendor login URL format:

/vendor/{client}/account/login

Only active vendors can log in.

10. Vendor Project Processing

When a lead is assigned to a vendor, the vendor can log in and view only assigned projects.

Vendor project listing shows:

  • Lead number.
  • Lead generation date.
  • Customer information.
  • Project information.
  • Vendor project starting date.
  • Vendor project complete date.
  • Progress count.

Vendor project details allow the vendor to:

  • Set project start date.
  • Set project completion date.
  • View and download uploaded lead documents.
  • Submit daily work progress with compulsory progress date.
  • Upload supporting files for progress steps.
  • Fill company name and power rating/type for solar panel, inverter, cable and structure.

11. Vendor Work Progress Steps

Vendor work progress includes these steps:

  1. Registration and subsidy amount certificate generation - PDF upload.
  2. Slip of paid payment amount of customer - PDF upload.
  3. Product dispatch to customer.
  4. Basement work or concrete work.
  5. Structures work.
  6. Earthing work 3 point.
  7. Panel setting.
  8. Inverter installing.
  9. Wiring.
  10. Solar meter.
  11. Net metering.
  12. Subsidy amount to customer.
  13. Proper monitoring and remarks.

Progress date is compulsory. The system validates the date in the browser and again on the server.

12. Vendor Product Details

Vendor fills product details for:

Sr.NoProductPower Rating and TypeCompany
1Solar PanelVendor fillsVendor fills
2InverterVendor fillsVendor fills
3CableVendor fillsVendor fills
4StructureVendor fillsVendor fills

The client team can view these details from the Lead Edit page and in the Lead PDF.

13. Users and Access Control

Roles used in the system:

  • Super Admin: full system setup.
  • Client Admin: full client setup and all client lead operations.
  • Team Leader: team-level lead handling according to configured logic.
  • Agent: own and unassigned leads according to configured logic.
  • Vendor: assigned solar project processing only.

Important security rules:

  • A vendor can see only projects assigned to that vendor.
  • A vendor can download only documents of assigned projects.
  • Client users cannot log in from the vendor portal.
  • Vendor users cannot log in from the client portal.

14. Assignment Audit and Lead Actions

Assignment Audit records who assigned a lead, from whom, to whom, action date, remarks, IP address and user agent where available.

Lead Actions are used to record follow-up activities such as call, WhatsApp, visit, status remarks or other communication. Lead actions are included in the lead PDF.

15. Upload Storage

Uploaded files are stored under wwwroot/uploads.

Important folders include:

  • `wwwroot/uploads/lead-documents/...`
  • `wwwroot/uploads/vendor-progress/...`

Recommended maintenance:

  • Include `wwwroot/uploads` in daily backup.
  • Do not manually rename or delete uploaded files unless database records are also handled.
  • Ensure IIS application pool identity has write permission.

16. Backup

Recommended backup items:

  1. SQL Server database `LeadCaptureDb`.
  2. Application folder.
  3. `wwwroot/uploads` folder.
  4. `appsettings.json` after removing or securing credentials.
  5. Database scripts used for deployment.

17. Troubleshooting

Login not working

  • Check correct portal URL.
  • Check active status of user/vendor/client.
  • Reset password if the password is not known. Password hashes cannot be decrypted.

Upload not working

  • Check file size and file type.
  • Check write permission on `wwwroot/uploads`.
  • Check IIS request upload limit if uploading larger files.

Vendor cannot see a project

  • Confirm the lead has selected vendor in Lead Edit.
  • Confirm vendor is active.
  • Confirm vendor is logging in under the correct client URL.

Vendor cannot download a document

  • Confirm the lead is assigned to that vendor.
  • Confirm the physical file exists in `wwwroot/uploads`.
  • Confirm the upload folder has read permission for the application pool.

SQL column missing

  • Run `Db_Add_LeadSolarFields.sql` and `Db_Add_VendorManagementAndUploads.sql` once on the existing database.

18. Deployment Notes

  • Target framework: .NET 8.
  • Hosting: IIS with ASP.NET Core Hosting Bundle installed.
  • Database: SQL Server Express or compatible SQL Server.
  • Connection string: configured in `appsettings.json`.
  • Static files must be enabled because help files, CSS and uploads are served from `wwwroot`.

19. Quick Operating Flow

  1. Super Admin creates client and client admin.
  2. Client Admin logs in and creates users, statuses, properties and vendors.
  3. Agent or Client Admin creates a lead.
  4. Client Admin uploads required solar documents and assigns vendor.
  5. Vendor logs in and opens assigned project.
  6. Vendor enters dates, updates progress steps and fills product details.
  7. Client team reviews progress from Lead Edit and exports/prints Lead PDF.
Top