Data Flow Diagram
A data flow diagram (DFD) shows how data moves between processes, data stores, and external entities — a readable architecture view for answering "what data goes where" without committing to behavior or sequencing.
Ngenaire gives DFDs their own dedicated canvas editor at /architecture/data-flow-diagram. Unlike the PlantUML-based UML and SysML diagrams, a DFD is drawn directly on an interactive canvas.
Elements
A DFD is built from four element types:
- Process — a transformation of data.
- Data Store — persisted data.
- External Entity — a source or sink of data outside the system.
- Data Flow — a labeled arrow connecting elements.
DFDs are typically leveled: a Context (Level 0) view shows the system as a single process with its external entities, then deeper levels decompose each process.
Walkthrough
1. Open the editor
- Go to /architecture/data-flow-diagram.
- Select a project if you haven't already — diagrams are project-scoped.
2. Create a diagram
- Click New Diagram.
- Give it a name and (where prompted) a level and description.
To skip the blank canvas, click Generate with AI instead — see AI generation.
3. Add elements
The toolbar has tools for Process, Data Store, External Entity, and Data Flow.
- Click a shape tool, then click the canvas to drop the element.
- For Data Flow, click the source element, then the target; the flow is drawn as a labeled arrow you can rename.
4. Edit, move, and delete
- Click an element to select it; drag to move, and drag a handle to resize.
- Double-click an element to edit its label inline, or use Edit Selected for the full dialog (label, description, process number, linked requirements).
- Delete Selected removes the selection; flows touching deleted elements are removed too.
5. Keyboard shortcuts
The canvas supports its own shortcuts:
- Cmd/Ctrl + Z — undo.
- Cmd/Ctrl + Shift + Z or Cmd/Ctrl + Y — redo.
- Delete / Backspace — delete the selection.
- Arrow keys — nudge the selection; hold Shift for a larger step.
- Cmd/Ctrl + D — duplicate the selection.
- Cmd/Ctrl + S — save.
6. Save
- Click Save Diagram (or press Cmd/Ctrl + S) to persist positions, labels, and metadata.
7. Export
- Click the PNG export button to download the current canvas as an image.
AI generation
Click Generate with AI to draft a DFD from your project's existing artifacts.
- Optionally set a name, level, and notation, and add free-text guidance for what the diagram should emphasize.
- Ngenaire reads the project's requirements, ConOps, SOW, risks, and trade studies and proposes processes, external entities, data stores, and the flows between them.
- The draft drops onto a fresh canvas, ready to edit, rearrange, and save like any hand-built diagram.
If the project has no requirements, ConOps, SOW, risks, or trades yet, the generator returns a helpful message rather than an empty diagram.
Tips
- Keep each diagram readable. Decompose into a deeper level once a diagram has too many processes.
- Label every flow. Unlabeled flows hide assumptions about what data is moving.