Skip to content

Update architecture doc for saasv2#508

Closed
mike-solomon wants to merge 3 commits intomainfrom
new-architecture-doc
Closed

Update architecture doc for saasv2#508
mike-solomon wants to merge 3 commits intomainfrom
new-architecture-doc

Conversation

@mike-solomon
Copy link
Copy Markdown
Contributor

@mike-solomon mike-solomon commented Mar 2, 2026

  • Replaces the existing architecture doc with an updated version reflecting the SaaS v2 platform
  • Uses "Connector" terminology (instead of "agent") throughout this doc — a docs-wide rename of other pages is a separate effort
  • Replaces the static PNG architecture diagram with a simplified Mermaid diagram showing the v2 service topology
  • Adds new sections for Changelog, Moddy, DevCenter, and Moderne Trigrep with links to detailed docs
  • Replaces superseded sections (Netflix Eureka, generic worker/recipe execution/SCM/tokens services) with v2 microservice descriptions (Organization Management, Recipe Marketplace + Worker, Changeset Services, Authorization Service, Audit Service)
  • Preserves the encryption/security narrative and all setup requirements unchanged
  • Updates the API gateway section to describe Apollo Router federation

This is largely based on AI documentation created by @scuba10steve

Open questions I have:

  • Did the artifact storage model change at all? I just left it the same but it's not clear to me if that's accurate.
  • Likewise, did the encryption model change at all? I left it as is (customer-held symmetric key, decrypt-on-use, revocable by shutting off Connector) - but unsure if that's accurate.

Copy link
Copy Markdown
Member

@scuba10steve scuba10steve left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll want to check on the Artifact Storage service as that no longer exists in the monorepo.

@mike-solomon
Copy link
Copy Markdown
Contributor Author

I've removed the artifact storage section from the doc.

Are LST artifacts fetched from the customer artifact repos through the Connector rather than being pre-copied into Moderne's cloud storage?

Do we still store these artifacts our cloud?

@mike-solomon
Copy link
Copy Markdown
Contributor Author

Closing this PR in favor of a SaaS v2 branch where all of the changes will come in at once: #591

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