SETUP GUIDE

센터 시트 연결
설명서

구글 시트 한 장으로 센터의 숙제와 결과를 자동으로 모으는 방법입니다. 한 번만 하면 그 뒤로는 손댈 일이 없습니다.

⏱️ 10분 💰 비용 0원 🖨️ 인쇄 가능

이 설명서의 구성

1시트 만들기표를 만들고 코드를 붙여 배포해서 주소를 받습니다 2앱에 주소 넣기첫 기기는 붙여넣기, 둘째 기기부터는 링크 한 번 3선생님 등록과 사용패드 한 대를 여러 선생님이 나눠 쓰는 방법 4무엇이 어떻게 오가는가시트에 적히는 내용과 개인정보 5문제 해결연결이 안 될 때 확인할 것

시트 만들기

'구글 시트'는 구글이 무료로 주는 엑셀입니다. 이 표가 센터의 숙제 공책이 됩니다. 미숙님 구글 계정 하나만 있으면 되고, 선생님들과 보호자는 계정이 필요 없습니다.

✅ 미리 알아두실 것

이 작업은 센터 전체에 딱 한 번입니다. 패드가 2대든 10대든 시트는 한 장이고, 새 패드에는 나중에 나오는 주소만 넣으면 됩니다.

💻 컴퓨터에서 하세요

1장(시트 만들기)은 반드시 컴퓨터에서 하시는 게 좋습니다. 패드·휴대폰에서는 Apps Script 화면이 제대로 열리지 않습니다. 2장(앱에 주소 넣기)부터는 패드에서 하시면 됩니다.

준비물: 미숙님 구글 계정(지메일 주소) 하나. 그것뿐입니다.

1.1 표 하나 만들기

인터넷 브라우저를 엽니다

크롬(🔴🟡🟢 동그란 아이콘)이나 엣지를 엽니다. 맨 위 흰 주소창에 sheets.new 라고 적고 엔터를 누릅니다.

검색창이 아니라 맨 위 주소창입니다. sheets.new 는 '새 표 하나 만들어라'는 뜻의 구글 전용 줄임 주소입니다. 점(.)까지 그대로 적으세요.

구글 계정으로 로그인합니다

로그인 화면이 나오면 미숙님 지메일 주소와 비밀번호를 넣습니다. 이미 로그인돼 있으면 이 화면은 건너뜁니다.

계정이 여러 개면 센터 일에 쓰실 계정을 고르세요. 나중에 시트를 찾으려면 그 계정으로 들어가야 합니다.

빈 표가 열립니다

A·B·C… 칸이 있는 빈 표가 나옵니다. 아무것도 적지 마세요. 칸 이름은 뒤에 붙일 코드가 알아서 만듭니다.

표 이름을 정합니다

왼쪽 맨 위에 회색으로 제목 없는 스프레드시트 라고 적혀 있습니다. 그 글자를 한 번 클릭하면 고칠 수 있게 됩니다. 핑퐁ABA 센터 숙제 라고 적고 엔터.

이름은 아무거나 괜찮습니다. 나중에 [연결 확인]을 누르면 이 이름이 화면에 나오니, 맞게 연결됐는지 알아보기 쉬운 이름으로 하세요.

저장은 하지 않아도 됩니다

구글 시트는 적는 순간 자동으로 저장됩니다. 저장 버튼을 찾지 않으셔도 됩니다. 이 탭은 닫지 말고 그대로 두세요.

1.2 코드 붙여넣기

'코드'는 이 표가 앱의 결과를 받아 적을 수 있게 해주는 글입니다. 아래 1.4 붙여넣을 코드에 전문이 있고 복사 버튼도 있습니다. 무슨 뜻인지 아실 필요는 없고, 통째로 옮기기만 하면 됩니다.

먼저 코드를 복사해 둡니다

이 설명서의 1.4 붙여넣을 코드로 내려가 📋 코드 전체 복사 버튼을 누릅니다. 복사했습니다 라고 초록 글씨가 나오면 됩니다.

버튼이 안 되면 코드 칸을 클릭한 뒤 Ctrl + A(전체 선택) → Ctrl + C(복사) 하셔도 같습니다.

시트 탭으로 돌아갑니다

아까 만든 핑퐁ABA 센터 숙제 표 탭으로 갑니다.

위쪽 메뉴 [확장 프로그램]을 누릅니다

표 위쪽에 파일 · 수정 · 보기 · 삽입 · 서식 · 데이터 · 도구 · 확장 프로그램 · 도움말 이 한 줄로 있습니다. 그중 확장 프로그램을 누릅니다.

화면이 좁아 메뉴가 안 보이면 창을 최대화하세요. 그래도 없으면 메뉴 끝의 ⋯ 안에 들어 있습니다.

[Apps Script]를 누릅니다

내려온 목록 맨 위쯤에 Apps Script 가 있습니다. 누르면 새 탭이 열립니다.

새 탭에 뭐가 보이는지 확인합니다

왼쪽에 <> 편집기 같은 메뉴가 있고, 가운데 흰 칸에 이렇게 세 줄이 적혀 있습니다.

function myFunction() {
}

이 화면이 맞습니다. 여기까지 오셨으면 거의 끝났습니다.

있던 세 줄을 전부 지웁니다

그 코드 칸 안을 한 번 클릭한 뒤 Ctrl + A(맥은 ⌘+A)를 누릅니다. 글자 전체가 파랗게 선택됩니다. 그 상태에서 Delete 또는 Backspace를 눌러 지웁니다. 칸이 완전히 비어야 합니다.

이 세 줄은 구글이 넣어둔 견본입니다. 지워도 아무 문제 없습니다. 남겨두면 오류가 납니다.

복사한 코드를 붙여넣습니다

빈 칸에 Ctrl + V(맥은 ⌘+V). 글이 아주 길게 쭉 들어갑니다. 맨 윗줄이 /** 로, 맨 아랫줄이 } 로 끝나면 제대로 들어간 것입니다.

빨간 밑줄이나 노란 표시가 몇 개 보여도 괜찮습니다. 구글 편집기가 참견하는 것일 뿐 동작에는 상관없습니다.

저장합니다 — 이건 꼭 눌러야 합니다

코드 칸 위쪽 줄에 있는 💾 저장 아이콘(플로피 디스크 모양)을 누릅니다. 또는 Ctrl + S.

저장하지 않고 다음으로 넘어가면 배포할 때 빈 코드가 나갑니다. 저장하면 위쪽 '프로젝트 저장 중' 표시가 잠깐 나타나고 사라집니다.

(물어보면) 프로젝트 이름을 적습니다

이름을 물으면 핑퐁ABA 숙제받기 처럼 아무거나 적고 이름 바꾸기. 안 물어보면 넘어가세요.

1.3 배포하고 주소 받기

'배포'는 이 표를 인터넷에서 결과를 받을 수 있는 상태로 켜는 것입니다. 여기서 나오는 주소 한 줄이 앱에 넣을 전부입니다. 이 설명서에서 가장 중요한 부분이고, 잘못되는 곳도 여기 한 군데뿐입니다.

오른쪽 위 파란 [배포] 버튼을 누릅니다

Apps Script 화면 오른쪽 맨 위에 파란 배포 버튼이 있습니다. (그 옆에는 ▷실행, 🐞디버그 같은 것들이 있습니다.)

[새 배포]를 누릅니다

내려온 목록에서 새 배포. (아래에 '배포 관리', '테스트 배포'도 있는데 지금은 새 배포입니다.)

창 왼쪽 위 톱니바퀴 ⚙️ 를 누릅니다

'새 배포' 창이 열립니다. 왼쪽 위에 ⚙️ (유형 선택) 이라고 톱니바퀴가 있습니다. 그것을 누르면 웹 앱 / API 실행 파일 / 부가기능 같은 목록이 나옵니다.

[웹 앱]을 고릅니다

웹 앱을 누릅니다. 그러면 창 가운데에 설명·실행·액세스 칸이 나타납니다.

이걸 안 고르면 아래 두 칸이 아예 나오지 않습니다. 칸이 안 보이면 톱니바퀴를 다시 눌러 웹 앱을 고르세요.

[설명] 칸 — 비워도 됩니다

'새 설명' 칸에는 1차 배포 처럼 아무거나 적거나 비워두셔도 됩니다. 동작에 상관없습니다.

★[다음 사용자로 실행] — 나

보통 이미 나 (내 이메일주소) 로 되어 있습니다. 그대로 두세요.

'나'여야 시트에 적을 권한이 미숙님 계정으로 붙습니다. 보호자는 구글 계정이 필요 없게 되는 이유가 이것입니다.

★★[액세스 권한이 있는 사람] — 모든 사용자

기본값은 보통 나만 입니다. 반드시 모든 사용자로 바꿔야 합니다. 그 칸을 누르면 나만 / 같은 도메인 사용자 / Google 계정이 있는 모든 사용자 / 모든 사용자 가 나옵니다. 맨 아래 모든 사용자를 고르세요.

여기가 거의 모든 실패의 원인입니다. '나만'이면 미숙님 패드에서는 되는데 보호자 휴대폰에서 결과가 안 올라옵니다. 'Google 계정이 있는 모든 사용자'도 안 됩니다 — 보호자에게 구글 로그인을 요구하게 됩니다.

오른쪽 아래 [배포]를 누릅니다

파란 배포 버튼을 누릅니다.

권한을 승인합니다 — 처음 한 번만

액세스 승인 버튼이 나오면 누릅니다. 계정을 고르는 창이 뜨면 미숙님 계정을 고릅니다.

구글 경고 화면을 통과합니다

"Google에서 확인하지 않은 앱" 이라는 회색 경고가 나옵니다. 당황하지 마세요. 순서는 이렇습니다.

왼쪽 아래 작은 글씨 고급 을 누릅니다
맨 아래 (프로젝트 이름)(으)로 이동(안전하지 않음) 을 누릅니다
권한 목록이 나오면 허용 을 누릅니다

이 경고는 '미숙님이 직접 만든 코드라 구글이 아직 심사하지 않았다'는 뜻입니다. 남이 만든 앱을 허락하는 게 아니라 본인 코드에 본인이 권한을 주는 것이니 안전합니다.

★주소를 복사합니다

배포가 업데이트되었습니다 창이 나오고 웹 앱 아래에 긴 URL 한 줄이 보입니다. 그 아래 복사 를 누릅니다.

모양은 이렇습니다.

https://script.google.com/macros/s/AKfycb…아주긴글자…/exec

/exec 로 끝나야 합니다. /dev 로 끝나는 주소는 미숙님만 쓸 수 있어서 보호자 기기에서 동작하지 않습니다.

주소를 카카오톡 '나에게 보내기'로 보내둡니다

컴퓨터 카카오톡에서 본인 채팅방(나와의 채팅)에 그 주소를 붙여넣어 보냅니다. 그러면 패드·휴대폰에서 길게 눌러 복사할 수 있습니다.

이 주소는 센터에 하나뿐입니다. 기기가 늘어도 같은 주소를 씁니다. 지워지지 않게 보관하세요.

[완료]를 눌러 창을 닫습니다

1장은 여기서 끝입니다. 이 작업은 센터 전체에 한 번이고 다시 할 일이 없습니다.

⚠️ 주소를 잃어버렸을 때

시트를 열고 확장 프로그램 → Apps Script → 배포 → 배포 관리에서 다시 볼 수 있습니다. 오른쪽에 웹 앱 URL과 복사 버튼이 있습니다.

[새 배포]를 다시 누르지 마세요. 주소가 새로 생기고, 예전 주소를 넣어둔 기기는 연결이 끊깁니다.

1.4 붙여넣을 코드 (전문)

아래 버튼을 누르면 전체가 복사됩니다. Apps Script 화면에 이것만 붙여넣으시면 됩니다 (1.2 참고).

sheet-code.gs — 구글 시트용 코드

복사했습니다 ✓

/**
 * 핑퐁ABA 숙제 결과 받기 — 구글 시트용 코드
 *
 * 쓰는 법
 *  1. 구글 드라이브에서 새 스프레드시트를 하나 만듭니다 (이름 예: 핑퐁ABA 센터 숙제)
 *  2. 메뉴 [확장 프로그램] → [Apps Script] 를 엽니다
 *  3. 화면에 있던 내용을 모두 지우고 이 파일 전체를 붙여넣습니다
 *  4. 저장(💾) → [배포] → [새 배포] → 유형 [웹 앱]
 *     - 다음 사용자로 실행 : 나
 *     - 액세스 권한이 있는 사용자 : 모든 사용자   ← 꼭 이걸로
 *  5. 나온 주소(.../exec)를 앱의 [선생님 · 센터] → [☁️ 결과 자동 받기] 칸에 붙여넣습니다
 *
 * 이 코드가 하는 일
 *  - 선생님이 숙제를 내면 시트에 한 줄이 생깁니다 (아직 안 함)
 *  - 아이가 숙제를 끝내면 그 줄이 결과로 채워집니다
 *  - 선생님이 앱에서 [숙제 검사]를 열면 그 줄을 불러옵니다
 */

