Выкат: образ, миграции, домен и первый инцидент

// Модель правил копирования: путь проверяется правилами ПО ПОРЯДКУ, решает
// первое совпавшее. Формы образцов здесь ровно три — те, что стоят в выкате:
// без «/» (сверяется с любым звеном пути), с «/» в середине (с хвостом пути)
// и с «/» в начале (с путём от корня передачи)
type Правило = { пускать: boolean; образец: string };

const вРегулярку = (образец: string): RegExp =>
  new RegExp("^" + образец.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*") + "$");

const совпал = (образец: string, путь: string): boolean => {
  if (образец.startsWith("/")) return вРегулярку(образец.slice(1)).test(путь);
  if (образец.includes("/")) {
    const хвост = путь.split("/").slice(-(образец.split("/").length)).join("/");
    return вРегулярку(образец).test(хвост);
  }
  return путь.split("/").some((звено) => вРегулярку(образец).test(звено));
};

const поедет = (правила: Правило[], путь: string): boolean => {
  const первое = правила.find((правило) => совпал(правило.образец, путь));
  return первое === undefined || первое.пускать;
};

const скрытьЛишнее: Правило[] = [
  { пускать: false, образец: ".git" },
  { пускать: false, образец: "node_modules" },
  { пускать: false, образец: "dist" },
];
const секреты: Правило[] = [
  { пускать: false, образец: ".env" },
  { пускать: false, образец: ".env.*" },
];
const возвраты: Правило[] = [
  { пускать: true, образец: "packages/content/runs/*/.env" },
  { пускать: true, образец: "/.env*.example" },
];

const ПУТИ = [
  "apps/api/src/main.ts",
  "node_modules/pg/index.js",
  "apps/api/.env",
  "packages/content/runs/boot-fails-fast/.env",
  ".env.prod.example",
  "packages/content/.env.example",
];

const показать = (заголовок: string, правила: Правило[]): void => {
  console.log(заголовок);
  for (const путь of ПУТИ) console.log(`  ${поедет(правила, путь) ? "едет:   " : "остался:"} ${путь}`);
};

показать("возвраты после запретов:", [...скрытьЛишнее, ...секреты, ...возвраты]);
показать("возвраты перед запретами:", [...скрытьЛишнее, ...возвраты, ...секреты]);

// Справочник переменных проекта: имя, как разобрать значение и зачем оно.
// Второго списка в приложении нет — из этого же справочника пишутся .env.example
// и переменные окружения в стеке
type Беда = string | null;
type Правило = { имя: string; разобрать: (raw: string | undefined) => Беда; зачем: string };

const непусто = (raw: string | undefined): string => (raw ?? "").trim();

const ПРАВИЛА: Правило[] = [
  {
    имя: "DATABASE_URL",
    зачем: "куда ходит репозиторий",
    разобрать: (raw) => (непусто(raw) === "" ? "не задан" : null),
  },
  {
    имя: "SECRET",
    зачем: "чем подписан токен входа",
    разобрать: (raw) => {
      const value = непусто(raw);
      if (value === "") return "не задан";
      return value.length < 32 ? `короче 32 символов (${value.length})` : null;
    },
  },
  {
    имя: "PORT",
    зачем: "какой порт слушает процесс",
    разобрать: (raw) => {
      const value = непусто(raw);
      if (value === "") return null; // порт необязателен: 0 значит «любой свободный»
      return /^\d+$/.test(value) ? null : `ожидалось целое число, пришло ${value}`;
    },
  },
];

// Все беды сразу: список, а не первая попавшаяся
const проверить = (env: Record<string, string | undefined>): string[] =>
  ПРАВИЛА.flatMap((правило) => {
    const беда = правило.разобрать(env[правило.имя]);
    return беда === null ? [] : [`${правило.имя} (${правило.зачем}): ${беда}`];
  });

const ОКРУЖЕНИЯ: [string, Record<string, string | undefined>][] = [
  ["пустая машина", {}],
  ["половина доехала", { DATABASE_URL: "postgres://app@db:5432/app", SECRET: "  ", PORT: "3000" }],
  ["секрет из черновика", { DATABASE_URL: "postgres://app@db:5432/app", SECRET: "dev", PORT: "восемь" }],
  ["всё на месте", { DATABASE_URL: "postgres://app@db:5432/app", SECRET: "o".repeat(40), PORT: "3000" }],
];

for (const [имя, env] of ОКРУЖЕНИЯ) {
  const беды = проверить(env);
  console.log(`${имя}: ${беды.length === 0 ? "конфигурация принята" : `старт не состоится, чинить ${беды.length}`}`);
  for (const беда of беды) console.log(`  ${беда}`);
}

// Хосты, которые есть только на машине разработчика: внутри контейнера
// «localhost» — это сам контейнер, а не база и не почтовый сервер
const ДОМАШНИЕ = ["localhost", "127.0.0.1", "::1", "0.0.0.0", "host.docker.internal", "mailpit"];

// Разбор адреса без сети: схема, необязательная учётка, хост.
// Проверка говорит о форме значения, а дозвониться она не пробует
const хостИз = (адрес: string): string | null => {
  const разобрано = /^[a-z][a-z\d+.-]*:\/\/(?:[^@/]*@)?\[?([^:/?#\]]+)/i.exec(адрес);
  return разобрано === null ? null : разобрано[1];
};

const осмотреть = (имя: string, адрес: string): string => {
  const хост = хостИз(адрес);
  if (хост === null) return `${имя}: адрес не разобрать`;
  return `${имя}: хост ${хост}${ДОМАШНИЕ.includes(хост) ? " — внимание: такой адрес есть только на машине разработчика" : ""}`;
};

const НАСТРОЙКИ: [string, string][] = [
  ["DATABASE_URL", "postgres://app:секрет@db:5432/app"],
  ["DATABASE_URL", "postgres://app:секрет@localhost:5432/app"],
  ["SMTP_URL", "smtp://host.docker.internal:1025"],
  ["SMTP_URL", "smtp://smtp.example.com:587"],
  ["S3_URL", "хранилище-файлов"],
];

for (const [имя, адрес] of НАСТРОЙКИ) console.log(осмотреть(имя, адрес));

// Проект целиком — в подложке: договор, личность, уровень доступа, таблицы
type Res = { status: number; body: string };
type Req = { procedure: string; input: unknown; headers: Record<string, string>; ip: string };
type Таблица = { where: (match: (row: never) => boolean) => unknown[]; find: (index: string, value: unknown) => unknown[] };
declare function answer(request: Req): Promise<Res>;
declare const db: { users: Таблица; notes: Таблица };

// Смоук обязан знать не только статус, но и то, до чего запрос ДОШЁЛ:
// считаем походы в таблицы проекта
let походов = 0;
for (const таблица of [db.users, db.notes]) {
  const where = таблица.where.bind(таблица);
  const find = таблица.find.bind(таблица);
  таблица.where = (match) => {
    походов += 1;
    return where(match);
  };
  таблица.find = (index, value) => {
    походов += 1;
    return find(index, value);
  };
}

const кратко = (body: string): string => {
  const value: unknown = JSON.parse(body);
  if (Array.isArray(value)) return `список из ${value.length}`;
  return (value as { code?: string }).code ?? body;
};

const спросить = async (шаг: string, procedure: string, input: unknown, токен = ""): Promise<void> => {
  походов = 0;
  const res = await answer({
    procedure,
    input,
    headers: токен === "" ? {} : { authorization: `Bearer ${токен}` },
    ip: "203.0.113.9",
  });
  console.log(`${шаг.padEnd(26)} ${res.status} ${кратко(res.body).padEnd(18)} походов в таблицы: ${походов}`);
};

async function смоук(): Promise<void> {
  await спросить("имени нет в договоре", "notes.mine", {});
  await спросить("закрытая без токена", "notes.create", { title: "т", body: "б" });
  await спросить("закрытая с чужой подписью", "notes.create", { title: "т", body: "б" }, "a.b.c");
  await спросить("гостевой список", "notes.list", { page: 0 });
}

смоук();

# deploy/deploy.sh учебника, выдержка: две страницы там проверяет цикл, таймауты убраны
curl -s -o /dev/null -w '%{http_code}' "https://$domain/"
curl -s -o /dev/null -w '%{http_code}' "https://$domain/app/"
# 401 — правильный ответ незалогиненному: прокси довёл /trpc до приложения,
# и оно ответило. Базу этот ответ не проверяет
curl -s -o /dev/null -w '%{http_code}' "https://$domain/trpc/auth.me"

// Журнал проекта за минуту после выката, слитый из двух контейнеров, —
// поэтому строки в файле не по времени
type Строка = {
  t: string;
  level: "info" | "warn" | "error";
  msg: string;
  requestId?: string;
  procedure?: string;
  status?: number;
  code?: string;
  cause?: string;
  version?: string;
};

const ЖУРНАЛ = [
  '{"t":"09:41:14.771","level":"error","msg":"запрос упал","requestId":"r-19","procedure":"notes.list","cause":"42P01 relation \\"notes\\" does not exist"}',
  '{"t":"09:41:02.004","level":"info","msg":"старт","version":"2026-09-29.1"}',
  '{"t":"09:41:16.020","level":"error","msg":"ответ","requestId":"r-21","procedure":"notes.byId","status":500,"code":"INTERNAL"}',
  '{"t":"09:41:11.317","level":"error","msg":"запрос упал","requestId":"r-17","procedure":"notes.list","cause":"42P01 relation \\"notes\\" does not exist"}',
  '{"t":"09:41:12.902","level":"warn","msg":"ответ","requestId":"r-18","procedure":"notes.create","status":401,"code":"NOT_AUTHENTICATED"}',
  '{"t":"09:41:14.772","level":"error","msg":"ответ","requestId":"r-19","procedure":"notes.list","status":500,"code":"INTERNAL"}',
  '{"t":"09:41:16.019","level":"error","msg":"запрос упал","requestId":"r-21","procedure":"notes.byId","cause":"42P01 relation \\"notes\\" does not exist"}',
  '{"t":"09:41:11.318","level":"error","msg":"ответ","requestId":"r-17","procedure":"notes.list","status":500,"code":"INTERNAL"}',
  '{"t":"09:41:15.640","level":"warn","msg":"ответ","requestId":"r-20","procedure":"notes.mine","status":404,"code":"NO_SUCH_ROUTE"}',
  '{"t":"09:41:17.006","level":"error","msg":"ответ","requestId":"r-22","procedure":"auth.login","status":500,"code":"INTERNAL"}',
  '{"t":"09:41:17.005","level":"error","msg":"запрос упал","requestId":"r-22","procedure":"auth.login","cause":"42P01 relation \\"users\\" does not exist"}',
  '{"t":"09:41:18.400","level":"warn","msg":"ответ","requestId":"r-23","procedure":"auth.login","status":429,"code":"TOO_MANY_REQUESTS"}',
];

// Время в журнале в UTC и с ведущими нулями — только поэтому строки
// сравниваются как строки
const строки = ЖУРНАЛ.map((текст) => JSON.parse(текст) as Строка).sort((a, b) => (a.t < b.t ? -1 : 1));
const ответы = строки.filter((строка) => строка.msg === "ответ");
const успех = ответы.filter((строка) => (строка.status ?? 0) < 400);
const клиенту = ответы.filter((строка) => (строка.status ?? 0) >= 400 && (строка.status ?? 0) < 500);
const наши = ответы.filter((строка) => (строка.status ?? 0) >= 500);
const перечислить = (список: Строка[]): string =>
  список.map((строка) => `${строка.procedure} ${строка.status}`).join(", ");

console.log(`ответов ${ответы.length}: успешных ${успех.length}, отказ клиенту ${клиенту.length}, наш отказ ${наши.length}`);
console.log(`  ответил договор: ${перечислить(клиенту)}`);
console.log(`  упало у нас:     ${перечислить(наши)}`);

const первый = наши[0];
if (первый !== undefined) {
  console.log(`первый наш отказ: ${первый.t} ${первый.procedure} (${первый.requestId})`);
  // причина стоит не в ответе, а в строке того же запроса уровнем ниже
  for (const строка of строки.filter((строка) => строка.requestId === первый.requestId && строка.cause !== undefined)) {
    console.log(`  причина того же запроса: ${строка.cause}`);
  }
  const старт = строки.filter((строка) => строка.msg === "старт" && строка.t < первый.t).at(-1);
  if (старт !== undefined) console.log(`  последний старт до него: ${старт.t}, версия ${старт.version}`);
}