Orbit · 가이드 · Chapter 05
Atlas
조직의 오늘을 보여주는 운영 지도
Atlas는 현황, 요청, 프로젝트, 주간보고서를 하나의 업무 surface에서 읽게 합니다.
Section 01
Atlas가 보여주는 것
Orbit에서 Atlas는 사용자가 매일 마주하는 실제 프론트엔드 surface입니다. 조직의 업무 현황, 들어온 요청, 프로젝트 흐름, 주간 보고서 — 이 네 가지를 탭으로 오가며 읽는 곳입니다. 화면은 하나지만, 그 아래에는 Field·Dictionary·Trace·Protocol이라는 기준 layer가 깔려 있습니다.
그래서 Atlas가 노리는 것은 "예쁜 대시보드"가 아닙니다. 보통의 대시보드는 흩어진 숫자를 한곳에 모아 보여줄 뿐, 그 숫자가 무엇을 기준으로 계산됐는지는 말하지 않습니다. Atlas는 반대 방향으로 설계됐습니다. 모든 상태가 합의된 기준 위에서 계산되고, 왜 그렇게 보이는지의 근거까지 함께 따라옵니다.
Atlas는 새로운 사실을 만들지 않습니다. 이미 정해진 기준 위에서, 지금 업무가 어디까지 왔는지를 읽을 뿐입니다.
— Orbit 설계 원칙Section 02
기준 위에서 읽힌다
Atlas 화면의 어떤 칸도 자기 데이터를 따로 들고 있지 않습니다. 네 개의 기준 layer에서 현재 상태를 끌어와 조합해 보여줄 뿐입니다. 같은 "지연된 업무"라도, 무엇 때문에 지연인지는 이 layer들이 결정합니다.
| 기준 Layer | Atlas가 읽어오는 것 |
|---|---|
| Field | 업무가 지금 어느 단계·상태에 있는가 |
| Dictionary | 그 상태를 어떤 이름·기준으로 부를 것인가 |
| Trace | 그렇게 판단한 근거가 무엇인가 |
| Protocol | 누가 무엇을 보고 실행할 수 있는가의 경계 |
그래서 네 layer가 끊기면 Atlas도 빈 화면이 됩니다. 화면의 풍부함은 Atlas가 잘 그려서가 아니라, 그 아래 기준이 살아 있기 때문에 나옵니다. Atlas를 고치는 일은 대개 화면이 아니라, 그 아래 기준을 고치는 일입니다.
Section 03
네 가지 탭
Atlas는 운영 상태를 네 가지 탭으로 나눠 읽습니다. 각 탭은 "지금 무엇을 알아야 하는가"라는 서로 다른 질문에 답합니다.
| 탭 | 답하는 질문 | 주로 읽는 기준 |
|---|---|---|
| 현황 | 지금 팀과 업무는 어떻게 흐르고 있나 | Field · Trace |
| 요청 | 들어온 요청이 어떤 업무로 이어지나 | Field · Dictionary |
| 프로젝트 | 프로젝트 상태와 담당이 어디서 막혔나 | Field · Protocol |
| 주간 보고서 | 이번 주, 무엇을 누구에게 보고할 것인가 | 네 기준 전부 |
현황 탭은 실제 API와 fallback state를 갖고 팀·업무 흐름의 live summary를 읽습니다. 요청과 프로젝트 탭은 그래프형 surface로 흐름을 펼쳐 보여주고, 주간 보고서 탭은 팀 선택부터 보고서 preview, 섹션 이동, graph render, 발송까지를 한 화면에 묶습니다.
Section 04
한 화면의 구조
Atlas 글에서는 코드를 나열하지 않습니다. 대신 실제 현황 탭의 구조를 그대로 가져와, 조직 원반·팀별 severity ring·사람과 업무의 연결·FieldScene3D 운영 장면이 한 무대 안에서 함께 보이도록 구성합니다.
핵심은 이 요소들이 각자 따로 노는 위젯이 아니라는 점입니다. 조직 원반 위의 한 점을 누르면, 그 사람과 이어진 업무가, 그 업무가 걸려 있는 Field가, 그 Field의 현재 단계가 같은 장면 안에서 이어집니다. 화면을 "탭의 모음"이 아니라 "하나로 이어진 운영 지형"으로 읽게 만드는 것이 Atlas surface의 의도입니다.
Section 05
공개 페이지의 표현 수위
Atlas는 고객이 제품을 가장 먼저 체감하는 surface이므로, Guide에서도 화면을 크게 보여주는 편이 맞습니다. 다만 보여주는 것과 넘겨주는 것은 다릅니다.
UI와 운영 원리는 보여주되, 복제 가능한 구현 레시피는 남기지 않습니다. API payload, tenant 권한 처리, report generation 내부 로직, fallback 판단 순서는 공개 페이지에 싣지 않습니다. 사용자가 "무엇을 보는가"는 그대로, "어떻게 만들었는가"는 제품 안에서만.
Section 06
Atlas가 아닌 것
Atlas는 기준을 정하는 곳이 아닙니다. 기준은 Field·Dictionary·Protocol에서 정해지고, Atlas는 그 위에서 읽기만 합니다. 화면에서 무언가 잘못 보인다면, 대개 Atlas의 문제가 아니라 그 아래 기준이 비어 있거나 어긋난 것입니다.
Atlas는 또한 기록의 원본이 아닙니다. 화면의 요약은 Trace의 근거를 가리키는 창일 뿐, 그 자체가 원장(原帳)은 아닙니다. 그래서 "화면에 그렇게 떴으니 사실"이라는 판단은 Orbit에서 성립하지 않습니다 — 사실은 언제나 그 아래 근거에 있습니다.