Owner & Downline Management Modules · Detailed Feature Specification, Business Rules & Client Approval
This document defines the detailed business requirements of the Admin Panel of the KailashBook platform — the operational console used by the Owner and the downline hierarchy (Super Master, Master, Agent, User) to manage balances, risk, events, casino, content, bonuses and banking. Each module is described by its purpose, the features included, the reference screen(s) captured from the staging build, the user flow, and applicable business rules.
The Admin Panel uses a deep navy canvas and sidebar with a teal/turquoise accent for active states, live indicators and primary actions. The gold "KailashBook" wordmark anchors the login screen and the sidebar header.
Click any module link to jump to it and expand its detail.
The Admin Login screen is the entry point to the operational console for every downline role — Owner, Super Master, Master and Agent each sign in here and land on a Dashboard scoped to their own downline.

| Brand crest / wordmark | Included |
| "LOGIN" heading | Included |
| Email Address field | Included |
| Password field (show / hide toggle) | Included |
| Log In button (teal gradient CTA) | Included |
Forgot Password link OTP Verification Two-Factor Authentication Remember Me
The Dashboard is the landing page after login. It gives an at-a-glance operational snapshot of balances, live exposure, downline composition, betting and casino activity, device mix, top performers and login activity — every widget respects an independently selectable date range.



| Total Balance | amount |
| Balance Down | amount |
| Available Credit | amount |
| Player Balance | amount |
| Net Exposure | amount |
Below the strip, a Live Events panel lists in-play matches with bets placed, filterable by Sport (default "All"); an empty state reads "No bets placed on live events yet."
| Total Super-Masters | count |
| Total Masters | count |
| Total Agents | count |
| Total Users | count |
| New Users | count |
| Active Users | count |
| Total Idle Users | count |
Filterable by Day (default "Last 7 Days"); an arrow shortcut opens the full downline report.
| Bet Count | count |
| Bet Stake | amount |
| Settled Bet | count |
| Unsettled Bet | count |
| User Winning | amount |
| Platform PL | amount |
Filterable by Game (default "All") and Day (default "Last 7 Days").
| Assigned Credit | amount |
| Remaining Credit | amount |
| Bet Count | count |
| Bet Stake | amount |
| Rollback Amount | amount |
| User Winning | amount |
| Platform PL | amount |
Filterable by Day (default "Last 7 Days").
| Initial Deposit | amount |
| Refilled Deposits | amount |
| Initial Deposits (Users) | count |
| Refilled Deposits (Users) | count |
| Total Withdraws (Users) | count |
| Total Deposits | amount |
| Total Withdraws | amount |
| Net Balance | amount |
Donut chart of active sessions by device, with a Total Devices count and a Desktop / Mobile legend showing count and percentage share. Filterable by Day.
Combo bar + line chart plotting Bets Count (bars) against User Winning (line) per username, filterable by Category (e.g. Sports) and Day.
Bar chart of Bets Count by sport / category (cricket, casino, etc.), filterable by Day.
| Logged in Super Master | count |
| Logged in Master | count |
| Logged in Agent | count |
Filterable by Day (default "Last 7 Days").
| Total Bonus Distributed | amount |
| Bonus User Count | count |
| Current Active Bonus | count |
Filterable by Day. Ties into the Bonus Management module (§10).
Widget drag-reorder / customization Per-widget export Auto-refresh interval setting
A fixed left sidebar on the dark navy canvas gives access to every module. Expandable groups (chevron icon) reveal their sub-items; the active item is highlighted with a teal fill.
| Item | Behaviour |
|---|---|
| Dashboard | Opens the Dashboard (Module 02) |
| Downline expandable | Super Master · Master · Agent · User · Settlement (Module 04) |
| Risk Management | Opens Risk Management (Module 05) |
| My Reports expandable | Bet List · Casino Bet List · P/L Reports · Business Report (Module 06) |
| Event Management expandable · Owner only | Events · Bet Config (Module 07) |
| Casino Control Owner only | Category Level · Provider Level · Game Control (Module 08) |
| Banking Management expandable | Deposit/Withdraw Request · Manage Accounts (Module 11) — visible to every role |
| Content Management Owner only | Banner Management · Notification Management · Support Contact Management (Module 09) |
| Bonus Management expandable · Owner only | Policy Management · Statement (Module 10) |
| Export Report History | Opens Export Report History (Module 12) |
| Account Statement | Owner's own statement (Module 13) |
| Change Password | Opens Change Password (Module 15) |
| Activity Log | Owner's own login activity (Module 14) |
| Logout | Pinned at the bottom, ends the session (Module 16) |
Downline Management is the core operational area: every level of the reseller hierarchy — Super Master, Master, Agent, and the End User — is listed, drilled into, and acted upon from here, with a Settlement view for fund transfers between adjacent levels.


