Files
Stirling-PDF/frontend/editor/src/saas/components/shared/FileSidebarGroupControls.css
T
EthanHealy01andGitHub c64369e56c Classifier Policy (#6898)
## Overview

Adds **AI document classification** and a **classification-aware Files
sidebar**: uploaded documents are automatically tagged with
document-type labels (Invoice, Contract, Lab report, …), and the sidebar
groups files under editable parent categories so a large library stays
navigable.

> [!IMPORTANT]
> **This feature only runs in the SaaS build.** Classification depends
on the AI engine and team-scoped label storage, so it's gated to SaaS
end-to-end:
> - The sidebar grouping is a `saas/`-layer override of the
`fileSidebarGrouping` seam; every other build (OSS core, self-hosted
proprietary, desktop) gets the null stub and renders the **unchanged
flat, recency-sorted list** — no categories, no "Other", no picker.
> - The classify/labels backend endpoints are gated on
`policies.enabled` (on in SaaS) and live in `app/proprietary`, so
they're absent from pure OSS and dormant in self-hosted unless
explicitly enabled.
> - The Python classifier is reached only via that gated path.
>
> Shared-layer changes that do compile everywhere are inert without the
engine (dormant schema/field additions) or intentional (`GetInfoOnPDF`
surfacing custom metadata).

## What it does

- **Classifier (engine):** reads the first/last two pages of a PDF and
assigns document-type labels from an allowed vocabulary. Labels are
deliberately document-*type* descriptors — no deep-content/PII
detection, since only a page window is read.
- **Team label vocabulary:** ~270 built-in defaults across ~15 families,
seeded per team. Editable by team leaders/admins in the Classification
policy settings (import/export/reset). Team-scoped and shared;
**per-user personal labels are intentionally out of scope** — the
vocabulary is team-level only.
- **Sidebar categories:** files group under parent categories
(Financial, Legal, Medical, …), busiest-first, collapsible, with a
"Recent" group on top and an "Other" group for anything uncategorised.
The category structure (names, icons, membership, custom categories) is
**device-local and user-editable** via a "Customize" picker — the only
per-user personalization; it never changes the team's label vocabulary.
- Classification results are written to PDF metadata
(`StirlingPDFClassification`), read back to keep files in their groups
without re-parsing.

## Architecture

Spans all three layers, mirroring the existing policy/source subsystem
conventions:
- **`frontend/editor`** — sidebar grouping seam + SaaS override,
category manager, labels editor, icon palette, file grouping, tests,
`en-US` i18n.
- **`app/proprietary` + `app/common` + `app/core`** —
`ClassifyLabelController`, team-scoped `ClassificationLabelStore` (Jpa +
in-process impls, same shape as `PolicyStore`/`SourceStore`), metadata
read/write.
- **`engine`** — the document-classifier agent, contracts, routes,
tests.

## Screenshots

**Files sidebar — grouped by category (SaaS)**

### Loading view

<img width="2056" height="1046" alt="Screenshot 2026-07-07 at 5 12
56 PM"
src="https://github.com/user-attachments/assets/1d712da5-50ae-4349-b0cd-e62665c3ec0c"
/>

### Organized in the sidebar

<img width="2056" height="1045" alt="Screenshot 2026-07-07 at 5 14
05 PM"
src="https://github.com/user-attachments/assets/3ea4fe21-da51-4cea-bc3a-18ce040d3d05"
/>

**Customize categories picker**
### Personal settings to change how labels are grouped in an individual
users editor

<img width="2056" height="1044" alt="Screenshot 2026-07-07 at 5 52
42 PM"
src="https://github.com/user-attachments/assets/40be03ce-0f63-4d1e-b58b-cec045d01cb2"
/>

**Classification labels editor (team settings)**

<img width="2056" height="1042" alt="Screenshot 2026-07-07 at 5 53
00 PM"
src="https://github.com/user-attachments/assets/337b0739-15c9-4749-9c6b-22e3b20825b8"
/>

## Testing

- Frontend `task frontend:check` — green (editor + portal tests,
typecheck across all flavors, lint, label-drift guard).
- Backend `task backend:check` (proprietary) and `:saas:test` — green.
- Engine `task engine:check` — green.
2026-07-09 11:47:37 +00:00

137 lines
2.4 KiB
CSS

/* Category-manager modal: editable parent categories with member-label chips.
Matches the labels editor's width so the two read as a set. */
.fsg-modal {
width: min(1100px, 94vw);
max-width: min(1100px, 94vw);
}
.fsg-body {
display: flex;
flex-direction: column;
gap: 12px;
max-height: 60vh;
overflow-y: auto;
padding-right: 4px;
}
.fsg-cat {
display: flex;
flex-direction: column;
gap: 6px;
}
.fsg-cat-header {
display: flex;
align-items: center;
gap: 6px;
font-size: 13px;
font-weight: 600;
color: var(--text-primary, inherit);
}
.fsg-cat-toggle {
display: inline-flex;
border: none;
background: transparent;
padding: 0;
cursor: pointer;
}
.fsg-chevron {
font-size: 1.1rem !important;
color: var(--text-muted, rgba(128, 128, 128, 0.9));
margin-left: -4px;
}
.fsg-cat-name {
flex: 1;
text-align: left;
border: none;
background: transparent;
padding: 2px 4px;
border-radius: 4px;
font: inherit;
color: inherit;
cursor: text;
}
.fsg-cat-name:hover {
background: var(--hover-bg, rgba(128, 128, 128, 0.12));
}
.fsg-rename {
flex: 1;
}
.fsg-cat-action {
display: inline-flex;
border: none;
background: transparent;
padding: 2px;
border-radius: 4px;
cursor: pointer;
color: var(--text-muted, rgba(128, 128, 128, 0.9));
}
.fsg-cat-action:hover {
background: var(--hover-bg, rgba(128, 128, 128, 0.12));
color: var(--text-primary, inherit);
}
.fsg-cat-body {
display: flex;
flex-direction: column;
gap: 6px;
/* Indent past the chevron so the hierarchy reads at a glance. */
padding-left: 24px;
}
/* Member chips are the shared @app/ui/LabelChip. */
.fsg-chips {
display: flex;
flex-wrap: wrap;
gap: 4px;
}
.fsg-count {
font-size: 11px;
font-weight: 500;
color: var(--text-muted, rgba(128, 128, 128, 0.9));
}
.fsg-add,
.fsg-new {
display: flex;
align-items: center;
gap: 6px;
}
.fsg-new {
padding-top: 4px;
border-top: 1px solid var(--border-subtle, rgba(128, 128, 128, 0.2));
}
.fsg-add-input {
flex: 1;
min-width: 0;
padding: 4px 8px;
font-size: 12px;
border: 1px solid var(--border-subtle, rgba(128, 128, 128, 0.35));
border-radius: 6px;
background: transparent;
color: var(--text-primary, inherit);
}
.fsg-add-input:focus {
outline: none;
border-color: var(--color-primary, #4f46e5);
}
.fsg-footer {
display: flex;
justify-content: space-between;
align-items: center;
width: 100%;
gap: 8px;
}