# berufsbildung-basel/parkit-management architecture

> Architecture diagram of the GitHub repository berufsbildung-basel/parkit-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/berufsbildung-basel/parkit-management
- Repository: https://github.com/berufsbildung-basel/parkit-management

## Overview

P.A.R.K.I.T is an office-parking reservation application under development; this repository coordinates its project rather than implementing the service. The documented workflow is to track project direction and current work, record context and decisions, and organize research and planned features into workstreams. The README identifies LED-matrix integration, administration approval, and expiring-reservation reminders as current or planned focus areas. Source excerpts were unavailable, so relationships below are limited to those explicitly stated in the README; implementation details and links between unsampled workstream materials are omitted.

Main entry points: [`README.md`](https://github.com/berufsbildung-basel/parkit-management/blob/main/README.md) (Repository Guide), [`CURRENT_TASKS.md`](https://github.com/berufsbildung-basel/parkit-management/blob/main/CURRENT_TASKS.md) (Current Tasks), [`PROJECT_ROADMAP.md`](https://github.com/berufsbildung-basel/parkit-management/blob/main/PROJECT_ROADMAP.md) (Roadmap), [`project-context`](https://github.com/berufsbildung-basel/parkit-management/tree/main/project-context) (Project Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Project Coordination"]
  node_readme["Repository Guide<br/>[README.md]"]
  node_roadmap["Roadmap<br/>[PROJECT_ROADMAP.md]"]
  node_current_tasks["Current Tasks<br/>[CURRENT_TASKS.md]"]
  node_project_board["Project Board"]
end

subgraph group_knowledge["Project Knowledge"]
  node_project_context["Project Context"]
  node_glossary["Glossary<br/>[glossary.md]"]
  node_project_notes["Project Notes"]
  node_decisions["Decisions<br/>[decisions.md]"]
  node_meeting_notes["Meeting Notes<br/>[meeting-notes.md]"]
  node_problems_risks_questions["Problems and Risks"]
end

subgraph group_workstreams["Workstreams"]
  node_led_workstream["LED Integration"]
  node_approval_focus["Administration Approval<br/>[CURRENT_TASKS.md]"]
  node_reminder_workstream["Reservation Reminder"]
  node_presentation_workstream["Project Presentation"]
end

node_project_team(("Project Team"))

node_readme -->|"points to"| node_roadmap
node_readme -->|"points to"| node_current_tasks
node_readme -->|"assigns tracking to"| node_project_board
node_readme -->|"locates context"| node_project_context
node_readme -->|"locates notes"| node_project_notes
node_readme -->|"identifies focus"| node_led_workstream
node_readme -->|"identifies focus"| node_approval_focus
node_readme -->|"identifies focus"| node_reminder_workstream
node_readme -->|"lists workstream"| node_presentation_workstream
node_project_team -->|"tracks progress"| node_project_board
node_project_team -->|"tracks work"| node_current_tasks
node_readme -->|"locates terminology"| node_glossary
node_readme -->|"locates decisions"| node_decisions
node_readme -->|"locates outcomes"| node_meeting_notes
node_readme -->|"locates records"| node_problems_risks_questions

click node_readme "https://github.com/berufsbildung-basel/parkit-management/blob/main/README.md"
click node_roadmap "https://github.com/berufsbildung-basel/parkit-management/blob/main/PROJECT_ROADMAP.md"
click node_current_tasks "https://github.com/berufsbildung-basel/parkit-management/blob/main/CURRENT_TASKS.md"
click node_project_context "https://github.com/berufsbildung-basel/parkit-management/tree/main/project-context"
click node_glossary "https://github.com/berufsbildung-basel/parkit-management/blob/main/project-context/glossary.md"
click node_project_notes "https://github.com/berufsbildung-basel/parkit-management/tree/main/project-notes"
click node_decisions "https://github.com/berufsbildung-basel/parkit-management/blob/main/project-notes/decisions.md"
click node_meeting_notes "https://github.com/berufsbildung-basel/parkit-management/blob/main/project-notes/meeting-notes.md"
click node_problems_risks_questions "https://github.com/berufsbildung-basel/parkit-management/tree/main/project-notes"
click node_led_workstream "https://github.com/berufsbildung-basel/parkit-management/tree/main/workstream/led-integration"
click node_approval_focus "https://github.com/berufsbildung-basel/parkit-management/blob/main/CURRENT_TASKS.md"
click node_reminder_workstream "https://github.com/berufsbildung-basel/parkit-management/tree/main/workstream/reservation-reminder"
click node_presentation_workstream "https://github.com/berufsbildung-basel/parkit-management/tree/main/workstream/project-presentation"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_roadmap,node_current_tasks,node_project_board toneBlue
class node_project_context,node_glossary,node_project_notes,node_decisions,node_meeting_notes,node_problems_risks_questions toneAmber
class node_led_workstream,node_approval_focus,node_reminder_workstream,node_presentation_workstream toneMint
class node_project_team toneIndigo
```

## Components

### Project Coordination

- [Repository Guide](https://github.com/berufsbildung-basel/parkit-management/blob/main/README.md): `README.md`
- [Roadmap](https://github.com/berufsbildung-basel/parkit-management/blob/main/PROJECT_ROADMAP.md): `PROJECT_ROADMAP.md`
- [Current Tasks](https://github.com/berufsbildung-basel/parkit-management/blob/main/CURRENT_TASKS.md): `CURRENT_TASKS.md`
- **Project Board**

### Project Knowledge

- [Project Context](https://github.com/berufsbildung-basel/parkit-management/tree/main/project-context): `project-context`
- [Glossary](https://github.com/berufsbildung-basel/parkit-management/blob/main/project-context/glossary.md): `project-context/glossary.md`
- [Project Notes](https://github.com/berufsbildung-basel/parkit-management/tree/main/project-notes): `project-notes`
- [Decisions](https://github.com/berufsbildung-basel/parkit-management/blob/main/project-notes/decisions.md): `project-notes/decisions.md`
- [Meeting Notes](https://github.com/berufsbildung-basel/parkit-management/blob/main/project-notes/meeting-notes.md): `project-notes/meeting-notes.md`
- [Problems and Risks](https://github.com/berufsbildung-basel/parkit-management/tree/main/project-notes): `project-notes`

### Workstreams

- [LED Integration](https://github.com/berufsbildung-basel/parkit-management/tree/main/workstream/led-integration): `workstream/led-integration`
- [Administration Approval](https://github.com/berufsbildung-basel/parkit-management/blob/main/CURRENT_TASKS.md): `CURRENT_TASKS.md`
- [Reservation Reminder](https://github.com/berufsbildung-basel/parkit-management/tree/main/workstream/reservation-reminder): `workstream/reservation-reminder`
- [Project Presentation](https://github.com/berufsbildung-basel/parkit-management/tree/main/workstream/project-presentation): `workstream/project-presentation`

### Other components

- **Project Team**

## Connections

- Repository Guide → Roadmap: points to (evidence: `README.md`)
- Repository Guide → Current Tasks: points to (evidence: `README.md`)
- Repository Guide → Project Board: assigns tracking to (evidence: `README.md`)
- Repository Guide → Project Context: locates context (evidence: `README.md`)
- Repository Guide → Project Notes: locates notes (evidence: `README.md`)
- Repository Guide → LED Integration: identifies focus (evidence: `README.md`)
- Repository Guide → Administration Approval: identifies focus (evidence: `README.md`)
- Repository Guide → Reservation Reminder: identifies focus (evidence: `README.md`)
- Repository Guide → Project Presentation: lists workstream (evidence: `README.md`)
- Project Team → Project Board: tracks progress (evidence: `README.md`)
- Project Team → Current Tasks: tracks work (evidence: `README.md`)
- Repository Guide → Glossary: locates terminology (evidence: `README.md`)
- Repository Guide → Decisions: locates decisions (evidence: `README.md`)
- Repository Guide → Meeting Notes: locates outcomes (evidence: `README.md`)
- Repository Guide → Problems and Risks: locates records (evidence: `README.md`)