← 베이스캠프

공통

대시보드 스프린트별 개발 스프린트별 문서 에이전트별 현황 개발 히스토리 문서보관함 팀 현황

특화

아키텍처 CI/CD & 테스트 스크립트 대시 메이커 (SDK) ⭐ Dash Creator 개발

⚡ DEVELOPMENT · BASECAMP 2

개발

E2E 연결 + 위젯 엔진. 텔레그램 → 폰 홈화면 전체 연결. Team 3 개발팀 이 운영합니다.

🔧 2차 베이스캠프 — 영역 3: E2E 연결 (CTL 주도 · 11명) + ⭐ 영역 1: 위젯 엔진 협력

아키텍처 개요

The Universe는 Dash 5-Layer 구조와 Orchestrator 4-Layer 파이프라인을 중심으로 설계되었습니다. 모든 기능 단위는 .dpk 포맷으로 패키징됩니다.

Dash 5-Layer

각 Dash는 5개의 독립 레이어로 구성되며, 관심사 분리를 통해 유연한 조합과 독립적 진화가 가능합니다.

L1 Meta ID, 버전, 카테고리, 권한 — Dash의 신원 정보

L2 Trigger 활성화 조건 (시간, 위치, 센서, 의도, 이벤트)

L3 Skin UI 렌더링 — 카드, 오버레이, 풀스크린 모드

L4 Skill AI 두뇌 — LLM 추론, API 호출, 데이터 처리

L5 Protocol Dash 간 통신 — Pub/Sub 토픽, 이벤트 버스

Orchestrator 4-Layer 파이프라인

Orchestrator는 사용자 의도를 해석하고 적절한 Dash를 선택, 구성, 실행하는 4단계 파이프라인으로 동작합니다.

P1 Intent 사용자 입력에서 의도(Intent)를 추출

P2 Plan 의도에 맞는 Dash 조합을 계획

P3 Execute 선택된 Dash를 순차/병렬 실행

P4 Reflect 결과 평가 및 학습 피드백 루프

.dpk 포맷

📦 Dash Package (.dpk)

.dpk는 Dash를 배포하기 위한 표준 패키지 포맷입니다. Meta, Trigger, Skin, Skill, Protocol 레이어 정의와 리소스를 하나의 아카이브로 묶어 Dash Store를 통해 배포합니다.

🚀 SPRINT PARTICIPATION

스프린트별 개발

개발팀(Team 3)이 각 스프린트에서 수행하는 주요 개발 항목입니다.

S00 — 런처 전략 확정

런처 Fork 후보 분석 & ADR 작성

Launcher Fork 후보 3종 비교 분석 (Lawnchair, Neo, Kiss)
ADR-001: Compose-Native 결정
프로젝트 스캐폴딩 (Gradle Kotlin DSL)

완료

S01 — Dash 5-Layer 스키마

앱 스켈레톤 & 기본 구조

HomeScreen + DynamicSpace Compose 레이아웃
5-Layer Dash 데이터 클래스 구현
Navigation 설정 & Theme 적용

완료

S02 — 보안 권한 모델 & 접근성

보안 권한 모델 & 접근성 설계

권한 모델 설계 & 접근성 프레임워크
보안 정책 정의 & 적용
접근성 검증 체계 수립

완료

S03 — 자동화 테스트 & CI/CD

테스트 자동화 & CI/CD 파이프라인

자동화 테스트 프레임워크 구축
CI/CD 파이프라인 설계 & 구현
품질 게이트 & 배포 자동화

완료

S04 — 홈 화면 & 앱드로어

홈 화면 & 앱드로어 구현

HomeScreen Compose UI 구현
App Drawer 레이아웃 & 인터랙션
Dynamic Space 초기 연동

완료

S05 — 시각 효과 3-Tier & 디자인 시스템

시각 효과 & Cosmic Design System

3-Tier 시각 효과 체계 구현
AGSL 셰이더 & 모프 애니메이션
Cosmic Design System 토큰 적용

완료

S06 — Space + Dash 컨테이너

Space & Dash 컨테이너 아키텍처

Space 매니저 & Orchestrator 구현
Dash 컨테이너 라이프사이클 관리
DashRegistry & 상태 동기화

완료

S07 — 대시 크리에이터 엔진 + 텔레그램

Dash Creator & 텔레그램 봇

Dash Creator 엔진 구현
텔레그램 봇 통합
E2E 테스트 31건 통과

완료

S08 — 카메라 OCR + QR + Gemini Nano

카메라 OCR & QR & 온디바이스 AI

카메라 OCR & QR 스캐너 구현
Gemini Nano 온디바이스 통합
테스트 8건 통과

완료

S09 — 멀티 메신저 + Dash Creator 웹 + Store

멀티 메신저 & Creator 웹 & Store

멀티 메신저 플랫폼 통합
Dash Creator 웹 버전 구현
Dash Store & 테스트 97건 통과

완료

S10 — 센서 허브 + 맥락 추론 + Seamless Injection

센서 허브 & 맥락 추론 엔진

센서 허브 인터페이스 & 파이프라인
4-Layer 맥락 추론 엔진 구현
Seamless Injection 메커니즘

완료

S11 — Dash 런타임 파서 + .dpk 샌드박스 + DEX 정적 분석

런타임 파서 & 샌드박스 & 정적 분석

Dash 런타임 파서 구현
.dpk 샌드박스 보안 모델
DEX 정적 분석 엔진

완료

S12 — P2P 통신 + 신뢰도 기반 규칙 엔진

P2P 통신 & 신뢰도 규칙 엔진

P2P 메시지 버스 & 프로토콜 설계
신뢰도 기반 규칙 엔진 구현
Orchestrator 연동 & 검증

진행 중

📚 TECH RESEARCH

스프린트별 문서

docs/research/ 하위의 개발 관련 리서치 문서입니다.

기술 리서치

docs/research/ 하위의 개발 관련 리서치 문서입니다.

ARCH Launcher Fork 후보 분석 launcher-fork-candidates.html ARCH CTO 아키텍처 리뷰 cto-architecture-review.html ARCH Compose 실현 가능성 분석 ui-compose-feasibility.html ARCH 런타임 플러그인 리서치 runtime-plugin-research.html INFRA 메시지 버스 통신 리서치 comm-messagebus-research.html INFRA 데이터 스키마 초안 data-schema-draft.html INFRA 백엔드 스토어 설계 backend-store-design.html AI 컨텍스트 ML 옵션 context-ml-options.html DESIGN AGSL 셰이더 리서치 anim-agsl-research.html SECURITY 보안 샌드박스 리서치 security-sandbox-research.html TEST QA 테스트 전략 qa-test-strategy.html

🤖 AGENT STATUS

에이전트별 현황

개발팀 에이전트의 담당 업무와 현재 상태입니다.

CTL 팀장

CTO · Tech Lead

아키텍처 설계, ADR 작성, 기술 의사결정, SDK 인터페이스 설계

RUN

Runtime Engine

Dash 파서, .dpk 로더, 라이프사이클 관리, 샌드박스

LCH

Launcher

홈 화면, 앱드로어, LauncherApps API, 시스템 통합

UI Systems

Compose 컴포넌트, Space 그리드, Dash 컨테이너, 디자인 시스템 구현

COM

Communication

P2P SharedFlow 메시지 버스, Protocol 토픽, 직렬화

CTX

Context Engine

4-Layer 맥락 추론, 센서 허브, 규칙 엔진, Gemini Nano

ANI

Animation Dev

Dash 모프 애니메이션, Spring 전환, AGSL 셰이더

DAT

Data

Room DB 스키마, 영속화, Space/Dash 배치 데이터

BKE

Backend

Store REST API, CDN, Smart Split 수익 분배

UZV T3

UZ Developer

UZ 사이트 프론트엔드 구현

AIE NEW

AI Engineer

Gemini Nano 온디바이스 통합, ML 파이프라인

DVO NEW

DevOps

CI/CD 파이프라인, 빌드 자동화, 배포 인프라

SDK

SDK Engineer

Dash SDK API 설계, 개발자 도구, 문서화

📋 DECISION RECORDS

개발 히스토리

주요 아키텍처 결정 사항을 기록하고 추적합니다.

ADR (Architecture Decision Records)

주요 아키텍처 결정 사항을 기록하고 추적합니다. 각 ADR은 결정의 배경, 선택지, 결과를 문서화합니다.

📋 ADR-001: Compose-Native 결정

The Universe의 UI 프레임워크로 Jetpack Compose를 선택한 배경과 근거를 기록합니다. XML View 시스템 대비 선언적 UI, 코드 생산성, AI 코드 생성 호환성 등을 종합 평가하였습니다.

ADR-001 원문 보기

🗃 ARCHIVE

문서보관함

코드 구조, 기술 스택 등 개발 참조 문서를 보관합니다.

코드 구조

Kotlin 파일이 8개의 패키지로 구성됩니다. 각 패키지는 명확한 책임을 가지며 의존 관계가 정의되어 있습니다.

app/src/main/java/com/theuniverse/ ├── dash/ // Dash 정의 및 라이프사이클 │ ├── DashMeta.kt │ ├── DashTrigger.kt │ ├── DashSkin.kt │ ├── DashSkill.kt │ └── DashProtocol.kt ├── home/ // 홈 화면 및 Dynamic Space │ ├── HomeScreen.kt │ ├── HomeViewModel.kt │ └── DynamicSpace.kt ├── space/ // Space 관리 및 Orchestrator │ ├── SpaceManager.kt │ ├── Orchestrator.kt │ ├── IntentParser.kt │ └── DashRegistry.kt ├── ui/ // 공통 UI 컴포넌트 및 테마 │ ├── Theme.kt │ ├── CosmicComponents.kt │ ├── Animations.kt │ ├── Navigation.kt │ └── Typography.kt ├── context/ │ ├── sensor/ // 센서 허브 & 데이터 수집 │ ├── engine/ // 맥락 추론 엔진 │ └── injection/ // Seamless Injection └── runtime/ // Dash 런타임 파서 & .dpk 샌드박스

패키지 의존 관계

ui/ ← home/ ← space/ ← dash/ ← runtime/

context/(sensor, engine, injection) → space/ → dash/

모든 패키지는 ui/에 의존하며, dash/는 독립적으로 동작합니다. space/는 Orchestrator를 통해 dash/를 관리합니다. context/는 센서 데이터를 수집하여 맥락을 추론하고, runtime/은 .dpk 파싱 및 샌드박스를 담당합니다.

기술 스택

The Universe의 핵심 기술 스택과 버전 정보입니다.

기술	버전	용도
`Kotlin`	2.2.10	주 개발 언어
`Jetpack Compose`	BOM 기반	선언적 UI 프레임워크
`AGP`	9.1.0	Android Gradle Plugin
`compileSdk`	36	컴파일 타겟 SDK
`minSdk`	26	최소 지원 SDK (Android 8.0)
`Gradle`	Kotlin DSL	빌드 시스템
`Maestro`	-	E2E 테스트 자동화

👥 TEAM STATUS

팀 현황

Team 3 개발팀 의 역할과 담당 영역입니다.

개발팀 현황 — Team 3 ()

핵심 미션: Dash Runtime + SDK + 인프라를 설계·구현하여 개발자가 Dash를 만들 수 있게 한다.

CTL 팀장

CTO · Tech Lead

아키텍처 설계, ADR 작성, 기술 의사결정, SDK 인터페이스 설계

RUN

Runtime Engine

Dash 파서, .dpk 로더, 라이프사이클 관리, 샌드박스

LCH

Launcher

홈 화면, 앱드로어, LauncherApps API, 시스템 통합

UI

UI Systems

Compose 컴포넌트, Space 그리드, Dash 컨테이너, 디자인 시스템 구현

COM

Communication

P2P SharedFlow 메시지 버스, Protocol 토픽, 직렬화

CTX

Context Engine

4-Layer 맥락 추론, 센서 허브, 규칙 엔진, Gemini Nano

ANI

Animation Dev

Dash 모프 애니메이션, Spring 전환, AGSL 셰이더

DAT

Data

Room DB 스키마, 영속화, Space/Dash 배치 데이터

BKE

Backend

Store REST API, CDN, Smart Split 수익 분배

UZV T3

UZ Developer

UZ 사이트 프론트엔드 구현

AIE NEW

AI Engineer

Gemini Nano 온디바이스 통합, ML 파이프라인

DVO NEW

DevOps

CI/CD 파이프라인, 빌드 자동화, 배포 인프라

🛠 ARCHITECTURE DETAIL

아키텍처

Dash 5-Layer 구조와 Orchestrator 4-Layer 파이프라인의 상세 설계입니다.

Dash 5-Layer 상세

각 Dash는 5개의 독립 레이어로 구성되며, 관심사 분리를 통해 유연한 조합과 독립적 진화가 가능합니다.

L1 Meta ID, 버전, 카테고리, 권한 — Dash의 신원 정보

L2 Trigger 활성화 조건 (시간, 위치, 센서, 의도, 이벤트)

L3 Skin UI 렌더링 — 카드, 오버레이, 풀스크린 모드

L4 Skill AI 두뇌 — LLM 추론, API 호출, 데이터 처리

L5 Protocol Dash 간 통신 — Pub/Sub 토픽, 이벤트 버스

Orchestrator 4-Layer 파이프라인

Orchestrator는 사용자 의도를 해석하고 적절한 Dash를 선택, 구성, 실행하는 4단계 파이프라인으로 동작합니다.

P1 Intent 사용자 입력에서 의도(Intent)를 추출

P2 Plan 의도에 맞는 Dash 조합을 계획

P3 Execute 선택된 Dash를 순차/병렬 실행

P4 Reflect 결과 평가 및 학습 피드백 루프

.dpk 포맷

📦 Dash Package (.dpk)

⚙ INFRASTRUCTURE

CI/CD & 테스트

빌드 시스템, CI/CD 파이프라인, 테스트 자동화 인프라입니다.

CI/CD

GitHub Actions 기반 CI/CD 파이프라인으로 빌드, 테스트, 배포를 자동화합니다.

⚙ GitHub Actions Workflow

Android CI 워크플로우가 PR 및 main 브랜치 push 시 자동으로 실행됩니다.

Lint 검사 및 정적 분석
Unit 테스트 실행
Debug/Release APK 빌드
Maestro E2E 테스트 (에뮬레이터)

android-ci.yml 보기

빌드 시스템

Gradle Kotlin DSL 기반의 빌드 구성입니다.

📦 빌드 구성 파일

build.gradle.kts — 루트 프로젝트 빌드 설정
app/build.gradle.kts — 앱 모듈 빌드 설정
settings.gradle.kts — 프로젝트 구조 및 저장소 설정
gradle.properties — Gradle 프로퍼티

테스트

Maestro를 활용한 E2E 테스트 플로우입니다. maestro/flows/ 디렉토리에 YAML 형식으로 정의됩니다.

플로우	설명
`app-launch.yaml`	앱 최초 실행 및 초기화 검증
`gesture-smoke.yaml`	제스처 인터랙션 스모크 테스트
`scenario-commute.yaml`	출퇴근 시나리오 통합 테스트

🎯 테스트 실행

로컬 환경에서 Maestro 테스트를 실행하려면:

# 에뮬레이터 기반 전체 테스트
$ ./scripts/run-emulator-tests.sh

# 개별 플로우 실행
$ maestro test maestro/flows/app-launch.yaml
          

📝 SCRIPTS

스크립트

scripts/ 디렉토리의 자동화 스크립트입니다.

스크립트

scripts/ 디렉토리의 자동화 스크립트입니다.

스크립트	설명
`validate-dash.sh`	Dash 정의 파일의 유효성 검증
`run-emulator-tests.sh`	에뮬레이터 기반 E2E 테스트 실행
`pm-notify.sh`	PM 알림 전송 (빌드/테스트 결과)
`simulation/`	Dash 시뮬레이션 환경 스크립트