ヘヤログ 導入ガイド

所要時間：初期設定 3分／保存用スクリプトの設置 約10分

1アプリを開いてホーム画面に追加する

お申し込み時のメールに記載のURL（…/app/）をスマートフォンで開きます。

• iPhone（Safari）：画面下の共有ボタン → 「ホーム画面に追加」
• Android（Chrome）：右上のメニュー → 「ホーム画面に追加」または「アプリをインストール」

ホーム画面から開くと、電波の届かない部屋でも立会いの記録ができます（電波が戻ると自動で送信されます）。

2初期設定

1. 会社名を入力します（精算書に表示されます）。
2. メールでお送りした店舗IDとライセンスキーを入力します。
3. 保存用スクリプトを設置しない場合は、URLとパスワードを空欄のまま「設定を保存して始める」を押します。この場合、データはその端末の中にだけ保存されます。

3保存用スクリプトを設置する

案件データは自社のGoogleアカウント（スプレッドシート）に、写真はGoogleドライブに保存されます。当社のサーバには案件データを置きません。会社で管理しているGoogleアカウントで作業してください（担当者の個人アカウントは避けてください）。

1. 新しいスプレッドシートを作り、名前を「ヘヤログデータ」などにします。
2. メニューの「拡張機能」→「Apps Script」を開きます。
3. 最初からある function myFunction() {} をすべて消し、下のコードを貼り付けて保存（Ctrl+S / ⌘+S）します。
   コードをコピー
   /** * ヘヤログ 保存用スクリプト（お客様のGoogleアカウントに設置） * * 案件データはこのスプレッドシート、写真はGoogleドライブの「ヘヤログ_写真」フォルダに保存されます。 * 設置手順は SETUP.md を参照。スクリプトプロパティ PASSWORD にログイン用パスワードを設定してください。 */ var VERSION = '1.0.0'; var SHEET_CASES = 'cases'; var SHEET_SETTINGS = 'settings'; var EXT_FIELDS = ['owner', 'contractor', 'signature', 'signedAt', 'signedVia']; var STATUSES = ['入居中', '立会い前', '判定中', '精算書発行', '工事中', '完了']; var PUBLIC_ACTIONS = { view: 1, tenantSign: 1, ownerDecision: 1, contractorQuote: 1, contractorPhoto: 1, contractorDone: 1 }; function doGet() { return json_({ ok: true, service: 'heyalog-store', version: VERSION }); } function doPost(e) { var req; try { req = JSON.parse(e.postData.contents); } catch (err) { return json_({ ok: false, error: 'bad_json' }); } try { if (PUBLIC_ACTIONS[req.action] || (req.action === 'getPhoto' && req.token)) return json_(handlePublic_(req)); var auth = checkPassword_(req.pw); if (auth) return json_({ ok: false, error: auth }); switch (req.action) { case 'ping': return json_({ ok: true, version: VERSION }); case 'sync': return json_(withLock_(function () { return sync_(req); })); case 'putPhoto': return json_(putPhoto_(req.id, req.caseId, req.dataUrl)); case 'getPhoto': return json_(getPhoto_(req.fileId)); } return json_({ ok: false, error: 'unknown_action' }); } catch (err) { return json_({ ok: false, error: String((err && err.message) || err) }); } } // ---------- 認証（総当たり対策つき） ---------- function checkPassword_(pw) { var expected = PropertiesService.getScriptProperties().getProperty('PASSWORD'); if (!expected) return 'no_password_set'; var cache = CacheService.getScriptCache(); var fails = Number(cache.get('pwfail') || 0); if (fails >= 20) return 'locked'; if (String(pw || '') !== expected) { cache.put('pwfail', String(fails + 1), 600); return 'unauthorized'; } return ''; } function withLock_(fn) { var lock = LockService.getScriptLock(); lock.waitLock(30000); try { return fn(); } finally { lock.releaseLock(); } } // ---------- シート ---------- function sheet_(name, header) { var ss = SpreadsheetApp.getActiveSpreadsheet(); var sh = ss.getSheetByName(name); if (!sh) { sh = ss.insertSheet(name); sh.appendRow(header); sh.setFrozenRows(1); } return sh; } function casesSheet_() { return sheet_(SHEET_CASES, ['id', 'updatedAt', 'extAt', 'json', '物件', '部屋', '入居者', '状況']); } function readAll_() { var sh = casesSheet_(); var values = sh.getDataRange().getValues(); var rows = []; for (var r = 1; r < values.length; r++) { if (!values[r][0] || !values[r][3]) continue; rows.push({ row: r + 1, id: String(values[r][0]), json: String(values[r][3]) }); } return rows; } function writeCase_(rec, rowNum) { var sh = casesSheet_(); var line = [rec.id, rec.updatedAt || 0, rec.extAt || 0, JSON.stringify(rec), rec.property || '', rec.room || '', rec.tenant || '', rec.deleted ? '削除' : (rec.status || '')]; if (rowNum) sh.getRange(rowNum, 1, 1, line.length).setValues([line]); else sh.appendRow(line); } function mergeCase_(server, incoming) { var base = (incoming.updatedAt || 0) > (server.updatedAt || 0) ? clone_(incoming) : clone_(server); var ext = (server.extAt || 0) >= (incoming.extAt || 0) ? server : incoming; EXT_FIELDS.forEach(function (f) { base[f] = ext[f]; }); base.extAt = Math.max(server.extAt || 0, incoming.extAt || 0); if (ext === server && STATUSES.indexOf(server.status) > STATUSES.indexOf(base.status)) base.status = server.status; base.photoFiles = assign_({}, server.photoFiles || {}, incoming.photoFiles || {}); var seen = {}; base.log = (server.log || []).concat(incoming.log || []).filter(function (l) { var k = l.at + l.text; if (seen[k]) return false; seen[k] = 1; return true; }).sort(function (x, y) { return x.at < y.at ? -1 : 1; }); return base; } function sync_(req) { var rows = readAll_(); var byId = {}; rows.forEach(function (r) { byId[r.id] = r; }); (req.records || []).forEach(function (rec) { if (!rec || !rec.id) return; var cur = byId[rec.id]; if (!cur) { writeCase_(rec, null); return; } writeCase_(mergeCase_(JSON.parse(cur.json), rec), cur.row); }); if (req.settings) saveSettings_(req.settings); var since = Number(req.since || 0); var out = []; readAll_().forEach(function (r) { var rec = JSON.parse(r.json); if (Math.max(rec.updatedAt || 0, rec.extAt || 0) > since) out.push(rec); }); return { ok: true, records: out, settings: loadSettings_(), serverTime: Date.now() }; } function loadSettings_() { var sh = sheet_(SHEET_SETTINGS, ['key', 'json']); var v = sh.getRange(2, 2).getValue(); return v ? JSON.parse(v) : {}; } function saveSettings_(incoming) { var cur = loadSettings_(); if ((incoming.settingsAt || 0) <= (cur.settingsAt || 0)) return; var sh = sheet_(SHEET_SETTINGS, ['key', 'json']); sh.getRange(2, 1, 1, 2).setValues([['shared', JSON.stringify(incoming)]]); } // ---------- 写真（Googleドライブ） ---------- function photoFolder_() { var props = PropertiesService.getScriptProperties(); var id = props.getProperty('PHOTO_FOLDER_ID'); if (id) { try { return DriveApp.getFolderById(id); } catch (e) { /* 作り直す */ } } var folder = DriveApp.createFolder('ヘヤログ_写真'); props.setProperty('PHOTO_FOLDER_ID', folder.getId()); return folder; } function putPhoto_(id, caseId, dataUrl) { var m = String(dataUrl || '').match(/^data:(image\/[a-z]+);base64,(.+)$/); if (!m) return { ok: false, error: 'bad_image' }; var blob = Utilities.newBlob(Utilities.base64Decode(m[2]), m[1], (caseId || 'case') + '_' + id + '.jpg'); var file = photoFolder_().createFile(blob); return { ok: true, fileId: file.getId() }; } function getPhoto_(fileId) { var file; try { file = DriveApp.getFileById(fileId); } catch (e) { return { ok: false, error: 'not_found' }; } // ヘヤログフォルダ内のファイルだけを返す var folderId = photoFolder_().getId(); var parents = file.getParents(); var inFolder = false; while (parents.hasNext()) { if (parents.next().getId() === folderId) inFolder = true; } if (!inFolder) return { ok: false, error: 'forbidden' }; var blob = file.getBlob(); return { ok: true, dataUrl: 'data:' + blob.getContentType() + ';base64,' + Utilities.base64Encode(blob.getBytes()) }; } // ---------- 共有リンク（入居者・オーナー・業者） ---------- function findByToken_(token) { if (!token || String(token).length < 20) return null; var rows = readAll_(); for (var i = 0; i < rows.length; i++) { if (rows[i].json.indexOf(token) < 0) continue; var rec = JSON.parse(rows[i].json); if (rec.deleted || !rec.links) continue; for (var role in rec.links) { if (rec.links[role] === token) return { rec: rec, row: rows[i].row, role: role }; } } return null; } function publicView_(rec, role) { var c = clone_(rec); ['links', 'log', 'revoked', 'dirty'].forEach(function (k) { delete c[k]; }); if (role !== 'tenant') { delete c.signature; delete c.tenantEmail; } if (role === 'tenant') { delete c.owner; delete c.contractor; } if (role === 'contractor') { delete c.deposit; delete c.owner; delete c.cleaningSpecial; } // 写真の対応表は、この画面で見せる写真だけに絞る var allowed = {}; (c.items || []).forEach(function (it) { (it.photoIds || []).forEach(function (p) { allowed[p] = 1; }); }); if (role === 'contractor' && c.contractor) (c.contractor.photos || []).forEach(function (p) { allowed[p] = 1; }); var pf = {}; Object.keys(c.photoFiles || {}).forEach(function (p) { if (allowed[p]) pf[p] = c.photoFiles[p]; }); c.photoFiles = pf; delete c.moveInPhotos; return c; } function pendingCount_(rec) { return (rec.items || []).filter(function (i) { return i.burden === '要確認' || !i.confirmed; }).length; } function handlePublic_(req) { var cache = CacheService.getScriptCache(); var hits = Number(cache.get('pub') || 0); if (hits > 600) return { ok: false, error: 'rate_limited' }; cache.put('pub', String(hits + 1), 60); var found = findByToken_(req.token); if (!found) return { ok: false, error: 'not_found' }; var rec = found.rec; var role = found.role; var settings = loadSettings_(); if (req.action === 'view') { return { ok: true, role: role, company: settings.company || '', tel: settings.tel || '', case: publicView_(rec, role) }; } if (req.action === 'getPhoto') { var view = publicView_(rec, role); var ok = Object.keys(view.photoFiles).some(function (p) { return view.photoFiles[p] === req.fileId; }); return ok ? getPhoto_(req.fileId) : { ok: false, error: 'forbidden' }; } return withLock_(function () { // ロック取得後に最新を読み直す found = findByToken_(req.token); if (!found) return { ok: false, error: 'not_found' }; rec = found.rec; var now = new Date().toISOString(); var note = ''; if (req.action === 'tenantSign' && role === 'tenant') { if (pendingCount_(rec) > 0) return { ok: false, error: 'pending' }; if (!/^data:image\/(png|jpeg);base64,/.test(String(req.signature || '')) || String(req.signature).length > 400000) return { ok: false, error: 'bad_signature' }; rec.signature = req.signature; rec.signedAt = now.slice(0, 10); rec.signedVia = 'link'; if (STATUSES.indexOf(rec.status) < STATUSES.indexOf('精算書発行')) rec.status = '精算書発行'; note = '入居者がリンクから署名しました'; } else if (req.action === 'ownerDecision' && role === 'owner') { if (['approved', 'rejected'].indexOf(req.decision) < 0) return { ok: false, error: 'bad_decision' }; rec.owner = assign_(rec.owner || {}, { decision: req.decision, comment: String(req.comment || '').slice(0, 2000), decidedAt: now }); note = 'オーナーが' + (req.decision === 'approved' ? '承認しました' : '差し戻しました') + (req.comment ? '：' + req.comment : ''); } else if (req.action === 'contractorQuote' && role === 'contractor') { rec.contractor = assign_(rec.contractor || {}, { quote: Number(req.quote) || 0, quoteNote: String(req.quoteNote || '').slice(0, 1000), quotedAt: now }); if (rec.contractor.status !== 'done') rec.contractor.status = 'quoted'; note = '業者が見積を登録しました：' + rec.contractor.quote + '円'; } else if (req.action === 'contractorPhoto' && role === 'contractor') { var id = String(req.id || '').replace(/[^a-z0-9]/gi, '').slice(0, 20); if (!id) return { ok: false, error: 'bad_id' }; var put = putPhoto_(id, rec.id, req.dataUrl); if (!put.ok) return put; rec.contractor = rec.contractor || {}; rec.contractor.photos = (rec.contractor.photos || []).concat([id]); rec.photoFiles = rec.photoFiles || {}; rec.photoFiles[id] = put.fileId; } else if (req.action === 'contractorDone' && role === 'contractor') { rec.contractor = assign_(rec.contractor || {}, { status: 'done', doneAt: now, doneNote: String(req.doneNote || '').slice(0, 2000) }); note = '業者が工事完了を報告しました'; } else { return { ok: false, error: 'forbidden' }; } rec.extAt = Date.now(); if (note) { rec.log = (rec.log || []).concat([{ at: now, text: note }]); notify_(settings, rec, note); } writeCase_(rec, found.row); return { ok: true }; }); } function notify_(settings, rec, note) { if (!settings.notifyEmail) return; try { MailApp.sendEmail({ to: settings.notifyEmail, subject: '【ヘヤログ】' + rec.property + ' ' + rec.room + '：' + note.split('：')[0], body: rec.property + ' ' + rec.room + '（' + rec.tenant + ' 様）\n\n' + note + '\n\nヘヤログを開いて内容を確認してください。', }); } catch (e) { /* 送信上限などは無視 */ } } // ---------- 共通 ---------- function clone_(o) { return JSON.parse(JSON.stringify(o)); } function assign_(t) { for (var i = 1; i < arguments.length; i++) { var s = arguments[i]; for (var k in s) if (Object.prototype.hasOwnProperty.call(s, k)) t[k] = s[k]; } return t; } function json_(obj) { return ContentService.createTextOutput(JSON.stringify(obj)).setMimeType(ContentService.MimeType.JSON); } // 初回設置時に一度だけ実行（Drive・メールの権限承認とフォルダ作成） function setup() { casesSheet_(); sheet_(SHEET_SETTINGS, ['key', 'json']); photoFolder_(); if (!PropertiesService.getScriptProperties().getProperty('PASSWORD')) { throw new Error('スクリプトプロパティ PASSWORD を設定してから、もう一度実行してください'); } Logger.log('準備ができました。デプロイ → 新しいデプロイ → ウェブアプリ で公開してください。'); }