var SHEET_NAME = '숙제';
var HEAD = ['낸날짜', '센터', '선생님', '연락처', '아이', '숙제코드', '내준횟수',
            '숙제내용', '상태', '한횟수', '회기', '시행', '정답', '정반응률',
            '마지막한날짜', '상세기록', '숙제링크'];

function sheet_() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sh = ss.getSheetByName(SHEET_NAME);
  if (!sh) {
    sh = ss.insertSheet(SHEET_NAME);
  }
  if (sh.getLastRow() === 0) {
    sh.getRange(1, 1, 1, HEAD.length).setValues([HEAD]);
    sh.getRange(1, 1, 1, HEAD.length).setFontWeight('bold').setBackground('#e8f0fe');
    sh.setFrozenRows(1);
    sh.setColumnWidth(HEAD.indexOf('상세기록') + 1, 60);
    sh.setColumnWidth(HEAD.indexOf('숙제링크') + 1, 60);
  } else {
    // 예전 버전에서 만든 시트에 칸이 새로 늘어난 경우 머리글을 맞춰준다
    var cur = sh.getRange(1, 1, 1, sh.getLastColumn()).getValues()[0];
    if (cur.length < HEAD.length) {
      sh.getRange(1, 1, 1, HEAD.length).setValues([HEAD]);
      sh.getRange(1, 1, 1, HEAD.length).setFontWeight('bold').setBackground('#e8f0fe');
    }
  }
  return sh;
}

function findRow_(sh, code) {
  var col = HEAD.indexOf('숙제코드') + 1;
  var last = sh.getLastRow();
  if (last < 2) return 0;
  var vals = sh.getRange(2, col, last - 1, 1).getValues();
  for (var i = 0; i < vals.length; i++) {
    if (String(vals[i][0]).trim().toUpperCase() === String(code).trim().toUpperCase()) {
      return i + 2;
    }
  }
  return 0;
}

function rowToObj_(sh, r) {
  var v = sh.getRange(r, 1, 1, HEAD.length).getValues()[0];
  var o = {};
  HEAD.forEach(function (h, i) { o[h] = v[i]; });
  var state = String(o['상태'] || '');
  return {
    code: o['숙제코드'],
    centerNm: o['센터'],
    teacherName: o['선생님'],
    teacherContact: o['연락처'],
    childName: o['아이'],
    need: o['내준횟수'],
    partLabels: String(o['숙제내용'] || '').split(' / ').filter(String),
    complete: state === '완료' ? true : (state === '미완료' ? false : null),
    doneN: o['한횟수'],
    sessionCount: o['회기'],
    trials: o['시행'],
    correct: o['정답'],
    rate: o['정반응률'],
    doneAt: o['마지막한날짜'] ? new Date(o['마지막한날짜']).toISOString() : '',
    data: o['상세기록'] || '',
    link: o['숙제링크'] || '',
    assignedAt: o['낸날짜'] ? new Date(o['낸날짜']).toISOString() : ''
  };
}

// ★점검용으로 만든 줄은 목록에 보이지 않게 한다 — 선생님이 손으로 지우지 않아도 되게. (2026-09-13)
var TEST_CHILDREN = ['점검용아이', '테스트', '연결시험', '코스시험', '코스시험2'];
var TEST_CODES = ['HWVERCHK1', 'HWDATECHK', 'HWLIVEHDD', 'HWPROBE1', 'HWPROBE2',
                  'HWTEST99', 'HWTEST0', 'HWCORS1', 'HWCORS2'];
function isTestRow_(o) {
  if (!o) return false;
  if (TEST_CHILDREN.indexOf(String(o.childName || '').trim()) >= 0) return true;
  if (TEST_CODES.indexOf(String(o.code || '').trim().toUpperCase()) >= 0) return true;
  return false;
}

function json_(obj) {
  return ContentService.createTextOutput(JSON.stringify(obj))
    .setMimeType(ContentService.MimeType.JSON);
}

