Bookstack Dev Notes

Single Type Limited Access UX Experiments
Bookstack has some predefined roles, but roles can be created such that they have read access limited to:
Books
Chapters
Pages
Interface for users with read permissions strictly limited to those types changes dynamically.
See: https://github.com/BookStackApp/BookStack/issues/1171#issuecomment-446378261
They do appear to all have access to the page set as the landing page.
Permissions Grid
Pages only interface
Pages only user:
has the Books menu item
can see the homepage
maybe can't edit homepage? (~LP)
can see other pages, (I don't believe there's a page that lists all pages ~LP)
Books only interface
Pages only user:
has the Books menu item
can see the homepage
can see/edit books (duh)
Chapters only interface
Chapters only user:
has the Books menu item
can see the homepage
can see/edit chapters (duh)

Misc Dev Notes
User name change error
Had an "unrecognized user name" error when I changed a test user name via admin panel and then tried to log in.
Logged in fine with email.
I'd changed my personal account name from the keycloak created hash without issue, so maybe issue is that the admin did it in this case? Or maybe I screwed it up, haven't tried to replicate.
ACL Strategy
Permissions can be overridden for specific Shelves/Books/Chapters/Pages, and they do inherit, but overrides are per defined role, so if many roles exist, there's a need for nearly redundant sets of overrides for each role.
1st SSO login issue
https://github.com/BookStackApp/BookStack/issues/4436#issuecomment-1684113880
Mobile Breadcrumbs
Mobile breadcrumbs are just icons, and kinda mushy. Might be nice to have Book name, even truncated with ... ~LP
Adding CSS or content based on page tags
Interesting tip that could be used during an import process, or also to add hero banners or something to specific tags.
https://excessivelyadequate.com/posts/booksthack.html#displaying-banners-or-making-other-style-changes-based-on-tags

Combo Books/Pages Permissions Testing
Testing users with a role that limits them to view/edit Books and Pages.
User has access to Books menu item
User had breadcrumbs for Book List/Book/Page

Wiki organization proposals
Possible wiki structure, including functioning as a general home page for WB.
Uses Books/Chapters/Pages
This was the first thing that came to mind, but seems like maybe Minutes and Proposals want to be books because they'll get big, and I'm not sure how the logical separation affects stuff like page link pickers, media pickers, etc.. ~LP
This diagram was made in the wiki, it can be double clicked to edit.