4. 左の歯車「プロジェクトの設定」→ 下の「スクリプト プロパティ」→「スクリプト プロパティを追加」で、
   プロパティ PASSWORD、値にログイン用のパスワード（8文字以上・担当者で共有）を入れて保存します。
5. エディタに戻り、上部の関数の選択で setup を選んで「実行」を押します。権限の確認が出たら、自社のアカウントを選んで「許可」します。
   「このアプリは Google で確認されていません」と表示された場合は「詳細」→「（プロジェクト名）に移動」を選びます。自社で作ったスクリプトなので問題ありません。
6. 右上の「デプロイ」→「新しいデプロイ」→ 種類の選択（歯車）で「ウェブアプリ」を選び、
   「次のユーザーとして実行」＝自分、「アクセスできるユーザー」＝全員 にして「デプロイ」します。
7. 表示された「ウェブアプリのURL」（https://script.google.com/macros/s/…/exec）をコピーします。
8. ヘヤログの「設定」→「データの保存先」に、URLと手順4のパスワードを入れて「保存」します。「同期済み」と表示されれば完了です。

4単価表を設定する

「設定」→「単価表」に、自社の協力業者の単価（クロス1㎡あたり、クリーニング1式など）を入れて保存します。お使いの単価表（Excel等）をお送りいただければ、無料で入力を代行します。

通知先メールを入れておくと、入居者の署名・オーナーの回答・業者の報告が届いたときにメールでお知らせします。

52台目以降の端末を追加する

新しい端末でアプリを開き、初期設定で会社名・店舗ID・ライセンスキーと、同じ保存用スクリプトのURL・パスワードを入れます。案件・写真・単価表は自動で読み込まれます。

6よくあるつまずき

• 「パスワードが違います」：スクリプト プロパティの PASSWORD と同じ文字を入れてください（前後の空白に注意）。20回続けて間違えると10分間ロックされます。
• 「接続できません」：デプロイ時の「アクセスできるユーザー」が「全員」になっているか確認してください。URLは /exec で終わるものを使います。
• コードを更新したとき：「デプロイ」→「デプロイを管理」→ 鉛筆アイコン → バージョン「新バージョン」→「デプロイ」。URLは変わりません。
• 写真が「未取得」と表示される：その端末で同期がまだ終わっていません。電波の良い場所でアプリを開き直してください。

ご不明な点は、お申し込み時のメールにご返信ください。