/** 앱이 읽을 때 (연결 확인 / 목록 / 한 건 조회) */
function doGet(e) {
  var p = (e && e.parameter) || {};
  var sh = sheet_();
  var action = p.action || 'ping';

  if (action === 'ping') {
    var ss0 = SpreadsheetApp.getActiveSpreadsheet();
    // ★시트 주소도 함께 알려준다 — 나중에 시트를 찾을 때 앱에서 바로 열 수 있다
    return json_({ ok: true, sheet: ss0.getName(), sheetUrl: ss0.getUrl(),
                   rows: Math.max(0, sh.getLastRow() - 1) });
  }

  if (action === 'get') {
    var r = findRow_(sh, p.code || '');
    return json_({ ok: true, row: r ? rowToObj_(sh, r) : null });
  }

  // 패드에서 숙제 코드만 넣어 링크를 받아간다 (카카오톡 없이 숙제를 여는 길)
  if (action === 'link') {
    var lr = findRow_(sh, p.code || '');
    if (!lr) return json_({ ok: false, error: 'not found' });
    var lo = rowToObj_(sh, lr);
    if (!lo.link) return json_({ ok: false, error: 'no link' });
    return json_({ ok: true, link: lo.link, childName: lo.childName, teacherName: lo.teacherName });
  }

  // 아이 기기가 "나에게 온 새 숙제 있나요?" 물을 때 (구독 방식)
  // 완료되지 않은 가장 최근 숙제 하나를 링크와 함께 돌려준다.
  if (action === 'latest') {
    var child = String(p.child || '').trim();
    if (!child) return json_({ ok: false, error: 'no child' });
    var last2 = sh.getLastRow();
    // ★규칙(Misuk 지시): 보호자 폰에는 **가장 최근에 낸 숙제 하나만** 보인다.
    //   그 이전 숙제는 완료든 미완료든 보여주지 않는다.
    //   (전에는 '완료 안 된 숙제'를 찾아 올라갔고, 그 때문에 오래된 미완료 숙제가
    //    계속 '새 숙제'로 잡혀 알림이 반복됐다. 2026-09-13)
    // ★have = 지금 이 기기가 가진 숙제 코드. 그 줄보다 아래(=더 나중에 낸) 줄만 새 숙제다.
    //   시트는 아래로 갈수록 나중에 낸 줄이므로, 날짜 칸이 비어 있어도 이것으로 정확히 판정된다.
    //   (낸날짜 칸이 비어 있던 옛 줄 때문에 끝낸 숙제가 또 '새 숙제'로 잡혔다. 2026-09-13)
    var haveRow = p.have ? findRow_(sh, String(p.have).trim()) : 0;
    for (var r2 = last2; r2 >= 2; r2--) {
      var o2 = rowToObj_(sh, r2);
      if (String(o2.childName || '').trim() !== child) continue;
      if (isTestRow_(o2)) continue;
      if (!o2.link) continue;
      if (haveRow && r2 <= haveRow) return json_({ ok: true, code: '', link: '', reason: 'not newer' });
      // ★첫 번째로 만난 줄(= 가장 최근에 낸 숙제)에서 무조건 끝낸다. 더 올라가지 않는다.
      return json_({ ok: true, code: o2.code, link: o2.link,
                     childName: o2.childName, teacherName: o2.teacherName,
                     partLabels: o2.partLabels, need: o2.need,
                     complete: o2.complete,
                     assignedAt: o2.assignedAt || '' });
    }
    return json_({ ok: true, code: '', link: '' });
  }

  if (action === 'list') {
    var last = sh.getLastRow();
    var out = [];
    for (var r = last; r >= 2 && out.length < 60; r--) {
      var o = rowToObj_(sh, r);
      if (isTestRow_(o)) continue;                  // ★점검용 줄은 목록에서 숨긴다
      if (p.teacher && String(o.teacherName || '').trim() !== String(p.teacher).trim()) continue;
      if (p.center && String(o.centerNm || '').trim() !== String(p.center).trim()) continue;
      if (p.child && String(o.childName || '').trim() !== String(p.child).trim()) continue;
      // 목록에서는 긴 칸을 빼서 가볍게 보낸다.
      // ★상세기록(data)이 응답 크기의 대부분이다. links=1 이면 링크는 주고 상세기록만 뺀다
      //   → '숙제 제공 시간'을 살리면서도 응답이 10배 작아진다. (2026-09-13)
      if (!p.detail) {
        o.data = o.data ? '1' : '';
        if (!p.links) o.link = '';
      }
      out.push(o);
    }
    return json_({ ok: true, rows: out });
  }

  // 📋 명단 받아가기 — 기기 3대가 같은 아동·선생님·센터를 쓰게 한다
  if (action === 'roster') {
    return json_({ ok: true, rows: rosterRead_(), devices: devRead_(), now: Date.now() });
  }

  // 🖥️ 기기 목록만 (누가 언제 맞췄는지)
  if (action === 'devices') {
    return json_({ ok: true, devices: devRead_(), now: Date.now() });
  }

  // 🎯 훈련 기록 받아가기 (2026-09-16 Misuk 요청 comet 4229009)
  //   "오늘 리포트를 맞춰줘 월간 보고서도"
  //   수업 중 기기를 바꿔 쓰면 기록이 기기마다 나뉜다. 이 탭에 회기(session)를 올려
  //   모든 기기가 합쳐 보게 한다. 사진·녹음은 올리지 않는다(용량).
  if (action === 'sessions') {
    return json_({ ok: true, rows: sesRead_(String(p.child || ''), Number(p.since || 0)), now: Date.now() });
  }

  return json_({ ok: false, error: 'unknown action' });
}

/** 앱이 쓸 때 (숙제 냄 / 결과 올라옴) */
function doPost(e) {
  var lock = LockService.getScriptLock();
  lock.waitLock(20000);
  try {
    var body = {};
    try { body = JSON.parse((e && e.postData && e.postData.contents) || '{}'); } catch (err) { body = {}; }
    // 📋 명단 올리기 — 올린 뒤 합쳐진 전체 명단을 돌려준다(한 번에 주고받기)
    if (body.action === 'roster') {
      var merged = rosterUpsert_(body.items || []);
      var devs = body.dev ? devTouch_(body.dev) : devRead_();
      return json_({ ok: true, rows: merged, devices: devs, now: Date.now() });
    }

    // 🖥️ 기기 이름만 고칠 때 / 기기 줄 삭제
    if (body.action === 'device') {
      return json_({ ok: true, devices: devTouch_(body.dev || {}), now: Date.now() });
    }
    // 🎯 훈련 기록 올리기 — 올린 뒤 그 아이의 합쳐진 기록을 돌려준다
    if (body.action === 'sessions') {
      var sres = sesUpsert_(body.items || []);
      return json_({ ok: true, rows: sesRead_(String(body.child || ''), Number(body.since || 0)),
                     saved: sres, now: Date.now() });
    }
    if (body.action === 'device_remove') {
      return json_({ ok: true, devices: devRemove_(body.id || ''), now: Date.now() });
    }

    var sh = sheet_();
    var code = String(body.code || '').trim().toUpperCase();
    if (!code) return json_({ ok: false, error: 'no code' });

    var r = findRow_(sh, code);
    if (!r) {
      r = sh.getLastRow() + 1;
      sh.getRange(r, HEAD.indexOf('숙제코드') + 1).setValue(code);
    }
    var set = function (name, val) {
      if (val === undefined || val === null || val === '') return;
      sh.getRange(r, HEAD.indexOf(name) + 1).setValue(val);
    };

    if (body.action === 'assign') {
      set('낸날짜', body.assignedAt ? new Date(body.assignedAt) : new Date());
      set('센터', body.centerNm);
      set('선생님', body.teacherName);
      set('연락처', body.teacherContact);
      set('아이', body.childName);
      set('내준횟수', body.need);
      set('숙제내용', (body.partLabels || []).join(' / '));
      set('숙제링크', body.link);
      if (!sh.getRange(r, HEAD.indexOf('상태') + 1).getValue()) {
        sh.getRange(r, HEAD.indexOf('상태') + 1).setValue('아직 안 함');
      }
      return json_({ ok: true, row: r });
    }

    // 결과가 올라온 경우
    // 낸날짜가 비어 있으면(옛 줄) 보호자 기기가 알려준 값으로 채운다
    if (body.assignedAt && !sh.getRange(r, HEAD.indexOf('낸날짜') + 1).getValue()) {
      set('낸날짜', new Date(body.assignedAt));
    }
    set('센터', body.centerNm);
    set('선생님', body.teacherName);
    set('아이', body.childName);
    set('내준횟수', body.need);
    set('숙제내용', (body.partLabels || []).join(' / '));
    sh.getRange(r, HEAD.indexOf('상태') + 1)
      .setValue(body.complete === true ? '완료' : (body.complete === false ? '미완료' : '진행'));
    set('한횟수', body.doneN);
    set('회기', body.sessionCount);
    set('시행', body.trials);
    set('정답', body.correct);
    set('정반응률', body.rate);
    set('마지막한날짜', body.doneAt ? new Date(body.doneAt) : new Date());
    if (body.data) {
      sh.getRange(r, HEAD.indexOf('상세기록') + 1).setValue(String(body.data).slice(0, 49000));
    }
    return json_({ ok: true, row: r });
  } finally {
    lock.releaseLock();
  }
}

/* ===================================================================
 * 📋 명단 맞추기 (아동 · 선생님 · 센터를 기기 3대가 같이 쓰게 한다)
 *   2026-09-15 Misuk 요청: "태블릿 2대 폰 1대 아동정보가 기기마다 다르다, 3기기 모두 일치"
 *   방식: 같은 시트 안에 '명단' 탭을 하나 더 두고, 각 기기가
 *         ① 자기 명단을 올리고(push) ② 시트 전체를 받아(pull) 합친다.
 *   같은 줄이 겹치면 '수정시각'이 더 나중인 쪽이 이긴다. 지운 것은 삭제=1 줄로 남겨
 *   다른 기기에서도 함께 지워진다(지운 것이 되살아나지 않게).
 * =================================================================== */
var ROSTER_SHEET = '명단';
// ★'성별' 칸은 아동에게만 쓰인다. 선생님 줄에서는 이 칸에 ★휴대폰 번호가 들어간다
//   (2026-09-15 Misuk 요청 comet 4184554 — 번호 뒤 4자리가 그 선생님 비밀번호).
//   비밀번호 자체는 시트에 올리지 않는다 — 번호에서 앱이 계산한다.
var RHEAD = ['종류', 'id', '이름', '성별/선생님번호', '센터', '담당선생님', '치료사구분', '삭제', '수정시각'];

function rsheet_() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sh = ss.getSheetByName(ROSTER_SHEET);
  if (!sh) sh = ss.insertSheet(ROSTER_SHEET);
  if (sh.getLastRow() === 0) {
    sh.getRange(1, 1, 1, RHEAD.length).setValues([RHEAD]);
    sh.getRange(1, 1, 1, RHEAD.length).setFontWeight('bold').setBackground('#e8f0fe');
    sh.setFrozenRows(1);
  }
  return sh;
}

function rosterRead_() {
  var sh = rsheet_();
  var last = sh.getLastRow();
  if (last < 2) return [];
  var vals = sh.getRange(2, 1, last - 1, RHEAD.length).getValues();
  var out = [];
  for (var i = 0; i < vals.length; i++) {
    var v = vals[i];
    if (!String(v[0] || '').trim()) continue;
    out.push({
      k: String(v[0]).trim(),           // child / teacher / center
      i: String(v[1] || '').trim(),
      n: String(v[2] || '').trim(),
      g: String(v[3] || '').trim(),
      c: String(v[4] || '').trim(),     // 센터 이름
      t: String(v[5] || '').trim(),     // 담당 선생님 이름
      p: String(v[6] || '').trim(),
      d: String(v[7] || '') === '1' ? 1 : 0,
      u: Number(v[8] || 0)              // 수정시각 (ms)
    });
  }
  return out;
}

/** 같은 대상을 가리키는 줄인가 — id가 같거나, (종류+이름+센터)가 같으면 같은 줄로 본다.
 *  기기마다 따로 등록해서 id가 다른 경우까지 하나로 합치기 위한 규칙이다. */
function rosterSame_(a, b) {
  if (a.k !== b.k) return false;
  if (a.i && b.i && a.i === b.i) return true;
  if (!a.n || !b.n) return false;
  if (a.n !== b.n) return false;
  if (a.k === 'child') return (a.c || '') === (b.c || '');
  return true;   // 선생님 · 센터는 이름이 같으면 같은 대상
}

function rosterWrite_(rows) {
  var sh = rsheet_();
  var last = sh.getLastRow();
  if (last > 1) sh.getRange(2, 1, last - 1, RHEAD.length).clearContent();
  if (!rows.length) return;
  var vals = rows.map(function (r) {
    return [r.k, r.i, r.n, r.g, r.c, r.t, r.p, r.d ? '1' : '', r.u];
  });
  sh.getRange(2, 1, vals.length, RHEAD.length).setValues(vals);
}

function rosterUpsert_(items) {
  var rows = rosterRead_();
  (items || []).forEach(function (it) {
    if (!it || !it.k) return;
    var n = { k: String(it.k), i: String(it.i || ''), n: String(it.n || ''),
              g: String(it.g || ''), c: String(it.c || ''), t: String(it.t || ''),
              p: String(it.p || ''), d: it.d ? 1 : 0, u: Number(it.u || 0) || Date.now() };
    var hit = -1;
    for (var j = 0; j < rows.length; j++) { if (rosterSame_(rows[j], n)) { hit = j; break; } }
    if (hit < 0) { rows.push(n); return; }
    // 더 나중에 고친 쪽이 이긴다
    if (n.u >= rows[hit].u) {
      if (!n.i) n.i = rows[hit].i;
      rows[hit] = n;
    }
  });
  rosterWrite_(rows);
  return rows;
}

/* ===================================================================
 * 🖥️ 기기 목록 (2026-09-15 Misuk 요청 comet 4181079, 4181124)
 *   "기기마다 이름을 부여하고, 전체가 일치하는지 모든 기기에서 확인 체크되게"
 *   시트에 '기기' 탭을 두고 맞출 때마다 그 기기의 이름·시각·아동수·명단지문을 적는다.
 *   모든 기기가 이 목록을 읽어 "어느 기기가 언제 맞췄고, 지금 같은 명단인가"를 ✅/⚠️로 보여준다.
 *   ★메인(주)기기 개념은 쓰지 않는다 — 모든 기기가 동등하다 (Misuk 지시 comet 4181124).
 * =================================================================== */
var DEV_SHEET = '기기';
var DHEAD = ['기기id', '기기이름', '마지막맞춘시각', '앱버전', '아동수', '명단지문'];

function dsheet_() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sh = ss.getSheetByName(DEV_SHEET);
  if (!sh) sh = ss.insertSheet(DEV_SHEET);
  if (sh.getLastRow() === 0) {
    sh.getRange(1, 1, 1, DHEAD.length).setValues([DHEAD]);
    sh.getRange(1, 1, 1, DHEAD.length).setFontWeight('bold').setBackground('#e8f0fe');
    sh.setFrozenRows(1);
  }
  return sh;
}

function devRead_() {
  var sh = dsheet_();
  var last = sh.getLastRow();
  if (last < 2) return [];
  var vals = sh.getRange(2, 1, last - 1, DHEAD.length).getValues();
  var out = [];
  for (var i = 0; i < vals.length; i++) {
    var v = vals[i];
    if (!String(v[0] || '').trim()) continue;
    out.push({ i: String(v[0]).trim(), n: String(v[1] || '').trim(),
               at: Number(v[2] || 0), v: String(v[3] || ''),
               c: Number(v[4] || 0), f: String(v[5] || '') });
  }
  return out;
}

/** 이 기기의 줄을 지금 시각으로 적는다 (없으면 새 줄) */
function devTouch_(dev) {
  if (!dev || !dev.i) return devRead_();
  var sh = dsheet_();
  var rows = devRead_();
  var hit = -1;
  for (var j = 0; j < rows.length; j++) { if (rows[j].i === String(dev.i)) { hit = j; break; } }
  var rec = { i: String(dev.i), n: String(dev.n || '이름 없는 기기'),
              at: Date.now(), v: String(dev.v || ''),
              c: Number(dev.c || 0), f: String(dev.f || '') };
  if (hit >= 0) rec.n = dev.n ? rec.n : rows[hit].n;
  if (hit >= 0) rows[hit] = rec; else rows.push(rec);
  var last = sh.getLastRow();
  if (last > 1) sh.getRange(2, 1, last - 1, DHEAD.length).clearContent();
  if (rows.length) {
    var vals = rows.map(function (r) { return [r.i, r.n, r.at, r.v, r.c, r.f]; });
    sh.getRange(2, 1, vals.length, DHEAD.length).setValues(vals);
  }
  return rows;
}

/** 기기 줄 삭제 (안 쓰는 기기를 목록에서 지울 때) */
function devRemove_(id) {
  var sh = dsheet_();
  var rows = devRead_().filter(function (r) { return r.i !== String(id); });
  var last = sh.getLastRow();
  if (last > 1) sh.getRange(2, 1, last - 1, DHEAD.length).clearContent();
  if (rows.length) {
    var vals = rows.map(function (r) { return [r.i, r.n, r.at, r.v, r.c, r.f]; });
    sh.getRange(2, 1, vals.length, DHEAD.length).setValues(vals);
  }
  return rows;
}


/* ===================================================================
 * 🎯 훈련 기록 합치기 (2026-09-16 Misuk 요청 comet 4229009)
 *   '기록' 탭에 회기를 한 줄씩 쌓는다. 회기id가 같으면 덮어쓴다(같은 회기 중복 방지).
 *   시행 상세는 JSON 한 칸에 넣는다. ★사진·녹음은 올리지 않는다.
 * =================================================================== */
var SES_SHEET = '기록';
var SHEAD = ['회기id', '아동', '날짜', '기기', '카테고리', '모드', '시행수', '정답수', '상세JSON', '올린시각'];

function ssheet_() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sh = ss.getSheetByName(SES_SHEET);
  if (!sh) sh = ss.insertSheet(SES_SHEET);
  if (sh.getLastRow() === 0) {
    sh.getRange(1, 1, 1, SHEAD.length).setValues([SHEAD]);
    sh.getRange(1, 1, 1, SHEAD.length).setFontWeight('bold').setBackground('#e8f0fe');
    sh.setFrozenRows(1);
  }
  return sh;
}

/** child 가 있으면 그 아이 것만, since(ms) 가 있으면 그 이후 올린 것만 */
function sesRead_(child, since) {
  var sh = ssheet_();
  var last = sh.getLastRow();
  if (last < 2) return [];
  var vals = sh.getRange(2, 1, last - 1, SHEAD.length).getValues();
  var out = [];
  child = String(child || '').trim();
  for (var i = 0; i < vals.length; i++) {
    var v = vals[i];
    var sid = String(v[0] || '').trim();
    if (!sid) continue;
    var nm = String(v[1] || '').trim();
    if (child && nm !== child) continue;
    var at = Number(v[9] || 0);
    if (since && at <= since) continue;
    var det = null;
    try { det = JSON.parse(String(v[8] || 'null')); } catch (e2) { det = null; }
    out.push({ id: sid, child: nm, date: String(v[2] || ''), dev: String(v[3] || ''),
               set: String(v[4] || ''), mode: String(v[5] || ''),
               n: Number(v[6] || 0), ok: Number(v[7] || 0), s: det, at: at });
  }
  return out;
}

function sesUpsert_(items) {
  var sh = ssheet_();
  var last = sh.getLastRow();
  var ids = {};
  if (last > 1) {
    var col = sh.getRange(2, 1, last - 1, 1).getValues();
    for (var i = 0; i < col.length; i++) {
      var k = String(col[i][0] || '').trim();
      if (k) ids[k] = i + 2;          // 시트 행 번호
    }
  }
  var added = 0, updated = 0;
  var news = [];
  (items || []).forEach(function (it) {
    if (!it || !it.id) return;
    var row = [String(it.id), String(it.child || ''), String(it.date || ''),
               String(it.dev || ''), String(it.set || ''), String(it.mode || ''),
               Number(it.n || 0), Number(it.ok || 0),
               JSON.stringify(it.s || null), Date.now()];
    var at = ids[String(it.id)];
    if (at) { sh.getRange(at, 1, 1, SHEAD.length).setValues([row]); updated++; }
    else { news.push(row); added++; }
  });
  if (news.length) sh.getRange(sh.getLastRow() + 1, 1, news.length, SHEAD.length).setValues(news);
  return { added: added, updated: updated };
}

❔ 이 코드가 하는 일

선생님이 숙제를 내면 시트에 '아직 안 함' 한 줄을 만듭니다
아이가 숙제를 끝내면 그 줄을 결과로 채웁니다
선생님이 [숙제 검사]을 열면 그 줄들을 앱으로 돌려줍니다

그 외에는 아무것도 하지 않습니다. 미숙님의 다른 파일이나 메일에는 손대지 않습니다.

앱에 주소 넣기

패드마다 한 번씩, 30초면 됩니다. 이게 '그 패드를 센터 시트에 등록하는' 일입니다.

2.1 첫 기기 — 주소를 직접 넣습니다

1장에서 받은 주소를 넣는 일입니다. 한 기기에서 한 번만 하시면, 나머지 기기는 2.2의 링크로 훨씬 쉽게 끝납니다. 선생님 컴퓨터나 주로 쓰시는 패드에서 하세요.

주소를 복사합니다

카카오톡 '나와의 채팅'에 보내둔 그 주소를 길게 눌러 → 복사. (컴퓨터면 그 글자를 드래그해 Ctrl+C)

앱을 엽니다

훈련 앱을 엽니다. 아동 선택 화면이나 훈련 설정 화면이 나옵니다.

[👩‍🏫 선생님 · 센터 추가]를 누릅니다

훈련 설정 화면 아래 버튼 줄, 또는 아동 선택 화면에 있습니다. 누르면 위쪽에 탭 세 개가 있는 화면이 나옵니다.

👩‍🏫 선생님 ｜ 🏢 센터 ｜ ☁️ 결과 받기

[☁️ 결과 받기] 탭을 누릅니다

맨 오른쪽 탭입니다. 시트 연결 이라는 칸과 주소를 넣는 긴 입력칸이 나옵니다.

[📋 붙여넣기]를 누릅니다

입력칸 아래 저장 ｜ 📋 붙여넣기 ｜ 🔌 연결 확인 세 버튼이 있습니다. 📋 붙여넣기를 누르면 복사해둔 주소가 칸에 들어가고 바로 저장까지 됩니다.

기기가 붙여넣기를 막는 경우(주로 아이폰 사파리)에는 입력칸을 길게 눌러 붙여넣기를 고른 뒤 저장을 누르세요. 손으로 적지는 마세요 — 한 글자만 달라도 안 됩니다.

[🔌 연결 확인]을 누릅니다

이렇게 나오면 성공입니다.

연결 성공 — 시트 이름: 핑퐁ABA 센터 숙제

시트 이름이 1.1에서 미숙님이 적은 그 이름과 같은지 보세요. 다르면 다른 시트에 붙은 것입니다.

실패로 나오면 5장 문제 해결로 가세요. 열에 아홉은 1.3의 '모든 사용자'를 안 고른 경우입니다.

선생님과 센터를 등록합니다

같은 화면의 👩‍🏫 선생님 탭에서 이름을 넣고 ＋ 추가, 🏢 센터 탭에서 센터 이름을 넣고 ＋ 추가. 자세한 건 3장에 있습니다.

지금 등록해 두시면 2.2의 연결 링크에 이 명단이 함께 담겨서, 다른 기기에 다시 적을 일이 없습니다.

2.2 둘째 기기부터 — 연결 링크 한 번

기기마다 주소를 옮겨 적는 건 번거롭습니다. 그래서 연결 링크를 넣었습니다. 새 기기에서 그 링크를 한 번 열면 시트 주소와 선생님·센터 명단이 자동으로 들어갑니다.

이미 연결된 기기에서 링크를 만듭니다

[👩‍🏫 선생님 · 센터 추가] → ☁️ 결과 받기 탭 → 아래쪽 다른 기기 연결하기 칸.

이 칸은 시트 주소가 저장돼 있을 때만 나옵니다. 안 보이면 2.1이 아직 안 끝난 것입니다.

[📨 연결 링크 보내기] 또는 [📋 링크 복사]

📨 연결 링크 보내기 — 공유창이 열립니다. 카카오톡을 골라 그 기기로 보내세요
📋 링크 복사 — 링크만 복사됩니다. 컴퓨터에서 쓰기 편합니다

새 기기에서 그 링크를 한 번 엽니다

새 패드·휴대폰에서 카톡으로 받은 링크를 누릅니다. 앱이 열리면서 연결됐다는 안내가 나옵니다. 그것으로 끝입니다 — 주소를 넣는 화면에 들어가실 필요가 없습니다.

여러 번 열어도 괜찮습니다. 선생님·센터 명단이 중복되지 않게 되어 있습니다.

새 기기에서 [🔌 연결 확인]으로 한 번 확인합니다

[선생님 · 센터 추가] → ☁️ 결과 받기 → 🔌 연결 확인. '연결 성공'이 나오면 그 기기도 끝났습니다.

🚫 연결 링크는 선생님용입니다

이 링크에는 시트 주소가 담겨 있습니다. 보호자에게 보내면 보호자가 센터 숙제 목록을 볼 수 있게 됩니다. 보호자에게는 숙제 링크(숙제 만들기에서 나오는 것)만 보내세요 — 그건 그 아이 숙제만 담고 있어 안전합니다.

2.3 연결됐는지 확인하는 세 가지 방법

'연결됐나?' 싶을 때 눈으로 확인하는 자리가 세 군데 있습니다.

보는 곳	연결됐을 때
[선생님 · 센터 추가] 맨 위 한 줄	담당 아동 ○명 · 센터 ○곳 · ☁️ 시트 연결됨
☁️ 결과 받기 탭 → 🔌 연결 확인	연결 성공 — 시트 이름: …
숙제 링크를 만들 때	☁️ 이 숙제는 센터 시트에 올라갑니다 라는 파란 문구

⚠️ 기기마다 따로입니다

주소는 그 기기 안에만 저장됩니다. 컴퓨터에 넣었다고 패드가 같이 연결되지는 않습니다. 패드 2대·휴대폰이면 기기마다 한 번씩 (2.2의 링크로) 하셔야 합니다. 한 번 하면 그 기기는 계속 유지됩니다.

그래도 시트는 한 장입니다. 어느 기기에서 낸 숙제든 같은 시트에 모이고, 연결된 기기 어디서든 전부 보실 수 있습니다.

🚫 시트를 연결하기 전에 보낸 숙제는 안 올라옵니다

숙제 링크에는 만들 때의 시트 주소가 담겨 갑니다. 연결 전에 보낸 링크에는 주소가 없어서 결과가 올라오지 않습니다. 연결 직후에는 숙제를 새로 내주세요.

2.4 앱을 홈 화면에 설치 (선택)

브라우저로 쓰셔도 되지만, 홈 화면에 설치하면 일반 앱처럼 아이콘으로 열리고 주소창이 사라져 화면이 넓어집니다.

앱 주소를 브라우저로 엽니다

안드로이드는 크롬, 아이패드·아이폰은 사파리로 여세요.

카카오톡 안에서 열면 설치가 안 됩니다. 카톡으로 받은 링크를 눌렀을 때는 오른쪽 아래 ⋯ → 다른 브라우저로 열기를 쓰세요.

안드로이드 (크롬)

오른쪽 위 ⋮ → 홈 화면에 추가 → 설치.

아이패드 · 아이폰 (사파리)

아래쪽(또는 위쪽) 공유 아이콘(□에 ↑) → 목록을 내려 홈 화면에 추가 → 오른쪽 위 추가.

설치 후 연결은 그대로입니다

브라우저에서 이미 연결해 두셨으면 설치한 앱에서도 연결돼 있습니다. 같은 기기라서 그렇습니다.

2.5 센터 패드에서 보호자 휴대폰으로 숙제 보내기

숙제를 내는 기기는 센터 패드이고, 받아야 하는 곳은 보호자 휴대폰입니다. 그런데 센터 패드마다 카카오톡을 깔아 선생님 계정으로 로그인해 둘 수는 없습니다. 그래서 카카오톡 없이 보내는 길을 넣었습니다.

방법	쓰는 경우	하는 법
📷 QR 비추기	기본으로 이걸 쓰세요. 보호자가 센터에 와 계실 때. 와이파이 전용 패드에서도 됩니다	패드 화면의 QR을 보호자 휴대폰 카메라로 비추면 바로 열립니다
💬 문자로 보내기	패드에 유심(전화 기능)이 있을 때만. 보호자가 집에 있을 때	아동에 등록해 둔 보호자 번호로 문자 앱이 열립니다. 와이파이 전용 패드에는 문자 앱이 없습니다
📨 카톡·다른 앱으로	선생님 개인 휴대폰으로 낼 때	보낼 앱을 고르는 창이 열립니다 (지금까지 쓰던 방법)
⌨️ 숙제 코드	보호자가 아니라 다른 센터 패드로 넘길 때	그 패드 앱의 [🏡 숙제 코드로 열기]에 코드를 넣습니다

⚠️ 먼저 확인 — 그 패드에 문자 앱이 있습니까?

패드는 두 종류입니다. 와이파이 전용(유심 넣는 자리가 없는 것)에는 문자 앱과 전화 앱이 아예 없습니다. 센터에서 쓰는 패드는 대부분 이쪽입니다.

확인하는 법 — 그 패드의 앱 목록에서 메시지(아이패드) 또는 메시지 · 문자(안드로이드) 앱을 찾아보세요. 없으면 와이파이 전용입니다.

없는 경우 → 아래 📷 QR을 쓰시면 됩니다. 보호자가 오실 때 화면을 비추게 하는 것이라 오히려 더 빠릅니다. 보호자가 집에 있을 때 보내야 한다면 📋 링크 복사 → 선생님 휴대폰(카톡·문자)으로 전달하시는 방법뿐입니다.

💬 문자로 보내기 — 유심이 있는 패드·휴대폰에서만

먼저 아동에 보호자 번호를 넣어둡니다 — 한 번만

아동 선택 화면 → ⭐ 새 아동 등록에 보호자 휴대폰 칸이 있습니다. 이미 등록한 아이는 목록의 그 아이 줄에서 [번호 넣기]를 누르세요.

번호는 그 기기에만 저장됩니다. 다른 패드에서도 보내시려면 그 패드에서도 한 번 넣어주세요.

숙제 링크를 만듭니다

[🏡 숙제 내기] → 설정 → 숙제 링크 생성. 링크 아래에 💬 ○○ 보호자 010-… 번호로 갑니다 라고 나옵니다.

[💬 보호자에게 문자로 보내기]를 누릅니다

패드의 문자 앱이 열리고, 받는 사람과 내용(안내문 · 오늘 할 숙제 · 링크)이 미리 채워져 있습니다.

내용을 확인하고 [보내기]

보내기는 선생님이 직접 누르셔야 합니다. 앱이 몰래 보내지는 않습니다.

번호를 아직 안 넣으셨으면 받는 사람만 비어 있고 내용은 채워져 있습니다. 거기서 번호를 적어 보내셔도 됩니다.

⚠️ 패드로 문자를 보낼 때

문자는 전화 기능(유심)이 있는 기기에서 나갑니다. 와이파이 전용 패드는 문자 앱이 없어 이 버튼이 열리지 않습니다. 그런 패드에서는 📷 QR(보호자가 센터에 계실 때)이나 📋 링크 복사를 쓰세요.

아이패드는 같은 애플 계정의 아이폰이 있으면 문자 중계로 보낼 수 있습니다 (아이폰 설정 → 메시지 → 문자 메시지 전달).

📷 방법 2 — QR을 카메라로 비추기

선생님 기기에서 숙제 링크를 만듭니다

[🏡 숙제 내기]에서 설정을 정하고 숙제 링크 생성. 링크 아래에 📷 패드·태블릿으로 바로 넘기기 라는 칸과 QR 그림이 나옵니다.

[🔍 크게 보기]를 누릅니다

QR이 화면 가득 커집니다. 작은 화면끼리 비출 때 훨씬 잘 읽힙니다.

받는 기기에서 카메라 앱을 엽니다

보호자 휴대폰(또는 다른 패드)에서 카메라 앱을 엽니다. 아이폰은 기본 카메라, 안드로이드도 기본 카메라(또는 삼성 빅스비 비전·구글 렌즈). 사진을 찍는 게 아니라 비추기만 하면 됩니다.

보호자가 센터에 와 계실 때 가장 빠릅니다 — 패드 화면을 보여드리고 휴대폰으로 비추게 하면 그 자리에서 끝납니다.

화면에 뜨는 주소를 누릅니다

카메라 화면 위에 노란(또는 흰) 말풍선으로 주소가 나옵니다. 그것을 누르면 브라우저가 열리고 숙제 입력 화면이 나옵니다.

여기서 [▶ 숙제 시작하기]만 누르면 시작됩니다. 비밀번호는 없습니다 — 아이 이름도 링크에 담겨 옵니다.

그 패드에 설치해 두면 다음부터는 아이콘으로

열린 뒤 홈 화면에 추가(2.4)를 하시면, 다음부터는 아이콘만 눌러도 그 숙제가 바로 나옵니다. 링크를 다시 받지 않아도 됩니다.

⌨️ 방법 3 — 숙제 코드만 넣기 (센터 패드끼리)

받는 기기가 센터 패드이고 시트가 연결돼 있으면(2.2의 연결 링크로), 코드 여덟 자만 넣어도 숙제가 열립니다. 카메라도 카톡도 필요 없습니다. 보호자 휴대폰에는 쓸 수 없습니다 — 보호자 기기에는 시트 주소가 없기 때문입니다.

선생님 화면의 숙제 코드를 봅니다

숙제 링크 아래 숙제 코드: HW○○○○○○ 라고 나옵니다. 이걸 아이 패드 쓰시는 분에게 말로 알려주셔도 됩니다.

패드 앱에서 [🏡 숙제 코드로 열기]를 누릅니다

훈련 설정 화면 아래 버튼 줄, 또는 아동 선택 화면 위쪽에 있습니다.

코드를 넣습니다

코드를 넣으면 앱이 시트에서 그 숙제를 찾아 자동으로 엽니다. 링크를 옮길 일이 없습니다.

'그 코드의 숙제를 찾지 못했습니다'가 나오면 ① 코드를 잘못 적었거나 ② 그 숙제가 시트 연결 전에 만들어진 것입니다. 숙제를 새로 내주세요.

2.6 한 번만 보내면 그 뒤로는 자동 (중요)

보호자 휴대폰이 QR을 한 번 읽으면, 그 기기는 센터 시트에 연결됩니다. 그 뒤로는 숙제를 다시 보내지 않아도 됩니다.

처음 한 번만 — QR을 읽게 합니다

보호자가 센터에 오셨을 때 QR을 비추게 하고, 그 휴대폰에서 홈 화면에 추가까지 해드리세요(2.4). 이 한 번이 전부입니다.

그 뒤로 선생님은 숙제만 만듭니다

[🏡 숙제 내기] → 숙제 링크 생성. 문자도, 카톡도, QR도 보내지 않으셔도 됩니다. 만드는 순간 시트에 올라갑니다.

보호자가 앱을 열면 스스로 찾아옵니다

보호자가 홈 화면 아이콘을 누르면 앱이 시트에 물어봅니다. 새 숙제가 있으면 초록 칸으로 알려줍니다.

🆕 선생님이 새 숙제를 내주셨습니다 → [▶ 새 숙제 받기]

보호자는 그 버튼만 누르면 됩니다. 링크를 찾을 일도 없습니다.

안 보이면 [🔄 새 숙제 확인]

숙제 끝 화면에 🔄 새 숙제 확인 버튼이 있습니다. 눌러서 직접 확인하실 수 있습니다.

✅ 그래서 실제 흐름은 이렇게 됩니다

처음 한 번 — 보호자가 센터에 오실 때 QR 비추기 + 홈 화면에 추가
그 뒤 매번 — 선생님은 숙제 만들기만, 보호자는 앱 열어 [새 숙제 받기]만

패드에 유심이 없어도, 카카오톡이 없어도 됩니다.

⚠️ 조건 두 가지

① 숙제를 만들 때 시트가 연결돼 있어야 합니다(2.3에서 확인). ② 아동 이름이 정확히 같아야 합니다 — 시트의 '아이' 칸과 보호자 기기에 등록된 이름으로 찾기 때문입니다. '장성준'과 '장성준 '(뒤에 빈칸)은 다른 이름이 됩니다.

그리고 이미 다 끝낸 숙제는 새 숙제로 알려주지 않습니다. 아직 남은 숙제 중 가장 최근 것 하나를 찾습니다.

✅ 어느 방법으로 열어도 결과는 같은 시트로

QR로 열었든 코드로 열었든 카톡 링크로 열었든, 아이가 끝내면 결과는 같은 센터 시트에 올라갑니다. [📥 숙제 검사]에서 똑같이 보입니다.

⚠️ QR이 안 만들어질 때

여러 단계를 한 링크에 담고 고친 글·이름까지 넣으면 링크가 아주 길어져 QR 한 장에 안 들어갑니다. 그때는 숙제 코드로 여시거나, 단계를 나눠 숙제를 두 번 내주세요.

📋 기기 여러 대의 명단을 같게 맞추기

패드·휴대폰을 여러 대 쓰시면, 아동·선생님·센터 명단이 기기마다 따로 저장돼 서로 달라질 수 있었습니다. 이제는 같은 시트 주소가 연결된 기기끼리 명단이 자동으로 같아집니다.

기기마다 같은 시트 주소를 연결합니다

첫 기기는 주소를 붙여넣고, 둘째·셋째 기기는 [☁️ 결과 받기] → [📨 연결 링크 보내기]로 보낸 링크를 한 번 열면 끝입니다.

그 다음부터는 저절로 맞춰집니다

앱을 켤 때 한 번, 그리고 아동을 등록·수정·삭제할 때마다 자동으로 올라가고 내려옵니다. 따로 누르실 것이 없습니다.

바로 맞추고 싶으면

[☁️ 결과 받기] → [📋 기기끼리 명단 맞추기] → [🔄 지금 맞추기]를 누르시면 즉시 맞춰집니다.

🖥️ 기기마다 이름 붙이기 · 다 같은지 확인하기

기기를 새로 추가하실 때 앱이 먼저 "이 기기 이름을 정해주세요" 창을 띄웁니다. 예: 위례 태블릿 / 평택 태블릿 / 선생님 폰. 저장하면 그 기기가 다른 기기들의 목록에 자동으로 나타납니다.

[☁️ 결과 받기] 화면의 기기 목록에서 어느 기기가 언제 맞췄는지 보입니다.

· ✅ 모든 기기가 같은 명단입니다 — 다 맞은 상태입니다. 아무것도 안 하셔도 됩니다.
· ⚠️ 아직 다른 기기가 있습니다 — ⚠️ 가 붙은 그 기기에서 앱을 열고 [🔄 지금 맞추기]를 한 번 누르시면 됩니다.

기기 이름은 [☁️ 결과 받기] → 이 기기 이름 칸에서 언제든 바꾸실 수 있습니다. 안 쓰는 기기는 [목록에서 빼기]로 정리하세요 (그 기기의 아동·기록은 지워지지 않습니다).

✅ 규칙

· 아동은 이름 + 소속 센터로 같은 아이인지 봅니다. 같은 이름이라도 센터가 다르면 다른 아이로 따로 남습니다.
· 같은 아이를 두 기기에서 고쳤으면 나중에 고친 쪽이 남습니다.
· 한 기기에서 아동을 지우면 다른 기기에서도 지워집니다. 되살아나지 않습니다 — 지우실 때 확인해 주세요.

⚠️ 이미 시트를 쓰고 계셨다면 — 코드를 한 번 갱신해 주세요

'명단' 탭 기능은 시트 쪽 코드에 새로 들어갔습니다. 예전 코드 그대로면 명단이 맞춰지지 않고, 앱이 "시트 코드가 옛 버전입니다"라고 알려줍니다. 그때는 이렇게 하세요 — 컴퓨터에서 하시는 것이 훨씬 편합니다.

① 위 1.4 붙여넣을 코드에서 [📋 코드 전체 복사]
② 시트 → 확장 프로그램 → Apps Script → 내용 전체 선택(Ctrl+A) 후 지우고 붙여넣기 → 저장(Ctrl+S)
③ [배포] → [배포 관리] → 연필(✏️) → 버전: 새 버전 → [배포]

③에서 [새 배포]가 아니라 [배포 관리]입니다. 이렇게 하면 주소가 그대로라서 기기들을 다시 손대지 않아도 됩니다. 그 다음 기기마다 앱을 한 번씩 켜시면 끝입니다. 시트에 '명단' 탭이 새로 생겼으면 제대로 된 것입니다.

⚠️ 훈련 기록과 사진은 옮겨지지 않습니다

명단(아동·선생님·센터)만 맞춰집니다. 훈련 기록·진전 그래프·바꿔 넣은 사진은 그 기기에 그대로 남습니다. 기록은 용량이 커서 시트로 옮기지 않습니다 — 기록을 모으실 때는 [기록] 화면의 CSV 내보내기를 쓰세요.

선생님 등록과 사용

패드 한 대를 여러 선생님이 나눠 쓰실 수 있습니다. 선생님을 여러 명 등록해 두고, 훈련을 시작할 때 본인을 고르시면 됩니다.

등록하는 순서

[선생님 · 센터] → [➕ 선생님 등록]

이름을 넣고 치료사 선택(센터장 · 행동치료사 · 언어치료사 · 인지치료사)에서 고른 뒤 선생님 추가. 몇 명이든 됩니다. 나중에 선생님이 들어오셔도 이 자리에서 바로 추가하시면 됩니다.

센터를 추가합니다

같은 화면의 🏢 센터 / 소속에서 센터 이름을 넣습니다. 센터가 한 곳이면 등록하지 않고 쓰셔도 됩니다.

아동을 등록할 때 담당 선생님을 고릅니다

아동 선택 화면의 새 아동 등록에 담당 선생님 칸이 생깁니다. 이미 등록한 아이는 목록에서 수정하시면 됩니다.

아동을 고르는 순서

아동 선택 화면이 센터 → 선생님 → 아동 세 단계로 나옵니다. 큰 버튼을 눌러 하나씩 고르시면 되고, 고른 단계는 접히면서 다음 단계가 열립니다. 각 버튼에 몇 명인지도 함께 나옵니다. 다시 고치실 때는 그 줄의 바꾸기를 누르세요.

센터가 한 곳이면 전체 센터를, 본인 아이만 보실 때는 선생님을 고르시면 됩니다. 센터를 등록하지 않으셨으면 센터 단계는 아예 나오지 않고 선생님 → 아동 두 단계가 됩니다.

선생님이 바뀔 때

[선생님 · 센터] 맨 위 👩‍🏫 지금 쓰는 선생님에서 본인을 고릅니다. 등록된 선생님 목록에서 이 선생님으로를 눌러도 됩니다. 그러면

아동 선택 화면에 그 선생님이 맡은 아이만 보입니다
숙제를 낼 때 선생님 이름이 자동으로 담깁니다
숙제 검사 화면에서 그 선생님이 낸 숙제만 불러옵니다

📨 숙제 링크를 카톡으로 보내기

숙제 링크를 만들면 📨 카톡으로 보내기 버튼이 나옵니다. 누르면 보낼 앱을 고르는 창이 열리고, 안내문 · 오늘 할 숙제 · 링크가 한 번에 담겨 갑니다. 복사해서 붙여넣지 않으셔도 됩니다. 컴퓨터에서는 공유창이 없어서 자동으로 복사됩니다.

✅ 결과를 볼 때

[📥 숙제 검사] → ☁️ 시트에서 불러오기에서 선생님을 고르고 목록 불러오기를 누르면, 코드를 넣지 않고도 아이별로 🎉 완료 / 📌 미완료 / ⏳ 아직 안 함이 한눈에 보입니다. 누르면 시행별 기록까지 펼쳐집니다.

무엇이 어떻게 오가는가

시트에 무엇이 적히는지, 보호자 쪽에서 무엇이 달라지는지 정리했습니다.

시트에 쌓이는 칸

칸	내용
낸날짜	선생님이 숙제를 만든 시각
센터 · 선생님 · 연락처	낸 사람. 선생님을 고르면 이 칸으로 걸러 봅니다 ('연락처' 칸에는 치료사 구분이 들어갑니다)
아이 · 숙제코드	누구의 어떤 숙제인지
내준횟수 · 숙제내용	하루 몇 회, 어떤 단계인지
상태	아직 안 함 / 미완료 / 완료
한횟수 · 회기 · 시행 · 정답 · 정반응률	아이가 한 결과
마지막한날짜	가장 최근에 한 시각
숙제링크	그 숙제를 여는 링크. 패드에서 숙제 코드로 열 때 앱이 이 칸을 읽습니다 (사람이 볼 필요 없습니다)
상세기록	시행별 기록이 담긴 긴 글. 앱이 읽어서 표로 펼칩니다 (사람이 볼 필요 없습니다)

언제 올라가는가

시점	선생님 쪽	보호자 쪽
1	숙제를 만들면 시트에 '아직 안 함' 한 줄이 올라갑니다	—
2	링크를 보냅니다 (시트 주소가 링크에 함께 담깁니다)	링크를 받아 엽니다
3	—	아이가 숙제를 합니다
4	—	끝나면 결과가 자동으로 올라갑니다. 버튼을 누르지 않아도 됩니다
5	[숙제 검사]에서 목록을 불러 결과를 봅니다	—

🎤 대답 녹음은 따로입니다

녹음은 용량이 커서 시트에 담지 않습니다. 아이 대답을 들으실 때는 예전처럼 보호자에게 🎤 녹음까지 보내기로 파일을 받아 [숙제 검사]의 📂 결과 파일 열기로 여시면 됩니다.

🔒 개인정보

시트에는 아이 이름과 훈련 기록이 적힙니다. 생년월일·연락처 같은 것은 담기지 않습니다(선생님 칸에는 이름과 치료사 구분만 들어갑니다). 시트는 미숙님 구글 계정 안에 있고, 주소를 아는 사람만 결과를 보낼 수 있습니다 — 시트를 읽는 것은 미숙님과 공유하신 분만 가능합니다.

보호자에게는 "가정 학습 기록이 센터 기록으로 자동 전달된다"고 한 줄 알려두시는 게 좋습니다.

✅ 인터넷이 끊겨도 괜찮습니다

보내지 못한 결과는 기기에 쌓아두고 다음에 앱을 열 때 다시 보냅니다. 시트를 연결하지 않으셔도 앱은 예전 그대로 — 코드를 주고받는 방식으로 — 동작합니다.

문제 해결

[연결 확인]에서 '연결 실패'가 나옵니다

주소를 다시 확인하세요. /exec 로 끝나야 합니다. /dev 로 끝나는 주소는 미숙님만 쓸 수 있어서 보호자 기기에서 동작하지 않습니다. 주소 앞뒤에 빈칸이나 따옴표가 붙어 있어도 실패합니다.

'응답이 이상합니다'라고 나옵니다

배포할 때 액세스 권한이 있는 사용자가 '모든 사용자'인지 확인하세요. [배포] → [배포 관리] → 연필(수정) → 그 칸을 '모든 사용자'로 바꾸고 새 버전으로 배포하면 주소는 그대로 유지됩니다.

선생님 패드에서는 되는데 보호자가 한 결과가 안 올라옵니다

시트를 연결한 뒤에 새로 만든 숙제 링크부터 자동 전송이 됩니다. 예전에 보낸 링크에는 시트 주소가 담겨 있지 않습니다. 숙제를 다시 내주세요. 숙제 링크를 만들 때 화면에 '☁️ 이 숙제는 센터 시트에 올라갑니다'라고 나오면 담긴 것입니다.

코드를 넣었는데 '결과가 아직 없습니다'라고 나옵니다

