Features

• Hour-bucketed dashboard — one row per warehouse and per hour interval between hour_start and hour_end, plus optional before and after rows for moves outside the window; columns group products by category just like the planning wizard.
• Forecast vs. actual on one screen — every warehouse total shows initial_stock (beginning of day), in_qty, out_qty, donation_qty, stock_on_hand (projected EOD) and the forecast from the selected manual forecast input.
• Donation tracking — a new is_donation flag on stock.picking (with a related field on stock.move) routes donation outflows to a separate column, so commercial delivery performance is not polluted by give-aways.
• Timezone-aware bucketing — done moves are projected into the user's res.users.tz, so an 09:30 UTC move correctly lands in the local 11:00–12:00 slot for an Europe/Bucharest planner.
• Detail and Summary views — the OWL component toggles between product-level grain and category-level aggregation, useful when the catalog is wide and you only need a high-level health check.
• Manual and 5-minute auto-refresh — a Refresh button reloads on demand and an Auto toggle keeps the grid live by re-running the controller every five minutes without leaving the page.
• Per-config time window — Realtime Hour Start (0-23) and Realtime Hour End (1-24) live on stock.manual.forecast.config, so each warehouse group can have its own dispatch window without global settings.

Configuration

The dashboard reuses your existing Forecast Configs and adds two new fields plus a Donation flag on transfers. There is no separate settings page.

1. Prerequisites

1. stock_manual_forecast must be installed with at least one Forecast Config and a Forecast Input for the day you want to monitor (only confirmed inputs feed the forecast column, but draft and queued inputs are still listed in the dashboard's selector).
2. Users must have a correct Timezone set on their preferences — the controller buckets moves using res.users.tz.

2. Set the dashboard time window

The hourly grid is built per Forecast Config:

1. Go to Inventory -> Configuration -> Manual Forecast -> Forecast Configs and open the config you want to monitor.
2. Two new fields appear after Ratio Split Mode:
   • Realtime Hour Start (0-23, default 7) — first visible hour interval.
   • Realtime Hour End (1-24, default 22) — last visible hour, exclusive.

A start = 7, end = 22 configuration produces intervals 07:00 - 08:00 through 21:00 - 22:00, plus a single 00:00 - 07:00 before row and a 22:00 - 24:00 after row for out-of-window movements. Validation enforces 0 <= hour_start < hour_end <= 24.

3. Mark donation pickings (optional)

To split give-aways from commercial deliveries:

1. Open any transfer at Inventory -> Operations -> Transfers.
2. Tick the Donation boolean toggle added next to the Source Document field.
3. All stock moves of that picking inherit is_donation = True through a stored related field and are reported in the donation_qty column of the dashboard.

The same flag is exposed as an optional column on the Transfers list, so you can filter or audit donations later.

4. Access rights

No new groups are introduced. Anyone who already opens the Manual Forecast wizards can open Realtime Stock vs Forecast at Inventory -> Operations -> Manual Forecast -> Realtime Stock vs Forecast.

How it works

The dashboard is a read-only view that combines beginning-of-day stock, the day's done stock moves and the forecast for the same date. It is meant to be left open on a screen during the dispatch window.

1. Open the dashboard

Go to Inventory -> Operations -> Manual Forecast -> Realtime Stock vs Forecast. The page opens on today's date with the first available config pre-selected.

2. Pick date, config and input

1. Set the Date in the picker at the top (defaults to today).
2. Choose a Config in the dropdown. If only one exists it is selected automatically.
3. If multiple forecast inputs exist for that date and config, pick the one to compare against in the Input selector. The grid loads automatically.

3. Read the grid

• Rows are grouped per warehouse: one row per hourly interval, plus optional before and after rows and a per-warehouse total.
• Each interval cell shows in (received), out (delivered) and donation chips for that hour, with zero values hidden to keep the grid readable.
• The warehouse-total row carries initial_stock, total in_qty, total out_qty, total donation_qty, projected stock_on_hand (EOD) and the matching forecast.
• A Summary toggle at the top switches the grid to a warehouse x category aggregation for a higher-level view.

4. Stay up to date

• Refresh reloads without losing the current selection.
• Auto toggles a background refresh every five minutes — a notification confirms the new state.
• Donation pickings only show up after their Donation flag is ticked and the transfer is validated.

Versions

19.0.1.0.0 (2026-05-25)

• Changelog tracking starts at this release.