Place decoded task codes beside the task name columns.

Report mail and KPI blocks follow header names, so the inserted columns do not shift the wrong fields.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Dmitriy_Kravchenko 2026-09-22 11:46:45 +03:00
parent d402220f62
commit 79ba28f4aa
11 changed files with 238 additions and 67 deletions

View File

@ -127,6 +127,61 @@ export function getTaskStatusName(statusId: string | number): string {
return TASK_STATUS_NAMES[String(statusId)] || String(statusId);
}
const TASK_NAME_HEADERS = [
'наименование задачи',
'название задачи',
'название',
];
export function taskCodeDecodeHeader(optionalColumnName?: string): string {
return optionalColumnName
? 'Расшифровка кода для столбца ' + optionalColumnName
: 'Расшифровка кода';
}
export function decodeTaskCodeText(taskText: unknown): string {
const code = String(beforeHash(String(taskText ?? '')) ?? '').trim().slice(0, -1);
if (!code) {
return '';
}
return [...code]
.map(letter => TASK_CODE_DICTIONARY[letter] || '')
.join(' ');
}
export function buildDecodedTaskCodeColumn(
values: any[][],
optionalColumnName?: string
): { sourceColumnIndex: number; column: string[][] } {
if (values.length === 0) {
throw new Error('На листе нет данных для расшифровки кода.');
}
const headers = values[0].map(header => String(header).trim().toLowerCase());
const wanted = optionalColumnName
? [optionalColumnName.trim().toLowerCase()]
: TASK_NAME_HEADERS;
const sourceColumnIndex = headers.findIndex(name => wanted.includes(name));
if (sourceColumnIndex === -1) {
throw new Error(
optionalColumnName
? `Не найден столбец "${optionalColumnName}".`
: 'Не найден столбец "Наименование задачи" или "Название задачи".'
);
}
const column: string[][] = [[taskCodeDecodeHeader(optionalColumnName)]];
for (let row = 1; row < values.length; row++) {
column.push([decodeTaskCodeText(values[row][sourceColumnIndex])]);
}
return { sourceColumnIndex, column };
}
export function decodeTaskCodes(
sheet: GoogleAppsScript.Spreadsheet.Sheet,
optionalColumnName?: string
@ -142,51 +197,18 @@ export function decodeTaskCodes(
return;
}
const headers = values[0];
const taskColumnIndex = headers.findIndex(header => {
const name = String(header).trim().toLowerCase();
const decoded = buildDecodedTaskCodeColumn(values, optionalColumnName);
const sourceColumn = range.getColumn() + decoded.sourceColumnIndex;
const targetColumn = sourceColumn + 1;
return (
name === 'наименование задачи' ||
name === 'название задачи' ||
name === optionalColumnName
);
});
if (taskColumnIndex === -1) {
throw new Error(
'Не найден столбец "Наименование задачи" или "Название задачи".'
);
}
const outputColumnIndex = values[0].length;
const result: string[][] = [];
result.push(
optionalColumnName
? ['Расшифровка кода для столбца ' + optionalColumnName]
: ['Расшифровка кода']
);
for (let row = 1; row < values.length; row++) {
const taskText = String(values[row][taskColumnIndex] ?? '');
const code = String(beforeHash(taskText) ?? '').trim().slice(0, -1);
if (!code) {
result.push(['']);
continue;
}
const decoded = [...code]
.map(letter => TASK_CODE_DICTIONARY[letter] || '')
.join(' ');
result.push([decoded]);
}
sheet.insertColumnAfter(sourceColumn);
const targetRange = sheet.getRange(range.getRow(), targetColumn, decoded.column.length, 1);
sheet
.getRange(1, outputColumnIndex + 1, result.length, 1)
.setValues(result);
.getRange(range.getRow(), sourceColumn, decoded.column.length, 1)
.copyTo(targetRange, SpreadsheetApp.CopyPasteType.PASTE_FORMAT, false);
targetRange.clearDataValidations();
targetRange.setValues(decoded.column);
}
export function bitrixBooleanToString(value: any): any {

View File

@ -2,11 +2,14 @@ import { EXECUTOR_SHEET_NAMES } from '../../core/constants';
import { askUser } from '../../core/ui';
import { getUserEmailMap } from '../../core/mail/emailConfig';
import { loadConfig, saveConfig } from '../../core/mail/executorTables';
import { taskCodeDecodeHeader } from '../../core/taskCodes';
import { sendExecutorNotification } from './executorEmail';
const EXECUTOR_SHEET_HEADERS = [
'Название задачи',
taskCodeDecodeHeader(),
'Название родительской задачи',
taskCodeDecodeHeader('Название родительской задачи'),
'ID Р. задачи',
'ID задачи',
'Исполнитель',
@ -22,8 +25,6 @@ const EXECUTOR_SHEET_HEADERS = [
'Требует внимания',
'Комментарий исполнителя',
'Комментарий руководителя',
'Расшифровка кода',
'Расшифровка кода для столбца Название родительской задачи'
];
export function distributeTasksToExecutors(): void {
@ -80,7 +81,12 @@ export function distributeTasksToExecutors(): void {
grouped[executor] = [];
}
grouped[executor].push(row);
grouped[executor].push(
EXECUTOR_SHEET_HEADERS.map(header => {
const index = col[header];
return index === undefined ? '' : row[index];
})
);
});
Object.keys(grouped).forEach(executor => {

View File

@ -292,10 +292,24 @@ function writeKpi(
];
const columnIndexes = getColumnIndexesByName(1, ['Исполнитель', 'Руководитель филиала']);
const labelColumn = findHeaderColumn(sheet, 'Наименование задачи');
const valueColumn = findHeaderColumn(sheet, 'Дата создания');
if (labelColumn === -1 || valueColumn === -1) {
throw new Error('Не найдены столбцы для блока оценки руководителя');
}
sheet.getRange(startRow, columnIndexes[0], 7, 1).setValues(Array.from({ length: 7 }, () => [executorName]));
sheet.getRange(startRow, columnIndexes[1], 7, 1).setValues(Array.from({ length: 7 }, () => [filialHeadName]));
sheet.getRange(startRow, 2, data.length, 2)
.setValues(data)
data.forEach((pair, offset) => {
sheet.getRange(startRow + offset, labelColumn).setValue(pair[0]);
sheet.getRange(startRow + offset, valueColumn).setValue(pair[1]);
});
sheet.getRange(startRow, labelColumn, data.length, 1)
.setBackground('#ffff00')
.setBorder(true, true, true, true, true, true);
sheet.getRange(startRow, valueColumn, data.length, 1)
.setBackground('#ffff00')
.setBorder(true, true, true, true, true, true);
@ -303,13 +317,21 @@ function writeKpi(
.requireValueInList([1, 2, 3, 4, 5])
.setAllowInvalid(false)
.build();
sheet.getRange(startRow + 4, 3, 1, 1).setDataValidation(rule);
sheet.getRange(startRow + 4, valueColumn, 1, 1).setDataValidation(rule);
}
function setupConditionalFormatting(sheet: GoogleAppsScript.Spreadsheet.Sheet): void {
const MARKER = 'Оценка руководителя филиала (1-5):';
const lastRow = sheet.getLastRow();
const values = sheet.getRange(1, 2, lastRow, 1).getValues();
const labelColumn = findHeaderColumn(sheet, 'Наименование задачи');
const valueColumn = findHeaderColumn(sheet, 'Дата создания');
if (labelColumn === -1 || valueColumn === -1) {
throw new Error('Не найдены столбцы для блока оценки руководителя');
}
const values = sheet.getRange(1, labelColumn, lastRow, 1).getValues();
const valueLetter = columnIndexToLetter(valueColumn);
const rules: GoogleAppsScript.Spreadsheet.ConditionalFormatRule[] = [];
for (let row = 1; row <= values.length; row++) {
@ -319,15 +341,18 @@ function setupConditionalFormatting(sheet: GoogleAppsScript.Spreadsheet.Sheet):
const scoreRow = row;
const formula =
`=OR(` +
`VALUE(REGEXEXTRACT($C$${percentRow};"^\\d+"))<50;` +
`$C$${scoreRow}<4` +
`VALUE(REGEXEXTRACT($${valueLetter}$${percentRow};"^\\d+"))<50;` +
`$${valueLetter}$${scoreRow}<4` +
`)`;
rules.push(
SpreadsheetApp.newConditionalFormatRule()
.whenFormulaSatisfied(formula)
.setBackground('#ff0000')
.setRanges([sheet.getRange(row + 1, 3), sheet.getRange(row + 2, 3)])
.setRanges([
sheet.getRange(row + 1, valueColumn),
sheet.getRange(row + 2, valueColumn)
])
.build()
);
}
@ -335,6 +360,25 @@ function setupConditionalFormatting(sheet: GoogleAppsScript.Spreadsheet.Sheet):
sheet.setConditionalFormatRules(rules);
}
function findHeaderColumn(sheet: GoogleAppsScript.Spreadsheet.Sheet, columnName: string): number {
const headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
const index = headers.findIndex(header => String(header).trim() === columnName);
return index === -1 ? -1 : index + 1;
}
function columnIndexToLetter(columnIndex: number): string {
let index = columnIndex;
let letter = '';
while (index > 0) {
const remainder = (index - 1) % 26;
letter = String.fromCharCode(65 + remainder) + letter;
index = Math.floor((index - 1) / 26);
}
return letter;
}
function getObjects(sheet: GoogleAppsScript.Spreadsheet.Sheet, mapping: Record<string, string>) {
const data = sheet.getDataRange().getValues();
if (data.length < 2) return [];

View File

@ -17,14 +17,24 @@ function validateBlocks() {
};
}
const labelColumn = findHeaderColumn(sheet, 'Наименование задачи');
const valueColumn = findHeaderColumn(sheet, 'Дата создания');
if (labelColumn === -1 || valueColumn === -1) {
return {
valid: false,
errors: 'Не найдены столбцы "Наименование задачи" или "Дата создания"'
};
}
const lastRow = sheet.getLastRow();
const columnB = sheet.getRange(1, 2, lastRow, 1).getValues();
const labels = sheet.getRange(1, labelColumn, lastRow, 1).getValues();
const errors: string[] = [];
const metricsStorage = new MetricsStorage();
const now = new Date();
for (let row = 1; row <= lastRow; row++) {
if (columnB[row - 1][0] !== MARKER) continue;
if (labels[row - 1][0] !== MARKER) continue;
const percentRow = row - 4;
const scoreRow = row;
@ -35,10 +45,10 @@ function validateBlocks() {
const executor = sheet.getRange(infoRow, executorCol).getDisplayValue().trim();
const filialHead = sheet.getRange(infoRow, filialHeadCol).getDisplayValue().trim();
const personInfo = `"${filialHead}","${executor}"`;
const percentValue = sheet.getRange(percentRow, 3).getDisplayValue().trim();
const scoreValue = sheet.getRange(scoreRow, 3).getDisplayValue().trim();
const commentValue = sheet.getRange(commentRow, 3).getDisplayValue().trim();
const taskValue = sheet.getRange(taskRow, 3).getDisplayValue().trim();
const percentValue = sheet.getRange(percentRow, valueColumn).getDisplayValue().trim();
const scoreValue = sheet.getRange(scoreRow, valueColumn).getDisplayValue().trim();
const commentValue = sheet.getRange(commentRow, valueColumn).getDisplayValue().trim();
const taskValue = sheet.getRange(taskRow, valueColumn).getDisplayValue().trim();
if (!scoreValue) {
errors.push(`${personInfo}: не заполнена оценка `);
@ -62,6 +72,12 @@ function validateBlocks() {
};
}
function findHeaderColumn(sheet: GoogleAppsScript.Spreadsheet.Sheet, columnName: string): number {
const headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
const index = headers.findIndex(header => String(header).trim() === columnName);
return index === -1 ? -1 : index + 1;
}
export function notifySalesDepartmentHead(): void {
const confirmed = askUser('Подтвеждаете отправку?');
if (!confirmed) return;

View File

@ -1,4 +1,5 @@
import { EXECUTOR_SHEET_NAMES } from '../../core/constants';
import { taskCodeDecodeHeader } from '../../core/taskCodes';
import { askUser } from '../../core/ui';
import { getUserEmailMap } from '../../core/mail/emailConfig';
import { loadConfig } from '../../core/mail/executorTables';
@ -56,8 +57,10 @@ export function distributeOverdueTasksToExecutors(): void {
executorTasks[executor].push([
row[col[REPORT.TASK_ID]],
row[col[REPORT.TASK_NAME]],
cell(row, col, taskCodeDecodeHeader()),
row[col[REPORT.DESC]],
row[col[REPORT.PARENT_TASK_NAME]],
cell(row, col, taskCodeDecodeHeader(REPORT.PARENT_TASK_NAME)),
row[col[REPORT.CRM]],
row[col[REPORT.CREATOR]],
row[col[REPORT.EXECUTOR]],
@ -74,7 +77,8 @@ export function distributeOverdueTasksToExecutors(): void {
}
const targetHeaders = [
REPORT.TASK_ID, REPORT.TASK_NAME, REPORT.DESC, REPORT.PARENT_TASK_NAME,
REPORT.TASK_ID, REPORT.TASK_NAME, taskCodeDecodeHeader(), REPORT.DESC,
REPORT.PARENT_TASK_NAME, taskCodeDecodeHeader(REPORT.PARENT_TASK_NAME),
REPORT.CRM, REPORT.CREATOR, REPORT.EXECUTOR, REPORT.CREATED, REPORT.DEADLINE,
REPORT.LOSS_CLIENT, REPORT.PRICE, REPORT.TRANSFER_COUNT, REPORT.NEED_REASON,
REPORT.OLD_REASON, REPORT.NEW_REASON, REPORT.NEW_DEADLINE
@ -139,6 +143,11 @@ export function distributeOverdueTasksToExecutors(): void {
});
}
function cell(row: any[], col: Record<string, number>, header: string): any {
const index = col[header];
return index === undefined ? '' : row[index];
}
function sendOverdueExecutorEmail(email: string, spreadsheetUrl: string): void {
if (!email || !spreadsheetUrl) return;

View File

@ -124,15 +124,19 @@ export function createOverdueTasksReport(): void {
reportSheet.getRange(1, 1, output.length, reportHeaders.length).setValues(output);
decodeTaskCodes(reportSheet);
decodeTaskCodes(reportSheet, 'Наименование родительской задачи');
reportSheet.getRange(1, 1, 1, reportHeaders.length).setBackground('yellow');
reportSheet.getRange(1, 1, 1, reportSheet.getLastColumn()).setBackground('yellow');
addApprovalDropdowns(reportSheet);
const lastCol = reportSheet.getDataRange().getNumColumns();
reportSheet.autoResizeColumns(1, lastCol);
setReportSheetFormat(reportSheet);
reportSheet.setColumnWidth(col['Наименование задачи'] + 1, 300);
reportSheet.setColumnWidth(col['Описание'] + 1, 300);
reportSheet.setColumnWidth(col['Наименование родительской задачи'] + 1, 300);
const reportHeaderRow = reportSheet.getRange(1, 1, 1, reportSheet.getLastColumn()).getValues()[0];
['Наименование задачи', 'Описание', 'Наименование родительской задачи'].forEach(name => {
const index = reportHeaderRow.findIndex(header => String(header).trim() === name);
if (index !== -1) {
reportSheet.setColumnWidth(index + 1, 300);
}
});
}
function addApprovalDropdowns(sheet: GoogleAppsScript.Spreadsheet.Sheet): void {

View File

@ -1,6 +1,7 @@
import { askUser } from '../../core/ui';
import { getUserEmailMap } from '../../core/mail/emailConfig';
import { sendTempSpreadsheetToEmail } from '../../core/sheets/export';
import { taskCodeDecodeHeader } from '../../core/taskCodes';
export function sendTasksToCreatorsForApproval(): void {
const confirmed = askUser('Подтвеждаете отправку?');
@ -32,8 +33,10 @@ export function sendTasksToCreatorsForApproval(): void {
creators[creator].push([
row[col['ID задачи']],
row[col['Наименование задачи']],
cell(row, col, taskCodeDecodeHeader()),
row[col['Описание']],
row[col['Наименование родительской задачи']],
cell(row, col, taskCodeDecodeHeader('Наименование родительской задачи')),
row[col['Элементы CRM']],
row[col['Постановщик']],
row[col['Исполнитель']],
@ -51,7 +54,8 @@ export function sendTasksToCreatorsForApproval(): void {
}
const pdfHeaders = [
'ID задачи', 'Наименование задачи', 'Описание', 'Наименование родительской задачи',
'ID задачи', 'Наименование задачи', taskCodeDecodeHeader(), 'Описание',
'Наименование родительской задачи', taskCodeDecodeHeader('Наименование родительской задачи'),
'Элементы CRM', 'Постановщик', 'Исполнитель', 'Дата создания задачи',
'Крайний срок задачи', 'Ведет к потере клиента', 'Ранее переносилась раз',
'Задача, требующая описания причины при переносе сроков', 'Прошлые причины переноса',
@ -73,3 +77,8 @@ export function sendTasksToCreatorsForApproval(): void {
});
});
}
function cell(row: any[], col: Record<string, number>, header: string): any {
const index = col[header];
return index === undefined ? '' : row[index];
}

View File

@ -105,6 +105,6 @@ export function buildSelfAssignedTasksReport(): void {
});
decodeTaskCodes(reportSheet);
reportSheet.autoResizeColumns(1, reportHeaders.length);
reportSheet.autoResizeColumns(1, reportSheet.getLastColumn());
setReportSheetFormat(reportSheet);
}

View File

@ -1,6 +1,7 @@
import { askUser } from '../../core/ui';
import { getUserEmailMap } from '../../core/mail/emailConfig';
import { sendTempSpreadsheetToEmail } from '../../core/sheets/export';
import { taskCodeDecodeHeader } from '../../core/taskCodes';
export function sendAttentionTasksToCreatorsForApproval(): void {
const confirmed = askUser('Подтвеждаете отправку?');
@ -41,7 +42,9 @@ export function sendAttentionTasksToCreatorsForApproval(): void {
creators[creator].push([
row[col['Название задачи']],
cell(row, col, taskCodeDecodeHeader()),
row[col['Название родительской задачи']],
cell(row, col, taskCodeDecodeHeader('Название родительской задачи')),
row[col['ID задачи']],
row[col['ID родительской задачи']],
row[col['Статус задачи']],
@ -62,7 +65,9 @@ export function sendAttentionTasksToCreatorsForApproval(): void {
const pdfHeaders = [
'Название задачи',
taskCodeDecodeHeader(),
'Название родительской задачи',
taskCodeDecodeHeader('Название родительской задачи'),
'ID задачи',
'ID родительской задачи',
'Статус задачи',
@ -96,3 +101,8 @@ export function sendAttentionTasksToCreatorsForApproval(): void {
});
});
}
function cell(row: any[], col: Record<string, number>, header: string): any {
const index = col[header];
return index === undefined ? '' : row[index];
}

View File

@ -118,8 +118,6 @@ export function buildWaitingControlReport(): void {
.getRange(1, 1, output.length, reportHeaders.length)
.setValues(output);
reportSheet.autoResizeColumns(1, reportHeaders.length);
addDropdownValidations(reportSheet, output[0], result.length + 1, {
'Резолюция Владимира Принять задачу или вернуть на доработку': [
'Принять',
@ -131,6 +129,7 @@ export function buildWaitingControlReport(): void {
addTaskResultsToReportSheet(reportSheet);
decodeTaskCodes(reportSheet);
decodeTaskCodes(reportSheet, 'Название родительской задачи');
reportSheet.autoResizeColumns(1, reportSheet.getLastColumn());
setReportSheetFormat(reportSheet);
}

View File

@ -2,9 +2,12 @@ import { describe, expect, it } from 'vitest';
import {
beforeHash,
bitrixBooleanToString,
buildDecodedTaskCodeColumn,
decodeTaskCodeText,
getTaskControlType,
getTaskSizeType,
normalizeTaskName,
taskCodeDecodeHeader,
validateTaskCode,
} from '../src/core/taskCodes';
@ -70,3 +73,52 @@ describe('bitrixBooleanToString', () => {
expect(bitrixBooleanToString('Да.')).toBe('Да');
});
});
describe('buildDecodedTaskCodeColumn', () => {
const values = [
['ID', 'Название задачи', 'Название родительской задачи', 'Исполнитель'],
['1', 'ЕПБ* Согласовать КП', 'ЕЗМ* Родитель', 'Иванов'],
['2', 'без кода', '', 'Петров'],
];
it('расшифровывает код задачи и указывает столбец сразу после названия', () => {
const decoded = buildDecodedTaskCodeColumn(values);
expect(decoded.sourceColumnIndex).toBe(1);
expect(decoded.column).toEqual([
[taskCodeDecodeHeader()],
['Периодическая Постановщик Большая'],
[''],
]);
});
it('для родительской задачи берёт её столбец, а не столбец самой задачи', () => {
const decoded = buildDecodedTaskCodeColumn(values, 'Название родительской задачи');
expect(decoded.sourceColumnIndex).toBe(2);
expect(decoded.column[0][0]).toBe(taskCodeDecodeHeader('Название родительской задачи'));
expect(decoded.column[1][0]).toBe('Периодическая Без контроля Маленькая');
expect(decoded.column[2][0]).toBe('');
});
it('находит короткое название столбца в отчёте нагрузки', () => {
const decoded = buildDecodedTaskCodeColumn([
['ID задачи', 'Название', 'Исполнитель'],
['10', 'РЗБ* Задача', 'Иванов'],
]);
expect(decoded.sourceColumnIndex).toBe(1);
expect(decoded.column[1][0]).toBe('Разовая Без контроля Большая');
});
it('сообщает, если нужного столбца нет', () => {
expect(() => buildDecodedTaskCodeColumn([['ID'], ['1']])).toThrow(/Не найден столбец/);
expect(() => buildDecodedTaskCodeColumn(values, 'Нет такого столбца')).toThrow(/Нет такого столбца/);
});
});
describe('decodeTaskCodeText', () => {
it('возвращает пустую строку без кода', () => {
expect(decodeTaskCodeText('просто название')).toBe('');
});
});