Skip to content

Add MBSE systems engineering documentation (Arcadia/Capella) - #536

Open
nestor-g wants to merge 1 commit into
nasa-jpl:masterfrom
nestor-g:feature/mbse-systems-engineering
Open

Add MBSE systems engineering documentation (Arcadia/Capella)#536
nestor-g wants to merge 1 commit into
nasa-jpl:masterfrom
nestor-g:feature/mbse-systems-engineering

Conversation

@nestor-g

@nestor-g nestor-g commented Mar 3, 2026

Copy link
Copy Markdown

Summary

  • Introduces a full 5-layer Arcadia/Capella MBSE structure for the JPL Open Source Rover, following the same methodology used on real Mars rover programs
  • Adds 22 documentation pages covering the complete traceability chain from stakeholder needs → system functions → logical components → physical hardware → product breakdown
  • Includes the Eclipse Capella 6.1.0 model scaffold (.capella, .aird, .afm) sourced from PhilCarPi/open-source-rover
  • Updates mkdocs.yml with a full Systems Engineering nav section (22 pages)

Structure Added

systems_engineering/
├── 01_operational_analysis/   — Stakeholders, entities, activities, capabilities
├── 02_system_analysis/        — System functions, capabilities, missions, interfaces
├── 03_logical_architecture/   — 8 logical components (LC-01..LC-08), functions, interfaces
├── 04_physical_architecture/  — RPi/RoboClaw/PCB component specs, ROS node deployment map
├── 05_epbs/                   — Full BOM with suppliers and cost estimates (~$1,100–1,550)
└── MBSE_workspace/            — Capella 6.1.0 model files (machine-readable)

Test plan

  • mkdocs build passes with zero new warnings (7 pre-existing warnings in repo are unaffected)
  • All 22 systems engineering HTML pages rendered in _site/systems_engineering/
  • Capella model files include valid XMI scaffold for all 5 Arcadia layers
  • ReadTheDocs build passes on PR (automated)

🤖 Generated with Claude Code

Introduces a full 5-layer Arcadia MBSE structure for the OSR based on
the Eclipse Capella methodology. Covers the complete traceability chain
from stakeholder needs through operational activities, system functions,
logical components, physical hardware, and product breakdown (EPBS).

- 01_operational_analysis: stakeholders, entities, activities, capabilities
- 02_system_analysis: system functions, capabilities, missions, interfaces
- 03_logical_architecture: 8 logical components (LC-01..LC-08), functions, interfaces
- 04_physical_architecture: RPi/RoboClaw/PCB component specs, ROS node deployment
- 05_epbs: full BOM with suppliers and cost estimates (~$1,100–1,550)
- MBSE_workspace: Capella 6.1.0 model scaffold (.capella, .aird, .afm, .project)
- mkdocs.yml: Systems Engineering nav section added (22 pages)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@Achllle

Achllle commented Mar 5, 2026

Copy link
Copy Markdown
Collaborator

I'm new to MBSE so forgive my ignorance. What does this do for the OSR? How do we maintain this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants