수업 메모를 학부모 리포트로

/**
 * Parent report starter — minimal teaching version.
 * Lesson memo (Sheet) -> AI draft -> human confirmation -> Google Doc.
 *
 * Rules this file enforces:
 *  1. Columns are found by header name, never by letter.
 *  2. Student names never leave the sheet. Only the memo (with names masked) goes to the AI.
 *  3. A report Doc is built only from a confirmed row. No confirmation, no report.
 */

var SHEET_LESSONS = '수업기록';
var SHEET_STUDENTS = '학생명단';
var LESSON_HEADERS = ['날짜', '학생ID', '반', '수업내용', '관찰메모', 'AI초안', '확정일시', '확정피드백', '리포트링크'];
var STUDENT_HEADERS = ['학생ID', '이름'];
var MODEL = 'gemini-3.8-flash';
var PROP_API_KEY = 'GEMINI_API_KEY';

// ---------- Menu (simple trigger: builds the menu only, touches no authorized service) ----------

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('학부모 리포트')
    .addItem('① 시트 준비', 'setupSheets')
    .addSeparator()
    .addItem('② 선택한 행 AI 초안 만들기', 'draftSelectedRow')
    .addItem('③ 선택한 행 확정하기', 'confirmSelectedRow')
    .addItem('④ 선택한 행 리포트 문서 만들기', 'buildReportForSelectedRow')
    .addToUi();
}

// ---------- Pure helpers (no Apps Script services; testable in Node) ----------

/** Maps header text to a 0-based column index. */
function headerMap(headerRow) {
  var map = {};
  for (var i = 0; i < headerRow.length; i++) {
    var key = String(headerRow[i]).trim();
    if (key) map[key] = i;
  }
  return map;
}

/** Returns the header names that are required but absent. */
function missingHeaders(map, required) {
  return required.filter(function (h) { return !(h in map); });
}

/** Replaces every known student name in the text with a neutral word. Longest names first. */
function maskNames(text, names) {
  var out = String(text || '');
  var sorted = names
    .map(function (n) { return String(n || '').trim(); })
    .filter(function (n) { return n.length >= 2; })
    .sort(function (a, b) { return b.length - a.length; });
  sorted.forEach(function (name) {
    out = out.split(name).join('학생');
  });
  return out;
}

/** Builds the request body. The student ID and name are deliberately not included. */
function buildRequestBody(lesson, names) {
  var memo = maskNames(lesson.memo, names);
  var content = maskNames(lesson.content, names);
  return {
    systemInstruction: {
      parts: [{
        text: [
          '너는 학원 선생님이 학부모에게 보낼 수업 피드백의 초안을 돕는다.',
          '주어진 메모에 있는 사실만 쓴다. 메모에 없는 점수, 등수, 칭찬을 지어내지 않는다.',
          '3~4문장, 존댓말, 과장 없이. 학생은 "학생"이라고만 부른다.',
          '성적 향상을 약속하거나 보장하는 표현을 쓰지 않는다.'
        ].join('\n')
      }]
    },
    contents: [{
      parts: [{ text: '반: ' + lesson.className + '\n수업 내용: ' + content + '\n관찰 메모: ' + memo }]
    }]
  };
}

/** Pulls the generated text out of a generateContent response. Throws with a readable reason. */
function extractText(json) {
  var candidate = json && json.candidates && json.candidates[0];
  var part = candidate && candidate.content && candidate.content.parts && candidate.content.parts[0];
  if (!part || !part.text) {
    var reason = (candidate && candidate.finishReason) || (json && json.promptFeedback && json.promptFeedback.blockReason) || '응답에 본문이 없습니다';
    throw new Error('AI 초안을 받지 못했습니다: ' + reason);
  }
  return String(part.text).trim();
}

/** The gate. A row may become a report only when it has both a confirmation time and confirmed text. */
function canPublish(lesson) {
  return Boolean(lesson.confirmedAt) && String(lesson.confirmedText || '').trim().length > 0;
}

// ---------- Sheet access ----------

function setupSheets() {
  var ss = SpreadsheetApp.getActive();
  ensureSheet_(ss, SHEET_LESSONS, LESSON_HEADERS);
  ensureSheet_(ss, SHEET_STUDENTS, STUDENT_HEADERS);
  SpreadsheetApp.getUi().alert('시트 준비가 끝났습니다. 이미 있던 열과 내용은 건드리지 않았습니다.');
}

/** Idempotent: creates the sheet if absent and appends only the headers that are missing. */
function ensureSheet_(ss, name, headers) {
  var sheet = ss.getSheetByName(name) || ss.insertSheet(name);
  var lastCol = Math.max(sheet.getLastColumn(), 1);
  var existing = headerMap(sheet.getRange(1, 1, 1, lastCol).getValues()[0]);
  var toAdd = missingHeaders(existing, headers);
  if (toAdd.length) {
    var start = Object.keys(existing).length ? sheet.getLastColumn() + 1 : 1;
    sheet.getRange(1, start, 1, toAdd.length).setValues([toAdd]).setFontWeight('bold');
    sheet.setFrozenRows(1);
  }
  return sheet;
}

