Dealer_Onboarding_Backend/docs/modular_wise/06_Relocation.md

12 KiB
Raw Blame History

RE Onboarding & Offboarding System

Requirements

System Requirements Specifications

16 - Oct- 2025

Version 1. 4

Contents

Change Log

1.1 Change Log Version 2.0

1.1.1 Notification Channel Enhancement

  • Added WhatsApp as a supported notification channel for reminders and workflow communications (e.g., questionnaire completion and status updates), while restricting sensitive document sharing to email only.

1.1.8 Access Control & Visibility Refinements

  • Defined view-only access for DD ASM, DD ZM, and RBM at relevant workflow stages.
  • Granted approval visibility to DD Lead where applicable.
  • Enabled DD ASM and DD ZM to upload site readiness and LOA-related documents, with DD Lead, RBM, and ZBH having view access.
  • Limited applicant and dealer portal access to stage-specific and context-specific scenarios only.
  • Confirmed that dealer portal access is revoked after resignation or termination.

1.1.9 Terminology & Documentation Corrections

  • Clarified KT Matrix as Kepner Tregoe Matrix for consistency and correctness.

1.1.10 Super Admin Role Introduction

  • Introduced a Super Admin (Master Role) with end-to-end access and workflow control across modules.
  • Defined segregation of duties by splitting Super Admin into two DD Admin roles with clearly scoped responsibilities.

1.2.1 Introduction of Dealer Portal

  • Introduced a Dealer Portal capability enabling onboarded dealers to initiate and track post-onboarding lifecycle requests through the portal.
  • Dealer actions are governed by role-based access controls , approval hierarchies, and audit mechanisms.

1.2.3 Dealer Relocation Request Enablement

  • Enabled dealers to initiate and track relocation requests through a guided workflow.

  • Added support for: o Manual or map-based location entry o Distance calculation from existing location o Property type selection and expected relocation date

  • Introduced document-driven relocation validation , including statutory, legal, property, and infrastructure documents.

  • Implemented multi-level approval workflow with Work Notesbased communication and audit trail.

  • Ensured dealer has view and upload access only , with approvals retained by RE stakeholders.

1 System Overview & Problem Statement

1.1.1 System Overview

The Dealer Onboarding and Offboarding System for Royal Enfield (RE) is designed to digitize, standardize, and streamline the complete dealer lifecycle — from application and evaluation to approval, resignation, termination, and full-and-final (F&F) settlement.

At present, the process operates through manual coordination , involving emails, spreadsheets, and physical documentation , which makes it difficult to maintain visibility, accountability, and consistency across teams.

The proposed solution introduces a centralized digital platform that brings all stakeholders onto a single workflow. It ensures that every stage — onboarding, operational approvals, financial diligence, legal validation, and final closure — follows a structured and traceable process.

The system integrates seamlessly with existing RE applications such as SSO , SAP , and Finance modules , providing role-based access , real-time tracking , and secure document management. It also offers automated workflows , configurable approval hierarchies , and AI-assisted decision support to improve efficiency and reduce turnaround time.

By moving to a digital workflow, Royal Enfield will achieve higher levels of process efficiency , data accuracy , and transparency , ensuring faster decision-making and stronger control over the dealer network lifecycle.

2 Intended Audience

This document is intended for all stakeholders involved in the design, implementation, approval, and operational use of the Dealer Onboarding and Offboarding System at Royal Enfield (RE).

The following user personas and roles are part of the system:

2.1 Business & Functional Users

2.1.2 Regional Sales & Business Team

  • RBM (Regional Business Manager): Participates in early-stage evaluations, provides ground-level business insights, and recommends suitable candidates.

  • ZBH (Zonal Business Head): Conducts the second-level review along with DD-Lead; provides strategic feedback on market and location viability.

  • NBH (National Business Head): Holds final authority for approval or rejection of dealer onboarding; reviews consolidated feedback from all levels.

  • Relocation Request Submission

The dealer can submit a relocation request in scenarios where there is an intent to shift
the dealership from the current location to a new proposed location. The request is
routed for internal feasibility assessment, validation, and management approval before
execution.

All dealer-initiated requests are subject to defined validations, mandatory document submissions, role-based reviews, and approvals. The dealers access is restricted to initiation, document upload, and status visibility , with final decision-making authority retained by authorized internal stakeholders of RE

4.5.1.1 Overview

The **Finance Team Process Flow** governs all financial activities related to dealer lifecycle
management — from **security deposit validation at onboarding** to **final settlement at
resignation or termination**.
It ensures complete financial traceability, proper verification of payments, and compliance with
Royal Enfields financial governance standards.
The process flow integrates with **Admin, Legal, Dealer Development (DD)** , and **Departmental
Modules** , ensuring accurate financial updates and timely closure of all financial transactions.

**4.5.2 Step-by-Step Process Flow**


4.5.2.3 Internal Clarification & Approval

- **Action:**
    Finance initiates clarification rounds with departments or DD-Lead for mismatched data.
