How orange-cyberdefense/ocd-mindmaps works
Project type and purpose
• The README and file layout show it is not a full-stack web app but a command-line generator for infosec mindmaps.
File structure
• Top-level:
• LICENSE, index.md, readme.md → documentation
• _config.yml → site config for GitHub Pages
• src/ → example XMind source
• excalimap/ → core Python package
• excalimap/:
• main.py → entrypoint/CLI
• config.py, utils.py → shared configuration and helpers
• parsermd.py, parserjson.py → two parser modules for Markdown and JSON sources
• output/ → output directory (placeholders)
• mindmap/ → example mindmap content (ad, example) with conf.yml + .md files
• doc/ → user documentation and images
• gen_all.sh, gen_all_svg.sh → orchestration scripts to batch-generate maps
• Dependencies:
• requirements.txt → Python dependencies
README for additional insights
• Minimal; points at the hosted mindmap site.
Elements
• Blue rectangles for modules/packages
• Green parallelograms for I/O (input files, output directory)
Final advice
• Be detailed: show each phase and how it hooks into the next.
• Configuration (config.py + conf.yml) as its own component since it influences parsing and rendering.
• Don’t overcomplicate: the strength of this tool is its linear pipeline and modularity.