/** Reads the currently selected lesson row into an object keyed by meaning, not by column letter. */
function readSelectedLesson_() {
  var sheet = SpreadsheetApp.getActiveSheet();
  if (sheet.getName() !== SHEET_LESSONS) throw new Error('"' + SHEET_LESSONS + '" 시트에서 행을 선택해 주세요.');
  var row = sheet.getActiveRange().getRow();
  if (row < 2) throw new Error('머리글이 아닌 수업 행을 선택해 주세요.');

  var map = headerMap(sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0]);
  var missing = missingHeaders(map, LESSON_HEADERS);
  if (missing.length) throw new Error('빠진 열이 있습니다: ' + missing.join(', ') + ' — 메뉴 ①을 먼저 실행하세요.');

  var values = sheet.getRange(row, 1, 1, sheet.getLastColumn()).getValues()[0];
  return {
    sheet: sheet, row: row, map: map,
    date: values[map['날짜']],
    studentId: String(values[map['학생ID']]).trim(),
    className: String(values[map['반']]).trim(),
    content: String(values[map['수업내용']]).trim(),
    memo: String(values[map['관찰메모']]).trim(),
    draft: String(values[map['AI초안']]).trim(),
    confirmedAt: values[map['확정일시']],
    confirmedText: String(values[map['확정피드백']]).trim(),
    reportUrl: String(values[map['리포트링크']]).trim()
  };
}

function writeCell_(lesson, header, value) {
  lesson.sheet.getRange(lesson.row, lesson.map[header] + 1).setValue(value);
}

/** Returns { names: [...], byId: {id: name} } from the roster sheet. */
function readRoster_() {
  var sheet = SpreadsheetApp.getActive().getSheetByName(SHEET_STUDENTS);
  if (!sheet || sheet.getLastRow() < 2) return { names: [], byId: {} };
  var data = sheet.getRange(1, 1, sheet.getLastRow(), sheet.getLastColumn()).getValues();
  var map = headerMap(data[0]);
  var byId = {};
  var names = [];
  for (var r = 1; r < data.length; r++) {
    var id = String(data[r][map['학생ID']]).trim();
    var name = String(data[r][map['이름']]).trim();
    if (id && name) { byId[id] = name; names.push(name); }
  }
  return { names: names, byId: byId };
}

// ---------- ② AI draft ----------

function draftSelectedRow() {
  var ui = SpreadsheetApp.getUi();
  try {
    var lesson = readSelectedLesson_();
    if (!lesson.memo) throw new Error('관찰메모가 비어 있습니다. 메모를 먼저 적어 주세요.');
    if (lesson.confirmedAt) throw new Error('이미 확정된 행입니다. 확정일시를 지운 뒤 다시 시도하세요.');

    var roster = readRoster_();
    var text = callGemini_(buildRequestBody(lesson, roster.names));
    writeCell_(lesson, 'AI초안', text);
    ui.alert('AI초안 칸에 초안을 넣었습니다. 읽고 고친 뒤 ③ 확정하기를 누르세요.');
  } catch (err) {
    ui.alert('초안을 만들지 못했습니다.\n\n' + err.message);
  }
}

function callGemini_(body) {
  var key = PropertiesService.getScriptProperties().getProperty(PROP_API_KEY);
  if (!key) throw new Error('스크립트 속성에 ' + PROP_API_KEY + ' 가 없습니다.');

  var url = 'https://generativelanguage.googleapis.com/v1beta/models/' + MODEL + ':generateContent';
  var response = UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    headers: { 'x-goog-api-key': key },
    payload: JSON.stringify(body),
    muteHttpExceptions: true
  });

  var code = response.getResponseCode();
  var raw = response.getContentText();
  if (code !== 200) throw new Error('Gemini API 응답 ' + code + ': ' + raw.slice(0, 300));
  return extractText(JSON.parse(raw));
}

// ---------- ③ Confirm (the only place that writes 확정피드백) ----------

function confirmSelectedRow() {
  var ui = SpreadsheetApp.getUi();
  try {
    var lesson = readSelectedLesson_();
    if (!lesson.draft) throw new Error('AI초안 칸이 비어 있습니다. 직접 써 넣어도 됩니다.');

    var answer = ui.alert('이 내용으로 확정할까요?', lesson.draft, ui.ButtonSet.YES_NO);
    if (answer !== ui.Button.YES) return;

    writeCell_(lesson, '확정피드백', lesson.draft);
    writeCell_(lesson, '확정일시', new Date());
  } catch (err) {
    ui.alert('확정하지 못했습니다.\n\n' + err.message);
  }
}

// ---------- ④ Report Doc (refuses unconfirmed rows) ----------

function buildReportForSelectedRow() {
  var ui = SpreadsheetApp.getUi();
  try {
    var lesson = readSelectedLesson_();
    if (!canPublish(lesson)) throw new Error('확정되지 않은 행입니다. ③ 확정하기를 먼저 누르세요.');

    var roster = readRoster_();
    var name = roster.byId[lesson.studentId];
    if (!name) throw new Error('학생명단에서 ' + lesson.studentId + ' 를 찾지 못했습니다.');

    var tz = Session.getScriptTimeZone();
    var dateText = Utilities.formatDate(new Date(lesson.date), tz, 'yyyy-MM-dd');

    var doc = DocumentApp.create(name + ' 수업 리포트 ' + dateText);
    var body = doc.getBody();
    body.appendParagraph(name + ' 학생 수업 리포트').setHeading(DocumentApp.ParagraphHeading.HEADING1);
    body.appendParagraph(dateText + ' · ' + lesson.className);
    body.appendParagraph('오늘 수업').setHeading(DocumentApp.ParagraphHeading.HEADING2);
    body.appendParagraph(lesson.content);
    body.appendParagraph('선생님 피드백').setHeading(DocumentApp.ParagraphHeading.HEADING2);
    body.appendParagraph(lesson.confirmedText);
    var url = doc.getUrl();
    doc.saveAndClose();

    writeCell_(lesson, '리포트링크', url);
    ui.alert('리포트 문서를 만들었습니다. 리포트링크 칸을 확인하세요.');
  } catch (err) {
    ui.alert('문서를 만들지 못했습니다.\n\n' + err.message);
  }
}