VauPrime Docs
Finance InsightsCurrent app behaviorDart-source backed

Daybook

Complete source-backed guide to the VauPrime Daybook (BookReportScreen): six transaction and inventory tabs, date controls, KPI summaries, per-tab search, voucher detail navigation, and the difference between period transactions and current stock.

Views

6 tabs

Sales · Purchase · Payment · Receipt · Journal · Inventory

Date choices

5 presets

Today, last 7, last 30, all and custom

Transaction details

Voucher drill-down

Open the corresponding entry or detail panel

Stock

Current inventory

Not a historical stock-as-of-date report

What is Daybook?

Purpose and current behavior of this feature.

Daybook is the VauPrime business-activity overview. Its current Flutter implementation is BookReportScreen in FinanceInsights/CashBookAndDayBook/day_book.dart. The screen brings sales, purchases, payments, receipts, journal vouchers and current inventory into one tabbed workspace.

The first five tabs show transactions within the selected date range, initially Today. Each tab has a search field and supports opening relevant transaction details. The Inventory tab is different: it retrieves current stock analytics and does not apply the Daybook date range to the stock snapshot.

The report calculates sales and purchase totals and a simplified sales-minus-purchases result. The source explicitly avoids describing that value as accurate net profit because expense vouchers and full cost-of-goods calculations are not included in that calculation. The page is a reporting/navigation screen, not a combined transaction-entry form.

Android UI structure

Screen-by-screen structure, tabs, lists, taps and action behavior on Android.

Title & headerThe page displays Day Book (आज का हिसाब in Hindi mode), a teal gradient header, refresh action, voucher-number display toggle, and a download-style action currently marked Coming Soon.
Date filter chipTap the date chip to open the bottom sheet with Today, Last 7 Days, Last 30 Days, All and Custom Date options.
KPI rowCards summarize data loaded from the current period, including sales, purchases and a simplified difference/margin indicator.
Six-tab selectorScrollable tab bar contains Sales, Purchase, Payment, Receipt, Journal and Inventory. Switching a tab updates the selected content.
Active tab searchSearch filters the current list. For transactions, matches can include particulars, voucher number, date, type or amount.
Transaction cardsRows show date/particular/amount and optional voucher-number details. Tapping a row opens the matching supported transaction view.
Inventory cardsEach product shows product name, category, material center, stock status, current quantity, average price and calculated stock value.
RefreshReloads all data for the selected date range and refreshes the current stock analytics.
LanguageThe page uses LangState to switch important titles, tabs and empty-state messages between Hindi and English.
Loading and empty viewsA skeleton/shimmer appears while loading. Empty lists show contextual no-record or no-search-match messaging.

Windows UI structure

Desktop layout, wide-screen controls, tables and row actions on Windows.

Shared Flutter screenBookReportScreen uses the same six-tab reporting workflow and responsive Flutter layout. Unlike a dedicated desktop Balance Sheet, it is not a separate Windows-only table implementation.
Header controlsDate preset selector, refresh, voucher number toggle and existing download-style placeholder are available through the shared screen layout.
Tab navigationA horizontal scrollable tab bar lets the user select Sales, Purchase, Payment, Receipt, Journal or Inventory.
Transaction searchThe current tab list is filtered client-side against its loaded rows. Search is not an organization-wide full-text query.
Voucher openingSales and Purchase open their supported detail panels; Payment, Receipt and Journal open their transaction-specific viewers.
Current stockThe inventory tab shows current product analytics and optional unit conversion, regardless of the transaction report date range.
Platform noteSome individual transaction/detail panels can vary by platform. The Daybook source itself does not define a dedicated Windows-only Daybook view.

All six tabs, filters and calculated fields

What the current Daybook source actually queries, displays and calculates.

