fix(backups): читать экспорт RouterOS порциями без потери данных
This commit is contained in:
Denozordec committed
1 parent
c3fb66dcbf
commit
41a76f1163
12 files changed
+1205
-18
No files matched your search
@@ -455,9 +455,12 @@ function rosResponsePreview(raw: Buffer, limit = 200): string {
|
||||
* @see https://help.mikrotik.com/docs/spaces/ROS/pages/47579160/API
|
||||
* @see https://help.mikrotik.com/docs/spaces/ROS/pages/2555971/Files
|
||||
*/
|
||||
export function extractRosContentsField(raw: Buffer): Buffer {
|
||||
const start = findRosStringField(raw, RET_MARKER) ?? findRosStringField(raw, CONTENTS_MARKER)
|
||||
export function extractRosContentsField(raw: Buffer, field: "contents" | "data" = "contents"): Buffer {
|
||||
const start = field === "data"
|
||||
? findRosStringField(raw, Buffer.from('"data":', "latin1"))
|
||||
: findRosStringField(raw, RET_MARKER) ?? findRosStringField(raw, CONTENTS_MARKER)
|
||||
if (start == null) {
|
||||
if (field === "data") throw new Error("Ответ RouterOS не содержит строковое поле data")
|
||||
throw new Error(`ответ не содержит поле ret/contents (${rosResponsePreview(raw)})`)
|
||||
}
|
||||
|
||||
@@ -911,6 +914,43 @@ export class MikrotikClient {
|
||||
return this.readFileContents({ id: entry.id, name: entry.name }, timeoutMs)
|
||||
}
|
||||
|
||||
/** Native text exports larger than /file/get's limit use bounded byte offsets. */
|
||||
private async downloadConfigurationFile(target: { id: string; name: string; size: number }): Promise<Buffer> {
|
||||
if (!Number.isSafeInteger(target.size) || target.size > MAX_ROS_BODY_BYTES) {
|
||||
throw new Error("Экспорт конфигурации больше 8 МиБ или размер не подтверждён")
|
||||
}
|
||||
const deadline = Date.now() + 120_000
|
||||
const remaining = () => {
|
||||
const ms = deadline - Date.now()
|
||||
if (ms <= 0) throw new Error("Истекло время чтения экспорта RouterOS")
|
||||
return Math.min(ms, 30_000)
|
||||
}
|
||||
const metadata = async () => {
|
||||
const rows = await this.get<Array<Record<string, unknown>>>("/file", remaining())
|
||||
if (!Array.isArray(rows)) throw new Error("Не подтверждён список файлов экспорта")
|
||||
const matches = rows.filter(row => row?.[".id"] === target.id || row?.name === target.name)
|
||||
const row = matches[0]
|
||||
if (matches.length !== 1 || row[".id"] !== target.id || row.name !== target.name || Number(row.size) !== target.size) {
|
||||
throw new Error("Файл экспорта изменился во время чтения")
|
||||
}
|
||||
return JSON.stringify([row["last-modified"] ?? null, row["creation-time"] ?? null])
|
||||
}
|
||||
const before = await metadata(), chunks: Buffer[] = []
|
||||
for (let offset = 0; offset < target.size;) {
|
||||
const length = Math.min(32768, target.size - offset)
|
||||
const raw = await rosRawRequest(this.params, {
|
||||
method: "POST", path: "/file/read",
|
||||
body: { file: target.name, offset: String(offset), "chunk-size": String(length) },
|
||||
timeoutMs: remaining(),
|
||||
})
|
||||
const chunk = extractRosContentsField(raw, "data")
|
||||
if (chunk.length !== length) throw new Error("RouterOS вернул неполную порцию экспорта")
|
||||
chunks.push(chunk); offset += chunk.length
|
||||
}
|
||||
if (await metadata() !== before) throw new Error("Файл экспорта изменился во время чтения")
|
||||
return Buffer.concat(chunks, target.size)
|
||||
}
|
||||
|
||||
/** Удаление файла RouterOS по `.id` или имени (для временных артефактов экспорта). */
|
||||
async removeFile(idOrName: string, timeoutMs = 10_000): Promise<void> {
|
||||
const id = idOrName.startsWith("*")
|
||||
@@ -1051,7 +1091,7 @@ export class MikrotikClient {
|
||||
return exportRouterConfiguration({
|
||||
list: () => this.get<unknown>("/file"),
|
||||
export: name => this.post("/export", { file: name }, 120_000),
|
||||
download: file => this.downloadFile(file, 30_000),
|
||||
download: file => this.downloadConfigurationFile(file),
|
||||
remove: id => this.removeFile(id),
|
||||
})
|
||||
}
|
||||
|
||||
@@ -2,19 +2,20 @@ import assert from 'node:assert/strict'
|
||||
import {createServer} from 'node:http'
|
||||
import {MikrotikClient} from './mikrotik.js'
|
||||
const good='# oct/14/2026 by RouterOS 7.24.5\n/system identity\nset name=export-test\n'
|
||||
for(const mode of ['success','malformed-list','export-error','truncated','section-error','oversize','cleanup-error','foreign-id']){
|
||||
for(const mode of ['success','malformed-list','export-error','truncated','section-error','oversize','cleanup-error','foreign-id','short-chunk','missing-data','changed-file','utf8-boundary','max-size']){
|
||||
let ownName='',exportCalls=0,readCalls=0,deletes=0
|
||||
const original={'.id':'*ORIG',name:'important.rsc',size:'2'}
|
||||
let own:Record<string,string>|null=null
|
||||
const content=mode==='section-error'?good+'#error exporting /routing (timeout)\n':mode==='oversize'?good+'#'.repeat(70000):good
|
||||
const content=mode==='utf8-boundary'?good+'#'.repeat(32767-Buffer.byteLength(good))+'я'.repeat(20000):mode==='section-error'?good+'#error exporting /routing (timeout)\n':['oversize','short-chunk','missing-data','changed-file'].includes(mode)?good+'#'.repeat(70000):good
|
||||
const fixture=createServer(async(req,res)=>{let input='';for await(const b of req)input+=b;const body=input?JSON.parse(input):{};const reply=(status:number,value:unknown)=>{res.statusCode=status;res.setHeader('content-type','application/json');res.end(JSON.stringify(value))}
|
||||
if(req.method==='GET'&&req.url==='/rest/file')return reply(200,mode==='malformed-list'?{}:[original,...(own?[own]:[])])
|
||||
if(req.method==='POST'&&req.url==='/rest/export'){exportCalls++;ownName=body.file;assert(/^mmapp-export-[a-f0-9-]{36}\.rsc$/.test(ownName));assert.deepEqual(Object.keys(body),['file']);own={'.id':mode==='foreign-id'?'*ORIG':'*TEMP',name:ownName,size:String(Buffer.byteLength(content))};return reply(mode==='export-error'?500:200,mode==='export-error'?{error:'export failed'}:[])}
|
||||
if(req.method==='POST'&&req.url==='/rest/export'){exportCalls++;ownName=body.file;assert(/^mmapp-export-[a-f0-9-]{36}\.rsc$/.test(ownName));assert.deepEqual(Object.keys(body),['file']);own={'.id':mode==='foreign-id'?'*ORIG':'*TEMP',name:ownName,size:String(mode==='max-size'?8*1024*1024+1:Buffer.byteLength(content))};return reply(mode==='export-error'?500:200,mode==='export-error'?{error:'export failed'}:[])}
|
||||
if(req.method==='POST'&&req.url==='/rest/file/read'){readCalls++;const offset=Number(body.offset),length=Number(body['chunk-size']);assert.equal(body.file,ownName);assert(length>0&&length<=32768);const bytes=Buffer.from(content).subarray(offset,offset+length);const data=bytes.toString('utf8');if(mode==='utf8-boundary'){const encoded=[];for(const byte of bytes){if(byte===34||byte===92)encoded.push(92,byte);else if(byte===10)encoded.push(92,110);else if(byte===13)encoded.push(92,114);else encoded.push(byte)}res.setHeader('content-type','application/json');res.end(Buffer.concat([Buffer.from('[{"data":"'),Buffer.from(encoded),Buffer.from('"}]')]));return}if(mode==='changed-file'&&own)own['last-modified']='changed';return reply(200,mode==='missing-data'?[{ret:data}]:[{data:['short-chunk','truncated'].includes(mode)?data.slice(0,-1):data}])}
|
||||
if(req.method==='POST'&&req.url==='/rest/file/get'){readCalls++;return reply(200,[{ret:mode==='truncated'?content.slice(0,20):content}])}
|
||||
if(req.method==='DELETE'&&req.url==='/rest/file/*TEMP'){deletes++;if(mode==='cleanup-error')return reply(500,{error:'cleanup denied'});own=null;return reply(200,{})}
|
||||
assert.fail('Unexpected request '+req.method+' '+req.url)
|
||||
});await new Promise<void>(r=>fixture.listen(0,'127.0.0.1',r));const address=fixture.address();assert(address&&typeof address!=='string');const c=new MikrotikClient({host:'127.0.0.1',port:address.port,useSsl:false,verifySsl:false,username:'fixture',password:'fixture'});
|
||||
try{if(mode==='success'){assert.equal(await c.exportConfigScript(),good);assert.equal(readCalls,1)}else await assert.rejects(c.exportConfigScript(), mode);assert.equal(original.name,'important.rsc');if(mode==='malformed-list')assert.equal(exportCalls,0);else assert.equal(exportCalls,1);if(!['malformed-list','foreign-id'].includes(mode))assert.equal(deletes,1);if(!['cleanup-error','foreign-id'].includes(mode))assert.equal(own,null);if(mode==='oversize')assert.equal(readCalls,0)}finally{await new Promise<void>(r=>fixture.close(()=>r()))}
|
||||
try{if(['success','oversize','utf8-boundary'].includes(mode)){assert.equal(await c.exportConfigScript(),content);assert.equal(readCalls,mode==='success'?1:3)}else await assert.rejects(c.exportConfigScript(), mode);assert.equal(original.name,'important.rsc');if(mode==='malformed-list')assert.equal(exportCalls,0);else assert.equal(exportCalls,1);if(!['malformed-list','foreign-id'].includes(mode))assert.equal(deletes,1);if(!['cleanup-error','foreign-id'].includes(mode))assert.equal(own,null);if(mode==='max-size')assert.equal(readCalls,0);if(['short-chunk','missing-data'].includes(mode))assert.equal(readCalls,1)}finally{await new Promise<void>(r=>fixture.close(()=>r()))}
|
||||
}
|
||||
console.log('native configuration export: 8 HTTP scenarios passed; original file never deleted')
|
||||
console.log('native configuration export: 13 HTTP scenarios passed; original file never deleted')
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# UX/UI: протокол внешней приёмки 12.5
|
||||
|
||||
Актуальное продолжение 2026-10-14: блок230 — исправлена подмена нативного экспорта частичным синтетическим скриптом. Реальные конфигурации обоих CHR выгружены в Selectel S3 и скачаны; ограниченный restore собственного bridge подтверждён RouterOS. Исходные файлы/bridge сохранены, собственные DB/roles/объекты удалены;6 versions+6 delete markers очищены. Live UI1440/390 с real Portal/API принят без изменения storage settings. Backend ux-backup230/frontend ux-routing218. Далее231 — чтение файлов>=61439 байт; S3 retention/смена bucket и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
Актуальное продолжение 2026-10-14: блоки230–231 — реальные native backup обоих CHR в S3 и ограниченный restore собственного bridge приняты, fixture/versions очищены. Частичный synthetic fallback удалён; native exports читаются /file/read порциями<=32768 bytes с общим deadline120s и пределом8 МиБ. HTTP13 (включая70КБ/UTF-8 boundary/partial/change/size cap) и native small exports обоих CHR прошли. Backend ux-backup231/frontend ux-routing218 healthy. Далее232 — live UI сохранение/проверка S3; смена bucket/endpoint, retention и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
|
||||
IPsec78: реальный PSK responder established, mode-config198.18.78.10 и online=true подтверждены API; точные собственные объекты удалены. Сертификатный/DN online, late failure и history restore остаются открытыми. [Отчёт](ux-ui/acceptance/ipsec-mode-config-2026-10-09.json), [журнал](ux-ui-progress.md).
|
||||
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# План реализации UX/UI по пятичасовым окнам
|
||||
|
||||
Актуальное продолжение 2026-10-14: блок230 — исправлена подмена нативного экспорта частичным синтетическим скриптом. Реальные конфигурации обоих CHR выгружены в Selectel S3 и скачаны; ограниченный restore собственного bridge подтверждён RouterOS. Исходные файлы/bridge сохранены, собственные DB/roles/объекты удалены;6 versions+6 delete markers очищены. Live UI1440/390 с real Portal/API принят без изменения storage settings. Backend ux-backup230/frontend ux-routing218. Далее231 — чтение файлов>=61439 байт; S3 retention/смена bucket и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
Актуальное продолжение 2026-10-14: блоки230–231 — реальные native backup обоих CHR в S3 и ограниченный restore собственного bridge приняты, fixture/versions очищены. Частичный synthetic fallback удалён; native exports читаются /file/read порциями<=32768 bytes с общим deadline120s и пределом8 МиБ. HTTP13 (включая70КБ/UTF-8 boundary/partial/change/size cap) и native small exports обоих CHR прошли. Backend ux-backup231/frontend ux-routing218 healthy. Далее232 — live UI сохранение/проверка S3; смена bucket/endpoint, retention и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
|
||||
Общий план проекта MikrotikManager. Основан на согласованном плане из задачи; точка продолжения обновлена 2026-10-14. Источник фактического прогресса, проверок и ограничений — [журнал реализации](ux-ui-progress.md). Этот документ задаёт объём и критерии завершения, журнал фиксирует результат.
|
||||
|
||||
|
||||
+12
-2
@@ -1,6 +1,6 @@
|
||||
# UX/UI: журнал реализации
|
||||
|
||||
Актуальное продолжение 2026-10-14: блок230 — исправлена подмена нативного экспорта частичным синтетическим скриптом. Реальные конфигурации обоих CHR выгружены в Selectel S3 и скачаны; ограниченный restore собственного bridge подтверждён RouterOS. Исходные файлы/bridge сохранены, собственные DB/roles/объекты удалены;6 versions+6 delete markers очищены. Live UI1440/390 с real Portal/API принят без изменения storage settings. Backend ux-backup230/frontend ux-routing218. Далее231 — чтение файлов>=61439 байт; S3 retention/смена bucket и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
Актуальное продолжение 2026-10-14: блоки230–231 — реальные native backup обоих CHR в S3 и ограниченный restore собственного bridge приняты, fixture/versions очищены. Частичный synthetic fallback удалён; native exports читаются /file/read порциями<=32768 bytes с общим deadline120s и пределом8 МиБ. HTTP13 (включая70КБ/UTF-8 boundary/partial/change/size cap) и native small exports обоих CHR прошли. Backend ux-backup231/frontend ux-routing218 healthy. Далее232 — live UI сохранение/проверка S3; смена bucket/endpoint, retention и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
|
||||
Общий план: [UX/UI по этапам и пятичасовым окнам](ux-ui-plan.md). План задаёт объём, этот журнал фиксирует выполненные блоки и ограничения. Записи расположены от новых к старым; подробная история этапа12 также сохранена в [ux-ui-stage-12.md](ux-ui-stage-12.md).
|
||||
|
||||
@@ -36,7 +36,17 @@
|
||||
| 10 | Маршрутизация, диагностика, карта и терминал | Завершён в границах локальной приёмки 2026-10-01; блоки 10.1–10.71, внешние ограничения в 10.71 |
|
||||
| 11А | Пользователи, контейнеры, сертификаты и резервные копии | Завершён в границах локальной приёмки 2026-10-01; 11А.1–11А.33, внешние ограничения в 11А.33 |
|
||||
| 11Б | Оповещения, сбор данных, интеграции, релизы и настройки | Завершён в границах локальной приёмки 2026-10-03; ограничения и evidence в11Б.7 |
|
||||
| 12 | Итоговая доступность, адаптивность, производительность и регрессия | Локальная приёмка12.3.83 в границах журнала. Внешняя12.5: блоки1–230 завершены в записанных scopes, этап открыт. Runtime backend ux-backup230/frontend ux-routing218; backend25/UI52 и дополнительные SQL/UDP222 прошли. |
|
||||
| 12 | Итоговая доступность, адаптивность, производительность и регрессия | Локальная приёмка12.3.83 в границах журнала. Внешняя12.5: блоки1–231 завершены в записанных scopes, этап открыт. Runtime backend ux-backup231/frontend ux-routing218; backend25/UI52 и дополнительные SQL/UDP222 прошли. |
|
||||
|
||||
## 12.5.231 — чтение нативного экспорта порциями и контроль целостности (2026-10-14)
|
||||
|
||||
Для native exports введён единый /file/read file/offset/chunk-size, максимум32768 bytes в порции. Байт-offset не зависит от количества символов. Существующий raw-byte parser получил отдельное поле data; части объединяются до UTF-8 decode. Нестроковое/отсутствующее data, неполная порция, изменившийся ID/name/size/timestamp приводят к ошибке. Общий deadline120s, request timeout<=30s, максимум8 МиБ; cleanup из230 сохраняется. Существующий binary/certificate downloadFile не меняет лимит /file/get.
|
||||
|
||||
13 HTTP export-сценариев passed: исходные8,70КБ теперь успешно читается, short/missing/change отклонены, UTF-8 разрезан между байтами символа на32768 и восстановлен точно,>8 МиБ отклонён до чтения. test:backups и test:ros-file passed; contracts/backend build и scoped ESLint passed. Это13 unique exporter cases, не сумма повторных запусков.
|
||||
|
||||
Production image ux-backup231:500 исходников/1060 compiled outputs совпали; отдельный контейнер выполнил native /export file→/file/read→cleanup на обоих CHR (917/782 bytes), SHA256 и точный files baseline readback подтверждены. Реальные конфигурации небольшие: большой native экспорт не получен,70КБ принят HTTP fixture. [Native](ux-ui/acceptance/native-export231.json), [deploy](ux-ui/acceptance/backup231-deployment.json). Main backend healthy/image ID matched, frontend ux-routing218 сохранён; rollback image230 оставлен. Приватный CHR env удалён локально/на Debian, пароли не менялись.
|
||||
|
||||
S3 uploads/restore230 и live UI230 повторно не запускались; семантика restore не менялась. Metadata before/after не является атомарной блокировкой файла от внешнего writer. [Документация file/read](https://help.mikrotik.com/docs/spaces/ROS/pages/2555971/Files). Далее232 — live UI save/test S3 с возвратом исходных storage settings, затем адресация backup при смене bucket/endpoint и version retention. Этап12.5 открыт.
|
||||
|
||||
## 12.5.230 — нативные резервные копии CHR в S3 и ограниченное восстановление (2026-10-14)
|
||||
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
# Оставшаяся внешняя приёмка — 2026-10-14
|
||||
|
||||
Актуальное продолжение 2026-10-14: блок230 — исправлена подмена нативного экспорта частичным синтетическим скриптом. Реальные конфигурации обоих CHR выгружены в Selectel S3 и скачаны; ограниченный restore собственного bridge подтверждён RouterOS. Исходные файлы/bridge сохранены, собственные DB/roles/объекты удалены;6 versions+6 delete markers очищены. Live UI1440/390 с real Portal/API принят без изменения storage settings. Backend ux-backup230/frontend ux-routing218. Далее231 — чтение файлов>=61439 байт; S3 retention/смена bucket и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
Актуальное продолжение 2026-10-14: блоки230–231 — реальные native backup обоих CHR в S3 и ограниченный restore собственного bridge приняты, fixture/versions очищены. Частичный synthetic fallback удалён; native exports читаются /file/read порциями<=32768 bytes с общим deadline120s и пределом8 МиБ. HTTP13 (включая70КБ/UTF-8 boundary/partial/change/size cap) и native small exports обоих CHR прошли. Backend ux-backup231/frontend ux-routing218 healthy. Далее232 — live UI сохранение/проверка S3; смена bucket/endpoint, retention и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
|
||||
Это актуальная матрица после 12.5.230. Исторические записи сохраняют версии и ограничения на момент выполнения; поздние проверки ниже уточняют их. Этап 12.5 открыт. Успех в двух CHR и одном backend не означает приёмку всех конфигураций, интеграций или полной регрессии.
|
||||
Это актуальная матрица после 12.5.231. Исторические записи сохраняют версии и ограничения на момент выполнения; поздние проверки ниже уточняют их. Этап 12.5 открыт. Успех в двух CHR и одном backend не означает приёмку всех конфигураций, интеграций или полной регрессии.
|
||||
|
||||
Стенд: Debian13/Compose, PostgreSQL18.6, два CHR RouterOS7.24.5. Backend `ux-backup230`, frontend `ux-routing218`; production lab с195 использует AUTH_REQUIRED=true и Portal1.3.1. Подписанные JWT/RBAC проверялись в изолированных процессах. Все собственные объекты112 удалены, исходные13 коллекций×2 (включая logging/certificates/files/routes) проверены; пароли не менялись.
|
||||
Стенд: Debian13/Compose, PostgreSQL18.6, два CHR RouterOS7.24.5. Backend `ux-backup231`, frontend `ux-routing218`; production lab с195 использует AUTH_REQUIRED=true и Portal1.3.1. Подписанные JWT/RBAC проверялись в изолированных процессах. Все собственные объекты112 удалены, исходные13 коллекций×2 (включая logging/certificates/files/routes) проверены; пароли не менялись.
|
||||
|
||||
## Остаток приёмки по группам — 2026-10-14
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
| REST и достоверность данных | Ошибки OSPF/BFD/BGP/GRE/WAN215–221 явные; latest API smoke222 прошёл | Причина единичных native401/500 неизвестна. Короткое независимое наблюдение возможно сейчас; оно не даст SLA |
|
||||
| Клиентские ОС и внешняя сеть | CHR↔CHR/Linux, private IPv4/ULA и synthetic IPv6/IPFIX; Android full-tunnel/reconnect227 подтверждены пользователем | Windows/macOS/iOS VPN, расширенная Android приёмка, независимые WAN/multi-WAN и public IPv6; public IPv6 на текущем стенде отсутствует |
|
||||
| Масштаб и длительная устойчивость | Контролируемые lock/dedupe/loss/recovery и короткие native проверки | Несколько backend/worker/writers, длительный rekey/REST/traffic, physical disconnect и maximum throughput |
|
||||
| Внешние хранилища и jobs | Локальные API/errors/RBAC/owned SQL; реальные Portal1.3.1/Telegram195–201 и Selectel S3/client/API/ownSQL228–229 | Large native exports, S3 save/test/restore через UI, смена bucket/endpoint и retention; provider/container/Gitea/MaxMind jobs с соответствующими endpoints/аккаунтами; private/paid credentials не выдумывать |
|
||||
| Внешние хранилища и jobs | Локальные API/errors/RBAC/owned SQL; реальные Portal1.3.1/Telegram195–201 и Selectel S3/client/API/ownSQL228–229 | Large native exports проверены HTTP fixture; S3 save/test/restore через UI, смена bucket/endpoint и retention; provider/container/Gitea/MaxMind jobs с соответствующими endpoints/аккаунтами; private/paid credentials не выдумывать |
|
||||
| Расширенные сетевые конфигурации | GRE/WG/VXLAN/IPsec/OSPF/BFD/BGP сценарии и точные границы записаны | from-pool/EUI-64/multiple-address import/export, outer IPv6, произвольная PKI/OID/policy/path-length и длительные переходы; BFD-only gate гарантией не стал |
|
||||
| Общий UX, доступность и производительность | Полная UI192 исторически; latest backend25/UI52, scoped contrast/live218 и keyboard206 | Свежая UI226 принята в записанных границах; профильный performance и ручная accessibility/screen-reader приёмка; scoped axe не полный WCAG |
|
||||
| Границы выпуска | План/доказательства/датированные блоки сохранены; коммиты локальные | Определить требуемые конфигурации и принять результат в этих границах; невыполненные варианты остаются явными ограничениями |
|
||||
|
||||
+12
-1
@@ -1,6 +1,6 @@
|
||||
# Этап 12: итоговая приёмка UX/UI
|
||||
|
||||
Актуальное продолжение 2026-10-14: блок230 — исправлена подмена нативного экспорта частичным синтетическим скриптом. Реальные конфигурации обоих CHR выгружены в Selectel S3 и скачаны; ограниченный restore собственного bridge подтверждён RouterOS. Исходные файлы/bridge сохранены, собственные DB/roles/объекты удалены;6 versions+6 delete markers очищены. Live UI1440/390 с real Portal/API принят без изменения storage settings. Backend ux-backup230/frontend ux-routing218. Далее231 — чтение файлов>=61439 байт; S3 retention/смена bucket и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
Актуальное продолжение 2026-10-14: блоки230–231 — реальные native backup обоих CHR в S3 и ограниченный restore собственного bridge приняты, fixture/versions очищены. Частичный synthetic fallback удалён; native exports читаются /file/read порциями<=32768 bytes с общим deadline120s и пределом8 МиБ. HTTP13 (включая70КБ/UTF-8 boundary/partial/change/size cap) и native small exports обоих CHR прошли. Backend ux-backup231/frontend ux-routing218 healthy. Далее232 — live UI сохранение/проверка S3; смена bucket/endpoint, retention и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
|
||||
План: [ux-ui-plan.md](ux-ui-plan.md). Фактические результаты: [ux-ui-progress.md](ux-ui-progress.md). Подготовлен после сводных проверок 11Б; завершение каждого блока требует локального коммита без push.
|
||||
|
||||
@@ -4100,3 +4100,14 @@ Live браузер с real Portal SSO/API, без mocks: /backups и настр
|
||||
|
||||
Ограничение: текущий /file/get отклоняет файлы>=61439 bytes; частичная подмена больше не допускается. Следующий231 — документированный /file/read с порциями, затем проверка смены S3 bucket/endpoint и retention semantics. Общая UI-регрессия повторно не запускалась; этап12.5 открыт.
|
||||
|
||||
|
||||
## 12.5.231 — чтение нативного экспорта порциями и контроль целостности (2026-10-14)
|
||||
|
||||
Для native exports введён единый /file/read file/offset/chunk-size, максимум32768 bytes в порции. Байт-offset не зависит от количества символов. Существующий raw-byte parser получил отдельное поле data; части объединяются до UTF-8 decode. Нестроковое/отсутствующее data, неполная порция, изменившийся ID/name/size/timestamp приводят к ошибке. Общий deadline120s, request timeout<=30s, максимум8 МиБ; cleanup из230 сохраняется. Существующий binary/certificate downloadFile не меняет лимит /file/get.
|
||||
|
||||
13 HTTP export-сценариев passed: исходные8,70КБ теперь успешно читается, short/missing/change отклонены, UTF-8 разрезан между байтами символа на32768 и восстановлен точно,>8 МиБ отклонён до чтения. test:backups и test:ros-file passed; contracts/backend build и scoped ESLint passed. Это13 unique exporter cases, не сумма повторных запусков.
|
||||
|
||||
Production image ux-backup231:500 исходников/1060 compiled outputs совпали; отдельный контейнер выполнил native /export file→/file/read→cleanup на обоих CHR (917/782 bytes), SHA256 и точный files baseline readback подтверждены. Реальные конфигурации небольшие: большой native экспорт не получен,70КБ принят HTTP fixture. [Native](ux-ui/acceptance/native-export231.json), [deploy](ux-ui/acceptance/backup231-deployment.json). Main backend healthy/image ID matched, frontend ux-routing218 сохранён; rollback image230 оставлен. Приватный CHR env удалён локально/на Debian, пароли не менялись.
|
||||
|
||||
S3 uploads/restore230 и live UI230 повторно не запускались; семантика restore не менялась. Metadata before/after не является атомарной блокировкой файла от внешнего writer. [Документация file/read](https://help.mikrotik.com/docs/spaces/ROS/pages/2555971/Files). Далее232 — live UI save/test S3 с возвратом исходных storage settings, затем адресация backup при смене bucket/endpoint и version retention. Этап12.5 открыт.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Тестовый сервер UX/UI — 2026-10-10
|
||||
|
||||
Актуальное продолжение 2026-10-14: блок230 — исправлена подмена нативного экспорта частичным синтетическим скриптом. Реальные конфигурации обоих CHR выгружены в Selectel S3 и скачаны; ограниченный restore собственного bridge подтверждён RouterOS. Исходные файлы/bridge сохранены, собственные DB/roles/объекты удалены;6 versions+6 delete markers очищены. Live UI1440/390 с real Portal/API принят без изменения storage settings. Backend ux-backup230/frontend ux-routing218. Далее231 — чтение файлов>=61439 байт; S3 retention/смена bucket и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
Актуальное продолжение 2026-10-14: блоки230–231 — реальные native backup обоих CHR в S3 и ограниченный restore собственного bridge приняты, fixture/versions очищены. Частичный synthetic fallback удалён; native exports читаются /file/read порциями<=32768 bytes с общим deadline120s и пределом8 МиБ. HTTP13 (включая70КБ/UTF-8 boundary/partial/change/size cap) и native small exports обоих CHR прошли. Backend ux-backup231/frontend ux-routing218 healthy. Далее232 — live UI сохранение/проверка S3; смена bucket/endpoint, retention и расширенная приёмка открыты. Этап12.5 открыт.
|
||||
|
||||
| Параметр | Проверенное состояние |
|
||||
| --- | --- |
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,21 @@
|
||||
{
|
||||
"date": "2026-10-14",
|
||||
"block": "12.5.231",
|
||||
"backendSourceMatched": 500,
|
||||
"compiledMatched": 1060,
|
||||
"frontendChanged": false,
|
||||
"services": {
|
||||
"backend": {
|
||||
"image": "mmapp-test/backend:ux-backup231",
|
||||
"imageId": "sha256:a52c0243525dd141a10be8a6f615fed99faa04db16b6c250eb87879881b06133",
|
||||
"running": true,
|
||||
"health": "healthy"
|
||||
},
|
||||
"frontend": {
|
||||
"image": "mmapp-test/frontend:ux-routing218",
|
||||
"imageId": "sha256:ec658b9da88c19d60987be5bfc0c15fb339a0310d7a42dc761b40a70a3428c5a",
|
||||
"running": true,
|
||||
"health": null
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
{
|
||||
"date": "2026-10-14",
|
||||
"block": "12.5.231",
|
||||
"kinds": [
|
||||
{
|
||||
"kind": "backend",
|
||||
"matched": 500
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"date": "2026-10-14",
|
||||
"block": "12.5.231",
|
||||
"devices": [
|
||||
{
|
||||
"host": "194.226.121.150",
|
||||
"passed": true,
|
||||
"bytes": 917,
|
||||
"sha256": "a7d636db2db403a98718098c0a38e142c6b5634ef2c7ff73b88647da45288fbe",
|
||||
"native": true,
|
||||
"filesBaselineMatched": true
|
||||
},
|
||||
{
|
||||
"host": "104.165.244.7",
|
||||
"passed": true,
|
||||
"bytes": 782,
|
||||
"sha256": "c8f5cf4662e5b5b32d900fe3c38f93c5592977ca77bfef79c8ae82a09f20c0c7",
|
||||
"native": true,
|
||||
"filesBaselineMatched": true
|
||||
}
|
||||
],
|
||||
"configurationWrites": 0,
|
||||
"passed": true
|
||||
}
|
||||
Reference in new issue
Block a user