Super Master, Master and Agent share one listing layout — only the role label, "+ Add [Role]" button and populated rows differ.
| Total Balance | amount |
| Total Avail. Bal. | amount |
| Total Exposure | amount |
| Balance (Downline) | amount |
| Total Users Balance | amount |
| Column | Description |
|---|---|
| S. No / userName | Row index and account username (with role initial badge, e.g. "SM") |
| Phone No. | Registered mobile number |
| Credit Reference | Credit line assigned to this account |
| Balance | Current account balance |
| Exposure | Current locked exposure, shown in parentheses |
| Partnership % | Revenue / loss share percentage with this account |
| Downline Bal. | Sum of balances of everyone below this account |
| Total Bal. | Own balance + downline balance |
| Status | Active / Inactive / Suspended / Bet Lock pill |
| Actions | Quick D (Deposit) / W (Withdraw) icons, plus an expandable row of: Profile, Sport Permission, Deposit, Withdraw, Change Status |

| Username | Required |
| Mobile Number (with country code selector) | Required |
| Password (show/hide toggle) | Required |
| Partnership % (cannot be less than 0%) | Required |
| Transaction Code | Required |

The End User listing shares the same KPI strip and action set as §4.2, with a wider set of columns reflecting real-money player activity rather than downline roll-up figures.
| Column | Description |
|---|---|
| Withdrawal Bal. | Amount currently available for the user to withdraw |
| Total P/L | Profit/loss for the selected date range |
| Lifetime P/L | All-time profit/loss |
| Total Deposit | Lifetime deposits |
| Total Withdraw | Lifetime withdrawals |
| Phone No. | Registered mobile number |
| Created At | Account creation date / time |
"Credit Reference", "Downline Bal.", "Total Bal." are not shown here as a User has no further downline. The "+ Add User" button replaces "+ Add Super Master/Master/Agent".
Four pop-ups are reached from every listing row's action icons (§4.2 / §4.3) and behave identically at every hierarchy level — Super Master, Master, Agent, and direct End User.

| Current Balance | Shown, read-only |
| Deposit Amount | Input |
| Updated Balance | Auto-calculated preview |
| Transaction Password | Required |
| Cancel / Deposit buttons | Included |

| Current Balance | Shown, read-only |
| Withdraw Amount | Input |
| Updated Balance | Auto-calculated preview |
| Transaction Password | Required |
| Cancel / Withdraw buttons | Included |

Per-sport toggle list: Cricket, Soccer, Tennis, Casino — each with an Active/Inactive status label and an on/off toggle, submitted together via the Submit button.

Single-select radio group: Active, Inactive, Suspended, Bet Lock, confirmed via Submit.
Opening "Profile" on a Super Master, Master or Agent row opens a 3-tab detail view: Account Summary, Transaction History, Activity Log.

| Section | Fields |
|---|---|
| Wallet | Main wallet — Available to Bet · Funds available to withdraw · Current exposure |
| Account Details | Owner → the selected account chain, each with a role badge |
| Profile | Masked Password field with a Change Password action |


| Column | Description |
|---|---|
| S. No / Date-Time | Row index and transaction timestamp |
| Credit / Debit | Amount moved, sortable |
| Balance | Resulting balance after the transaction |
| From/To | The two accounts involved |
Export to Excel / PDF / CSV icons, a refresh icon, and a date range filter sit above the table.

| Column | Description |
|---|---|
| S. No / Date-Time | Row index and login attempt timestamp |
| Login Status | Login Success / Login Failed pill |
| IP Address | Origin IP of the login attempt |
Opening a direct End User's profile expands the tab set to 5 tabs — Account Summary, Bet List, Betting Pnl, Account Statement, Activity Log — since a User is a real player rather than a reseller node.

| Column | Description |
|---|---|
| Bet ID / Status | Pending / Won / Lost / cancelled pill |
| Bet Taken / Bet Settle | Placed and settled timestamps |
| Event | Sport / competitors |
| Market | Match Odds, Session, Tied Match, etc. |
| Type | back (blue) / lay (pink) |
| Odds Req. / Result | Requested odds and the settled outcome |
| Stake / P/L | Amount staked and resulting profit/loss |
| IP | IP address the bet was placed from |
Sports / Casino top-level toggle, export icons, refresh, date range filter and pagination.