Sales tabReads sales with user_id, fvs_id and voucher_date in the selected range. Rows include account, voucher date, total amount, voucher number and source ID.
Purchase tabReads purchases with user_id, fvs_id and voucher_date in range. Rows include party, date, total amount, voucher number and source ID.
Payment tabReads transaction_entries joined with transactions where voucher_type is PAYMENT. Entries with debit_amount > 0 are mapped as Payment rows.
Receipt tabReads the same joined source with voucher_type RECEIPT. Entries with credit_amount > 0 are mapped as Receipt rows.
Journal tabReads transactions with voucher_type JOURNAL in range, ordered newest first. Amount uses total_debit or total_credit; particular uses long_narration or Journal Entry.
Inventory tabCalls CentralizedStockService.getStockAnalytics for current productAnalytics and reads unit_conversions. Inventory ignores the Daybook selected date range.
Inventory columnsProduct name, category, material center, stock status, quantity, unit, average price and computed value are shown.
Displayed stock quantityIf a nonzero conversion factor is found for the main unit, displayStock = currentStock / conversionFactor; otherwise it uses currentStock.
Displayed stock valueThe current Daybook code calculates stockValue = displayStock × avgPrice. Verify unit consistency when interpreting converted quantities and price.
TodayFrom the start of the current day through 23:59:59 on the current day; this is the initial date preset.
Last 7 DaysFrom six days before the current date through the end of today.
Last 30 DaysFrom 29 days before the current date through the end of today.
AllUses 1 Jan 2000 as its earliest date and today as the end; this is a broad date window, not an unrestricted database query.
Custom DateOpens a date-range picker; earliest permitted date is 1 Jan 2000 and latest is today. The chosen end date is normalized to 23:59:59.
Show Voucher NumberTop-bar icon toggles visibility of voucher number fields in the transaction list.
SearchTransaction search is case-insensitive over particular, voucher number, date, type and amount. Inventory search covers name, category, material center, status, unit, quantity, price and value.
Sales totalSum of the loaded sales rows' total_amount. Bill count equals the number of loaded sales rows; average is total divided by that count.
Purchase totalSum of loaded purchase total_amount values. Bill count equals the number of loaded purchase rows.
Payment/Receipt/Journal totalEach is computed from the mapped amount values of its respective row list.
Simplified gross figuregrossProfit = totalSales − totalPurchase; cogs is set to totalPurchase in the current implementation. grossMargin = (totalSales − totalPurchase) / totalSales × 100 when sales are positive.
Export/download actionCurrently calls _showFilterOptions(), which displays Coming Soon. The source does not implement a working export here.

How to use Daybook — step by step

Follow the current in-app flow from start to completion.

01

Choose the organization

Sign into VauPrime and select the business whose data you want to examine.

02

Open Finance Insights → Daybook

The report initially loads Today's transactions for the selected organization.

03

Choose a date preset

Tap the date filter and choose Today, Last 7 Days, Last 30 Days, All or Custom; selecting a preset reloads the data.

04

Review KPI figures

Read the sales and purchase totals, counts and sales-minus-purchases indicator. Do not treat the simplified figure as audited net profit.

05

Review Sales and Purchases

Switch between the first two tabs to inspect voucher parties, amounts and dates. Open a row for details.

06

Inspect Payment, Receipt and Journal

Use the next three tabs to review cash/bank movement and journal voucher records for the selected range.

07

Search a voucher

Type a party name, account, voucher number, amount or date to narrow the current transaction tab; toggle voucher-number display when helpful.

08

Inspect current Inventory

Open Inventory for current stock, status, average price and material-center context. Changing the date range does not turn this into historic inventory.

09

Refresh after changes

Tap Refresh if vouchers or stock data were changed outside this report; all source sections are reloaded.

10

Open the original record

Select a transaction row to investigate it in the corresponding Sale/Purchase/Payment/Receipt/Journal viewer.

Validation and common checks

Checks and restrictions applied by the current screen.

The app must have an authenticated user and selected organization. Without user_id or fvs_id, the screen stops loading and clears the loading state.
Transactions are filtered by the selected date range, and sales/purchases additionally use the current user and organization IDs.
Payment and Receipt mapping intentionally excludes rows with the opposite or zero-sign amount: PAYMENT only debit_amount > 0; RECEIPT only credit_amount > 0.
Journal records are loaded from transactions; their description may be narration or a generic Journal Entry label.
All date presets and custom selection end no later than today; custom range begins no earlier than 1 January 2000.
Inventory is a current snapshot. The date range only controls transaction reporting, not stock-as-of-date valuation.
The simplified gross-profit indicator is NOT a complete Profit & Loss or net-profit figure; other expenses and detailed COGS calculations are not included.
The current download/export-style top-bar action displays Coming Soon rather than creating a downloadable file.

Important behavior and notes

Details worth knowing before using the feature in daily work.

Source: faroffvstudio/App_P0_VauPackage/lib/screens/FinanceInsights/CashBookAndDayBook/day_book.dart, BookReportScreen and _BookReportScreenState.
The UI is shared Flutter code with teal/cream styling, responsive tabbed cards, shimmer loading and language-aware labels.
Date filtering is applied separately to sales, purchases, transaction entries and journal transaction records. Individual source-query failures are logged and can leave a category empty without invalidating other loaded sections.
Purchases and sales use SalesReadProjection and PurchaseReadProjection. Payment/Receipt use the transaction_entries → transactions joined data, and Journal uses transactions.
The source calls getStockAnalytics for current inventory and computes stockValue using the displayed conversion-adjusted stock. This may differ from dedicated inventory valuation methods.
Worked example: sales ₹45,000 and purchases ₹30,000 yield a displayed difference of ₹15,000 and an approximate percentage of 33.33%. It does not automatically mean net profit of ₹15,000.
For transaction-level opening balances or full net profit, consult the relevant ledger or Profit & Loss report rather than relying on this Daybook overview.
Marketing overview: www.vauprime.com/daybook. That page does not contain private organization data or provide a working web Daybook.