Автоматизированный финансовый учет и контроль рентабельности

Обзор проекта

Stack:           Google Apps Script (V8 Runtime)
Core:            LibraryScript.js — 8 800+ LOC, 110 functions
Client Wrapper:  Code.js — 82 LOC
APIs integrated: 7 (Wildberries) + Sheets API v4 + Drive API
Architecture:    Library Pattern + State Machine Orchestrator
Deployment:      clasp CLI → obfuscated build → Google Cloud

Ключевые характеристики:

• Полностью serverless — работает в облаке Google, zero-cost infrastructure
• Обфускация ядра для защиты IP (JavaScript Obfuscator)
• CI/CD через clasp CLI: dev:push:lib / prod:push пайплайны
• 17 листов генерируются и форматируются программно

Архитектурные паттерны

Wrapper + Core (Code.js → LibraryScript.js)

+-----------------------------------------------------+
|  Client Spreadsheet (Code.js - 82 LOC)              |
|                                                     |
|  onOpen(e) -> WBToolLibrary.buildMenu()             |
|                                                     |
|  menuAction1()  --+                                 |
|  menuAction2()  --+                                 |
|  ...            --+--> _run(slot)                   |
|  menuAction25() --+      |                          |
|                          v                          |
|              try { WBToolLibrary                    |
|                .dispatchMenuAction(slot) }          |
|              catch(e) { _showError(e) }             |
+-----------------------+-----------------------------+
                        | Library Bridge              |
+-----------------------v-----------------------------+
|  WBToolLibrary (LibraryScript.js - 8800+ LOC)       |
|                                                     |
|  dispatchMenuAction(slot) {                         |
|    switch(slot) {                                   |
|      case 1: return startReportMerging();           |
|      case 7: return calculateCFR();                 |
|      case 18: return actualizeSkuData();            |
|      ...                                            |
|    }                                                |
|  }                                                  |
+-----------------------------------------------------+

            

State Machine Orchestrator (обход 6-минутного лимита)

Google Apps Script убивает любой скрипт через 6 минут. WBTool загружает данные из 8 API-эндпоинтов, что занимает 15–40 минут. Решение — Finite State Machine на базе минутных триггеров.

+-----------------------------------------------------+
|              actualizeSkuData(isBackground)         |
|                                                     |
|  State = PropertiesService.get("WB_ACTUALIZE_STATE")|
|  {                                                  |
|    "currentStep": 3,        // 0..7                 |
|    "dateTo": "2024-05-31",                          |
|    "startTime": 1717144800  // stale session guard  |
|  }                                                  |
|                                                     |
|  while (state.currentStep <= 7) {                   |
|    if (elapsed > 250s) {    // <- 4.1 min guard     |
|      saveState();                                   |
|      return;  // exit gracefully, trigger continues |
|    }                                                |
|    executeStep(state.currentStep);                  |
|    state.currentStep++;                             |
|  }                                                  |
|                                                     |
|  deleteAllTriggers();                               |
|  showSuccess("✅ Завершено");                       |
+-----------------------------------------------------+
         ^                          |
         |  every 1 min             | on first call
         |                          v
    +----+----------------------------------+
    |  ScriptApp.newTrigger('menuAction25') |
    |    .timeBased()                       |
    |    .everyMinutes(1)                   |
    |    .create();                         |
    +---------------------------------------+

Механика:

• Пользователь нажимает «🔄 Актуализировать» → запускается Step 0
• Оркестратор создаёт ежеминутный фоновый триггер
• Каждую минуту триггер «будит» оркестратор с сохранённого шага
• При превышении 250 секунд — graceful exit + сохранение JSON-состояния
• На финальном шаге триггер удаляется, статус → «✅ Завершено»
• Пользователь может закрыть таблицу — процесс продолжится в облаке

Работа с API Wildberries

Rate Limiting & Retry Strategy

+-------------------------------------------------+
|           _handleApiResponse(response, apiName) |
|                                                 |
|  HTTP 200-299 -> JSON.parse(body)               |
|    +- catch: "API вернуло невалидный JSON"      |
|                                                 |
|  HTTP 401/403 -> context-aware error            |
|    +- apiName.includes('promotion')             |
|       ? "Нужны права «Продвижение»"             |
|       : "Проверьте токен WB"                    |
|                                                 |
|  HTTP 429 -> throw Error (NOT sleep!)           |
|    +- Перехватывается Оркестратором             |
|       -> increment error counter                |
|       -> exit session                           |
|       -> retry in 1 min via trigger             |
|                                                 |
|  HTTP 5xx -> throw "Сервер WB недоступен"       |
+-------------------------------------------------+

Исключение — Supplies API (Поставки)

Этот API требует сотни последовательных GET-запросов. Здесь используется динамический парсинг HTTP-заголовков:

if (responseCode === 429) {
  var headers = response.getHeaders();
  var retryAfter = headers['retry-after'] || headers['x-ratelimit-retry'];
  var waitMs = retryAfter ? (parseInt(retryAfter, 10) + 1) * 1000 : 5000;
  Utilities.sleep(waitMs);  // точное время бана от WB
}

Оптимизация производительности

Batch-операции с Sheets API v4

Форматирование P&L-отчёта (38 строк × 50+ колонок) через стандартный getRange().setBackground() занимает ~30 секунд. WBTool использует Advanced Sheets API v4 BatchUpdate:

// Один запрос вместо сотен
var requests = [];
requests.push({ updateSheetProperties: { ... } });
requests.push({ repeatCell: { range: {...}, cell: { format: { backgroundColor: ... } } } });
// ... 50+ операций форматирования

Sheets.Spreadsheets.batchUpdate({ requests: requests }, spreadsheetId);
// Время: ~0.5 секунды

High-Performance XLSX Parser

Стандартная конвертация Excel→Google Sheets через Drive API: 30–60 секунд на файл. WBTool парсит XLSX напрямую в памяти как ZIP-архив:

blob.setContentType('application/zip');
var xmlFiles = Utilities.unzip(blob);
// Парсинг xl/sharedStrings.xml через String.split(' тегов

Безопасность и защита данных

Технологии и инструменты

Ключевые инженерные решения