Full ledger of deposits, withdrawals and balance changes for this User — same column pattern as the Account Statement module (§13), scoped to this account only.
Same structure as the Downline Activity Log in §4.5: Date/Time, Login Status, IP Address.

Gives the logged-in account a single view of balance and P/L across its immediate downline, for reviewing and transferring funds without opening each profile individually.
| Column | Description |
|---|---|
| Checkbox / S. No. | Row selector for bulk actions |
| Username | Downline account, with role badge |
| Credit Reference | Assigned credit line |
| Total P/L / Upline P/L | Profit/loss figures |
| Total Balance / Balance / Exposure | Balance figures |
| Transfer | Per-row link to open a settlement transfer for this account |
| Profile Icon | Jumps to the account's Profile Detail (§4.5 / §4.6) |
Risk Management surfaces live platform-wide exposure per market, so the operator can spot lopsided books and hedge a market before it settles. It drills from a cross-sport summary down to a single event's odds ladder and per-user liability.

| Top 10 Exposure Player panel | Included |
| Sport tabs (Cricket / Football / Tennis) | Included |
| S. No / Sports / Market / Event-Market Name / Player P/L (1 / x / 2) / Downline P/L table | Included |

Expanding a market row (session, Tied Match, Match Odds, etc.) reveals the full back/lay price ladder for each selection, with a "Back all" / "Lay all" quick-action pair and the platform's live P/L per selection shown alongside.

Manual market lock/unlock from this screen Bulk risk alerts / thresholds
My Reports is the cross-account reporting suite — bet-level lists, P/L roll-ups by downline/event/player, and a Business Report covering platform-wide activity metrics.

| Column | Description |
|---|---|
| S. No / User / Bet Id | Row index, bettor, and internal bet reference |
| Status | Pending / Won / Lost pill |
| Bet Taken / Bet Settle | Placed and settled timestamps |
| Event / Market | Fixture and market name |
| Type / Odds Req. | Back or Lay, requested odds |
| Result / Stake / P/L / IP | Settled outcome, amount staked, profit/loss, origin IP |
Search by username, Sports filter, Status filter, date range, export and pagination controls.

| Column | Description |
|---|---|
| S. No / User / Bet Id | Row index, bettor, bet reference |
| Date & Time / Game Name / Provider Name / Game Id | When and which game the bet was placed on |
| Bet Amount / P/L / Outcome | Stake, profit/loss, Win / Loss / Neutral outcome pill |

Rows list each direct downline account (Username, Player P/L, Downline P/L, Upline P/L) and expand to show that account's own downline breakdown; a Total row sums the page.

Search by event name, Game filter, Sports / Casino toggle; rows expand from event to market-level Stake / Player P/L / Downline P/L / Upline P/L.

Flat list of Username against User P/L for the selected date range, with a running Total row.

Same expandable-by-downline pattern as §6.3, scoped to casino activity; adds a Client P/L column alongside Player P/L, Downline P/L and Upline P/L.

Flat list of Username against User P/L for casino activity in the selected date range.
Business Report groups platform activity by a category — each choice swaps the whole table, shared Hierarchy Users / Platform Users toggle, search, date range, export and pagination controls throughout.
Every deposit transaction, split into First Deposit and Refill Deposit sub-filters.


Columns: S.No · Username · Amount · Category (DEPOSIT) · Subcategory (First Deposit / Refill) · Transaction Date.

Columns: S.No · Username · Withdraw Amount · Category (WITHDRAW) · Transaction Date.

Columns: S.No · Username · Role badge · Login Date.

An Active User is any user who performed a deposit, withdrawal, or placed a bet that has since settled, within the selected date range.
Columns: S.No · Username · Role badge · Last Deposit Date.

Columns: S.No · Username · Mobile No. · Signup Date.

Users who deposited at some point but have shown no deposit, withdrawal or settled-bet activity within the selected date range.
Columns: S.No · Username · Mobile No. · Total Deposit · Last Deposit Amount · Last Deposit Date.
Event Management is where the operator turns matches on/off for betting, marks them Popular/Inplay, and tunes stake/rate limits per market — either per event (Bet Config) or platform-wide (Bet Config / Default Setting).



