osFoundry / Platform
노트 — 다이어그램
Mermaid 다이어그램이 소스 옆에 실시간으로 표시됩니다. 한쪽에서 편집하고, 다른 쪽에서 렌더링됩니다.
개요
Notes(다이어그램)는 osFoundry의 Notes 안에 있는 Mermaid 작성 화면입니다. Mermaid 다이어그램은 순수 텍스트로 정의되며(플로차트, 시퀀스 다이어그램, 클래스 다이어그램, 상태 머신, ER 다이어그램, 간트 차트), 이 기능은 그 텍스트와 렌더링된 그림을 같은 노트 안에 함께 담아 둡니다. 한쪽에서 소스를 편집하면 다른 쪽에서 다이어그램이 렌더링되므로 정의와 결과가 서로 어긋나는 일이 없습니다.
다이어그램은 내보낸 이미지가 아니라 소스 형태로 저장되기 때문에 노트 텍스트의 일부로 남습니다. diff를 뜨거나, 복사하거나, 에이전트에게 넘기거나, 다른 노트에 붙여넣어도 편집 가능성을 잃지 않습니다. 그 어떤 것도 바꾸려면 다시 그려야 하는 스크린샷으로 납작하게 굳어 버리지 않습니다. 코드에서 화살표 하나만 바꿔도 렌더링이 즉시 반영하며, 바로 이 점이 다이어그램 반복 작업을 번거로운 일이 아니라 빠른 작업으로 만들어 줍니다.
이 기능은 채팅, 에이전트, 앱, 코드, 지식이 한곳을 공유하는 자체 키(BYOK) 방식의 데스크톱 워크스페이스 osFoundry 안에 있습니다. Notes는 로컬 우선이므로 여러분이 스케치한 다이어그램(아키텍처, 프로세스, 데이터 모델 등)은 달리 선택하지 않는 한 여러분의 기기에 남습니다. 또한 osFoundry는 여러분이 자체 키로 가져온 어떤 모델이든 실행하므로, 워크스페이스의 에이전트가 노트 안에서 직접 Mermaid 소스를 작성하거나 수정할 수 있고, 입력이 반영되는 순간 렌더링되는 것을 볼 수 있습니다.
주요 기능
- 노트 안에서 Mermaid 다이어그램을 작성하고 소스는 한쪽, 그림은 다른 쪽에 나란히 렌더링되는 것을 확인합니다
- 다이어그램 코드를 수정하면 입력하는 대로 그림이 다시 렌더링되므로 플로나 시퀀스에 대한 반복 작업이 즉각적입니다
- 다이어그램은 구워 넣은 이미지가 아니라 텍스트 소스로 저장되므로 편집, diff, 복사가 그대로 가능합니다
- Mermaid가 다루는 다이어그램 유형을 지원합니다: 플로차트, 시퀀스, 클래스, 상태, ER, 간트
- 로컬 우선 Notes가 다이어그램 소스를 여러분의 기기에 보관하며, 자체 키로 실행하는 에이전트가 Mermaid를 직접 작성하거나 수정할 수 있습니다
활용 사례
- 엔지니어: 서비스의 요청 흐름을 노트에 Mermaid 시퀀스 다이어그램으로 문서화하고 설계가 바뀔 때마다 소스를 조정한다
- 테크니컬 라이터: 아키텍처 플로차트를 그것을 설명하는 문서와 인라인으로 두고, 이미지를 다시 내보내는 대신 코드를 편집한다
- 팀 리드: 프로젝트 일정을 간트 다이어그램으로 스케치하고, 날짜가 바뀌면 워크스페이스 에이전트에게 Mermaid 소스를 갱신하도록 요청한다
자주 묻는 질문
어떤 Mermaid 다이어그램 유형을 렌더링할 수 있나요?
Mermaid의 표준 집합, 즉 플로차트, 시퀀스 다이어그램, 클래스 다이어그램, 상태 다이어그램, 엔티티-관계 다이어그램, 간트 차트입니다. Mermaid의 텍스트 문법으로 작성하면 노트가 이를 실시간으로 렌더링합니다.
다이어그램은 이미지로 저장되나요, 아니면 편집 가능한 텍스트로 저장되나요?
텍스트로 저장됩니다. Mermaid 소스가 노트 안에 있고 렌더링은 거기서 생성됩니다. 즉 정적 이미지를 다시 그리는 대신 언제든 정의로 돌아가 편집할 수 있으며, 노트를 복사하면 소스도 함께 따라갑니다.
AI 에이전트가 대신 다이어그램을 작성해 줄 수 있나요?
네. osFoundry는 자체 키 방식의 워크스페이스이므로 여러분이 연결한 모델에서 실행되는 에이전트가 노트 안에서 Mermaid 소스를 생성하거나 수정할 수 있습니다. 다이어그램이 소스 텍스트이기 때문에 에이전트가 작성한 내용도 여러분의 편집과 똑같은 방식으로 렌더링됩니다.