add spreadsheet_dashboard_pos_cooperative & pos_dashboard_cooperative

pos_dashboard_cooperative/README.md

@@ -0,0 +1,29 @@
+# POS Dashboard Cooperative
+
+Real-time BI dashboards for cooperative supermarkets, built on top of
+Point of Sale data.
+
+This module extends `report.pos.order` with three new dimensions:
+
+| Field | Description |
+|---|---|
+| `is_member_at_date` | True if the customer held a `share.line` whose `effective_date` was on or before the order date. |
+| `categ_root_id` | Product family (root of `product.category` parent_path). |
+| `categ_parent_id` | Product subfamily (parent of the leaf category). |
+| `date_day` | Order date truncated to day. |
+| `hour_of_day` | Hour of the order (`EXTRACT(HOUR FROM date_order)`). |
+| `day_of_week` | Day of week, 1 = Monday … 7 = Sunday (ISO). |
+
+Pre-configured menus under *Point of Sale → Reporting → Cooperative
+Dashboards* cover overview, members vs. non-members, categories, top
+products, and time distributions. Four tiles surface the headline KPIs
+on the `web_dashboard_tile` board.
+
+For spreadsheet dashboards published in Odoo's *Dashboards* menu, install
+the companion module `spreadsheet_dashboard_pos_cooperative`.
+
+See `readme/` for the OCA-style structured documentation.
+
+## License
+
+AGPL-3.0 or later.