| InActive Matches / InPlay / Upcoming tabs | Included |
| Game filter (Cricket, Tennis, Football, etc.) | Included |
| Search box | Included |
| Activate/Deactivate selected — bulk toggle for checked rows | Included |
| Refresh icon | Included |
| Column | Description |
|---|---|
| Checkbox / S. No. / expand chevron | Row selector, index, and expand toggle for the market list |
| Market Info | Fixture name and competition |
| Status | Per-event on/off toggle — enables or disables betting on the whole event |
| Inplay / Popular | Checkboxes marking the event as currently in-play / surfaced as Popular |
| Time | Kickoff/start date and time |
| User Played / No of bets | Count of users who have bet, and total bet count, on this event |
| Bet Config | Opens the per-event Bet Setting modal |
| Actions (BS) | Opens the Bet Suspended confirmation for this event |

| Exposure Limit / Bet Delay (Seconds) | Editable |
| Min Rate / Max Rate | Editable |
| Inplay Min Stake / Inplay Max Stake | Editable |
| OffPlay Min Stake / OffPlay Max Stake | Editable |
| Max Profit | Editable |
| Cancel / Update buttons | Included |



Bet Config sets the platform-wide default stake/rate limits applied to every event unless overridden per event (§7.1).
| Section | Fields |
|---|---|
| Limit Setting | Exposure Limit · Bet Delay (Seconds) |
| Market Setting (Match Odds) | Min Rate · Max Rate · Inplay Min/Max Stake · OffPlay Min/Max Stake · Max Profit |
| Bookmaker Setting | Min Rate · Max Rate · Inplay Min/Max Stake · OffPlay Min/Max Stake · Max Profit |
| Session Setting | Min Rate · Max Rate · Inplay Min/Max Stake · OffPlay Min/Max Stake · Max Profit |
Casino Control turns casino inventory on/off at three levels of granularity — category, provider, and individual game — and lets the operator edit a game's metadata.





| Column | Description |
|---|---|
| S. No. / Game Id / Game Code | Row index, internal ID (linked), provider-side code |
| Game Name / Category / Provider | Display name, category pill, supplying provider |
| Status | On/off toggle — same flag as §8.1/§8.2 |
| Actions | Edit (pencil) icon opens the Edit Game modal |

| Game Code | Read-only |
| Game Name | Editable |
| Category (dropdown) | Editable |
| Provider | Read-only |
| Thumbnail Image (URL) + Preview File link | Editable |
| Cancel / Update buttons | Included |
Bulk edit / bulk category reassignment New game creation from this screen Game priority / sort-order field
Content Management controls the marketing surfaces shown to end users — site/app banners and the support contact block — via three tabs: Banner Management, Notification Management, Support Contact Management.

| Column | Description |
|---|---|
| S. No. / Banner Image | Row index and a thumbnail preview of the uploaded banner |
| Banner Type | Placement, e.g. "MainBanner", "HomeBanner" |
| Platform | "WebBanner" or "AppBanner" — which surface the banner renders on |
| Status | Active / Inactive indicator dot |
| Date | Upload date/time |
| Actions | Inactive/Active toggle button, delete (trash) icon |
"+ Add Banner" and "+ Add Promotional Banner" buttons sit top right.

Columns: S. No., Notification Type, Notification Title, Message, Status, Date, Actions (empty in the reference build).



Two support channel cards — WhatsApp Support and Telegram Channel — each with a "Click to Connect" action that opens its configuration modal. Table columns: S. No., Support, WhatsApp Number, Telegram Number, Default, Actions.
Bonus Management configures every promotional bonus a player can earn — Joining, Deposit and Referral — and controls how each bonus is locked, unlocked (turnover) and released. Policy Management lists and creates these bonus policies; Statement (§10.2) is the resulting player-level ledger.

| Column | Description |
|---|---|
| S. No. / Bonus Category | Row index and policy type — JoiningBonus, DepositBonus, ReferralBonus |
| Bonus Name / Min Amount | Internal label and minimum qualifying amount |
| Approval Method | AUTO or MANUAL |
| Date Range / Status / Created | Policy's active window, Active/Inactive pill, creation timestamp |
| Action | View (eye) icon, delete (trash) icon |
| Select Category (Joining Bonus / Deposit Bonus / Referral Bonus) | Required |
| Bonus Name / Description / Status / From-To | Required |
| Approval Method (Auto Approve / Manual) | Required |
| Turnover Formula (Bonus * multiplier / (Deposit + Bonus) * multiplier) | Required |
| Turnover Multiplier | Required |
| Minimum Odd / Maximum Odd / Bet Type (ALL) | Optional / Required |
| Select Categories — Sports / Casino | Required |
| Installments / Expire in days | Required |
| Select Claim Period (Day / Month), Claim Period From-To | Required |


Adds Limit Maximum Applicants (toggle + Applicant Limit), Minimum Deposit Amount, Maximum Bonus Amount, Release Type (Fixed Amount). Per the base build's rule, Joining Bonus requires signup followed by a first deposit to trigger.

