mirror of
https://github.com/Kingsrook/qqq-frontend-material-dashboard.git
synced 2025-07-18 05:10:45 +00:00
573 lines
21 KiB
TypeScript
573 lines
21 KiB
TypeScript
/*
|
|
* QQQ - Low-code Application Framework for Engineers.
|
|
* Copyright (C) 2021-2022. Kingsrook, LLC
|
|
* 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
|
|
* contact@kingsrook.com
|
|
* https://github.com/Kingsrook/
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
import {useAuth0} from "@auth0/auth0-react";
|
|
import {QException} from "@kingsrook/qqq-frontend-core/lib/exceptions/QException";
|
|
import {QAppNodeType} from "@kingsrook/qqq-frontend-core/lib/model/metaData/QAppNodeType";
|
|
import {QAppTreeNode} from "@kingsrook/qqq-frontend-core/lib/model/metaData/QAppTreeNode";
|
|
import {QAuthenticationMetaData} from "@kingsrook/qqq-frontend-core/lib/model/metaData/QAuthenticationMetaData";
|
|
import {QBrandingMetaData} from "@kingsrook/qqq-frontend-core/lib/model/metaData/QBrandingMetaData";
|
|
import {QInstance} from "@kingsrook/qqq-frontend-core/lib/model/metaData/QInstance";
|
|
import CssBaseline from "@mui/material/CssBaseline";
|
|
import Icon from "@mui/material/Icon";
|
|
import {ThemeProvider} from "@mui/material/styles";
|
|
import {LicenseInfo} from "@mui/x-license-pro";
|
|
import React, {JSXElementConstructor, Key, ReactElement, useEffect, useState,} from "react";
|
|
import {useCookies} from "react-cookie";
|
|
import {Navigate, Route, Routes, useLocation,} from "react-router-dom";
|
|
import {Md5} from "ts-md5/dist/md5";
|
|
import {setMiniSidenav, setOpenConfigurator, useMaterialUIController} from "context";
|
|
import Settings from "layouts/pages/account/settings";
|
|
import ProfileOverview from "layouts/pages/profile/profile-overview";
|
|
import QContext from "QContext";
|
|
import Sidenav from "qqq/components/Sidenav";
|
|
import Configurator from "qqq/components/Temporary/Configurator";
|
|
import MDAvatar from "qqq/components/Temporary/MDAvatar";
|
|
import MDBox from "qqq/components/Temporary/MDBox";
|
|
import theme from "qqq/components/Temporary/Theme";
|
|
import AppHome from "qqq/pages/app-home";
|
|
import CarrierPerformance from "qqq/pages/dashboards/CarrierPerformance";
|
|
import Overview from "qqq/pages/dashboards/Overview";
|
|
import EntityCreate from "qqq/pages/entity-create";
|
|
import EntityEdit from "qqq/pages/entity-edit";
|
|
import EntityList from "qqq/pages/entity-list/EntityList";
|
|
import EntityDeveloperView from "qqq/pages/entity-view/EntityDeveloperView";
|
|
import EntityView from "qqq/pages/entity-view/EntityView";
|
|
import ProcessRun from "qqq/pages/process-run";
|
|
import ReportRun from "qqq/pages/process-run/ReportRun";
|
|
import QClient from "qqq/utils/QClient";
|
|
import QProcessUtils from "qqq/utils/QProcessUtils";
|
|
|
|
///////////////////////////////////////////////////////////////////////////////////////////////
|
|
// define the parts of the nav that are static - before the qqq tables etc get dynamic added //
|
|
///////////////////////////////////////////////////////////////////////////////////////////////
|
|
function getStaticRoutes()
|
|
{
|
|
return [
|
|
{type: "divider", key: "divider-0"},
|
|
{
|
|
type: "collapse",
|
|
name: "Dashboards",
|
|
key: "dashboards",
|
|
icon: <Icon fontSize="medium">dashboard</Icon>,
|
|
collapse: [
|
|
{
|
|
name: "Overview",
|
|
key: "overview",
|
|
route: "/dashboards/overview",
|
|
component: <Overview />,
|
|
},
|
|
{
|
|
name: "Carrier Performance",
|
|
key: "carrierPerformance",
|
|
route: "/dashboards/carrierPerformance",
|
|
component: <CarrierPerformance />,
|
|
},
|
|
],
|
|
},
|
|
{type: "divider", key: "divider-1"},
|
|
];
|
|
}
|
|
|
|
const qController = QClient.getInstance();
|
|
export const SESSION_ID_COOKIE_NAME = "sessionId";
|
|
LicenseInfo.setLicenseKey(process.env.REACT_APP_MATERIAL_UI_LICENSE_KEY);
|
|
|
|
export default function App()
|
|
{
|
|
const [, setCookie, removeCookie] = useCookies([SESSION_ID_COOKIE_NAME]);
|
|
const {user, getAccessTokenSilently, getIdTokenClaims, logout} = useAuth0();
|
|
const [loadingToken, setLoadingToken] = useState(false);
|
|
const [isFullyAuthenticated, setIsFullyAuthenticated] = useState(false);
|
|
const [profileRoutes, setProfileRoutes] = useState({});
|
|
const [branding, setBranding] = useState({} as QBrandingMetaData);
|
|
|
|
useEffect(() =>
|
|
{
|
|
if (loadingToken)
|
|
{
|
|
return;
|
|
}
|
|
setLoadingToken(true);
|
|
|
|
(async () =>
|
|
{
|
|
const authenticationMetaData: QAuthenticationMetaData = await qController.getAuthenticationMetaData();
|
|
|
|
if (authenticationMetaData.type === "AUTH_0")
|
|
{
|
|
/////////////////////////////////////////
|
|
// use auth0 if auth type is ... auth0 //
|
|
/////////////////////////////////////////
|
|
try
|
|
{
|
|
console.log("Loading token...");
|
|
await getAccessTokenSilently();
|
|
const idToken = await getIdTokenClaims();
|
|
setCookie(SESSION_ID_COOKIE_NAME, idToken.__raw, {path: "/"});
|
|
setIsFullyAuthenticated(true);
|
|
console.log("Token load complete.");
|
|
}
|
|
catch (e)
|
|
{
|
|
console.log(`Error loading token: ${JSON.stringify(e)}`);
|
|
removeCookie(SESSION_ID_COOKIE_NAME);
|
|
qController.clearAuthenticationMetaDataLocalStorage();
|
|
logout();
|
|
return;
|
|
}
|
|
}
|
|
else if (authenticationMetaData.type === "FULLY_ANONYMOUS" || authenticationMetaData.type === "MOCK")
|
|
{
|
|
/////////////////////////////////////////////
|
|
// use a random token if anonymous or mock //
|
|
/////////////////////////////////////////////
|
|
console.log("Generating random token...");
|
|
setIsFullyAuthenticated(true);
|
|
setCookie(SESSION_ID_COOKIE_NAME, Md5.hashStr(`${new Date()}`), {path: "/"});
|
|
console.log("Token generation complete.");
|
|
return;
|
|
}
|
|
else
|
|
{
|
|
console.log(`Unrecognized authenticationMetaData.type: ${authenticationMetaData.type}`);
|
|
qController.clearAuthenticationMetaDataLocalStorage();
|
|
}
|
|
|
|
})();
|
|
}, [loadingToken]);
|
|
|
|
const [controller, dispatch] = useMaterialUIController();
|
|
const {miniSidenav, direction, layout, openConfigurator, sidenavColor} = controller;
|
|
const [onMouseEnter, setOnMouseEnter] = useState(false);
|
|
const {pathname} = useLocation();
|
|
|
|
const [needToLoadRoutes, setNeedToLoadRoutes] = useState(true);
|
|
const [sideNavRoutes, setSideNavRoutes] = useState(getStaticRoutes());
|
|
const [appRoutes, setAppRoutes] = useState(null as any);
|
|
|
|
////////////////////////////////////////////
|
|
// load qqq meta data to make more routes //
|
|
////////////////////////////////////////////
|
|
useEffect(() =>
|
|
{
|
|
if (!needToLoadRoutes || !isFullyAuthenticated)
|
|
{
|
|
return;
|
|
}
|
|
setNeedToLoadRoutes(false);
|
|
|
|
(async () =>
|
|
{
|
|
function addAppToSideNavList(app: QAppTreeNode, appList: any[], parentPath: string, depth: number)
|
|
{
|
|
const path = `${parentPath}/${app.name}`;
|
|
if (app.type !== QAppNodeType.APP)
|
|
{
|
|
return;
|
|
}
|
|
|
|
if (depth > 2)
|
|
{
|
|
console.warn("App depth is greater than 2 - not including app in side nav...");
|
|
return;
|
|
}
|
|
|
|
const childList: any[] = [];
|
|
if (app.children)
|
|
{
|
|
app.children.forEach((child: QAppTreeNode) =>
|
|
{
|
|
addAppToSideNavList(child, childList, path, depth + 1);
|
|
});
|
|
}
|
|
|
|
if (childList.length === 0)
|
|
{
|
|
if (depth === 0)
|
|
{
|
|
/////////////////////////////////////////////////////
|
|
// at level 0, the entry must always be a collapse //
|
|
/////////////////////////////////////////////////////
|
|
appList.push({
|
|
type: "collapse",
|
|
name: app.label,
|
|
key: app.name,
|
|
route: path,
|
|
icon: <Icon fontSize="medium">{app.iconName}</Icon>,
|
|
noCollapse: true,
|
|
component: <AppHome />,
|
|
});
|
|
}
|
|
else
|
|
{
|
|
appList.push({
|
|
name: app.label,
|
|
key: app.name,
|
|
route: path,
|
|
icon: <Icon fontSize="medium">{app.iconName}</Icon>,
|
|
component: <AppHome />,
|
|
});
|
|
}
|
|
}
|
|
else
|
|
{
|
|
appList.push({
|
|
type: "collapse",
|
|
name: app.label,
|
|
key: app.name,
|
|
dropdown: true,
|
|
icon: <Icon fontSize="medium">{app.iconName}</Icon>,
|
|
collapse: childList,
|
|
});
|
|
}
|
|
}
|
|
|
|
function addAppToAppRoutesList(metaData: QInstance, app: QAppTreeNode, routeList: any[], parentPath: string, depth: number)
|
|
{
|
|
const path = `${parentPath}/${app.name}`;
|
|
if (app.type === QAppNodeType.APP)
|
|
{
|
|
if (app.children)
|
|
{
|
|
app.children.forEach((child: QAppTreeNode) =>
|
|
{
|
|
addAppToAppRoutesList(metaData, child, routeList, path, depth + 1);
|
|
});
|
|
}
|
|
|
|
routeList.push({
|
|
name: `${app.label}`,
|
|
key: app.name,
|
|
route: path,
|
|
component: <AppHome app={metaData.apps.get(app.name)} />,
|
|
});
|
|
}
|
|
else if (app.type === QAppNodeType.TABLE)
|
|
{
|
|
const table = metaData.tables.get(app.name);
|
|
routeList.push({
|
|
name: `${app.label}`,
|
|
key: app.name,
|
|
route: path,
|
|
component: <EntityList table={table} />,
|
|
});
|
|
|
|
routeList.push({
|
|
name: `${app.label} Create`,
|
|
key: `${app.name}.create`,
|
|
route: `${path}/create`,
|
|
component: <EntityCreate table={table} />,
|
|
});
|
|
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
// this is the path to open a modal-form when viewing a record, to create a different (child) record //
|
|
// it can also be done with a hash like: #/createChild=:childTableName //
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
routeList.push({
|
|
key: `${app.name}.createChild`,
|
|
route: `${path}/:id/createChild/:childTableName`,
|
|
component: <EntityView table={table} />,
|
|
});
|
|
|
|
routeList.push({
|
|
name: `${app.label} View`,
|
|
key: `${app.name}.view`,
|
|
route: `${path}/:id`,
|
|
component: <EntityView table={table} />,
|
|
});
|
|
|
|
routeList.push({
|
|
name: `${app.label}`,
|
|
key: `${app.name}.edit`,
|
|
route: `${path}/:id/edit`,
|
|
component: <EntityEdit table={table} />,
|
|
});
|
|
|
|
routeList.push({
|
|
name: `${app.label}`,
|
|
key: `${app.name}.record.dev`,
|
|
route: `${path}/:id/dev`,
|
|
component: <EntityDeveloperView table={table} />,
|
|
});
|
|
|
|
const processesForTable = QProcessUtils.getProcessesForTable(metaData, table.name, true);
|
|
processesForTable.forEach((process) =>
|
|
{
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
// paths to open modal process under its owning table. //
|
|
// note, processes can also be launched (at least initially on entityView screen) with a hash like: #/launchProcess=:processName //
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
routeList.push({
|
|
name: process.label,
|
|
key: process.name,
|
|
route: `${path}/${process.name}`,
|
|
component: <EntityList table={table} launchProcess={process} />,
|
|
});
|
|
|
|
routeList.push({
|
|
name: process.label,
|
|
key: `${app.name}/${process.name}`,
|
|
route: `${path}/:id/${process.name}`,
|
|
component: <EntityView table={table} launchProcess={process} />,
|
|
});
|
|
});
|
|
|
|
const reportsForTable = QProcessUtils.getReportsForTable(metaData, table.name, true);
|
|
reportsForTable.forEach((report) =>
|
|
{
|
|
// todo - do we need some table/report routes here, that would go to EntityList and/or EntityView
|
|
routeList.push({
|
|
name: report.label,
|
|
key: report.name,
|
|
route: `${path}/${report.name}`,
|
|
component: <ReportRun report={report} />,
|
|
});
|
|
});
|
|
}
|
|
else if (app.type === QAppNodeType.PROCESS)
|
|
{
|
|
const process = metaData.processes.get(app.name);
|
|
routeList.push({
|
|
name: `${app.label}`,
|
|
key: app.name,
|
|
route: path,
|
|
component: <ProcessRun process={process} />,
|
|
});
|
|
}
|
|
else if (app.type === QAppNodeType.REPORT)
|
|
{
|
|
const report = metaData.reports.get(app.name);
|
|
routeList.push({
|
|
name: `${app.label}`,
|
|
key: app.name,
|
|
route: path,
|
|
component: <ReportRun report={report} />,
|
|
});
|
|
}
|
|
}
|
|
|
|
try
|
|
{
|
|
const metaData = await QClient.getInstance().loadMetaData();
|
|
if (metaData.branding)
|
|
{
|
|
setBranding(metaData.branding);
|
|
const favicon = document.querySelector("link[rel~='icon']") as HTMLLinkElement;
|
|
const appleIcon = document.querySelector("link[rel~='apple-touch-icon']") as HTMLLinkElement;
|
|
if (favicon)
|
|
{
|
|
favicon.href = metaData.branding.icon;
|
|
}
|
|
if (appleIcon)
|
|
{
|
|
appleIcon.href = metaData.branding.icon;
|
|
}
|
|
}
|
|
|
|
let profileRoutes = {};
|
|
const gravatarBase = "https://www.gravatar.com/avatar/";
|
|
const hash = Md5.hashStr(user?.email || "user");
|
|
const profilePicture = `${gravatarBase}${hash}`;
|
|
profileRoutes = {
|
|
type: "collapse",
|
|
name: user?.name,
|
|
key: "username",
|
|
icon: <MDAvatar src={profilePicture} alt="{user?.name}" size="sm" />,
|
|
collapse: [
|
|
{
|
|
name: "My Profile",
|
|
key: "my-profile",
|
|
route: "/pages/profile/profile-overview",
|
|
component: <ProfileOverview />,
|
|
},
|
|
{
|
|
name: "Settings",
|
|
key: "profile-settings",
|
|
route: "/pages/account/settings",
|
|
component: <Settings />,
|
|
},
|
|
],
|
|
};
|
|
setProfileRoutes(profileRoutes);
|
|
|
|
const sideNavAppList = [] as any[];
|
|
const appRoutesList = [] as any[];
|
|
for (let i = 0; i < metaData.appTree.length; i++)
|
|
{
|
|
const app = metaData.appTree[i];
|
|
addAppToSideNavList(app, sideNavAppList, "", 0);
|
|
addAppToAppRoutesList(metaData, app, appRoutesList, "", 0);
|
|
}
|
|
|
|
const newSideNavRoutes = getStaticRoutes();
|
|
// @ts-ignore
|
|
newSideNavRoutes.unshift(profileRoutes);
|
|
for (let i = 0; i < sideNavAppList.length; i++)
|
|
{
|
|
newSideNavRoutes.push(sideNavAppList[i]);
|
|
}
|
|
|
|
setSideNavRoutes(newSideNavRoutes);
|
|
setAppRoutes(appRoutesList);
|
|
}
|
|
catch (e)
|
|
{
|
|
console.error(e);
|
|
if (e instanceof QException)
|
|
{
|
|
if ((e as QException).message.indexOf("status code 401") !== -1)
|
|
{
|
|
removeCookie(SESSION_ID_COOKIE_NAME);
|
|
|
|
//////////////////////////////////////////////////////
|
|
// todo - this is auth0 logout... make more generic //
|
|
//////////////////////////////////////////////////////
|
|
logout();
|
|
return;
|
|
}
|
|
}
|
|
}
|
|
})();
|
|
}, [needToLoadRoutes, isFullyAuthenticated]);
|
|
|
|
// Open sidenav when mouse enter on mini sidenav
|
|
const handleOnMouseEnter = () =>
|
|
{
|
|
if (miniSidenav && !onMouseEnter)
|
|
{
|
|
setMiniSidenav(dispatch, false);
|
|
setOnMouseEnter(true);
|
|
}
|
|
};
|
|
|
|
// Close sidenav when mouse leave mini sidenav
|
|
const handleOnMouseLeave = () =>
|
|
{
|
|
if (onMouseEnter)
|
|
{
|
|
setMiniSidenav(dispatch, true);
|
|
setOnMouseEnter(false);
|
|
}
|
|
};
|
|
|
|
// Change the openConfigurator state
|
|
const handleConfiguratorOpen = () => setOpenConfigurator(dispatch, !openConfigurator);
|
|
|
|
// Setting the dir attribute for the body element
|
|
useEffect(() =>
|
|
{
|
|
document.body.setAttribute("dir", direction);
|
|
}, [direction]);
|
|
|
|
// Setting page scroll to 0 when changing the route
|
|
useEffect(() =>
|
|
{
|
|
document.documentElement.scrollTop = 0;
|
|
document.scrollingElement.scrollTop = 0;
|
|
}, [pathname]);
|
|
|
|
///////////////////////////////////////////////////////////////////////////////////////////
|
|
// convert an object that works for the Sidenav into one that works for the react-router //
|
|
///////////////////////////////////////////////////////////////////////////////////////////
|
|
const getRoutes = (allRoutes: any[]): any => allRoutes.map(
|
|
(route: {
|
|
collapse: any;
|
|
route: string;
|
|
component: ReactElement<any, string | JSXElementConstructor<any>>;
|
|
key: Key;
|
|
}) =>
|
|
{
|
|
if (route.collapse)
|
|
{
|
|
return getRoutes(route.collapse);
|
|
}
|
|
|
|
if (route.route)
|
|
{
|
|
return <Route path={route.route} element={route.component} key={route.key} />;
|
|
}
|
|
|
|
return null;
|
|
},
|
|
);
|
|
|
|
const configsButton = (
|
|
<MDBox
|
|
display="flex"
|
|
justifyContent="center"
|
|
alignItems="center"
|
|
width="3.25rem"
|
|
height="3.25rem"
|
|
bgColor="white"
|
|
shadow="sm"
|
|
borderRadius="50%"
|
|
position="fixed"
|
|
right="2rem"
|
|
bottom="2rem"
|
|
zIndex={99}
|
|
color="dark"
|
|
sx={{cursor: "pointer"}}
|
|
onClick={handleConfiguratorOpen}
|
|
>
|
|
<Icon fontSize="small" color="inherit">
|
|
settings
|
|
</Icon>
|
|
</MDBox>
|
|
);
|
|
|
|
const [pageHeader, setPageHeader] = useState("");
|
|
|
|
return (
|
|
|
|
appRoutes && (
|
|
<QContext.Provider value={{
|
|
pageHeader: pageHeader,
|
|
setPageHeader: (header: string) => setPageHeader(header)
|
|
}}>
|
|
<ThemeProvider theme={theme}>
|
|
<CssBaseline />
|
|
{layout === "dashboard" && (
|
|
<>
|
|
<Sidenav
|
|
color={sidenavColor}
|
|
icon={branding.icon}
|
|
logo={branding.logo}
|
|
companyName={branding.companyName}
|
|
routes={sideNavRoutes}
|
|
onMouseEnter={handleOnMouseEnter}
|
|
onMouseLeave={handleOnMouseLeave}
|
|
/>
|
|
<Configurator />
|
|
</>
|
|
)}
|
|
<Routes>
|
|
<Route path="*" element={<Navigate to="/dashboards/overview" />} />
|
|
{appRoutes && getRoutes(appRoutes)}
|
|
{getRoutes(getStaticRoutes())}
|
|
{profileRoutes && getRoutes([profileRoutes])}
|
|
</Routes>
|
|
</ThemeProvider>
|
|
</QContext.Provider>
|
|
)
|
|
);
|
|
}
|