| 항목 | 내용 |
|---|
| 기능 ID | FEAT-DIGITAL |
| 연결 시스템 | 마스터 시스템⑪ 디지털자립 · ① 아리 대화(d01) |
| 한 줄 정의 | 키오스크·앱·서류 등 어려운 디지털 작업을 단계 안내하거나 아리가 대신 처리한다 |
| 관련 액터 | PWA실벗서버아리 |
설계 철학 — "못하는 게 아니라 안 알려준 것"입니다. 아리가 천천히·큰 글씨로 한 단계씩 안내하고, 정 어려우면 대신 해드립니다.
▍설계 7계층 체크리스트
| 계층 | 이 문서의 섹션 |
|---|
| ① UI | 대행 요청 / 단계 안내 SCR-DIG-01·02 |
| ② Flow | 요청 → 안내/대행 → 완료 상태 머신 |
| ③ Data | digital_tasks / task_steps |
| ④ API | 대행 요청·진행·완료 엔드포인트 |
| ⑤ Seq | 링크풀이·서류작성 대행 시퀀스 |
| ⑥ Comp | 대행·안내 서비스 구조 |
| ⑦ Test | 검수 체크리스트 |
② Flow · 요청·안내·대행
도움 요청→
작업 분해(steps)→
단계 안내→
완료
/
대행 처리
아리가 요청을 작은 단계(steps)로 분해. 어르신이 한 단계라도 막히면 즉시 대행 모드로 전환해 좌절을 막는다.
③ Data · DB 스키마
MariaDB · UTF8MB4 · InnoDB
CREATE TABLE digital_tasks (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
user_id BIGINT NOT NULL,
category VARCHAR(40), -- 'kiosk','document','app'
title VARCHAR(120),
mode ENUM('guide','proxy') DEFAULT 'guide', -- 안내/대행
status ENUM('open','in_progress','done','escalated') DEFAULT 'open',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE task_steps (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
task_id BIGINT NOT NULL,
ord TINYINT,
instruction VARCHAR(255), -- 한 단계 안내문
done TINYINT DEFAULT 0,
FOREIGN KEY (task_id) REFERENCES digital_tasks(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
설계 포인트 — 한 작업이 여러 task_steps로 분해되어 "한 단계 한 화면" UI를 데이터로 뒷받침한다.
⑥ Comp · 컴포넌트 / 모듈 구조
프론트엔드 (PWA)
features/digital/
├─ HelpRequest.js # 음성/사진 요청
├─ StepGuide.js # 한 단계 한 화면
└─ ProxyStatus.js # 대행 진행
백엔드 (PHP)
app/
├─ Controllers/DigitalController.php
└─ Services/
├─ TaskDecomposer.php # 요청→단계 분해(LLM)
└─ ProxyService.php # 대행 처리·에스컬레이션
| 모듈 | 책임 |
|---|
TaskDecomposer | 복잡한 작업을 어르신이 따라할 수 있는 작은 단계로 분해(d01 DeepSeek 재활용). |
ProxyService | 대행 가능 작업 자동 처리, 불가 시 사람(가족·상담)에게 안전하게 이관. |
⑦ Test · 검수 체크리스트
| ID | 시나리오 | 기대 결과 |
|---|
| T-01 | 음성으로 도움 요청 | 작업 인식 → task_steps 분해 |
| T-02 | 단계 안내 따라가기 | 한 단계 한 화면, TTS 안내, "다음" 진행 |
| T-03 | "어려워요" 탭 | mode=proxy 전환, 좌절 없이 대행 |
| T-04 | 대행 불가 작업 | 가족/상담으로 안전하게 에스컬레이션 |
| T-05 | LLM 작업 인식 실패 | "다시 말씀해 주세요" 폴백, 기록 보존 |
완료 판정 — T-01~T-05 통과 시 FEAT-DIGITAL 완료. T-03(대행 전환)이 디지털 격차 해소의 핵심.
기능설계 ⑪ 완성 — 디지털자립을 7계층으로 설계했습니다. 안내해도 막히면 대신 해드려, 누구도 소외되지 않습니다.