# Tools Relationship Map

**Last Updated:** 2026-01-08

Map of relationships between tools to guide cross-referencing in documentation.

## Tool Categories

### Salary & Income Calculators

**Related Tools:**

- **Minijob-Rechner** → Related to: Midijob-Rechner, Brutto-Netto-Rechner, Stundenlohnrechner
- **Midijob-Rechner** → Related to: Minijob-Rechner, Brutto-Netto-Rechner, Stundenlohnrechner
- **Brutto-Netto-Rechner** → Related to: Minijob-Rechner, Midijob-Rechner, Einkommensteuer-Rechner, Stundenlohnrechner, TVöD-SuE Gehaltsrechner
- **Einkommensteuer-Rechner** → Related to: Brutto-Netto-Rechner, TVöD-SuE Gehaltsrechner
- **TVöD-SuE Gehaltsrechner** → Related to: Brutto-Netto-Rechner, Einkommensteuer-Rechner
- **Stundenlohnrechner** → Related to: Minijob-Rechner, Midijob-Rechner, Brutto-Netto-Rechner, Arbeitszeitrechner

**Relationship Types:**

- **Complementary:** Tools that work together (e.g., calculate gross → calculate net → calculate tax)
- **Alternative:** Tools for similar purposes (e.g., Minijob vs Midijob)
- **Sequential:** Tools used in sequence (e.g., Stundenlohn → Arbeitszeit → Brutto-Netto)

### Time & Attendance Calculators

**Related Tools:**

- **Arbeitstage-Rechner** → Related to: Urlaubsanspruch-Rechner, Arbeitszeitrechner, Zuschlagsrechner
- **Urlaubsanspruch-Rechner** → Related to: Arbeitstage-Rechner, Minijob-Rechner, Midijob-Rechner
- **Arbeitszeitrechner** → Related to: Arbeitstage-Rechner, Stundenlohnrechner, Zuschlagsrechner, Industrieminuten-Rechner
- **Industrieminuten-Rechner** → Related to: Arbeitszeitrechner, Zuschlagsrechner

**Relationship Types:**

- **Complementary:** Tools that calculate different aspects of time/work (e.g., work days → vacation entitlement)
- **Conversion:** Tools that convert between time formats (e.g., hours ↔ industrial minutes)

### Cost & Financial Calculators

**Related Tools:**

- **Kostenrechner** → Related to: ROI-Rechner Schichtplanung, Zuschlagsrechner
- **ROI-Rechner Schichtplanung** → Related to: Kostenrechner, Zuschlagsrechner
- **Zuschlagsrechner** → Related to: Kostenrechner, ROI-Rechner Schichtplanung, Arbeitszeitrechner, Industrieminuten-Rechner
- **Mehrwertsteuer-Rechner** → Related to: PayPal Gebührenrechner, Kostenrechner
- **PayPal Gebührenrechner** → Related to: Mehrwertsteuer-Rechner, Kostenrechner
- **Zinseszinsrechner** → Related to: ROI-Rechner Schichtplanung

**Relationship Types:**

- **Cost Analysis:** Tools for calculating different types of costs
- **Financial Planning:** Tools for financial analysis and ROI

### General Purpose Calculators

**Related Tools:**

- **Prozentrechner** → Related to: All tools (used in many calculations)
- **ShiftOps** → Related to: All planning tools (Arbeitstage-Rechner, Urlaubsanspruch-Rechner, ROI-Rechner Schichtplanung), business analysis tools

**Relationship Types:**

- **Utility:** General-purpose tools used across many scenarios
- **AI Assistant:** Provides guidance for using other tools

### Specialized Calculators

**Related Tools:**

- **Arbeitslosengeld-Rechner** → Related to: Brutto-Netto-Rechner (previous income), Einkommensteuer-Rechner

**Relationship Types:**

- **Benefit Calculation:** Tools for calculating government benefits based on income

## Cross-Reference Guidelines

### When to Add Cross-References

1. **Complementary Tools:** Always link tools that are typically used together
2. **Alternative Tools:** Link tools that solve similar problems but for different scenarios
3. **Sequential Tools:** Link tools that are used in a workflow sequence
4. **Related Concepts:** Link tools that share concepts or calculations

### Cross-Reference Format

In each tool documentation, add a "Related Tools" section:

```markdown
## Related Tools

### Complementary Tools

- **[Tool Name](tool-slug-documentation.md)** - [Brief description of relationship]
  - Use together when: [Scenario]
  - Example workflow: [Brief example]

### Alternative Tools

- **[Tool Name](tool-slug-documentation.md)** - [Brief description of alternative]
  - Use instead when: [Scenario]

### Sequential Tools

- **[Tool Name](tool-slug-documentation.md)** - [Brief description of sequence]
  - Use after: [Previous step]
  - Use before: [Next step]
```

## Visual Enhancement Guidelines

### Screenshot Placeholders

Add visual description sections with notes for screenshots:

```markdown
## Visual Examples

### Screenshots (To Be Added)

**Hero Section Screenshot:**

- Location: `docs/guides/tools-pages/screenshots/[tool-slug]-hero.png`
- Description: [What the screenshot shows]
- Dimensions: 1920x1080 (desktop), 375x667 (mobile)

**Calculator Form Screenshot:**

- Location: `docs/guides/tools-pages/screenshots/[tool-slug]-form.png`
- Description: [What the screenshot shows]

**Result Display Screenshot:**

- Location: `docs/guides/tools-pages/screenshots/[tool-slug]-results.png`
- Description: [What the screenshot shows]
```

### Diagram Placeholders

Add flow diagrams for complex workflows:

```markdown
### Workflow Diagrams (To Be Added)

**Calculation Flow Diagram:**

- Location: `docs/guides/tools-pages/diagrams/[tool-slug]-flow.svg`
- Description: [What the diagram shows]
- Format: SVG (vector) for scalability

**Tool Relationship Diagram:**

- Location: `docs/guides/tools-pages/diagrams/[tool-slug]-relationships.svg`
- Description: [What the diagram shows]
```

## Real-World Scenario Guidelines

### Scenario Structure

Add detailed real-world scenarios to Use Cases sections:

```markdown
### Real-World Scenarios

**Scenario 1: [Title]**

- **User:** [User type]
- **Situation:** [Context]
- **Goal:** [What they want to achieve]
- **Steps:**
  1. [Step 1]
  2. [Step 2]
  3. [Step 3]
- **Result:** [Outcome]
- **Related Tools:** [Links to related tools used]
```

### Scenario Categories

1. **Employee Scenarios:** Individual workers calculating their income/benefits
2. **Employer Scenarios:** Businesses calculating costs/compliance
3. **HR Scenarios:** HR professionals managing workforce planning
4. **Financial Planning Scenarios:** Long-term financial planning
5. **Compliance Scenarios:** Ensuring legal compliance