feat: add dashboard core by Pieselak · Pull Request #1797 · Selleo/mentingo

Pieselak · 2026-07-21T10:06:44Z

Issue(s)

[EPIC] Add dashboard #1714

Overview

Adds a customizable dashboard with role-based widgets. Users can reorder entire widget cards, resize supported widgets, manage visibility, restore defaults, and save their layout.

Business Value

Provides users with a personalized dashboard focused on relevant information and activities. The modular widget structure also makes it easier to add dedicated business widgets without changing the dashboard layout system.

Screenshots / Video

typeWolffo · 2026-07-21T13:05:15Z

-    return userSettings;
+    const widgetIds = userSettings.dashboard.widgets.map((widget) => widget.id);
+    const validIds = await this.filterDashboardWidgets(userId, widgetIds);
+    const returnedWidgets = userSettings.dashboard.widgets.filter((widget) =>


what if there is no dashboard in users settings jsonb yet?

Created a migration to ensure consistent data in db and resolve potentional issues with lack of dashboard property in user settings

typeWolffo · 2026-07-21T14:01:55Z

+    const { roleSlugs } = await this.permissionsService.getUserAccess(userId);
+    const userRoles = new Set(roleSlugs);
+    const globalSettings = await this.getPublicGlobalSettings();


@its-gabo shouldn't the dbInstance be passed down to those awaited methods?

There’s no need to do that, unless it’s part of a transaction and we specifically need the state of the data within given transaction.

If the concern was that it wouldn’t work because of RLS, that shouldn’t be an issue. The call happens within the request context, so the data remains properly scoped through AsyncLocalStorage.

typeWolffo · 2026-07-21T14:11:40Z

    return new BaseResponse(await this.settingsService.updateUserSettings(userId, updatedSettings));
  }

+  @Get("dashboard")


shouldn't be guarded with @RequirePermission(PERMISSIONS.DASHBOARD_READ)?

Added missing Permission decorator to dashboard endpoints

typeWolffo · 2026-07-21T14:20:04Z

+          widgets: [
+            {
+              id: DASHBOARD_WIDGET_IDS.ADMIN_PLACEHOLDER1,
+              enabled: true,


is this flag used anywhere but specs?

Pieselak · 2026-07-22T08:56:30Z

@its-gabo please review

its-gabo

Pretty good in overall, just some few minor things to adjust

its-gabo · 2026-07-22T09:08:48Z

+  queryFn: async () => {
+    try {
+      const response = await ApiClient.api.settingsControllerGetAvailableDashboardWidgets();
+
+      return response.data;
+    } catch (error) {
+      if (isAxiosError(error) && error.response?.status === 401) {
+        return null;
+      }
+      throw error;
+    }
+  },
+  staleTime: 1000 * 60 * 5,
+});


Is the try .. catch needed here? Can we just not query when there's no session for a user?

its-gabo · 2026-07-22T09:09:04Z

+      if (!data) {
+        throw new Error("User not authenticated");
+      }


Translate the error please

its-gabo · 2026-07-22T09:09:33Z

+  queryFn: async () => {
+    try {
+      const response = await ApiClient.api.settingsControllerGetDefaultDashboardWidgets();
+
+      return response.data;
+    } catch (error) {
+      if (isAxiosError(error) && error.response?.status === 401) {
+        return null;
+      }
+      throw error;
+    }
+  },
+  staleTime: 1000 * 60 * 5,
+});


Same as in file above

its-gabo · 2026-07-22T09:09:46Z

+      if (!data) {
+        throw new Error("User not authenticated");
+      }


Same as in file above

its-gabo · 2026-07-22T09:11:55Z