아이가 아직 숙제를 하지 않았거나, 시트 연결 전에 낸 숙제입니다. 시트가 연결돼 있으면 코드를 넣었을 때 앱이 시트에서도 찾아봅니다. 그래도 없으면 보호자에게 결과 파일을 받아 여세요.

코드를 수정하거나 다시 배포해야 할 때

Apps Script에서 코드를 고친 뒤 [배포] → [배포 관리] → 연필 → 버전: 새 버전 → 배포. 이렇게 하면 주소가 바뀌지 않아 패드를 다시 손대지 않아도 됩니다. [새 배포]를 누르면 주소가 새로 생기니 주의하세요.

시트를 센터마다 따로 두고 싶습니다

센터별로 시트와 배포를 하나씩 만들고, 그 센터 패드에는 그 센터 주소를 넣으시면 됩니다. 센터끼리 데이터가 아예 섞이지 않습니다. 다만 미숙님이 여러 센터를 한 번에 보실 수는 없습니다.

이미 시트를 만들어 쓰고 있는데 [숙제 코드로 열기]가 안 됩니다

코드가 예전 버전입니다. 숙제링크 칸이 새로 늘어서 코드를 한 번 갱신해야 합니다. 3분이면 됩니다.

이 설명서 1.4에서 📋 코드 전체 복사
시트 → 확장 프로그램 → Apps Script → 코드 칸에서 Ctrl+A → 지우고 → Ctrl+V → 💾 저장
[배포] → [배포 관리] → 연필(수정) → 버전: 새 버전 → 배포

[새 배포]가 아니라 [배포 관리]입니다. 이렇게 하면 주소가 바뀌지 않아 패드를 다시 손댈 필요가 없습니다. 시트에 쌓인 기록도 그대로 남습니다.

갱신한 뒤 새로 내는 숙제부터 코드로 열립니다. QR은 코드 갱신과 상관없이 지금 바로 됩니다.

QR을 비췄는데 카메라가 못 읽습니다

🔍 크게 보기를 눌러 화면 가득 키우세요. 화면 밝기를 올리고, 20~30cm 거리에서 전체가 화면에 들어오게 비춥니다. 그래도 안 되면 링크가 너무 길어진 경우이니 숙제 코드로 여시거나 단계를 나눠 내주세요.

[확장 프로그램] 메뉴가 안 보입니다

패드·휴대폰에서 시트를 여신 경우입니다. 모바일 구글 시트 앱에는 Apps Script가 없습니다. 컴퓨터에서 sheets.google.com 으로 들어가 그 표를 열면 메뉴가 나옵니다. 1장은 컴퓨터에서만 됩니다.

"Google에서 확인하지 않은 앱" 경고에서 막혔습니다

고급(왼쪽 아래 작은 글씨) → (프로젝트이름)(으)로 이동(안전하지 않음) → 허용 순서입니다. '고급'이 안 보이면 창을 넓히거나 스크롤을 내려보세요. 이 경고는 미숙님이 직접 만든 코드라서 나오는 것이고, 본인 코드에 본인이 권한을 주는 것이니 안전합니다.

[📋 붙여넣기]를 눌러도 아무것도 안 들어갑니다

기기가 앱의 붙여넣기를 막은 경우입니다(아이패드 사파리에서 자주 그렇습니다). 주소 입력칸을 길게 눌러 → 붙여넣기를 고른 뒤 저장을 누르세요. 손으로 적지는 마세요 — 한 글자만 달라도 연결되지 않습니다.

[다른 기기 연결하기] 칸이 안 보입니다

그 기기에 시트 주소가 아직 저장되지 않은 상태입니다. 연결 링크는 이미 연결된 기기에서만 만들 수 있습니다. 먼저 2.1을 끝내시면 그 칸이 나타납니다.

연결 링크를 열었는데 아무 일도 안 일어난 것 같습니다

링크가 카카오톡 안에서 열렸을 가능성이 큽니다. 오른쪽 아래 ⋯ → 다른 브라우저로 열기로 크롬·사파리에서 열어주세요. 그리고 [선생님 · 센터 추가] → ☁️ 결과 받기 → 🔌 연결 확인으로 확인하시면 됩니다. 링크를 여러 번 열어도 명단이 중복되지 않습니다.

선생님을 골랐는데 숙제 목록이 비어 있습니다

선생님 칸이 빈 숙제는 담당 미지정으로 따로 나옵니다. 목록 위에서 모든 선생님을 고르면 센터 전체가 보입니다. 앞으로 낸 숙제에 이름이 담기게 하려면 [선생님 · 센터 추가]에서 지금 쓰는 선생님을 본인으로 맞춰두시거나, 아동마다 담당 선생님을 지정해 두세요.

나중에 판매할 때는 어떻게 됩니까

판매 단계에서는 선생님이 각자 이 설치를 하시는 게 무리여서, 가입만 하면 되는 정식 서버(파이어베이스 등)로 옮기는 게 맞습니다. 그때 훈련·기록·화면은 그대로 두고 '결과를 어디로 보내는가' 한 군데만 바꿉니다. 지금 시트로 쓰시는 것이 버려지는 일이 아니라, 무엇을 자동으로 올려야 하는지 정하는 과정이 됩니다.

보내기 전 확인 목록

주소가 /exec 로 끝납니다
배포 권한이 '모든 사용자'입니다
[연결 확인]에서 '연결 성공'이 나옵니다
패드마다 같은 주소를 넣었습니다
선생님을 등록하고, 아동마다 담당 선생님을 골랐습니다
시트 연결 후에 숙제를 새로 만들었습니다

센터 시트 연결설명서

이 설명서의 구성

시트 만들기

✅ 미리 알아두실 것

💻 컴퓨터에서 하세요

1.1 표 하나 만들기

인터넷 브라우저를 엽니다

구글 계정으로 로그인합니다

빈 표가 열립니다

표 이름을 정합니다

저장은 하지 않아도 됩니다

1.2 코드 붙여넣기

먼저 코드를 복사해 둡니다

시트 탭으로 돌아갑니다

위쪽 메뉴 [확장 프로그램]을 누릅니다

[Apps Script]를 누릅니다

새 탭에 뭐가 보이는지 확인합니다

있던 세 줄을 전부 지웁니다

복사한 코드를 붙여넣습니다

저장합니다 — 이건 꼭 눌러야 합니다

(물어보면) 프로젝트 이름을 적습니다

1.3 배포하고 주소 받기

오른쪽 위 파란 [배포] 버튼을 누릅니다

[새 배포]를 누릅니다

창 왼쪽 위 톱니바퀴 ⚙️ 를 누릅니다

[웹 앱]을 고릅니다

[설명] 칸 — 비워도 됩니다

★[다음 사용자로 실행] — 나

★★[액세스 권한이 있는 사람] — 모든 사용자

오른쪽 아래 [배포]를 누릅니다

권한을 승인합니다 — 처음 한 번만

구글 경고 화면을 통과합니다

★주소를 복사합니다

주소를 카카오톡 '나에게 보내기'로 보내둡니다

[완료]를 눌러 창을 닫습니다

⚠️ 주소를 잃어버렸을 때

1.4 붙여넣을 코드 (전문)

❔ 이 코드가 하는 일

앱에 주소 넣기

2.1 첫 기기 — 주소를 직접 넣습니다

주소를 복사합니다

앱을 엽니다

[👩‍🏫 선생님 · 센터 추가]를 누릅니다

[☁️ 결과 받기] 탭을 누릅니다

[📋 붙여넣기]를 누릅니다

[🔌 연결 확인]을 누릅니다

선생님과 센터를 등록합니다

2.2 둘째 기기부터 — 연결 링크 한 번

이미 연결된 기기에서 링크를 만듭니다

[📨 연결 링크 보내기] 또는 [📋 링크 복사]

새 기기에서 그 링크를 한 번 엽니다

새 기기에서 [🔌 연결 확인]으로 한 번 확인합니다

🚫 연결 링크는 선생님용입니다

2.3 연결됐는지 확인하는 세 가지 방법

⚠️ 기기마다 따로입니다

🚫 시트를 연결하기 전에 보낸 숙제는 안 올라옵니다

2.4 앱을 홈 화면에 설치 (선택)

앱 주소를 브라우저로 엽니다

안드로이드 (크롬)

아이패드 · 아이폰 (사파리)

설치 후 연결은 그대로입니다

2.5 센터 패드에서 보호자 휴대폰으로 숙제 보내기

⚠️ 먼저 확인 — 그 패드에 문자 앱이 있습니까?

💬 문자로 보내기 — 유심이 있는 패드·휴대폰에서만

먼저 아동에 보호자 번호를 넣어둡니다 — 한 번만

숙제 링크를 만듭니다

[💬 보호자에게 문자로 보내기]를 누릅니다

내용을 확인하고 [보내기]

⚠️ 패드로 문자를 보낼 때

📷 방법 2 — QR을 카메라로 비추기

선생님 기기에서 숙제 링크를 만듭니다

[🔍 크게 보기]를 누릅니다

받는 기기에서 카메라 앱을 엽니다

화면에 뜨는 주소를 누릅니다

그 패드에 설치해 두면 다음부터는 아이콘으로

⌨️ 방법 3 — 숙제 코드만 넣기 (센터 패드끼리)

선생님 화면의 숙제 코드를 봅니다

패드 앱에서 [🏡 숙제 코드로 열기]를 누릅니다

코드를 넣습니다

2.6 한 번만 보내면 그 뒤로는 자동 (중요)

센터 시트 연결
설명서