@hrbolek/uoisfrontend-template 0.6.0

package/src/GroupGQLModel/Pages/PageNavbar.jsx

@@ -0,0 +1,264 @@
+import Nav from 'react-bootstrap/Nav'
+import { ProxyLink, MyNavbar, useHash } from '@hrbolek/uoisfrontend-shared';
+
+import { LinkURI } from '../Components'
+import { RolesURI } from './PageReadItemEx';
+import { Link as GroupLink } from '../Components';
+import { Link as UserLink } from '../../UserGQLModel/Components';
+import { NavDropdown } from 'react-bootstrap';
+import { VectorItemsURI as GroupVectorItemsURI } from '../Components/Link';
+import { CreateURI as CreateRoleTypeURI } from '../../RoleTypeGQLModel/Components/Link';
+import { CreateURI as CreateGroupTypeURI } from '../../GroupTypeGQLModel/Components/Link';
+import { VectorItemsURI as UserVectorItemsURI } from '../../UserGQLModel/Components/Link';
+import { VectorItemsURI as GroupTypeVectorItemsURI } from '../../GroupTypeGQLModel/Components/Link';
+import { CreateGroupInserMembershipButton } from '../Mutations/AddMembership';
+import { UpdateButton, UpdateLink } from '../Mutations/Update';
+import { AddRoleOnGroupButton } from '../../RoleGQLModel/Mutations/AddRoleonGroup';
+import { Link } from '../../../../_template/src/Base/Components';
+
+/**
+ * Allow to use HashContainer for determination which component at page will be rendered.
+ * That must be manually inserted at TemplatePageContent, usually this should be done 
+ * as children of TemplateLargeCard.
+ * <TemplateLargeCard>
+ *     <HashContainer>
+ *         <VectorA id="history"/>
+ *         <VectorB id="roles"/>
+ *         <VectorC id="graph"/>
+ *     </HashContainer>
+ * </TemplateLargeCard>
+ * it is usefull to define globally active "areas" like science, administration, teaching, ...
+ */
+const TemplatePageSegments = [
+    { segment: 'education', label: 'Výuka' },
+    { segment: 'reaserach', label: 'Tvůrčí činnost' },
+    { segment: 'administration', label: 'Organizační činnost' },
+    { segment: 'development', label: 'Rozvoj' },
+]
+
+/**
+ * A navigation button component that generates a URL based on the template's ID and a specific segment.
+ * The button uses a `ProxyLink` to navigate while preserving hash and query parameters.
+ *
+ * ### Features:
+ * - Dynamically constructs the URL with a hash fragment pointing to the specified segment.
+ * - Displays a label for the navigation link.
+ * - Integrates seamlessly with `ProxyLink` for enhanced navigation.
+ *
+ * @component
+ * @param {Object} props - The properties for the TitleNavButton component.
+ * @param {Object} props.template - The template object containing details about the template.
+ * @param {string|number} props.template.id - The unique identifier for the template.
+ * @param {string} props.segment - The segment to append as a hash fragment in the URL.
+ * @param {string} props.label - The text to display as the label for the navigation button.
+ *
+ * @returns {JSX.Element} A styled navigation button linking to the constructed URL.
+ *
+ * @example
+ * // Example 1: Basic usage with a template and segment
+ * const template = { id: 123 };
+ * const segment = "details";
+ * const label = "View Details";
+ *
+ * <TitleNavButton template={template} segment={segment} label={label} />
+ * // Resulting URL: `/ug/template/view/123#details`
+ *
+ * @example
+ * // Example 2: Different segment and label
+ * <TitleNavButton template={{ id: 456 }} segment="settings" label="Template Settings" />
+ * // Resulting URL: `/ug/template/view/456#settings`
+ */
+const TitleNavButton = ({ item, segment, label, ...props }) => {
+    // const urlbase = (segment) => `/templates/template/${segment}/${template?.id}`;
+    const urlbase = (segment) => `${LinkURI}${item?.id}#${segment}`;
+    return (
+        <Nav.Link as={"span"} {...props}>
+            {/* <ProxyLink to={urlbase(segment)}>{label}</ProxyLink> */}
+        </Nav.Link>
+    );
+};
+
+/**
+ * Renders the navigation bar for an Template page.
+ *
+ * This component uses a custom hook, `useHash()`, to determine the current hash
+ * and highlights the active segment. It displays a navigation bar (using MyNavbar)
+ * with several segments (e.g. "history", "roles", "graph"), each rendered as a 
+ * TitleNavButton. The segments are hardcoded in this component and only rendered 
+ * if an `template` object is provided.
+ *
+ * @component
+ * @param {Object} props - The component properties.
+ * @param {Object} props.template - The template entity object that provides context for the page.
+ * @param {string|number} props.template.id - The unique identifier for the template.
+ * @param {Function} props.onSearchChange - Callback function to handle changes in the search input.
+ *
+ * @returns {JSX.Element} The rendered TemplatePageNavbar component.
+ *
+ * @example
+ * // Example usage:
+ * const template = { id: 123, ... };
+ * <TemplatePageNavbar template={template} onSearchChange={handleSearchChange} />
+ */
+export const PageNavbar = ({ item, children, onSearchChange }) => {
+    // const [currentHash, setHash] = useHash(); // Use the custom hook to manage hash
+    const currentHash = "da"
+    return (
+        <div className='screen-only'>
+            <MyNavbar onSearchChange={onSearchChange} >
+                {/* {item && TemplatePageSegments.map(({ segment, label }) => (
+                    <Nav.Item key={segment} >
+                        <TitleNavButton
+                            template={item}
+                            segment={segment}
+                            label={label}
+                            className={segment === currentHash ? "active" : ""} aria-current={segment === currentHash ? "page" : undefined}
+                        />
+                    </Nav.Item>
+                ))} */}
+                {item && (<>
+                    <NavDropdown title="Skupiny">
+                        <NavDropdown.Item as={ProxyLink} to={GroupVectorItemsURI}>
+                            Seznam všech skupin
+                        </NavDropdown.Item>
+                        {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                        <NavDropdown.Item as={GroupLink} item={item} action="roles">
+                            Role
+                        </NavDropdown.Item>
+                        {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                        <NavDropdown.Item as={GroupLink} item={item} action="subgroups">
+                            Podskupiny
+                        </NavDropdown.Item>
+                        <NavDropdown.Item as={GroupLink} item={item} action="memberships">
+                            Členové
+                        </NavDropdown.Item>
+                        <NavDropdown.Divider />
+                        <NavDropdown.Item 
+                            as={CreateGroupInserMembershipButton} 
+                            item={item} 
+                            // item={{
+                            //     group: item,
+                            //     groupId: item?.groupId
+                            // }}
+                            action="memberships"
+                        >
+                            Nové členství
+                        </NavDropdown.Item>
+                    </NavDropdown>
+
+                    <NavDropdown title="Uživatelé">
+                        <NavDropdown.Item as={UserLink} to={UserVectorItemsURI}>
+                            Seznam všech uživatelů
+                        </NavDropdown.Item>
+                        {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                        <NavDropdown.Item as={UserLink} item={item} action="roles">
+                            Role
+                        </NavDropdown.Item>
+                        {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                        <NavDropdown.Item as={UserLink} item={item} action="subgroups">
+                            Podskupiny
+                        </NavDropdown.Item>
+                    </NavDropdown>
+
+
+                    <NavDropdown title="Typy">
+                        <NavDropdown.Item as={UserLink} to={GroupTypeVectorItemsURI}>
+                            Seznam všech typů skupin
+                        </NavDropdown.Item>
+                        <NavDropdown.Item as={ProxyLink} to={CreateGroupTypeURI}>
+                            Nový typ skupiny
+                        </NavDropdown.Item>
+                        <NavDropdown.Item as={"span"} disabled>
+                            {/* <hr/> */}
+                        </NavDropdown.Item>
+                        {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                        <NavDropdown.Item as={UserLink} item={item} action="roles">
+                            Seznam všech typů rolí
+                        </NavDropdown.Item>
+                        {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                        <NavDropdown.Item as={ProxyLink} to={CreateRoleTypeURI}>
+                            Nový typ role
+                        </NavDropdown.Item>
+                    </NavDropdown>
+
+                    <Nav.Item>
+                        <Nav.Link as={ProxyLink} to={GroupVectorItemsURI}>
+                            Seznam všech skupin
+                            
+                        </Nav.Link>
+                    </Nav.Item>
+                    {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                    <Nav.Item>
+                        <Nav.Link as={GroupLink} item={item} action="roles">
+                            Role
+                        </Nav.Link>
+                    </Nav.Item>
+                    {/* <span className="border-start mx-2" aria-hidden="true" /> */}
+                    <Nav.Item>
+                        <Nav.Link as={GroupLink} item={item} action="subgroups">
+                            Podskupiny
+                        </Nav.Link>
+                    </Nav.Item>
+                </>)}
+
+                {children}
+            </MyNavbar>
+        </div>
+    );
+};
+
+export const MyNavDropdown = ({ item }) => {
+    const { __typename } = item || {}
+    const hasProperType = __typename === "GroupGQLModel"
+    return (
+        <NavDropdown title="Skupiny">
+            <NavDropdown.Item as={ProxyLink} to={GroupVectorItemsURI}>
+                Seznam všech skupin
+            </NavDropdown.Item>
+            
+            <NavDropdown.Item as={GroupLink} item={item} action="roles" disabled={!hasProperType}>
+                Role {hasProperType&&item?.name}
+            </NavDropdown.Item>
+            <NavDropdown.Item as={GroupLink} item={item} action="subgroups" disabled={!hasProperType}>
+                Podskupiny {hasProperType&&item?.name}
+            </NavDropdown.Item>
+            <NavDropdown.Item as={GroupLink} item={item} action="memberships" disabled={!hasProperType}>
+                Členové {hasProperType&&item?.name}
+            </NavDropdown.Item>
+        
+        
+            <NavDropdown.Divider />
+            
+            <NavDropdown.Item 
+                as={UpdateLink} 
+                item={item}
+                disabled={!hasProperType} 
+            >
+                Upravit {hasProperType&&item?.name}
+            </NavDropdown.Item>
+            <NavDropdown.Item 
+                as={CreateGroupInserMembershipButton} 
+                // item={item} 
+                disabled={!hasProperType} 
+                item={item}
+            >
+                Nové členství {hasProperType&&item?.name}
+            </NavDropdown.Item>
+            <NavDropdown.Item 
+                as={AddRoleOnGroupButton} 
+                // item={item} 
+                rbacitem={item}
+                item={{
+                    group: item,
+                    groupId: item?.id,
+                }}
+                disabled={!hasProperType}
+            >
+                Nové oprávnění u {hasProperType&&item?.name}
+            </NavDropdown.Item>
+            
+            <NavDropdown.Divider />
+            <NavDropdown.Item as={ProxyLink} to={`/generic/${item?.__typename}/__def/${item?.id}`} reloadDocument={false}>Definice</NavDropdown.Item >
+        </NavDropdown>
+    )
+}

package/src/GroupGQLModel/Pages/PageReadItem.jsx

@@ -0,0 +1,12 @@
+import { GroupSubgroups } from "../Vectors/GroupSubgroups"
+import { PageItemBase } from "./PageBase"
+
+export const PageReadItem = ({ 
+    // SubPage=GeneratedContentBase,
+    SubPage=GroupSubgroups,
+    ...props
+}) => {
+    return (
+        <PageItemBase SubPage={SubPage} {...props}/>
+    )
+}

package/src/GroupGQLModel/Pages/PageReadItemEx.jsx

@@ -0,0 +1,57 @@
+import { ReadItemURI } from "../Components"
+import { ReadAsyncAction } from "../Queries"
+import { GroupMemberships } from "../Vectors/GroupMemberships"
+import { GroupRoles } from "../Vectors/GroupRoles"
+import { GroupRolesOn } from "../Vectors/GroupRolesOn"
+import { GroupSubgroups } from "../Vectors/GroupSubgroups"
+import { PageReadItem } from "./PageReadItem"
+
+export const RolesOnURI = ReadItemURI.replace("view", "roleson")
+export const RolesURI = ReadItemURI.replace("view", "roles")
+export const SubgroupsURI = ReadItemURI.replace("view", "subgroups")
+export const MembershipsURI = ReadItemURI.replace("view", "memberships")
+/**
+ * Základní obálka pro „read“ stránku entity podle `:id` z routy.
+ *
+ * Využívá `PageItemBase`, který zajistí:
+ * - získání `id` z URL (`useParams`)
+ * - načtení entity přes `AsyncActionProvider` pomocí `queryAsyncAction`
+ * - vložení navigace (`PageNavbar`)
+ *
+ * Uvnitř provideru vykreslí `ReadWithComponent`, který si vezme načtený `item`
+ * z `useGQLEntityContext()` a zobrazí ho v zadané komponentě (defaultně `LargeCard`).
+ *
+ * @component
+ * @param {object} props
+ * @param {Function} [props.queryAsyncAction=ReadAsyncAction]
+ *   Async action (např. thunk) pro načtení entity z backendu/GraphQL dle `id`.
+ * @param {Object<string, any>} [props]
+ *   Další props předané do `ReadWithComponent` (např. `Component`, layout props).
+ *
+ * @returns {import("react").JSX.Element}
+ */
+export const PageReadItemRolesOn = ({ queryAsyncAction=ReadAsyncAction}) => (
+    <PageReadItem queryAsyncAction={queryAsyncAction} SubPage={GroupRolesOn}/>
+)
+
+// export const PageReadItemRoles = ({ queryAsyncAction=ReadAsyncAction}) => (
+//     <PageReadItem queryAsyncAction={queryAsyncAction} SubPage={GroupRoles}/>
+// )
+
+const CombinedRoles = ({ item }) => <>
+    <GroupRoles item={item} />
+    <GroupRolesOn item={item} />
+</>
+
+export const PageReadItemRoles = ({ queryAsyncAction=ReadAsyncAction}) => (
+    <PageReadItem queryAsyncAction={queryAsyncAction} SubPage={CombinedRoles}/>
+)
+
+export const PageReadItemSubgroups = ({ queryAsyncAction=ReadAsyncAction}) => (
+    <PageReadItem queryAsyncAction={queryAsyncAction} SubPage={GroupSubgroups}/>
+)
+
+export const PageReadItemMemberships = ({ queryAsyncAction=ReadAsyncAction}) => (
+    <PageReadItem queryAsyncAction={queryAsyncAction} SubPage={GroupMemberships}/>
+)
+

package/src/GroupGQLModel/Pages/PageUpdateItem.jsx

@@ -0,0 +1,14 @@
+import { UpdateBody } from "../Mutations/Update"
+import { PageItemBase } from "./PageBase"
+
+export const PageUpdateItem = ({ 
+    SubPage=UpdateBody,
+    ...props
+}) => {
+    return (
+        <PageItemBase 
+            SubPage={SubPage}
+            {...props}
+        />
+    )
+}

package/src/GroupGQLModel/Pages/PageVector.jsx

@@ -0,0 +1,80 @@
+
+import { ReadPageAsyncAction } from "../Queries"
+import { useInfiniteScroll } from "../../../../dynamic/src/Hooks/useInfiniteScroll"
+import { PageBase } from "./PageBase"
+import { Table } from "../Components/Table"
+import { Filter } from "../Components/Filter"
+import { FilterButton, ResetFilterButton } from "../../../../_template/src/Base/FormControls/Filter"
+import { useSearchParams } from "react-router"
+import { useEffect } from "react"
+import { useMemo } from "react"
+import { AsyncStateIndicator } from "../../../../_template/src/Base/Helpers/AsyncStateIndicator"
+import { Collapsible } from "../../../../_template/src/Base/FormControls/Collapsible"
+
+
+function safeParseWhere(sp, paramName = "where") {
+    const raw = sp.get(paramName);
+    if (!raw) return null;
+    try {
+        const obj = JSON.parse(raw);
+        return obj && typeof obj === "object" ? obj : null;
+    } catch {
+        return null;
+    }
+}
+
+// 
+const filterParameterName = "gr_where"
+export const PageVector = ({ children, queryAsyncAction = ReadPageAsyncAction }) => {
+    
+    const [sp] = useSearchParams();
+
+    const whereFromUrl = useMemo(() => safeParseWhere(sp, filterParameterName), [sp.toString()]);
+
+    const { items, loading, error, hasMore, sentinelRef, loadMore, restart } = useInfiniteScroll(
+        {
+            asyncAction: queryAsyncAction,
+            actionParams: { skip: 0, limit: 25, where: whereFromUrl },
+            // reset: whereFromUrl
+        }
+    )
+
+    useEffect(() => {
+        const params = {skip: 0, limit: 25, where: whereFromUrl} 
+        restart(params)
+    }, [whereFromUrl]);
+
+    
+    return (
+        <PageBase>
+            <Collapsible 
+                className="form-control btn btn-outline-primary"
+                buttonLabelCollapsed="Zobrazit filtr"
+                buttonLabelExpanded="Skrýt filtr"
+            >
+                <Filter>
+                    <FilterButton 
+                        className="form-control btn btn-outline-success"
+                        paramName={filterParameterName}
+                    >
+                        Filtrovat
+                    </FilterButton>
+                    <ResetFilterButton 
+                        className="form-control btn btn-warning"
+                        paramName={filterParameterName}
+                    >
+                        Vymazat filtr
+                    </ResetFilterButton>
+                </Filter>
+            </Collapsible>
+
+            <Table data={items} />
+
+            <AsyncStateIndicator error={error}  loading={loading} text="Nahrávám další..." />
+
+            {hasMore && <div ref={sentinelRef} style={{ height: 80, backgroundColor: "lightgray" }} />}
+            {hasMore && <button className="btn btn-success form-control" onClick={() => loadMore()}>Více</button>}
+        </PageBase>
+    )
+}
+

package/src/GroupGQLModel/Pages/RouterSegment.jsx

@@ -0,0 +1,85 @@
+import { PageVector } from "./PageVector"
+import { PageUpdateItem } from "./PageUpdateItem"
+import { PageCreateItem } from "./PageCreateItem"
+import { PageReadItem } from "./PageReadItem"
+import { PageDeleteItem } from "./PageDeleteItem"
+
+import { MembershipsURI, PageReadItemMemberships, PageReadItemRoles, PageReadItemRolesOn, PageReadItemSubgroups, RolesOnURI, RolesURI, SubgroupsURI } from './PageReadItemEx'
+import { CreateURI, DeleteItemURI, DeleteURI, ListURI, ReadItemURI, UpdateItemURI, UpdateURI } from "../Components"
+
+/**
+ * Definice segmentů rout pro Template stránky.
+ *
+ * Každý objekt v tomto poli popisuje jednu trasu (route) v aplikaci:
+ *  - `path`: Stringová URL s parametrem `:id`, která identifikuje konkrétní instanci template entity.
+ *  - `element`: React komponenta, která se má renderovat při shodě s cestou.
+ *
+ * Pokud komponenta stránky podporuje children jako render funkci,
+ * všechny children předané přes router budou dostávat objekt:
+ *   - `template` — načtená entita podle `:id`
+ *   - `onChange` — callback pro změnu hodnoty pole
+ *   - `onBlur` — callback pro blur event (například při opuštění pole)
+ *
+ * @constant
+ * @type {Array<{ path: string, element: JSX.Element }>}
+ *
+ * @example
+ * // Tato route reaguje na URL jako "/template/123"
+ * {
+ *   path: "/template/:id",
+ *   element: <TemplatePage />
+ * }
+ *
+ * // Editační route: "/template/edit/123"
+ * {
+ *   path: "/template/edit/:id",
+ *   element: <TemplateEditPage />
+ * }
+ */
+export const GroupRouterSegments = [
+    {
+        path: CreateURI,
+        element: (<PageCreateItem />),
+    },
+    {
+        path: ListURI,
+        element: (<PageVector />),
+    },
+    {
+        path: ReadItemURI,
+        element: (<PageReadItem />),
+    },
+    {
+        path: UpdateItemURI,
+        element: (<PageUpdateItem />),
+    },   
+    {
+        path: DeleteItemURI,
+        element: (<PageDeleteItem />),
+    },   
+    {
+        path: RolesOnURI,
+        element: (<PageReadItemRolesOn />)
+    },
+    {
+        path: RolesURI,
+        element: (<PageReadItemRoles />)
+    },
+    {
+        path: SubgroupsURI,
+        element: (<PageReadItemSubgroups />)
+    },
+    {
+        path: MembershipsURI,
+        element: (<PageReadItemMemberships />)
+    },
+    {
+        path: ListURI.replace("list", ":any"),
+        element: (<PageVector />),
+    },
+    {
+        path: ReadItemURI.replace("view", ":any"),
+        element: (<PageReadItem />),
+    },
+
+]

package/src/GroupGQLModel/Pages/index.js

@@ -0,0 +1,2 @@
+export * from './RouterSegment'
+export * from './PageNavbar'

package/src/GroupGQLModel/Queries/DeleteAsyncAction.jsx

@@ -0,0 +1,22 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared";
+import { LargeFragment } from "./Fragments";
+import { createAsyncGraphQLAction2 } from "../../../../dynamic/src/Core/createAsyncGraphQLAction2";
+
+const DeleteMutationStr = `
+mutation DeleteMutation($id: UUID!, $lastchange: DateTime!) {
+  result: groupDelete(
+    item : {id: $id, lastchange: $lastchange}
+  ) {
+    ... on GroupGQLModelDeleteError {
+      failed
+      msg
+      input
+      Entity {
+        ...Large
+      }
+    }
+  }
+}
+`
+const DeleteMutation = createQueryStrLazy(`${DeleteMutationStr}`, LargeFragment)
+export const DeleteAsyncAction = createAsyncGraphQLAction2(DeleteMutation)

package/src/GroupGQLModel/Queries/Fragments.jsx

@@ -0,0 +1,129 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared"
+
+const LinkFragmentStr = `
+fragment Link on GroupGQLModel {
+  __typename
+  id
+  lastchange
+name
+nameEn
+email
+abbreviation
+startdate
+enddate
+grouptypeId
+  grouptype {
+    __typename
+    id
+    name
+    }
+
+mastergroupId
+mastergroup { __typename id name }
+}
+
+`
+
+const MediumFragmentStr = `
+fragment Medium on GroupGQLModel {
+  ...Link
+  rbacobject {
+    ...RBRoles
+  }
+    changedby {
+    __typename
+    id
+    fullname
+    }    
+    mastergroup {
+        ...Link
+    }
+    mastergroups {
+        ...Link
+    }
+}
+`
+
+const LargeFragmentStr = `
+fragment Large on GroupGQLModel {
+  ...Medium
+  subgroups {
+    __typename
+    id
+    name
+    grouptype {
+      __typename
+      id
+      name
+    }
+  }
+  rolesOn {
+    ...Role
+  }
+  roles {
+    ...Role
+  }
+}
+`
+
+const RoleFragmentStr = `
+fragment Role on RoleGQLModel {
+    __typename
+    id
+    lastchange
+    created
+    createdbyId
+    changedbyId
+    rbacobjectId
+    createdby { id __typename fullname }
+    changedby { id __typename fullname }
+    rbacobject { id __typename }
+    valid
+    deputy
+    startdate
+    enddate
+    roletypeId
+    userId
+    groupId
+    roletype { __typename id name }
+    user { __typename id fullname }
+    group { __typename id name }
+  }
+`
+
+const RBACFragmentStr = `
+fragment RBRoles on RBACObjectGQLModel {
+  __typename
+  id
+  currentUserRoles {
+    __typename
+    id
+    lastchange
+    valid
+    startdate
+    enddate
+    roletype {
+      __typename
+      id
+      name
+    }
+    group {
+      __typename
+      id
+      name
+      grouptype {
+        __typename
+        id
+        name
+      }
+    }
+  }
+}`
+
+export const RoleFragment = createQueryStrLazy(`${RoleFragmentStr}`)
+export const RBACFragment = createQueryStrLazy(`${RBACFragmentStr}`)
+
+export const LinkFragment = createQueryStrLazy(`${LinkFragmentStr}`)
+export const MediumFragment = createQueryStrLazy(`${MediumFragmentStr}`, LinkFragment, RBACFragment)
+export const LargeFragment = createQueryStrLazy(`${LargeFragmentStr}`, MediumFragment, RoleFragment)
+