- **System Steps:**
    o Uses the **Work Notes** section for comments, tagging users like _@DD-_
       _Lead_ , _@Legal_ , or _@Admin_.
    o Tracks status as _Pending Clarification_ until resolved.
    o After reconciliation, Finance locks the summary and updates case status
       to _Ready for Approval_.

`


## 5 System Features & Requirements

Here, we describe the **system features** along with their respective **Width** and **Depth** to provide
complete visibility of each requirement.

The **Width** defines the **functional coverage** of a feature — outlining what the feature does,
its **boundaries, use cases, and user interactions**. It answers the question: _“What scenarios and
actions are covered by this feature?”_

The **Depth** captures the **operational and behavioral details** — describing how the feature
behaves through its **logic, workflow, system responses, and edge-case handling**. It answers the
question: _“How does the system execute and respond in these scenarios?”_

---

Dealer Relocation Request



**12.2.6 Functionality Scope**

This functionality enables a **dealer to initiate, track, and manage dealership relocation
requests** through the portal after successful onboarding. The system provides a **guided self-
service mechanism** to propose a new dealership location, submit **location-specific statutory,
property, and infrastructure documents** , and route the request through a **multi-level internal
approval workflow**.

**12.2.7 Functional Width**

- Displays a **dealer-facing relocation dashboard** with summary indicators:
    o Total Requests
    o Pending Requests
    o Completed Requests
- Lists all **relocation requests** with:
    o Request ID
    o Current location
    o Proposed location
    o Distance from current location
    o Submission date
    o Current status
    o Progress percentage
- Enables **initiation of a new relocation request**
- Allows **manual address entry** or **map-based location selection** for the proposed site
- Captures **distance from the existing location**
- Provides **request-level detailed view** including:
    o Relocation overview
    o Submitted information
    o Workflow progress


o Required and uploaded documents o History & audit trail

- Supports **document upload, verification, and status tracking**
- Provides **role-based visibility and action controls**
- Prevents parallel or duplicate relocation requests for the same outlet

**12.2.8 11.3.3 Functional Depth**

- Relocation requests can be initiated **only for active and eligible dealerships**.
- On selecting **“New Relocation Request”** , the dealer is presented with a structured
    submission form capturing:
       o Dealer Code and Dealer Name (auto-populated, non-editable)
       o Current dealership address (auto-populated)
       o Proposed new location (manual entry or map selection)
       o Complete address details (city, state, pincode)
       o Distance from the current location
       o Property type
       o Expected relocation date
       o Reason for relocation
- Upon submission, the request enters a **multi-level approval workflow** , typically
    progressing through:
       o DD ASM Review
       o RBM Review
       o DD ZM Review
       o ZBH Review
       o DD Lead Review
       o NBH Review
       o Legal (as applicable)
- Each stage is reflected through a **visual workflow progress timeline** , showing:
    o Responsible role
    o Stage status (Completed / In Progress / Pending)
    o Overall progress percentage
- The system enforces **mandatory document submission and verification** , categorized as:
    o Property
    o Legal
    o Statutory
    o Infrastructure
- Required documents include, but are not limited to:
    o Property documents for new location
    o Lease / Rental agreement for new location
    o NOC from current landlord
    o Municipal approvals


o Fire safety certificate o Pollution clearance o Layout / Floor plan of new location o Photos of new location o Locality map o Building plan approval o Electricity connection documents o Water supply documents

- Document status is tracked as **Pending Verification** , **Verified** , or **Rejected**.
- Authorized internal users may **Approve, Send Back, or Revoke** the relocation request.
- **Send Back and Revoke actions are communicated through Work Notes** , with mandatory
    remarks captured by the system.
- All uploads, verifications, remarks, and approvals are **logged in the audit trail**.
- Upon final approval:
    o The relocation request is marked as completed.
    o Dealer master records are updated as per the approved new location.
- The system ensures **full traceability and compliance** across all stages of the relocation
    process.

**12.2.9 11.3.4 Personas-wise Accessibility & Visibility**

Persona Responsibilities Access Rights Dealer Initiates and tracks dealership relocation requests.

- Initiate relocation request
- Provide proposed location details
- Upload required documents
- View request status, workflow
progress, and Work Notes
DD ASM Coordinates initial review and
document readiness.
- View relocation requests
- Upload and review documents
- Support coordination
RBM Performs regional feasibility and
business review.
- View requests
- Review and recommend
DD ZM Conducts zonal-level evaluation. • View requests
- Review and provide inputs
ZBH Ensures zonal governance and
compliance.
- Review requests
- Send Back or Revoke with mandatory
Work Notes
- Approve as per hierarchy
DD Lead Ensures policy adherence and cross-
functional alignment.
- Review requests
- Send Back or Revoke with mandatory
Work Notes
- Approval visibility


NBH Provides senior management approval. • Review requests

- Send Back or Revoke with mandatory
Work Notes
- Final approval authority
Legal
Team

Validates statutory and legal compliance.

- Review legal documents
- Validate approvals and clearances
System Enforces workflow and compliance
rules.
- Control action availability
- Track document status and progress
- Maintain history and audit trail