Files
mmd-pdf/docs/mmd-pdf/SCREENS.md
T
kua-agentandClaude Opus 5 e02d219736 docs: product documentation, design working files, and the failed design review
Adds the required doc set under docs/mmd-pdf/ - PRD, feature backlog with
status and sign-off per feature, screens with wireframes, test cases with the
test data and the agent-tasking prompts, and the sign-off log.

The sign-off log records the independent design review of 2026-08-27:
DESIGN-FAIL, three blockers and five major findings, which is why every design
feature in the backlog is blocked and the logo/token branch is unmerged.

Design working files live in docs/mmd-pdf/design/ so the next agent can
regenerate and re-render them. redplate.css there is the MMD shell design
system lifted verbatim from the session that owns it - do not edit it.

Also carries the session handover.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-27 13:25:29 +02:00

5.4 KiB
Raw Blame History

MMD PDF — screens

Every screen is 800×600. Budget: 28px title bar + 2023px status bar leaves about 550px for the toolbar and the page.

Design source files: design/*.dc.html, generated by design/build.py on the red-plate stylesheet design/redplate.css (lifted verbatim from the MMD shell design system, not retyped). Renders: design/shots/*.png.

These are mockups. The design failed independent review on 2026-08-27 and is not approved. Do not build from them yet.


Directions — the toolbar decision

Not a screen; a comparison sheet. A PDF editor carries about thirty tools and thirty named tools need roughly 1400px of row. Three ways out:

+------------------------------------------------------------------+
| A - one row, named tools                                         |
| [Open][Save][Print][Scan][OCR] | [Select][Text][Mark]...  [Fit][…]|
| 40px chrome · 512px page · 16 of 30 tools behind the "…"          |
+------------------------------------------------------------------+
| B - icons only, nothing hidden                                    |
| [][][][][][][][][][][][][][][][][][][][][]          [Fit -  +]    |
| 30px chrome · 522px page · nothing hidden, everything unlabelled  |
+------------------------------------------------------------------+
| C - three tabs, named tools, nothing hidden                       |
| DOCUMENT | EDIT | PAGES                                           |
| [Select][Text][Mark][Draw][Shape][Sign][Stamp][Image]  [Fit -  +] |
| 56px chrome · 496px page · nothing hidden, one click deeper       |
+------------------------------------------------------------------+

Independent reviewer's recommendation: C. A is the one drawn on every other screen and it hides sixteen tools behind an unlabelled "…" button; B asks a first-time clerk to guess thirty glyphs.


Main — a document open

+------------------------------------------------------------------+
| [MMD] MMD PDF / BON-2026-0847 delivery note.pdf        - [] X     |  28px
+------------------------------------------------------------------+
| [Open][Save][Print][Scan][OCR] | [Select][Text][Mark][Draw]       |  40px
| [Shape][Sign] | [Pages][Search][Undo]        [FIT WIDTH - +] […]  |
+---+--------------------------------------------------------------+
| > |                                                              |
| 1 |          +--------------------------------------+            |
|   |          |  MMD STEEL GROUP - DELIVERY NOTE     |            |
|   |          |                                      |            |
|   |          |  Supplier: Fabrimetal SARL           |            |
|   |          |  Reference: BON-2026-0847            |            |
|   |          |  Quantity delivered: 12 tonnes       |            |
|   |          +--------------------------------------+            |
+---+--------------------------------------------------------------+
| Ready                             1 OF 1 · FIT WIDTH · 100%       |  23px
+------------------------------------------------------------------+
  • Title bar — official MMD lockup at 13px, then the application name in Fraunces, then the file name. Window controls right.
  • Tool strip — grouped: document actions, then editing tools, then navigation. The armed tool is a solid red fill with white glyph; that is the only red on the screen.
  • Closed page strip (2426px) — a chevron to open the page list and the page you are on. It reclaims 62px over the open rail, which matters at 800px.
  • Page — white on the F3F3F0 field, hairline border, no shadow.
  • Status bar — what the application is doing, left; where you are, right.

EditText — changing a figure on the page

Same as Main plus a context bar (28px) that exists only while the Text tool is armed: colour swatches, size, bold/italic, and the sentence "Enter keeps it · Esc throws it away" — both were guessed wrong in testing.

The edited run is boxed in red on a red wash. The status bar turns red and says "The old quantity is removed from the file when you save." That is the moment the original is destroyed and it must be unmissable.

PageRail — the page list open

The 88px rail replaces the closed strip: PAGES / MARKS headers, then one thumbnail per page. The page you are on carries a 3px red left edge.

Nothing — no document open

The editing tools are dimmed to the label tone. The work area becomes a dense table of recent documents: reference, document, pages, state. Row click opens. Two actions in the section header: Open a file… outlined, Scan a document the one red fill.

Save — writing over the original

The application stays visible and dimmed behind. The dialog is white, ink-ruled title, and says in plain words what changes:

  Save
  Write the change into BON-2026-0847 delivery note.pdf?
  WAS            Quantity delivered: 12 tonnes
  BECOMES        Quantity delivered: 19 tonnes
  THE OLD TEXT   is taken out of the file, not covered over
                        [ Cancel ] [ Keep both ] [ Replace ]

Replace is the one red fill — the destructive action is correctly primary because it is what the person came to do. Open finding: "Keep both" does not yet say what filename it produces.

Scan — pulling pages off a copier

Not built. Same dialog shape: copier, feed, colour, detail, and text-search on by default in French and English. Scan is the one red fill.