Wiki Migration — Placement Map for the Old Azure DevOps Wiki
🤖 Generated with Claude Code
⚠️ Not yet reviewed
Co-Authored-By: Claude (noreply@anthropic.com)
Status: Draft Author: Martin Riemann Date: 2026-08-25 Stakeholders: Development, Operations, Customer Service, Security
The old wiki (tis-cca.wiki) is the historical home of TOGETHER platform knowledge. It is to
be folded into this repository, which now has an explicit placement rule set
(DOCUMENTATION-GUIDELINES.md, sections 1 to 5) and four published roots.
This document maps every page of the old wiki to a proposed destination and rates how much it is actually worth. The wiki grew over roughly seven years, and a good part of it is stale, unfinished, duplicated, or was never more than a note to self. Moving it wholesale would import that problem rather than solve it — so placement and value are decided together.
A destination is either a path in this repository, or another repository where Rule 1 sends it.
Scan Basis
The scan is based on a local working copy of the tis-cca.wiki repository.
| Markdown pages with content | 229 (646 KB) |
| Empty placeholder pages | 39 |
| Attachments | 153 PNG, 21 JPG, 9 GIF, 5 SVG, 6 XML, 6 D2, 4 PS1, 4 XLSX, 3 PDF, 2 VSDX, 1 DOCX, 1 JSON, 1 HTML (~57 MB) |
| Top-level sections | 27 |
1. Condition of the Source
How Value Is Rated
| Grade | Meaning |
|---|---|
| A | Accurate, substantial, and no better source exists. Move it, edit lightly. |
| B | Real content, but stale, incomplete, or needing verification against code before anyone should trust it. |
| C | Thin, but records a fact still needed — a link, an ID, a register, a one-line invariant. Usually folds into a larger page rather than becoming one. |
| D | Superseded or finished. The value is historical: why a decision was made, or what a legacy system did. |
| E | No value. Stub, duplicate, badge page, trial page, or a heading with nothing underneath it. |
The grade is about the content, not about how important the topic is. A vital subject documented in three placeholder bullets still grades E — the topic then needs writing, not migrating.
Distribution
Approximate, since several pages sit on a boundary:
| Grade | Pages | Share |
|---|---|---|
| A | ~30 | 13% |
| B | ~65 | 28% |
| C | ~70 | 31% |
| D | ~40 | 17% |
| E | ~24 | 11% |
Plus the 39 empty pages, which are not counted above.
The practical reading: roughly 40% of the wiki (A and B) carries knowledge that would be expensive to reconstruct. Another 30% (C) is worth a sentence inside somebody else's page. The remaining 30% (D and E, plus the empty pages) is archive or delete.
What Is Systematically Wrong
These patterns cut across sections and matter more than any individual page.
Pages That Contradict Each Other
| Subject | The disagreement |
|---|---|
| OMDS3 endpoint paths | OMDS3/TOGETHER-hosted-Endpoints.md says omds3services/tis/bestand and omds3services/vig/sachprivat; the attachment copy says omds3services/bestand/tis and omds3services/vigo/sp. Same author, two drafts, no note of which won |
| Elasticsearch index naming | together.userrights.gf in Volltextsuche-Aufbau.md and Berechtigungsfilter.md; together.gf.userrights in Berechtigungen.md. Kibana-Queries.md uses both, on the same page |
| Elasticsearch field naming | Templates/Geschäftsfälle.md (dated 27.08.2019) shows PascalCase GfNr and MaklerBerechtigung in its examples while its own mapping above uses camelCase. The live queries in Volltextsuche-Aufbau.md are camelCase |
| WildFly version | The install runbook targets wildfly-14.0.1.Final; the admin page works against Wildfly18/wildfly-18.0.0.Final |
| Elasticsearch host | Elasticsearch-und-Kibana-Installation.md sets network.host to one address, then states a different one is "the TISAPP001 address", and configures Kibana against the second |
None of these is resolvable from the wiki alone. Each needs a check against running configuration before the page can be published as fact.
Stale Against Facts This Repository Already Records
VUDEV was decommissioned in August 2026 and this repository documents that
(infrastructure/environments/vudev-decommissioning.md). Three wiki pages still present it as
a live environment: Betrieb/RDP-Testumgebungen.md (a whole column),
Wildfly: Infos und Tipps/Wildfly-Infos.md ("aktuell installiert auf … vudev"), and
TOGETHER - Hosting…/Azure-Key-Vault-Zugriff…md (vudev-apps, Vudev-Applications).
Similarly, IdentityServer/Together-Identity-Authentication.md frames everything around
IdentityServer 4, while Duende-6-Migration.md in the same folder records the migration to
Duende 6 executed in December 2023.
Pages That Stop Mid-Thought
Nine pages end without finishing:
| Page | How it ends |
|---|---|
Volltextsuche/Berechtigungen/Swiss-Life-AWD-User.md | mid-sentence, "…wird mit" |
Testing/UNIQA-Easy-Option-Plus…md | a heading, "Hinweis zur Suche von Interessenten:", then nothing |
Testing/Testfall-Schadenmeldung…md | "[Weitere Schritte folgen]" three times |
Wissenswertes/TOGETHER-Endpoints-Check-List.md | two empty headings and "bitte die Liste … ergänzen" |
Volltextsuche/Gf-Collector.md | a title and an empty "Endpoints" heading |
Volltextsuche/Administration/GF-Updates.md | an empty "Vollimport" heading |
OMDS3/OMDS-3-KFZ-VIG-Request-Forwarding - Konzept.md | "TODO: Ist stand dokumentieren!", never filled |
TIS-Applikationen/OMDSManager.md | "Beschreibung folgt …" |
TIS-Applikationen/OVB-Selfservice.md | an ellipsis |
Generated but Never Reviewed
Five pages under TIS-Applikationen/OMDSX2024-Upload/Analysen-von-OMDSXUploadService.java/
state outright that they were produced by ChatGPT from source and stored-procedure analysis.
Two more in the same folder read the same way without saying so.
TIS-Applikationen/ÖAMTC-Unfall-Tarifrechner/Übersicht-Frontend.md describes an Angular
application in terms that would fit any Angular application.
Across the whole wiki, exactly one page carries a review marker — OMDS3.md, with
✅ Reviewed by author. About six carry an attribution line of any kind. Under
DOCUMENTATION-GUIDELINES.md section 9, unreviewed generated content does not count as
verified, so all of this needs a human pass before it can be published as fact.
The Same Content in Two or Three Places
| Duplicate | Copies |
|---|---|
The COMMON.dbo.UserLogins DELETE statement | 3 pages, byte-for-byte |
The error-handling thought notes in .attachments | 2 files, byte-for-byte |
| OMDS3 endpoint inventory | OMDS3/TOGETHER-hosted-Endpoints.md, the older attachment copy, and partly Wissenswertes/TOGETHER-Endpoints-Check-List.md |
| Vermittlernummer format rules | TIS-Applikationen/TIS-Anmeldung.md, stated to be copied out of Vermittlerweb2 and Benutzeranmeldung configuration — so the config is the real source |
Target State Written in the Present Tense
Several pages describe what was planned as though it exists.
OMDS3/TOGETHER-hosted-Endpoints.md interleaves an "Ausgangssituation" with a "Vorschlag" and
effort estimates, one marked "(Done)". Projekte/VIG - AVAG…/CATCH-Integration-Guide.md opens
by saying it describes the target architecture and that no complete version exists on Fachtest
— and it is dated January 2025, while the project's own meeting minutes run to March 2026.
A reader who takes either page as current will be wrong.
Screenshot-Only Pages
MaklerAdmin-2025/Anforderungen… (7 images), TIS-Applikationen/Adressänderung.md (10),
Testing/EOP-Geschäftsfall erzeugen… (10), Testing/Testfall-Schadenmeldung… (9) and
ÖAMTC-Unfall-Tarifrechner/Übersicht-Gesamt.md (2, and nothing else) carry their content
inside images of user interfaces that have since changed. Migrating them means migrating 188
image files whose accuracy nobody can currently assert.
2. Placement Map
Identity and SSO
products/shared/identity/ currently states that in-depth documentation is pending. These
pages fill it.
| Wiki page | Value | Destination and note |
|---|---|---|
IdentityServer/Together-Identity-Authentication.md | B | products/shared/identity/authentication.md — the best overview of the auth methods, but framed around IdentityServer 4; re-check against Duende 6 |
IdentityServer/…/Mitarbeiter-Login-auf-TOGETHER-(Azure-AD-OIDC).md | B | products/shared/identity/employee-login.md — thorough, with real code; the "was funktioniert noch nicht" and "nächste Schritte" sections are from the build period |
Together-Benutzer/SSO-login-Together - Informationssammlung.md | A | products/shared/identity/sso-partners.md — living register, entries dated into January 2026, no other source |
IdentityServer/TokenExchangeGrant.md | B | tis.identity repo (Rule 1) — good reference with three "TODO: describe handling" gaps |
IdentityServer/Duende-6-Migration.md | D | tis.identity repo — the migration ran in December 2023; historical |
IdentityServer/SAML2-Zertifikate-hinzufügen-(VIG).md | C | tis.identity repo — a script that still runs |
IdentityServer/Signing-Zertifikat-aktualisieren.md | B | Section 3 — a recurring annual task, still valid; depends on a Confluence link |
IdentityServer/Passkey-Login.md plus 3 sub-pages | B | proposals/passkey-login/ — clear design intent; whether any of it shipped is not recorded |
Trustcenter/Trustcenter - exportierbares-Zertifikat.md | A | Section 3 — a model debugging write-up: symptom, code trace, root cause, one-line fix |
OMDS3
| Wiki page | Value | Destination and note |
|---|---|---|
OMDS3.md | A | products/together/omds3/README.md — the only reviewed page in the wiki |
OMDS3/TOGETHER-hosted-Endpoints.md | B | products/together/omds3/endpoints.md — authoritative inventory, but written as a migration proposal; separate current state from plan |
OMDS3/Dokumentation-and-Endpoint-Location.md | C | merge into endpoints.md — the WSDL and Swagger URLs are the real content |
OMDS3/OMDS3-FAQs.md | C | merge — two lines |
OMDS3/OMDS3 - Deeplink: User Delegation…md | A | products/together/omds3/user-delegation.md — declares itself the governing spec, has a D2 source, recent |
OMDS3/OMDS3-qualifiedDeepLinkOffer…(POC).md | B | products/together/omds3/qualified-deeplink.md — says its payload structure will change |
VIG…/OMDS3-DeepLinkOffer: Bearbeiten eines GF…md | C | merge into the deeplink page — one sequence diagram |
OMDS3/OMDS-3-Onboarding.md plus 23 client pages | C/D | products/together/omds3/onboarding/ — the newest entry is April 2023; several list contacts as "?" and rollout as "noch offen". Value is now historical plus a handful of live clients. See Section 4 |
OMDS3/Übersicht-PROD-Tokens.md | B | Section 4 — May 2025, the operationally current artifact of that set. Do not publish |
OMDS3/VigoNG-Schema-Changes.md (47 KB) | B | tis-cca.omds3 repo (Rule 1) — a real changelog whose newest entry is June 2022 |
OMDS3/OMDS3-Schemas-(Sachprivat).md | D | tis-cca.omds3 repo — a schema critique sent to a third party; outcome unrecorded |
OMDS3/Omds3-Delegation-Proposal-with-SAML-2.0.md | D | proposals/ — options 2 and 3 were weighed, 3 was built. Keep as the record of why |
OMDS3/OMDS-3-KFZ-VIG-Request-Forwarding - Konzept.md | D | proposals/ — never finished; the "document the current state" TODO is still open |
OMDS3/OMDS3-Engine-Berechtigung-Benutzerverwaltung.md | C | Section 3 — two sentences and a screenshot |
OMDS3/ÖBV-Benutzer-Consent-vergeben.md | B | Section 3 — a well-built runbook that escalates from one user to 453 |
.attachments/OMDS3-Services-Endpoint-und-Resources-*.md | E | drop — older draft that contradicts the page that replaced it |
Partner Integrations
Proposed home: products/together/partner-integrations/.
| Wiki page | Value | Destination and note |
|---|---|---|
UNIQA/Account-Linking.md | B | …/uniqa/account-linking.md — explains clearly why full accounts became necessary; the TODO list is build-era |
UNIQA/Geschäftsfallsynchronisation UNIQA-EOP nach TOGETHER.md | A | …/uniqa/gf-synchronisation.md — compact, specific, no filler |
ARAG/Linked-Account.md | C | …/arag/ — dated June 2025; short, and most of it is the credential that must go |
Allianz/Allianz-Integration-Debugging-14.10.2024.md | D | …/allianz/ or drop — one incident from October 2024, and the evidence is customer JWTs |
Allianz/Allianz-Integration-2.0.md | E | drop — one sentence |
OMDS3/VIG-Authentication/VIG-Authentication.md | A | …/vig/authentication.md — traces the SAML2-to-VIG token exchange end to end with real requests |
OMDS3/Vereinbarungen-zu-OMDS3-VIGONG - Protokolle.md | B | …/vig/ — records what was agreed not to implement, which is durable |
OMDS3/Abzuklärende-Fragen Faktor10, Twinformatics, VIG.md | D | …/vig/ — Q&A from August 2020 with the answers embedded |
VIG…/Kooperative-Antragsbearbeitung/Integration.md | B | …/vig/cooperative-processing.md — real API spec and error contract |
VIG…/Kooperative-Antragsbearbeitung.md | D | proposals/ — three meeting rounds, explicitly never commissioned |
Projekte/VIG - AVAG…/ index, CATCH-Integration-Guide, diagrams plus 6 D2 sources | A | …/vig/avag/ — the best-maintained corner of the wiki. Caveat: the guide is dated January 2025 and describes target state, while project minutes run to March 2026 |
Projekte/VIG - AVAG…/AVAG-Developer-Guide.md | A | tis.identity repo (Rule 1) — checklists, config paths, ADR links, test scripts |
Projekte/VIG - AVAG…/Projektspezifikation.md | C | …/vig/avag/ — effort estimates and phases; a project record, not documentation |
Projekte/VIG - AVAG…/SOURCES.md | C | merge into the README |
Projekte/VIG - AVAG…/_build/, _templates/ | C | compare with development/pdf/ — do not duplicate |
Projekte/VIG - AVAG…/_tools/Generate-Jwt.ps1 | B | tis.identity repo — already referenced from there |
Projekte/VIG - AVAG…/AVAG-Kontonummern.md, AVAG-Maklerliste…, 2 Userkonzept pages | C | not documentation — customer account data; SharePoint |
Together Services
| Wiki page | Value | Destination and note |
|---|---|---|
Wissenswertes/Geschäftsfälle/SMR5-Architektur.md | A | products/together/smr5/architecture.md — the best architecture text in the wiki; covers the send service, Hangfire retries, per-VU adapters and status flow |
TIS-Applikationen/Schadenmeldung-SMR5.md, Hinweise fürs Debuggen und Testen.md | C | products/together/smr5/ — attachment limits and two debugging hints |
ESIGN/CCA-Clients/Namirial/Status-Maschine-TOGETHERsign.md | B | products/together/togethersign/ — useful state machine; the PlantUML block has a typo in its terminator |
ESIGN/Sendhybrid.md | C | products/together/togethersign/ — a procurement-era scope note about signature pads |
TIS-Applikationen/TogetherSign.md | C | products/together/togethersign/ — upload size limits, practically useful |
ESIGN/Troubleshooting/ (3 pages) | B | products/together/togethersign/knowledge-base/ — real support answers with root causes |
ESIGN/CCA-Clients/Namirial.md | B | tis.gf.esign repo (Rule 1) — good API examples, built around tokens that must go |
ESIGN/Zurückgestellte-Signaturprozess.md | B | tis.gf.esign repo — real content, sloppy ending |
ESIGN.md | E | drop — build badges |
ESIGN/Testen.md | D | thin checklist using LaTeX footnote syntax |
SoaGFX/SOAGFX - Logik für Druckdokumente.md | A | products/together/soagfx/ — precise behavioural spec for SetGfState versus ModifyGf; nobody would re-derive this |
TIS-Applikationen/CADS/CADS: Links zu Doku, WSDL…md | C | products/together/cads/ — a link list, but those URLs are the published contract |
Wissenswertes/Plattform-Menü- bzw. CADS-Änderungsmenü.md | C | products/together/cads/ — four URLs and a credential hint; see Section 4 |
TIS-Applikationen/Adressänderung.md | C | products/together/geschaeftsfaelle/adressaenderung.md — ten screenshots, and the "new realisation" may never have been built |
TIS-Applikationen/GF-Abgleich.md | C | products/together/geschaeftsfaelle/ plus Section 3 — one screenshot of a scheduled task |
TIS-Applikationen/Stornoansuchen-R5-(GPSR5).md | C | products/together/geschaeftsfaelle/ — three lines, but all three are facts |
Wissenswertes/Geschäftsfälle/GF.md | C | products/together/geschaeftsfaelle/ — a single data invariant worth keeping |
Wissenswertes/Together-Sichtschnittstelle.md | A | products/together/volltextsuche/sichtschnittstelle.md — the URL contract CCA still depends on, with the old-to-new rewrite explained |
Wissenswertes/TOGETHER-Endpoints-Check-List.md | B | products/together/endpoints.md — valuable inventory, visibly unfinished |
Wissenswertes/Wichtige-MaklerIDs.md | A | products/together/reference/maklerids.md — durable reference data that decays slowly |
TIS-Applikationen/Auto-Ole.md | D | products/together/auto-ole.md — HTML-styled project listing with two entries marked "?", and the target repository is empty |
TIS-Applikationen/OVB-Selfservice.md | E | drop — four lines ending in an ellipsis |
TIS-Applikationen/Applikationsübersicht.md | C | merge into products/platform-usage-overview.md — the linked spreadsheet is the real artifact |
Notifications.md | C | products/shared/notifications/ — a backlog fragment, not documentation |
Projekte/NIS2-Compliance/Softwarelandschaft.md (22 KB) | A | products/software-landscape.md — structured and attributed; overlaps platform-usage-overview.md, which measures the same platform quantitatively |
Projekte/NIS2-Compliance.md | C | index page, folds into the above |
BoaBot
products/boabot/ is currently a placeholder.
| Wiki page | Value | Destination and note |
|---|---|---|
BOAbot.md | E | one sentence; the new products/boabot/README.md should be written, not migrated |
BOAbot/Callbacks-und-Geschäftsfälle.md | C | products/boabot/ — thinking aloud, but it captures who needs business-case data and why |
BOAbot/BoaAPI.md | B | proposals/boa-api.md — thorough scoping with estimates and an open-questions table, May 2025 |
BOAbot/BoaAPI/Example-Requests.md | C | attach to the same proposal — a Postman export link |
BOAbot/BOAbot-Einstellungsseite-neu-bei-Together.md | C | proposals/ — Figma links and a realisation order |
BOAbot/Wechselkennzeichen-(WKZ).md | B | proposals/boabot-wechselkennzeichen/ — genuine requirements and a question table, mostly unanswered |
BOAbot/Wechselkennzeichen-(WKZ)/ 5 sub-pages | E | four are a screenshot under a "Besonderheiten" heading filled with placeholder bullets; VAV is marked obsolete |
BOAbot/BOABOT-CONFIG-MANAGEMENT.md | B | Section 3 — a real runbook with the stored procedure and CSV format |
BOAbot/Riskine-Integration.md | E | drop — five lines |
TIS-Applikationen/Riskine-Integreation-(BOAbot-Konfiguration).md | A | Tis.Partner.RiskineIntegration repo (Rule 1) — detailed and current; explains the OVB COM-Betreuer model and the access validation |
Development
| Wiki page | Value | Destination and note |
|---|---|---|
Secure-Development-Guidelines.md | C | development/secure-development/README.md — an index with one entry |
Secure-Development-Guidelines/Repository-Kritikalität.md (27 KB) | A / B | development/secure-development/repository-criticality.md — the criteria table is A and durable; the ~158-row inventory is a February 2026 snapshot that decays, and names a developer per repository. See Section 4 |
Betrieb/Azure-Artifacts-npm-Upstream-E404.md | A | development/ci-cd/azure-artifacts-npm-upstream.md — already written to this repository's standard: problem, two root causes, fix, verification |
Testing/Testfall-Schadenmeldung…md | B | development/testing/ — detailed walkthrough, unfinished in three places |
Testing/UNIQA-Easy-Option-Plus…md | B | development/testing/ — a genuinely useful field-mapping test matrix, truncated |
Testing/EOP-Geschäftsfall erzeugen…md, XML-aus-CCA.md | C | development/testing/ — mostly screenshots |
Testing/Impersonation…md, Standard-Testcases…md, BOAbot-Testing.md | C | development/testing/ — two URLs, three names, one environment note |
Projekte/2024 - OVB-Projekt/Test-Benutzer-und-Test-Vermittlernummern.md | C | test data, not documentation — tis-cca.testdata-management, and only after stripping |
TOGETHER-Service-Dokumentation-Projekt-2025.md | B | merge into proposals/documentation-strategy.md — the audience analysis still holds |
Fehler-Handling TOGETHER - Projekt 2025.md plus 2 attachment notes | B | proposals/error-handling-pattern.md — well structured, but it is a briefing for a workshop whose own to-do list still says "arrange the workshop" |
Infrastructure
| Wiki page | Value | Destination and note |
|---|---|---|
Betrieb/RDP-Testumgebungen.md | B | infrastructure/servers/together/ — the only server and IP inventory that exists, but it still carries VUDEV and its table markup is broken |
Wildfly: Infos und Tipps/Wildfly-Infos.md | B | infrastructure/servers/together/wildfly.md — a genuinely useful admin guide; lists VUDEV, and carries credentials |
Wildfly: Infos und Tipps/Wildfly-Windows-Service-installieren.md | C | same page or a sibling — targets WildFly 14 while the admin page runs 18 |
Volltextsuche/Administration/Elasticsearch-und-Kibana-Installation.md | B | infrastructure/servers/together/elasticsearch.md — detailed, but pins versions and contradicts itself on the host address |
Volltextsuche/Administration/Setup.md, CDC.md, Administration.md | C | fold into the same page — a checklist, a CDC statement, two IIS settings |
Volltextsuche/Entwicklungsumgebung-TISDEV.md | D | a development environment on Elasticsearch 7.4; verify it still exists |
Betrieb/Index-Stats.md | C | infrastructure/databases/ (new) — a good query pattern with example dates hardcoded to 2023 |
Wissenswertes/Kusto-DataExplorer-vs-Workbook.md | A | infrastructure/monitoring/ — small, but records a non-obvious trap: a blank line invalidates every let above it in Data Explorer |
SoaGFX/SOAGFX-modifyGF-Monitoring - Data Explorer.md | C | infrastructure/monitoring/ — two dashboard links |
TOGETHER - Hosting…/Azure-Key-Vault-Zugriff…md | B | mostly already in infrastructure/secrets/README.md — same principals, client IDs, groups, tenant. New material is the bootstrap script and the specialised-principal procedure. Merge as a section; drop the VUDEV rows |
Wissenswertes/TIS-Umgebungen-benötigte-Environment-Variablen.md | E | drop — five lines already covered |
Proposals
| Wiki page | Value | Destination and note |
|---|---|---|
MaklerAdmin-2025/Anforderungen an die Makleradmin 2025.md | C | proposals/makleradmin-2025.md — seven screenshots with "Verbesserung:" bullets between them |
Together-Benutzer/…/Architektur-Grooming-2025-05-12.md | B | proposals/benutzerverwaltung-2025.md — records the chosen path and the rejected alternatives, which is what makes it durable |
Together-Benutzer/Neukundenenrollment für Großkunden ÖAMTC…md | B | proposals/ — two sessions with real process detail, including the seven Excel lists it aims to replace |
Projekte/ÖAMTC/ÖAMTC-riskine-Beratung.md | B | proposals/ — a sequence diagram and a list of open questions |
TIS-Applikationen/Portal - Hybridgui/Banner-im-Portal.md | C | proposals/ — requirements from a 2023 meeting |
Plattform-Relaunch-2026.md plus 3 sub-pages | E | one proposals/plattform-relaunch-2026.md holding the links — all four pages are nothing but links today |
Rule 1: Application Repositories
Roughly 40 pages describe exactly one application from the inside and therefore belong next to its code.
| Wiki pages | Value | Repository |
|---|---|---|
TIS-Applikationen/OMDSX2024-Upload.md and the 4 Import-Modul-* pages | A | tis.omdsx2024 — precise down to table and stored-procedure level, clearly written by the implementer |
Analysen-von-OMDSXUploadService.java/ (7 pages) | B | tis.omdsx2024 — five say outright they were generated by ChatGPT and none is marked reviewed. They describe the legacy Java service being replaced, so their value is highest during the port and historical after it |
ÖAMTC-Unfall-Tarifrechner/Übersicht-Backend.md | B | tis.gf.oeamtcUnfall — specific: endpoint list, UNIQA SOAP integration, configuration |
ÖAMTC-Unfall-Tarifrechner/Übersicht-Frontend.md | D | tis.gf.oeamtcUnfall — describes an Angular application in terms that fit any Angular application |
ÖAMTC-Unfall-Tarifrechner/Übersicht-Gesamt.md | E | two screenshots and nothing else |
TIS-Applikationen/TIS-Anmeldung.md | B | tis.anmeldung — the Vermittlernummer format table is A-grade domain data, bolted onto unrelated newsletter log-grepping. Split it |
TIS-Anmeldung/Firmenanmeldung und Benutzeranmeldung.md | A | tis.anmeldung — full flow, GISA integration, PDF and e-mail handling |
TIS-Anmeldung/GISA-Assets.md | B | tis.anmeldung — the GISA check-digit algorithm is durable and hard to find elsewhere |
TIS-Applikationen/ÖAMTC-BP-2018.md, Auslieferung-PROD.md, Querverweise.md | C/D | tis.gf.bp.oeamtc — one line, a deployment runbook (Section 3), and cross-references to code |
Volltextsuche/Volltextsuche-Aufbau.md and Berechtigungsfilter.md | A | tis.volltextsuche — current query shapes, well explained, worked examples |
Volltextsuche/Einstiegspunkte.md, Sucheingaben-Anforderungen.md | B | tis.volltextsuche — entry points and real search-behaviour requirements |
Volltextsuche/Berechtigungen.md and 2 sub-pages | B/C | tis.volltextsuche — contradicts the newer pages on index naming; the Swiss Life page stops mid-sentence |
Volltextsuche/Administration/Templates.md, Templates/Geschäftsfälle.md | D | tis.volltextsuche — index templates dated August 2019 whose field naming no longer matches the live queries |
Volltextsuche/Kibana-Queries.md | D | tis.volltextsuche — mostly literal permission dumps; low signal, and it points at a development host |
Volltextsuche/Gewichtung.md, Referenzen.md | C | tis.volltextsuche — one tuning note, one link collection |
Volltextsuche/Gf-Collector.md | E | a title and an empty heading |
IdentityServer/TokenExchangeGrant, Duende-6-Migration, SAML2-Zertifikate | B/D/C | tis.identity — see the identity table above |
Projekte/VIG - AVAG…/AVAG-Developer-Guide.md, _tools/Generate-Jwt.ps1 | A/B | tis.identity |
ESIGN/CCA-Clients/Namirial.md, Zurückgestellte-Signaturprozess.md | B | tis.gf.esign |
OMDS3/VigoNG-Schema-Changes.md, OMDS3-Schemas-(Sachprivat).md | B/D | tis-cca.omds3 |
TIS-Applikationen/Riskine-Integreation-(BOAbot-Konfiguration).md | A | Tis.Partner.RiskineIntegration |
TIS-Applikationen/Auto-Ole.md would go to tis.bestand.ole.autoOle, but that repository is
empty and the page itself has unanswered entries — which together suggest checking whether the
application still runs before doing anything with it.
3. Support and Operations Runbooks — Home Undecided
25 pages with no clean home in the four roots. They are ticket-driven procedures for
customer service and second-level support, most acting directly on production data. Their
audience and lifecycle differ from developer documentation, which is why neither
development/, products/ nor infrastructure/ fits without stretching.
Every one of these needs a Who does this line under its heading
(DOCUMENTATION-GUIDELINES.md, section 3) wherever it lands.
Benutzerverwaltung and OTRS Procedures (14) — mostly B
All under Together-Benutzer/Benutzerverwaltung (Usermanagement)/:
Anlage-Benutzer, Anlage-Vermittlernummer, Benutzer-zu-Makler-zuordnen, Makler-anlegen,
Makler-Stammdaten-ändern, Makler-stilllegen, Stilllegen-Benutzer,
Stilllegen-ÖAMTC-Benutzer, Stilllegen-Vermittlernummer,
Vermittlernummer-zu-eingeschränkten-Benutzer-hinzufügen, Änderung-Stammdaten,
Änderung-Benutzer-Stammdaten, Änderung-Benutzer-Berechtigung,
Änderung-Benutzer-Leistungsstufe, Änderung-ÖAMTC-Benutzer
They encode a real process that exists nowhere else, which is why they grade B rather than C. But they are Mermaid diagrams with no prose at all — no preconditions, no failure handling, no explanation of the terms. Several are three boxes long. Converting them to D2 as required by section 7 is an opportunity to write the missing sentences.
Stilllegen-Benutzer.md is the outlier and grades A: it carries the API endpoints, the
BENUTZER_Stilllegen stored procedure behaviour, the affected tables, resolved open questions
marked ✅, and a cross-link to tis.identity.api/docs/USER_DEACTIVATION.md. It also has a
clear Rule 1 half.
SQL Runbooks Against Production (8)
| Page | Value | What it does |
|---|---|---|
Wissenswertes/SSO-und-Partneraccounts/Allianz-User-und-Makler-Cleanup.md | B | Deletes Allianz sync links, jobs and OMDS2 delivery settings; has a safety count check first |
Wissenswertes/Geschäftsfälle/Neuen-GFTyp-anlegen-in-der-Datenbank.md | B | Migration script creating a new business-case type, with a versioning table |
Wissenswertes/SSO-und-Partneraccounts/Partner-Accounts (ALLIANZ, UNIQA, HDI, …) clonen.md | B | The partner.CopyPartnerAccount procedures |
Wissenswertes/Polizzenkopien-und-Kontoauszüge-umhängen(SQL).md | C | Reassigns documents between brokers |
Wissenswertes/SSO-und-Partneraccounts/alte-SSO-User-Einträge-entfernen-(UserLogins).md | C | Deletes from COMMON.dbo.UserLogins — keep one copy |
Wissenswertes/SSO-und-Partneraccounts/Stillgelegte-SSO-User…entfernen.md | E | Byte-identical duplicate |
Together-Benutzer/ÖAMTC-SSO-Login - alten User…entfernen.md | E | Third copy of the same statement |
Wissenswertes/SSO-und-Partneraccounts/VERALTET - Massenkopie AllianzUser…md | D | Marked obsolete by its own title; documents a nightly job on TISDB01 that may still run |
Operational Procedures (9)
| Page | Value | What it does |
|---|---|---|
Trustcenter/Trustcenter - exportierbares-Zertifikat.md | A | Root-causes an enrolment error through the ASP code and ends with a one-line fix |
IdentityServer/Signing-Zertifikat-aktualisieren.md | B | Annual signing certificate rotation; VIG must be coordinated |
BOAbot/BOABOT-CONFIG-MANAGEMENT.md | B | SP_MANAGE_BOABOT_CONFIG plus CSV mass update |
OMDS3/ÖBV-Benutzer-Consent-vergeben.md | B | Bulk consent insert, scaling from one user to 453 |
Kommunikation-intern-und-extern/Wartungsseite-auf-PROD-aktivieren.md | C | Edits the Helicon rewrite configuration on TISWEB01 |
Wissenswertes/Geschäftsfälle/GF-XML-oder-json-aus-DB-ziehen.md | C | Extracts business-case payload for debugging |
Wissenswertes/EFM-Vertragsliste-f.-CCA.md | C | Recurring export on request; names the requester, who has already changed once |
TIS-Applikationen/ÖAMTC-BP-2018/Auslieferung-PROD.md | C | Manual production deployment from a file share |
OMDS3/OMDS3-Engine-Berechtigung-Benutzerverwaltung.md | C | Where to set the OMDS3-KFZ permission |
Options
| Option | Consequence |
|---|---|
products/together/operations/ | No new root; grouped by the service each procedure acts on |
A fifth operations/ root | Own Docusaurus plugin and navbar entry; support gets its own home, but the four-root model changes |
infrastructure/databases/runbooks/ | Grouped by the system touched rather than by audience |
| Keep out of this repository | Different audience and lifecycle; a service-desk knowledge base may fit better |
4. Sensitive Content Inventory
These pages MUST NOT be copied unchanged. DEPLOYMENT.md notes that the site is
SAS-protected today but that a migration to a public CDN endpoint is planned, so anything
migrated has to be safe for that endpoint.
Live Credentials
| File | What is exposed |
|---|---|
ARAG/Linked-Account.md | Shared partner-portal password for the DevOps mailbox account at ARAG, in clear text |
OMDS3/OMDS-3-Onboarding/Toyota-IM.md | Production client secret for the Toyota OMDS3 client |
Wildfly: Infos und Tipps/Wildfly-Infos.md | WildFly admin password — Admin UI on Fachtest, Prod, Stage, VuDev and TISDEV |
Wildfly: Infos und Tipps/Wildfly-Windows-Service-installieren.md | Same password, inside the service install command |
Projekte/2024 - OVB-Projekt/OVB-Accounts-Api.md | Bearer token valid until 2035 |
VIG…/Kooperative-Antragsbearbeitung/Integration.md | Bearer token valid until 2034 |
ESIGN/CCA-Clients/Namirial.md | Bearer token in three request examples |
ESIGN/Zurückgestellte-Signaturprozess.md | Bearer token |
Projekte/VIG - AVAG…/AVAG-Developer-Guide.md | Client secret inside a token-exchange CLI example |
Wissenswertes/TOGETHER-Endpoints-Check-List.md | ÖAMTC UDS bearer token in a sample request |
OMDS3/OMDS3 - Deeplink: User Delegation…md | Security context token identifier, repeated in the delegation proposal and the CATCH guide |
Wissenswertes/Plattform-Menü- bzw. CADS-Änderungsmenü.md | Technical user for the production menu configuration |
Wildfly: Infos und Tipps/Wildfly-Infos.md | The same technical user for the menu upload |
These values are already in wiki history — removing them from the copy does not undo the exposure. A rotation list for the DevOps team is worth raising independently of the migration.
Test Credentials (Real Accounts on Fachtest)
| File | What is exposed |
|---|---|
Projekte/2024 - OVB-Projekt/Test-Benutzer-und-Test-Vermittlernummern.md | 15 users with passwords, plus the OVB SSO login password |
UNIQA/Account-Linking.md | 4 TOGETHER passwords and the matching UNIQA test passwords |
Testing/BOAbot-Testing.md | CCA-Online and CCA9 test logins |
Testing/Testfall-Schadenmeldung-(aus-CCA-Online - CCA9).md | CCA-Online test login |
Testing/UNIQA-Easy-Option-Plus…md | Links a client certificate file on SharePoint |
Token Register
OMDS3/OMDS-3-Onboarding/Übersicht-PROD-Tokens-(Stand: 26.05.2025).md — 8 production access
tokens with only the last ten characters masked, alongside user, MaklerID and the named
recipient. The page itself states that the full tokens live on the Secret Server.
Customer Personal Data
Allianz/Allianz-Integration-Debugging-14.10.2024.md — three full JWTs that decode to the
names, e-mail addresses and Allianz user numbers of real brokers.
External Contact Data
| File | What is exposed |
|---|---|
Kommunikation-intern-und-extern/Ansprechpartnerliste.md | Around 60 named contacts at 20+ partners, with direct and mobile numbers |
Kommunikation-intern-und-extern/E-Mail-Liste-Partner-für-Wartungsankündigungen…md | Around 25 partner addresses |
OMDS3/OMDS-3-Onboarding/* | Around 20 pages, each naming a contact with e-mail and often a mobile number |
Projekte/VIG - AVAG…/AVAG-Developer-Guide.md, CATCH-Integration-Guide.md | Internal and external contact tables |
BOAbot/BoaAPI.md | Named internal and VersFinanz people |
Together-Benutzer/SSO-login-Together - Informationssammlung.md | EFS and AON contact details |
Internal Employee Data
Secure-Development-Guidelines/Repository-Kritikalität.md — around 158 repositories, each
mapped to a named main developer with last-commit dates. Useful internally, awkward on a
public URL.
Infrastructure Detail
| File | What is exposed |
|---|---|
Betrieb/RDP-Testumgebungen.md | Complete internal IP plan including production, with operating system versions |
Volltextsuche/Administration/Elasticsearch-und-Kibana-Installation.md, Entwicklungsumgebung-TISDEV.md | Server IPs, ports and configuration paths |
Wissenswertes/TOGETHER-Endpoints-Check-List.md | Internal host and port inventory of Java and .NET services |
TOGETHER - Hosting…/Azure-Key-Vault-Zugriff…md | Service principal object and client IDs, tenant ID — already in infrastructure/secrets/ |
Customer Business Data
Projekte/VIG - AVAG…/AVAG-Kontonummern.md and AVAG-Maklerliste…md plus their spreadsheet
attachments carry AVAG commission account numbers and the broker and user list.
Volltextsuche/Kibana-Queries.md and Volltextsuche/Berechtigungen.md embed real broker IDs
and user names in example queries.
5. Proposed Not to Migrate
Everything graded E, plus the pages whose only content is a link to a better source.
| Pages | Why |
|---|---|
| 39 empty pages | DOCUMENTATION-GUIDELINES.md section 6 forbids placeholder documents. Their hierarchy is preserved by the README.md index of the folder they land in |
Volltextsuche.md, ESIGN.md | Build and deployment badges only — these belong in the repository README |
Plattform-Relaunch-2026.md plus 3 sub-pages | Link lists to work items; keep the links, drop the pages |
BOAbot/Wechselkennzeichen-(WKZ)/ 4 sub-pages | A screenshot under placeholder bullets; one is marked obsolete |
Wissenswertes/Test-des-Diagramm-Editors-Mermaid.md | A tooling trial; the repository standard is D2 |
Wissenswertes/Styleguide.md | A single Confluence link |
Wissenswertes/TIS-Umgebungen-benötigte-Environment-Variablen.md | Already in infrastructure/secrets/README.md |
Projekte/Planung-Together.md | 2025 Gantt chart, superseded |
MaklerAdmin-2025/Besprechungen.md | One meeting link |
.attachments/OMDS3-Services-Endpoint-und-Resources-*.md | Older draft that contradicts the page that replaced it |
.attachments/2025-07-04-mh-gedanken-fehler-handling-*.md | Two byte-identical copies; keep one, folded into the error-handling proposal |
Allianz/Allianz-Integration-2.0.md, BOAbot/Riskine-Integration.md, TIS-Applikationen/OMDSManager.md, Benutzeranmeldung.md, OVB-Selfservice.md, BOAbot.md, Volltextsuche/Gf-Collector.md | One to five lines, or a heading with nothing under it |
ÖAMTC-Unfall-Tarifrechner/Übersicht-Gesamt.md | Two screenshots |
Together-Benutzer/ÖAMTC-SSO-Login…entfernen.md, Wissenswertes/…/Stillgelegte-SSO-User…entfernen.md | Second and third copy of the same DELETE statement |
Pages graded D are a separate decision: they are not wrong, they are finished. Whether they come along depends on whether the old wiki stays readable — see the open questions.
6. Conversion Work Any Migration Will Need
Independent of placement, the wiki is written for the Azure DevOps renderer and will not build under Docusaurus as it stands.
| Issue | Extent |
|---|---|
| Azure DevOps Mermaid fences | Around 20 pages. Docusaurus needs a fenced mermaid block plus the Mermaid theme, but section 7 requires D2 with the .d2 source and a rendered .svg committed — so these are conversions, not reformats |
[[_TOC_]] macros | Around 20 pages, must be removed |
| Attachment image paths | 188 image files to relocate into diagrams/ folders next to their document |
| Filenames with escaped characters, ampersands, parentheses and umlauts | Around 40 files; section 6 requires kebab-case.md |
MDX build breakers — < and { are markup | Bare e-mail addresses in angle brackets across the OMDS3 onboarding pages, XML element names in prose in the OMDSX pages, inline LaTeX in ESIGN/Testen.md, raw HTML in TIS-Applikationen/Auto-Ole.md. Section 6 notes these fail the build rather than warn |
| Headings without a space after the hash | Around 25 pages |
| Table defects | Betrieb/RDP-Testumgebungen.md uses empty leading cells as continuation rows; several pages have blank lines inside tables, which breaks rendering |
| Checkbox syntax inside table cells | Section 7 requires ✅ and ❌ instead |
| Language | Everything is German. Section 7 lets existing German documents stay; translation is expected only where a page is substantially rewritten — worth deciding per page rather than as a blanket rule |
CLAUDE.md states that only development/ and products/ are published. That is out of date:
site/docusaurus.config.ts mounts all four roots, as DOCUMENTATION-GUIDELINES.md describes.
Worth correcting while this work is underway.
7. Open Questions
- Does the grading drive the scope? Migrating only A and B is about 95 pages and captures the knowledge that would be expensive to lose. Adding C roughly doubles the count for material that mostly belongs as sentences inside other pages. That is the cheapest lever on the size of this project.
- Rule 1 pages (around 40). Routing them to ten application repositories means pull requests across repositories owned by different people. Do those go out now, or does this repository hold them temporarily so the wiki can be retired sooner?
- Support runbooks (Section 3). Where they land, and whether that needs a fifth root.
- Who verifies the B pages? Grade B means "real content, unverified". The contradictions listed in Section 1 cannot be resolved from the wiki — somebody with access to the running configuration has to settle the OMDS3 endpoint paths, the Elasticsearch index and field names, and the WildFly version. Without that, migrating them just moves the uncertainty.
- Public CDN. If the documentation site becomes public, the server IP plan, endpoint inventory, MaklerID reference, repository criticality table and partner contact lists each need a decision — exclude, prefix with an underscore, or keep the site internal.
Softwarelandschaft.mdversusplatform-usage-overview.md. Two overlapping platform overviews from the same month, one qualitative and one measured. Merge, or keep both and cross-link?- Wiki retirement. Whether the old wiki stays readable read-only after the move. This decides the fate of every D page: if the wiki survives as an archive, none of them needs to come along.