+
+const OVERLAY_MODIFIERS = [restrictOverlayToViewport];
+
+function SortableWidget({ widget, isEditing, onWidthChange }: SortableWidgetProps) {


Let's extract this component to a separate file, alongside the types

its-gabo · 2026-07-22T09:20:21Z

@@ -1,5 +1,5 @@
 /* AUTO-GENERATED FILE - DO NOT EDIT BY HAND */


Let's unstage this file

its-gabo · 2026-07-23T09:35:11Z

+const titleKey = "dashboardHome.widgets.a_placeholder_3.title";
+const descriptionKey = "dashboardHome.widgets.placeholderDescription";
+const iconClassName = "text-warning-700";
+const iconContainerClassName = "bg-warning-50";


Is there a reason for having them not in the html? (applies to all placeholder widget files)

its-gabo · 2026-07-23T09:52:13Z

+export const adminPlaceholder3Widget = {
+  component: WidgetAdminPlaceholder3,
+  titleKey,
+  descriptionKey,
+  icon: ListChecks,
+  iconClassName,
+  iconContainerClassName,
+} satisfies DashboardWidgetModule;


Can we move all of them to one file and then import these configs and use them in components?

So then the consts from the top of the file can be deleted and we can use it like adminPlaceholder3Widget.icon to display icon for example

(applies to all)

its-gabo

Looks a bit overcomplicated, is there a way to eliminate some of the refs perhaps?

Japrolol · 2026-08-04T07:01:36Z

+        ...updatedSettings,
+        dashboard: {
+          widgets: [...submittedWidgets]
+            .sort((first, second) => first.order - second.order)


Sorting feels kind of redundant since FE already sorts by order

Japrolol · 2026-08-04T10:09:45Z

+import type { UpdateUserSettingsBody, UpdateUserSettingsResponse } from "../generated-api";
+import type { UseMutationResult } from "@tanstack/react-query";
+
+export function useUpdateDashboardWidgets(): UseMutationResult<


Do we need to type this explicitly?

Japrolol · 2026-08-04T10:13:33Z

+  height: number;
+};
+
+type DropPlacement = "before" | "after";


Since we use these values several times here, might as well extract it to an enum and derive the union from it

Japrolol · 2026-08-04T10:51:11Z

So much is happening here, let's extract reusable utilities to separate file, merge refs into one ref with object.

Japrolol · 2026-08-04T10:57:41Z

+  const displayedWidgets = previewWidgets ?? sortedWidgets;
+  const activeEntry = activeId ? DASHBOARD_WIDGET_REGISTRY[activeId] : null;
+  const ActiveIcon = activeEntry?.icon;
+  const dashboardCollisionDetection: CollisionDetection = (args) => {


The logic is very abstract, can we include some jsdoc to explain what is happening in each function?

Japrolol · 2026-08-04T11:46:44Z

Either rename extension to .ts or change name to WidgetRegistry.tsx

Pieselak added the review me 👀 PR is ready to be reviewed label Jul 21, 2026

Pieselak changed the base branch from main to staging July 21, 2026 10:34

Pieselak force-pushed the pz_feat_1714_add_dashboard branch from a6d2848 to 9a820c3 Compare July 21, 2026 11:45

typeWolffo reviewed Jul 21, 2026

View reviewed changes

Pieselak force-pushed the pz_feat_1714_add_dashboard branch from 239cd70 to 306e711 Compare July 22, 2026 08:26

Pieselak requested a review from its-gabo July 22, 2026 08:56

its-gabo requested changes Jul 22, 2026

View reviewed changes

Pieselak requested a review from its-gabo July 22, 2026 11:11

Pieselak self-assigned this Jul 23, 2026

its-gabo requested changes Jul 23, 2026

View reviewed changes

its-gabo added the run E2E tests ⚙️ Trigger E2E tests run on this branch. label Jul 23, 2026

its-gabo had a problem deploying to e2e July 23, 2026 11:02 — with GitHub Actions Failure

its-gabo temporarily deployed to e2e July 23, 2026 11:02 — with GitHub Actions Inactive

its-gabo had a problem deploying to e2e July 23, 2026 11:02 — with GitHub Actions Failure

Pieselak added run E2E tests ⚙️ Trigger E2E tests run on this branch. and removed run E2E tests ⚙️ Trigger E2E tests run on this branch. labels Jul 23, 2026

Pieselak temporarily deployed to e2e July 23, 2026 11:45 — with GitHub Actions Inactive

Pieselak added run E2E tests ⚙️ Trigger E2E tests run on this branch. and removed run E2E tests ⚙️ Trigger E2E tests run on this branch. labels Jul 23, 2026

Pieselak temporarily deployed to e2e July 23, 2026 11:55 — with GitHub Actions Inactive

Pieselak requested a review from its-gabo July 23, 2026 12:07

its-gabo approved these changes Jul 23, 2026

View reviewed changes

its-gabo reviewed Jul 29, 2026

View reviewed changes

Pieselak requested a review from its-gabo July 29, 2026 08:31

Japrolol reviewed Aug 4, 2026

View reviewed changes

Japrolol force-pushed the pz_feat_1714_add_dashboard branch from 44a1e85 to 095ed57 Compare August 5, 2026 10:08

feat: add dashboard foundation

dd67618

Japrolol force-pushed the pz_feat_1714_add_dashboard branch from 095ed57 to dd67618 Compare August 7, 2026 09:35

Pieselak and others added 2 commits August 7, 2026 14:48

feat: add admin tiles to dashboard (#1825)

ab5b071

test: cover dashboard widgets and AI Mentor practice

3b228e6


		const OVERLAY_MODIFIERS = [restrictOverlayToViewport];

		function SortableWidget({ widget, isEditing, onWidthChange }: SortableWidgetProps) {

		@@ -1,5 +1,5 @@
		/* AUTO-GENERATED FILE - DO NOT EDIT BY HAND */

Uh oh!

Conversation

Pieselak commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue(s)

Overview

Business Value

Screenshots / Video

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Pieselak commented Jul 22, 2026

Uh oh!

its-gabo left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

its-gabo left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Pieselak commented Jul 21, 2026 •

edited

Loading