## 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.
137 lines
2.4 KiB
CSS
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;
|
|
}
|