USER GUIDE · PILOT
From document to approved German.
Follow the translation, review and knowledge workflows. Human approval controls what is delivered and what the next document can reuse.
Process only documents you are authorised to use in this pilot. Workspaces are separate by browser, and reviewer roles are demonstrations. The responsibilities below describe a team process; they are not enforced account permissions.
- 1Upload & extract
- 2Confirm source
- 3Prepare German
- 4Approve passages
- 5Approve document
Approved passages selected for reuse → Knowledge → Future matching documents
Intake operator
Upload and extract
Start with a clear original and the right curriculum context.
- Open New document and choose a PDF or DOCX. Use PDFs up to 25 MB and 30 pages, and Word files up to 3 MB. Convert older .doc files first.
- Select Turkish, Farsi, Russian, Arabic or English as the source language. German is always the target.
- Enter the university, programme and curriculum year consistently. These are entered manually and determine which approved knowledge applies.
- If the workspace owner has set a private pilot access code, enter it; access is then remembered on this browser for 30 days. Without a code, processing starts directly. Confirm that you are authorised to process the document, then click Extract source text. Keep the page open while processing.
Use PDF for scans, stamps, embedded images and page references. DOCX extraction includes text only. Keep the original file separately: Berlin saves extracted text, not the original file bytes.
Ready when: Extracted passages ready for source review.
Source-language reviewer
Check the source
First approval gate: confirm that the extracted text represents the original.
- Compare every passage with the original. Check names, numbers, units, table relationships, footnotes and missing sections.
- Correct extraction errors and click Save source correction for each changed passage.
- Select the checkbox confirming that you checked the entire source, then click Confirm extracted source. Any later source edit requires confirmation again.
The original PDF preview is temporary and disappears on reload. Open your saved original alongside the app when needed. If a whole passage is missing, use a clearer or shorter input and repeat intake; the pilot has no add/split/merge passage controls. Source text is locked after translation.
Ready when: A human-confirmed source, ready for German translation.
Berlin + GPT-6 Astra
Prepare the German draft
Approved wording is searched before new translation is generated.
- Click Prepare German translation after the source has been confirmed.
- Berlin reuses an active approved translation when the source passage, language pair, university, programme and year match exactly and the entry passes the applicable checks.
- GPT-6 Astra drafts the remaining passages using approved terminology, wording guidance and examples from the same context.
- Inspect the origin shown for each passage: approved memory or a new AI draft. Both require expert review for this document.
Different hours, a different curriculum year or even a differently written university name can prevent an exact match. Similarity matching and automatic university/year recognition are not part of this pilot.
Ready when: A German draft with a visible origin for each passage.
Expert translator
Correct and approve passages
Second approval gate: take responsibility for each German passage.
- In Review, compare the source and German side by side. Correct meaning, terminology, wording, numbers and omissions.
- Resolve the terminology and number warnings where they are real, then choose a Correction category; a false warning can be overridden by ticking the acknowledgement below the check list, and the override is recorded with the approval. Automatic checks help you inspect the text; they do not prove it is correct.
- Select Save this passage for reuse only when the approved wording should be available to future matching documents.
- Use Save draft to pause without approving. Use Approve & next or Approve passage when the passage is ready. Cmd/Ctrl + Enter also approves a passage.
With reuse selected, passage approval publishes the source/German pair to memory immediately, before whole-document approval. Saving a draft or choosing a correction category does not publish knowledge or create a general rule.
Ready when: An approved passage; reusable knowledge only when selected.
Final reviewer
Approve the document and export
Third approval gate: check the translation as a complete document.
- Approve every passage, resolve all remaining checks and save outstanding edits. The document will be Ready to approve.
- Review completeness, sequence and consistency against the original, then click Approve document.
- Inspect the approved preview and choose Download sample text to save the German translation as a TXT file.
Output is labelled as a synthetic sample. Formatted Word/PDF export, certification and client delivery are not implemented. Try next document creates another prepared Turkish sample; use New document to upload a new file.
Ready when: An approved sample translation with a plain-text download.
Lead translator
Maintain approved knowledge
Translations, terminology and wording have different purposes.
- Translations contains approved source/German passage pairs for exact reuse. Terminology holds preferred term equivalents. Wording holds writing conventions.
- Open a document with the intended language and context, then choose Knowledge → Propose a rule. Select Terminology or Preferred wording and enter the rule.
- Choose whether the rule applies to the current curriculum or all documents in the language pair. Click Save proposal, review it, then click Approve rule. Proposed rules are inactive.
- After approving terminology, inspect affected documents and memory. Incompatible approved passages may be reopened and memory may be marked Needs review.
The learning loop uses approved memory and guidance; it does not retrain model weights. Wording rules guide the model and reviewer, but are not comprehensively enforced. Conflicting duplicate term replacements require a comparison workflow that is not yet implemented.
Ready when: Approved knowledge that informs later work in this workspace.
Quality reviewer
Revise approvals and inspect history
Corrections remain traceable, and unsuitable wording can be stopped from spreading.
- Use Reopen for correction on an approved passage, edit it and approve it again. The complete document will also require a new approval.
- If old wording must stop being reused immediately, separately open Knowledge → Translations → Withdraw from future reuse. Enter a reason and choose Withdraw entry.
- Inspect Approval & version details and Activity for decisions, versions and available before/after text. A changed approved target for the same source/context creates a new memory version.
Reopening a passage does not automatically withdraw its previous memory entry. Withdrawal prevents future reuse; it does not rewrite existing documents. The pilot history uses a demonstration reviewer identity, not an authenticated employee signature.
Ready when: Reapproved work and a record of what changed.
Application owner
Manage access and interruptions
Know the boundaries before inviting colleagues to the pilot.
- The private pilot code is optional. When BERLIN_AI_ACCESS_CODE is set (at least 16 characters), enter it once per browser; access is remembered for 30 days, and changing the variable in Vercel and redeploying revokes all remembered access. When it is not set, AI processing is available to anyone who can open the site, so keep a spending limit on the provider key. Enter the code only in Berlin; the provider API key belongs in the server configuration, not in the app's pilot-code field.
- Use the same browser to return to saved work. Each browser has a separate cookie-bound workspace. Another device or colleague does not see your knowledge, and clearing the cookie opens a fresh workspace.
- After a timeout, reload and inspect saved state before retrying. Translation failure preserves saved source text. A job may have completed after the browser stopped waiting.
- Send the owner the document type, selected language, step and error message when processing fails. Keep credentials out of screenshots and messages.
This pilot has no authenticated team accounts, assignments or shared company knowledge base. It allows 20 documents, 50 rules and 500 recorded events per workspace, plus a daily AI processing limit per workspace (10 by default; set BERLIN_AI_DAILY_LIMIT between 1 and 1000). Extraction and translation are separate attempts; failed attempts count. This is not a company-wide spending cap.
Ready when: A supervised pilot with clear recovery steps.
TRY THE WORKFLOW
Two ways to practise
Review and reuse, without an AI request
Choose New document → Prepare sample document. Correct the preferred course wording and the deliberate practical-hours error from 20 to 30. Approve the passages with reuse selected, approve the document, then choose Try next document to see the corrected wording reused. The new document still needs review.
Extraction and translation with a synthetic scan
Download the one-page test PDF below. In New document, use English → German, Sample University, Medicine and 2012. Extract the source, compare it with the PDF, confirm it, then prepare and review the German translation.
Check these values throughout: 120 total hours, 80 lecture hours, 40 practical hours, 6 ECTS and a passing score of 60 out of 100. This is a practice fixture, not evidence that the live AI workflow has passed validation.
Download synthetic test PDF 1 page · EnglishWHEN SOMETHING NEEDS ATTENTION
Troubleshooting
Why is source confirmation disabled?
Save every edited source passage first, then select the checkbox confirming comparison with the original.
Why can’t I approve a passage or document?
A passage needs German text and resolved term/number checks. A document also needs every passage approved and all local edits saved. Report a false positive instead of changing the source meaning to silence a check.
What if extraction is incomplete?
Check the selected language and use a clearer or smaller file. The pilot rejects detected incomplete extraction rather than saving it as a partial document. Always compare an accepted extraction with the original too.
What does an OpenAI access or quota error mean?
The owner needs to check the API project, key permissions, model availability, billing or limits. The configured status confirms settings are present, not that a live request has succeeded or that its output is accurate.
Why is my colleague’s knowledge missing?
Workspaces are separate by browser in the current pilot. Authenticated shared workspaces are still to be built; sharing the pilot code does not share saved knowledge.
Can we import our historical translation archive?
Bulk import and alignment of historical originals with approved translations are not implemented. The current intake accepts a source document, not a validated archive pair. Only documents authorised for this pilot may be processed.