Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,17 @@
import { ActionFunction, LoaderFunctionArgs } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import RowEditRoute from "~/modules/rows/components/RowEditRoute";
import { Rows_Edit } from "~/modules/rows/routes/Rows_Edit.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_Edit.LoaderData> = ({ data }) => data?.meta || [];
export const loader = (args: LoaderFunctionArgs) => Rows_Edit.loader(args);
export const action: ActionFunction = (args) => Rows_Edit.action(args);
export default () => <RowEditRoute />;
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,28 @@
import { ActionFunction, LoaderFunctionArgs, useActionData, useLoaderData } from "react-router";
import RowOverviewRoute from "~/modules/rows/components/RowOverviewRoute";
import ServerError from "~/components/ui/errors/ServerError";
import { Rows_Overview } from "~/modules/rows/routes/Rows_Overview.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_Overview.LoaderData> = ({ data }) => data?.meta || [];
export const loader = (args: LoaderFunctionArgs) => Rows_Overview.loader(args);
export const action: ActionFunction = (args) => Rows_Overview.action(args);
export default function () {
const data = useLoaderData<Rows_Overview.LoaderData>();
const actionData = useActionData<Rows_Overview.ActionData>();
return (
<RowOverviewRoute
rowData={data.rowData}
item={actionData?.updatedRow?.item ?? data.rowData.item}
routes={data.routes}
relationshipRows={data.relationshipRows}
/>
);
}
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,17 @@
import { ActionFunction, LoaderFunctionArgs } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import RowShareRoute from "~/modules/rows/components/RowShareRoute";
import { Rows_Share } from "~/modules/rows/routes/Rows_Share.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_Share.LoaderData> = ({ data }) => data?.meta || [];
export const loader = (args: LoaderFunctionArgs) => Rows_Share.loader(args);
export const action: ActionFunction = (args) => Rows_Share.action(args);
export default () => <RowShareRoute />;
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,15 @@
import { ActionFunction, LoaderFunctionArgs } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import RowTagsRoute from "~/modules/rows/components/RowTagsRoute";
import { Rows_Tags } from "~/modules/rows/routes/Rows_Tags.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
export { serverTimingHeaders as headers };
export const loader = (args: LoaderFunctionArgs) => Rows_Tags.loader(args);
export const action: ActionFunction = (args) => Rows_Tags.action(args);
export default () => <RowTagsRoute />;
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,17 @@
import { ActionFunction, LoaderFunctionArgs } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import { Rows_List } from "~/modules/rows/routes/Rows_List.server";
import RowsAllInOneRoute from "~/modules/rows/components/RowsAllInOneRoute";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_List.LoaderData> = ({ data }) => data?.meta || [];
export const loader = (args: LoaderFunctionArgs) => Rows_List.loader(args);
export const action: ActionFunction = (args) => Rows_List.action(args);
export default () => <RowsAllInOneRoute />;
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,6 @@
import { LoaderFunctionArgs } from "react-router";
import { Rows_Export } from "~/modules/rows/routes/Rows_Export.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
export { serverTimingHeaders as headers };
export const loader = (args: LoaderFunctionArgs) => Rows_Export.loader(args);
@@ -0,0 +1,12 @@
import { ActionFunction, LoaderFunctionArgs } from "react-router";
import RowsImportRoute from "~/modules/rows/components/RowsImportRoute";
import { Rows_Import } from "~/modules/rows/routes/Rows_Import.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_Import.LoaderData> = ({ data }) => data?.meta || [];
export const loader = (args: LoaderFunctionArgs) => Rows_Import.loader(args);
export const action: ActionFunction = (args) => Rows_Import.action(args);
export default () => <RowsImportRoute />;
@@ -0,0 +1,17 @@
import { ActionFunction, LoaderFunctionArgs } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import RowNewRoute from "~/modules/rows/components/RowNewRoute";
import { Rows_New } from "~/modules/rows/routes/Rows_New.server";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_New.LoaderData> = ({ data }) => data?.meta || [];
export const loader = (args: LoaderFunctionArgs) => Rows_New.loader(args);
export const action: ActionFunction = (args) => Rows_New.action(args);
export default () => <RowNewRoute />;
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,14 @@
import { LoaderFunctionArgs } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import { Rows_Relationships } from "~/modules/rows/routes/Rows_Relationships.server";
import RowsRelationshipsRoute from "~/modules/rows/components/RowsRelationshipsRoute";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
export { serverTimingHeaders as headers };
export const loader = (args: LoaderFunctionArgs) => Rows_Relationships.loader(args);
export default () => <RowsRelationshipsRoute />;
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,42 @@
import { describe, expect, it, vi } from "vitest";
vi.mock("~/modules/rows/routes/Rows_List.server", () => ({
Rows_List: {
loader: vi.fn(() => Response.json({ ok: true })),
action: vi.fn(() => Response.json({ ok: true })),
},
}));
vi.mock("~/utils/db/entities/entityGroups.db.server", () => ({
getEntityGroupBySlug: vi.fn(),
}));
import { Rows_List } from "~/modules/rows/routes/Rows_List.server";
import { getEntityGroupBySlug } from "~/utils/db/entities/entityGroups.db.server";
import { action, loader } from "./__$entity";
const request = new Request("https://app.example.test/acme/g/sales/invoices");
describe("group entity route boundary", () => {
it("rejects entities that are not part of the active group before loading rows", async () => {
vi.mocked(getEntityGroupBySlug).mockResolvedValue({
id: "group_1",
slug: "sales",
entities: [{ entity: { slug: "contacts", name: "contact" } }],
} as never);
await expect(loader({ request, params: { tenant: "acme", group: "sales", entity: "invoices" }, context: {} } as never)).rejects.toMatchObject({ status: 302 });
expect(Rows_List.loader).not.toHaveBeenCalled();
});
it("delegates actions only for entities in the active group", async () => {
vi.mocked(getEntityGroupBySlug).mockResolvedValue({
id: "group_1",
slug: "sales",
entities: [{ entity: { slug: "contacts", name: "contact" } }],
} as never);
await action({ request, params: { tenant: "acme", group: "sales", entity: "contacts" }, context: {} } as never);
expect(Rows_List.action).toHaveBeenCalled();
});
});
@@ -0,0 +1,57 @@
import { ActionFunction, LoaderFunctionArgs, redirect, useLoaderData } from "react-router";
import ServerError from "~/components/ui/errors/ServerError";
import RowsViewRoute from "~/modules/rows/components/RowsViewRoute";
import { Rows_List } from "~/modules/rows/routes/Rows_List.server";
import { useAppOrAdminData } from "~/utils/data/useAppOrAdminData";
import UrlUtils from "~/utils/app/UrlUtils";
import { getEntityGroupBySlug } from "~/utils/db/entities/entityGroups.db.server";
import { getEntityPermission, getUserHasPermission } from "~/utils/helpers/PermissionsHelper";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { v2MetaFunction } from "~/utils/compat/v2MetaFunction";
export { serverTimingHeaders as headers };
export const meta: v2MetaFunction<Rows_List.LoaderData> = ({ data }) => data?.meta || [];
async function requireEntityInGroup(params: { group?: string; entity?: string; tenant?: string }) {
if (!params.group || !params.entity) {
throw redirect(UrlUtils.currentTenantUrl(params, "404"));
}
const group = await getEntityGroupBySlug(params.group);
const entityBelongsToGroup = group?.entities.some(({ entity }) => entity.slug === params.entity || entity.name === params.entity) === true;
if (!entityBelongsToGroup) {
throw redirect(UrlUtils.currentTenantUrl(params, "404"));
}
}
export const loader = async (args: LoaderFunctionArgs) => {
await requireEntityInGroup(args.params);
return Rows_List.loader(args);
};
export const action: ActionFunction = async (args) => {
await requireEntityInGroup(args.params);
return Rows_List.action(args);
};
export default function () {
const data = useLoaderData<Rows_List.LoaderData>();
const appOrAdminData = useAppOrAdminData();
return (
<RowsViewRoute
key={data.rowsData.entity.id}
rowsData={data.rowsData}
items={data.rowsData.items}
routes={data.routes}
saveCustomViews={true}
permissions={{
create: getUserHasPermission(appOrAdminData, getEntityPermission(data.rowsData.entity, "create")),
}}
currentSession={{
user: appOrAdminData.user,
isSuperAdmin: appOrAdminData.isSuperAdmin,
}}
/>
);
}
export function ErrorBoundary() {
return <ServerError />;
}
@@ -0,0 +1,119 @@
import { LoaderFunctionArgs, MetaFunction, redirect, useLoaderData } from "react-router";
import { useTranslation } from "react-i18next";
import { PlusIcon } from "~/components/ui/icons/vendor";
import IndexPageLayout from "~/components/ui/layouts/IndexPageLayout";
import { getTranslations } from "~/locale/i18next.server";
import { RowsApi } from "~/utils/api/.server/RowsApi";
import UrlUtils from "~/utils/app/UrlUtils";
import { getAllEntities } from "~/utils/db/entities/entities.db.server";
import { getEntityGroupBySlug } from "~/utils/db/entities/entityGroups.db.server";
import { getTenantIdOrNull } from "~/utils/services/.server/urlService";
import RowsList from "~/components/entities/rows/RowsList";
import { Link, useParams } from "react-router";
import { EntitiesApi } from "~/utils/api/.server/EntitiesApi";
import { useAppOrAdminData } from "~/utils/data/useAppOrAdminData";
import { requireAuth } from "~/utils/loaders.middleware";
import { getPermissionsByUser, getUserRoleInAdmin } from "~/utils/db/permissions/userRoles.db.server";
import { getEntityPermission, getUserHasPermission } from "~/utils/helpers/PermissionsHelper";
import { getUserInfo } from "~/utils/session.server";
import { DefaultAdminRoles } from "~/application/dtos/shared/DefaultAdminRoles";
import { translateLabel } from "~/utils/i18n/translateLabel";
type LoaderData = {
title: string;
entitiesData: { [entity: string]: RowsApi.GetRowsData };
entitiesRoutes: { [entity: string]: EntitiesApi.Routes };
};
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
await requireAuth({ request, params });
const { t } = await getTranslations(request);
const tenantId = await getTenantIdOrNull({ request, params });
const userInfo = await getUserInfo(request);
const group = await getEntityGroupBySlug(params.group!);
if (!group) {
throw redirect(tenantId ? UrlUtils.currentTenantUrl(params, "404") : "/404");
}
const isSuperAdmin = Boolean(await getUserRoleInAdmin(userInfo.userId, DefaultAdminRoles.SuperAdmin));
const permissions = isSuperAdmin ? null : (await getPermissionsByUser(userInfo.userId, tenantId)).map((permission) => permission as string);
const urlSearchParams = new URL(request.url).searchParams;
const allEntities = await getAllEntities({ tenantId });
const entitiesData: LoaderData["entitiesData"] = {};
const entitiesRoutes: LoaderData["entitiesRoutes"] = {};
await Promise.all(
group.entities.map(async ({ entityId, allView }) => {
const entity = allEntities.find((f) => f.id === entityId);
if (!entity || (!isSuperAdmin && !permissions?.includes(getEntityPermission(entity, "view")))) {
return;
}
const data = await RowsApi.getAll({
entity,
tenantId,
userId: isSuperAdmin ? undefined : userInfo.userId,
urlSearchParams,
entityView: allView ?? undefined,
});
entitiesData[entity.name] = data;
entitiesRoutes[entity.name] = EntitiesApi.getNoCodeRoutes({ request, params });
return entitiesData;
})
);
const data: LoaderData = {
title: `${t(group.title)} | ${process.env.APP_NAME}`,
entitiesData,
entitiesRoutes,
};
return data;
};
export const meta: MetaFunction<typeof loader> = ({ data }) => [{ title: data?.title }];
export default () => {
const { t, i18n } = useTranslation();
const data = useLoaderData<LoaderData>();
const appOrAdminData = useAppOrAdminData();
const params = useParams();
function getGroup() {
return appOrAdminData.entityGroups.find((f) => f.slug === params.group);
}
const visibleGroupEntities = getGroup()?.entities.filter(({ entity }) => getUserHasPermission(appOrAdminData, getEntityPermission(entity, "view"))) ?? [];
return (
<IndexPageLayout>
<div className="space-y-2">
{visibleGroupEntities.map(({ entity, allView }) => {
const entityData = data.entitiesData[entity.name];
if (!entityData) {
return null;
}
return (
<div key={entity.id} className="space-y-1">
<div className="flex items-center justify-between space-x-2">
<h3 className="text-sm font-medium">
{translateLabel(t, i18n, entity.titlePlural)} <span className="text-muted-foreground text-xs">({entityData.items.length})</span>
</h3>
{getUserHasPermission(appOrAdminData, getEntityPermission(entity, "create")) && (
<Link
to={entity.slug + "/new"}
aria-label={`${t("shared.create")} ${translateLabel(t, i18n, entity.title)}`}
className="text-foreground bg-secondary hover:bg-secondary/90 rounded-full p-1 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gray-600"
>
<PlusIcon className="h-5 w-5" aria-hidden="true" />
</Link>
)}
</div>
<RowsList
view={(allView?.layout ?? "card") as "table" | "board" | "grid" | "card"}
entity={entityData.entity}
items={entityData.items}
routes={data.entitiesRoutes[entity.name]}
pagination={entityData.pagination}
currentView={allView}
/>
</div>
);
})}
</div>
</IndexPageLayout>
);
};
@@ -0,0 +1,113 @@
import { LoaderFunctionArgs, redirect, MetaFunction, useLoaderData } from "react-router";
import { useSearchParams } from "react-router";
import { getTranslations } from "~/locale/i18next.server";
import { getAppDashboardStats } from "~/utils/services/appDashboardService";
import { DashboardStats } from "~/components/ui/stats/DashboardStats";
import { getTenantIdFromUrl } from "~/utils/services/.server/urlService";
import { Stat } from "~/application/dtos/stats/Stat";
import InputSelector from "~/components/ui/input/InputSelector";
import PeriodHelper, { defaultPeriodFilter, PeriodFilters } from "~/utils/helpers/PeriodHelper";
import { useTranslation } from "react-i18next";
import ServerError from "~/components/ui/errors/ServerError";
import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders";
import { getTenant } from "~/utils/db/tenants.db.server";
import { EntityGroupWithDetails, getEntityGroupBySlug } from "~/utils/db/entities/entityGroups.db.server";
import UrlUtils from "~/utils/app/UrlUtils";
import EditPageLayout from "~/components/ui/layouts/EditPageLayout";
import { requireAuth } from "~/utils/loaders.middleware";
import { adminPath, appPath } from "~/utils/app/CanonicalUrlUtils";
import { getPermissionsByUser, getUserRoleInAdmin } from "~/utils/db/permissions/userRoles.db.server";
import { getEntityPermission } from "~/utils/helpers/PermissionsHelper";
import { getUserInfo } from "~/utils/session.server";
import { DefaultAdminRoles } from "~/application/dtos/shared/DefaultAdminRoles";
import { translateLabel } from "~/utils/i18n/translateLabel";
export { serverTimingHeaders as headers };
type LoaderData = {
title: string;
group: EntityGroupWithDetails;
stats: Stat[];
};
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
await requireAuth({ request, params });
const { t } = await getTranslations(request);
const tenantId = await getTenantIdFromUrl(params);
const userInfo = await getUserInfo(request);
const group = await getEntityGroupBySlug(params.group!);
const tenant = await getTenant(tenantId);
if (!group) {
throw redirect(tenantId ? UrlUtils.currentTenantUrl(params, "404") : "/404");
}
const isSuperAdmin = Boolean(await getUserRoleInAdmin(userInfo.userId, DefaultAdminRoles.SuperAdmin));
const permissions = isSuperAdmin ? null : (await getPermissionsByUser(userInfo.userId, tenantId)).map((permission) => permission as string);
const visibleEntities = group.entities.flatMap((e) => e.entity).filter((entity) => isSuperAdmin || permissions?.includes(getEntityPermission(entity, "view")));
const stats = await getAppDashboardStats({
t,
tenant,
gte: PeriodHelper.getGreaterThanOrEqualsFromRequest({ request }),
entities: visibleEntities,
});
stats
.filter((f) => f.entity)
.forEach((stat) => {
const tenantSlug = tenant?.slug ?? params.tenant ?? tenantId;
stat.path = tenantId
? appPath({ tenantSlug, path: `g/${params.group}/${stat.entity?.slug}`, mode: "host-aware" })
: adminPath(`g/${params.group}/${stat.entity?.slug}`, { mode: "host-aware" });
});
const data: LoaderData = {
title: `${t(group.title)} | ${process.env.APP_NAME}`,
group,
stats,
};
return data;
};
export const meta: MetaFunction<typeof loader> = ({ data }) => [{ title: data?.title }];
export default function GroupIndexRoute() {
const { t, i18n } = useTranslation();
const data = useLoaderData<LoaderData>();
const [searchParams, setSearchParams] = useSearchParams();
return (
<EditPageLayout>
{data.stats.length > 0 && (
<div className="space-y-3">
<div className="flex items-center justify-between space-x-2">
<h3 className="text-foreground grow font-medium leading-4">{translateLabel(t, i18n, data.group.title)}</h3>
<div>
<InputSelector
className="w-44"
withSearch={false}
name="period"
value={searchParams.get("period")?.toString() ?? defaultPeriodFilter}
options={PeriodFilters.map((f) => {
return {
value: f.value,
name: t(f.name),
};
})}
setValue={(value) => {
if (value) {
searchParams.set("period", value?.toString() ?? "");
} else {
searchParams.delete("period");
}
setSearchParams(searchParams);
}}
/>
</div>
</div>
<DashboardStats items={data.stats} />
</div>
)}
</EditPageLayout>
);
}
export function ErrorBoundary() {
return <ServerError />;
}