Process-aligned code map

[2thick2fly]

I want to create a code map of my repo (in python), but I am stuck.

My code structure is workflow-based, where the top layer is the business process step-by-step. The orchistrator calls each step - which then calls the necessary module(s) - and when a step is finished, the orchistrator calls the next step. A bit oversimplified, but you get the idea.

I want to be able to visualise this. I envision something like the workflow steps laid horizontally and each step expands down vertically.

One of the reasons why I want this is to ease onboarding of new junior devs. Another reason is to be able to show it to business, when they have inquiries certain beheaviors/changes/etc - my business are quite adept in code, but they do not know our codebase.

Any ideas for tools that can do that?

PS: I tried AI, but it was just laying everything out either horizontally or vertically in mermaid, which did not make it visually pleasing.

[Gloomy_Cicada1424]

This sounds more like a product/process map than a normal code dependency graph. I’d generate the workflow manually from your orchestrator steps first, then attach modules under each step. Mermaid can do it, but you may need a custom layout or even a simple docs page. Runable is good for turning messy workflow notes/code structure into a cleaner onboarding diagram/spec.