Adds Limit Maximum Applicants, Limit Single Applicant, Frequency (Every…) — this is the Refill variant of a Deposit Bonus.

Adds Bonus Eligible Roles (Both / Referrer / Referee), Referral Type (On Signup / On First Deposit), Referrer Bonus, Referee Bonus.





| Column | Description |
|---|---|
| S. No. / Username / Bonus Name / Bonus Id | Row index, recipient, policy name and ID |
| Category / Release Type | DepositBonus/ReferralBonus/JoiningBonus, Fixed or Percentage |
| Awarded Amount | Bonus amount credited to the user's Bonus Wallet |
| Turnover (Completed / Required) | Live progress against the turnover target |
| Installments / Awarded At / Expire At / Status | Total installment count, grant date, forfeiture deadline, current status |
Banking Management is where player-initiated deposit and withdrawal requests are reviewed and approved/rejected, and where the platform's own receiving accounts (UPI / Bank Account) are configured.


| Column | Description |
|---|---|
| S. No. / User Name / UTR No. | Row index, requesting player, bank/UPI transaction reference |
| Account Type / Screenshot / Amount | Receiving account slot, payment-proof thumbnail, requested amount |
| Status / Req. At / Upd. At | Approved / Pending / Rejected, request and last-update timestamps |
| Actions / Remark / View | Rejected/Approved buttons, a remark note icon, and a detail view icon |
| Column | Description |
|---|---|
| Account/UPI No. / Account Holder-Name / Bank Name / IFSC Code / Account Type | Full destination bank detail |
| Amount / Status / Req. At / Upd. At / Actions / Remark / View | Same pattern as Deposit |


| Column | Description |
|---|---|
| S. No. / QR / UPI Id | Row index, uploaded QR thumbnail, receiving UPI address |
| Type / Min Amount / Max Amount | QR1-4 account slot, deposit range this QR accepts |
| Default / Actions | Marks it as an active receiving account, delete icon |


| Column | Description |
|---|---|
| Bank Name / Account Holder / Account Number / IFSC Code | Full bank account detail |
| Account Type / Min Amount / Max Amount / Type / Default / Actions | Same pattern as Manage QR |
Export Report History is the central log of every export triggered elsewhere in the admin — it tracks generation progress and hosts the download links, so an operator doesn't wait on-screen for large files.

| Column | Description |
|---|---|
| S. No. / Report Name | Row index and the source report, e.g. "Deposit/Withdraw Request" |
| Date & Time / File Type | When the export was requested; format icon — CSV / Excel / PDF |
| Status / Action | Completed / Pending / Failed pill; download icon, active once Completed |
Account Statement is the logged-in account's own full ledger, with a Deposit/Withdraw view and a Game Transaction view reached via a top-right toggle.

| Deposit/Withdraw / Game Transaction toggle | Included |
| Context filter / Type filter (Debit/Credit) | Included |
| Search by user name / Date range | Included |
| Export to Excel / PDF / CSV icons, refresh | Included |
| Column | Description |
|---|---|
| Transaction Id / Transaction Time | Sequential ledger reference and timestamp |
| Description | Plain-language summary, e.g. "Money Deposit Approved" |
| Type / Amount | Debit (red) / Credit (green) pill and signed amount |
| Context / Status | Reason tag, e.g. "Deposit Approval"; Confirmed pill |
| Balance / From/To | Resulting balance, the two accounts involved |
Game Transaction view replaces From/To with a Player column and reflects individual bet outcomes rather than fund transfers.
Activity Log (Owner) is the logged-in account's own login history.

| Column | Description |
|---|---|
| S. No. / Date/Time | Row index and login attempt timestamp |
| Login Status / IP Address | Login Success / Login Failed pill; origin IP |
| ISP / City / State / Country | Masked by default |
| Action | Eye icon to reveal the masked ISP / location fields |
Change Password lets the logged-in account update its own login password from a simple settings form.

| Current Password (masked, show/hide toggle) | Required |
| New Password (masked, show/hide toggle) | Required |
| Confirm Password (masked, show/hide toggle) | Required |
| Change Password button | Included |
Logout ends the current admin session, pinned as the last sidebar item (§3), and returns to the Login screen (Module 01).
By signing this document, the client confirms that the module requirements described above have been reviewed and approved. Any feature not explicitly mentioned in this document is considered outside the agreed scope and may require a separate Change Request (CR).
| Name & Role | Signature | Date |
|---|---|---|
| Client Representative | ||
| Project Manager |
Remarks / requested changes: