SoC TaskManager Framework
DeviceAgent의 이동·청정·화면·TTS·보안·예약 기능을 바꾸지 않고, 그 앞에 공통 Task 실행 계약을 둔다. 요청 출처와 관계없이 접수, 실행 허용, 순서, 상태, 취소, 실패와 실제 완료 증거를 같은 방식으로 관리하는 SKIX namuh Product Framework 영역이다.
시작점
| 목적 | 문서 | 범위 |
|---|---|---|
| 전체 사양 확인 | TaskManager 기준 사양서 | 허브에서 역할별 경로를 선택하고 주제별 상세 사양으로 이동 |
| 개념과 도입 효과 이해 | AS-IS / TO-BE 가이드 | 기존 직접 호출 구조와 Task 기반 구조의 차이 |
| 발표·공유 | TaskManager 핵심 설명 자료 | 구조와 대표 실행 흐름의 압축본 |
세 문서를 모두 읽을 필요는 없다. 처음 접할 때는 가이드, 구현 판단에는 기준 사양서 허브, 짧은 공유에는 설명 자료를 사용한다.
사양 바로가기
기준 사양서는 한 페이지를 길게 스크롤하는 방식 대신 다음 여덟 범위로 나뉜다. 장 번호와 규범 ID는 유지되므로 기존 링크와 검토 기록도 계속 사용할 수 있다.
| 범위 | 확인할 내용 |
|---|---|
| 1. 개념과 아키텍처 | 책임 경계, AOSP·SKIX namuh 내 위치, Core 구성요소 |
| 2. 요청, API와 실행 정책 | ingress, 공개 API, 기본값, admission과 기기 정책 |
| 3. 생명주기와 Workflow | Task 상태, queue, Workflow, 완료 증거, 취소, 예약 |
| 4. 도메인 기능과 기기 컨텍스트 | 기존 기능 실행기 연결과 계획용 상태 계약 |
| 5. 외부 연동과 기존 시스템 호환 | AAR, IoT/MQTT, 선택적 Planner와 점진 전환 |
| 6. 운영, 보안과 검증 | 관측성, 실패 UX, 보안, 실기기 인수와 변경 절차 |
| 7. Core와 Task 규범 | Core 불변 조건, 장기 세션과 도메인별 Task 규범 |
| 8. 적합성, 용어와 설계 근거 | 요구사항 ID, 적합성 단계, 용어와 설계 참조 |
분할 전 전체 사양 보존본은 전체 문구를 한 파일에서 검색해야 할 때만 사용한다.
업무별 문서
| 업무 | 기준 문서 |
|---|---|
| DeviceAgent 구현과 기능 편입 | Source-Level Implementation Guide |
| 시스템 앱용 typed API | TaskManagerClient AAR API |
| DeviceAgent control·event·reason 계약 | DeviceAgent API Contract |
| IoT/MQTT 요청과 callback | MQTT Task Contract |
| 예약·지연 실행과 출시 기준 | Scheduling Runtime Readiness |
| 기기 상태를 이용한 계획 | Device Context Planning Spec |
| capability와 실행 조합 | Capability Composition Catalog |
| Cloud·On-device·DeviceAgent 폐루프 | Voice TaskManager Closed Loop |
| 운영 관찰과 실기기 검증 | TaskManager Live Monitor |
| PUI·Voice 기능 경계 | PUI and Voice Task Design Hub |
| LLM/MCP capability 표현 | TaskManager LLM/MCP Mapping |
| 업체 구현과 인수 | Vendor Implementation Workbook |
구조 요약
TaskManager가 소유하는 것은 구조화된 요청 이후의 실행 관리다.
| 계층 | 책임 |
|---|---|
| 호출자·제품 시나리오·선택적 Planner | 목적 해석, 기능 선택, Task 또는 Workflow 구성 |
| TaskManager Core | 검증, admission, queue, 순서, timeout, retry, 취소, terminal 상태 |
| 기기 도메인 | 이동·청정·보안·화면·TTS 등 실제 기능 수행 |
| Evidence Adapter | 물리 완료·실패·사용자 취소 신호를 공통 Task event로 변환 |
| UI·관제 | 진행 상태, 실패 이유, 후속 선택을 사용자와 운영자에게 표시 |
TaskManager는 자연어를 해석하거나 기존 기기 기능을 재구현하지 않는다. AOSP frameworks/base의 SystemService도 아니다. 시스템 특권 앱 내부에서 공통 제품 실행 API 역할을 하며, 기존 직접 호출 경로와 점진적으로 공존한다.
구현 기준
기준 소스는 다음 영역이다.
/home/silogood/work/1.A1_SoC_new/SoC/a1-packages-mr6/apps/DeviceAgent
핵심 구성은 MainApi 공통 진입점, TaskManager, validator와 policy registry, queue와 workflow runtime, executor registry, completion bridge, event·reason contract, planning context provider다. 클래스별 연결과 변경 절차는 Source-Level Implementation Guide에만 유지한다.
문서 관리 원칙
- 규범은 기준 사양서 허브가 연결하는 여덟 상세 사양에 한 번만 정의한다.
- 소스 경로와 구현 절차는 구현 가이드에만 둔다.
- 외부 payload는 AAR, DeviceAgent API, MQTT 계약 문서로 분리한다.
- 실기기 결과와 release gate는 readiness·monitor 문서에만 둔다.
- 통합된 이전 문서는 기존 URL을 유지하되 활성 검색에서 제외한다.
원문 보존본과 통합 매핑은 저장소의 archive/taskmanager-docs-2026-08-12/와 ops/wiki-deployment/taskmanager-doc-consolidation.tsv에서 확인할 수 있다.