DOC-V 8.5.10 нұсқасындағы 200 өзгеріс: PDF-тегі ЭЦҚ визуализациясы, баптау бойынша кеңестер және тағы басқалар

DOC-V 8.5.10 — 8.5 тармағының ең мазмұнды нұсқаларының бірі: оған сервер мен интерфейстің екі жүзден астам өзгерісі кірді. Енді DOC-V әкімшіге сервер баптауларында нені түзету керегін өзі айтады, PDF-ке көрінетін мөртабаны бар PAdES форматында қол қояды, сыртқы жүйелерге REST арқылы құжаттар іріктеуін береді, ал ЖИ-әкімші кез келген түрдегі әрекеттерді баптауды үйренді.

Төменде — бөлімдер бойынша ең бастысы. Мақаланың соңында жаңарту алдында нені тексеру керегі жиналған: өзгерістердің бір бөлігі әдеттегі мінез-құлықты өзгертеді.

🩺 Баптау бойынша ұсынымдар: DOC-V серверде нені түзету керегін айтады

DOC-V өнімділігі көбіне дерекқор серверінің баптауларына байланысты, ал олар орнатудан кейін жиі зауыттық күйінде қалады. Енді DOC-V оларды өзі тексереді. Әкімшілендіру панелінде «Баптау бойынша ұсынымдар» беті, ал әкімшінің бастапқы бетінде «Жүйе күйі» блогында аттас жол пайда болды.

• Не тексеріледі: InnoDB буферлер пулы, DOC-V-нің дерекқормен қосылымдар пулы, ДҚ серверінің қосылымдар лимиті және KalkanCrypt кітапханасының құрастырылымы.
• Ұсынымда не көрінеді: не дұрыс емес, не істеу керек және дәл осы машинаға арналған бағдар — деректер көлемі мен сервер жадын ескере отырып.
• Шешімді әкімші қабылдайды: DOC-V баптаулардың өзін өзгертпейді. Ұсынымды назарға алуға немесе өзгерістерден кейін қайта тексеруге болады.
• Артық хаттарсыз: жаңа ұсыным туралы әкімші хатты бір рет алады.

⚙️ Сервер параметрлері — «Баптаулар» бетінде

Бұрын сервер параметрлерінің көпшілігі тек doc-v.conf файлында берілетін, әр түзету үшін серверге қолжетімділік қажет болатын. 8.5.10-да оларды әкімшілендіру панелінде өзгертуге болады:

• Жаңа «Сервер параметрлері» қойындысы: әкімшіге хабарландырулар, қызмет көрсету, жұмыс барысы, REST, көшіру және импорт.
• Файлдар мен пайдаланушылар параметрлері — «Файлдар» және «Пайдаланушы» қойындыларында. Бетте барлығы 30 параметр бар.
• Файл басым: егер кілт doc-v.conf файлына жазылса, бетте ол мәннің қайдан алынатыны көрінуі үшін қолжетімсіз өріс ретінде көрсетіледі.
• Файлда қалады күн мен уақыт, электрондық қолтаңба және ЖИ параметрлері.
• ЖИ-әкімші бұл параметрлерді де көреді және өзгертеді.

🤖 ЖИ-әкімші кез келген түрдегі әрекеттерді баптайды

ЖИ-әкімшіде DOC-V әрекеттерінің толық каталогы пайда болды. Бұрын ол әрекеттерді тек дайын мінез-құлықтармен құратын, енді — 31 түрдің кез келгенін:

• Маршрут нүктелерінің әрекеттерін, нүктелер мен журналдардың батырмаларын, сондай-ақ жаңа құжат түрінің сипаттамасындағы әрекеттерді ол өзі құрады және өзгертеді.
• Кез келген әрекетті қолмен баптауды түсіндіреді — егер әкімші бәрін өзі істегісі келсе, пішіннің қойындылары мен панельдері бойынша.
• Тәуекелді әрекеттер — тек келісіммен: «Қолжетімділік», «Іске қосу», HTTP-сұрау, пошта, Telegram, «Жою», «Мұрағаттау» және «Импорт» әрекеттерін ЖИ-әкімші тек әкімші растағанда ғана құрады.

✍️ Электрондық қолтаңба: PAdES, мөртабандар және бірнеше файлға бірден

Нұсқадағы өзгерістердің ең үлкен блогы. PAdES форматындағы қолтаңба тікелей PDF-ке енгізіледі: құжат кәдімгі PDF қарау құралында қолтаңбаның көрінетін мөртабанымен бірге ашылады, жеке қолтаңба файлы қажет емес.

NCALayer (Қазақстан)

• Өрістің барлық файлдары — құпия сөзді бір рет енгізумен.
• PAdES форматы: PDF-тегі қолтаңба, стандартты немесе өз үлгіңіз бойынша мөртабан, құжаттың уақыт белгісі.
• Әрекет баптауларындағы «Мөртабан» және «Колонтитул» қойындылары: мөртабанның орны, беттердегі колонтитул, көрінісі.
• Қол қою терезесі қатып қалмайды: ол NCALayer қатесі кезінде және байланыс үзілгенде жабылады.

КриптоПро (Ресей)

• Көрінетін қолтаңбасы бар PAdES және ГОСТ Р 7.0.97-2016 бойынша стандартты мөртабан (ИНН, СНИЛС, ОГРН, лауазым).
• Бірнеше файл — сертификатты бір рет таңдаумен. Сертификат таңдауы есте сақталады.
• Бірлескен бөлінген қолтаңба және бар қолтаңба файлына қосу арқылы қол қою — бірнеше адам қол қоятын құжаттар үшін.
• ГОСТ 2012-512 кілтімен бөлінген қолтаңба, плагин Chrome-ның жаңа нұсқаларында табылады, плагин қателері пайдаланушыға көрінеді.

eGov арқылы QR-код бойынша ЭЦҚ-мен қол қою

• Мөртабаны бар PAdES — NCALayer-дегідей.
• Бірнеше файл — eGov Mobile немесе eGov Business-те бір растаумен.

Kalkan арқылы қолтаңбаны тексеру

• Әр қолтаңба жеке тексеріледі. Қол қоюшының сертификаты ҚР ҰКО берген және қол қою сәтінде жарамды болуы тиіс.
• Сертификаттың кері қайтарылуы ҚР ҰКО OCSP бойынша тексеріледі — әдепкі бойынша қосулы. Серверге http://ocsp.pki.gov.kz мекенжайына қолжетімділік қажет; тексеруді [Network] KalkanOCSP = off параметрімен өшіруге болады.
• Түсінікті нәтиже: тексеру сәтсіз болса, маршрут шарттары алдыңғы қолтаңбаның деректерін көрмеуі үшін ЖСН, БСН және рөлдер тазартылады. Бас тарту себептері — орнату тілінде, JSON-нәтижеде мәртебе мен бас тарту кодтары бар.
• Кітапхананың сенімділігі: KalkanCrypt нұсқасы іске қосу кезінде журналға жазылады, ал іске қосылғаннан кейінгі алғашқы бір мезгілдегі тексерулер енді ақауға әкелмейді.

Жылдамдық туралы тағы бір дерек: 20 МБ файлға PAdES қолтаңбасы енді ~33 секундтың орнына шамамен бір секунд алады.

🖥️ DOC-V Desktop: Windows пен Linux-қа арналған қосымша

DOC-V-нің жұмыс үстелі қосымшасы пайда болды. Windows пен Linux-та пайдаланушы профилі оны PWA орнына орнатуды ұсынады: «DOC-V Desktop орнату» батырмасы Windows үшін орнатқышты, Debian, Ubuntu және Astra Linux үшін .deb пакетін немесе басқа дистрибутивтерге арналған AppImage-ді береді. Алғаш іске қосқанда қосымша DOC-V серверінің мекенжайын сұрайды.

• Қойындылар браузердегідей. Ctrl+T, Ctrl+W, Ctrl+Tab, сүйреп апару; құжаттарға сілтемелер бастапқы қойындының жанынан ашылады. Қойынды тақырыбы — құжаттың немесе мәзір тармағының атауы, ал қайта іске қосқаннан кейін қойындылар қалпына келеді.
• Беттегі әдеттегі DOC-V мәзірі. Жүйелік жиектемесіз терезе: қойындылар жолы DOC-V тақырыбының түсіне боялады, оның астында — кәдімгі мәзір.
• Қосымша белгішесіндегі, науадағы және терезе тақырыбындағы хабарландырулар санауышы. Айқас белгісі терезені науаға жасырады — хабарландырулар келе береді.
• Байланыс болмаса, ақ терезенің орнына түсінікті экран: қосымша не болғанын түсіндіреді — желі жоқ, сервер жауап бермейді, сертификатта ақау бар — және сервер қайта қолжетімді болғанда өзі қайта қосылады.
• Бірнеше сервер: серверді ауыстырғанда алдыңғысының қойындылары сақталады және оған қайта оралғанда қайта ашылады.
• Өзі жаңарады: жаңа нұсқа фонда жүктеледі және «Жаңарту» батырмасы арқылы немесе келесі іске қосқанда орнатылады.
• Ұйым серверінен жаңартулар. DOC-V сервері орнатқыштарды бір рет жүктеп алып, оларды жергілікті желі арқылы қосымшаларға таратады — бұл жабық контурда да жұмыс істейді. Интернеті жоқ сервер үшін жаңарту файлдарын басқа компьютерде дайындайтын скрипттер бар.

Қосымша DOC-V 8.5.10-дан бастап толық ашылады. Сервердің ескі нұсқаларымен де жұмыс істейді, бірақ DOC-V мәзірі қойындылар жолындағы «☰» батырмасымен ашылады, ал қойындылардың атаулары болмайды.

📱 Интерфейс: айналдыру, телефон және белгішелер

• Беттерді айналдыру арқылы жүктеу. Журнал жолдарының соңына жеттіңіз — келесі бет өзі жүктеледі, пагинатор оның нөміріне ауысады. Нақты бет керек болса — оның нөмірін басыңыз. «Құжаттар кестесі», «Құжаттар жинағы», «Кесте» өрісі, «Жұмыс барысы», жойылған құжаттар және шығыс хабарламалар журналы да осылай парақталады.
• Телефондағы журнал: телефон мен планшетте ықшам жолдар, пагинаторда бет нөмірлері, көрініс қойындылары жанына айналдырылмайды — сыймағандары «Тағы N» ішіне жиналған. Телефондағы мәзір, профиль және хабарландырулар қоңыраушасы да ұқыптырақ болды.
• Белгіше таңдау терезесі: ~2 000-нің орнына шамамен 4 200 белгіше, орысша іздеу, санаттар, «Соңғылар» және «Қолданылатындар». Бұл ретте белгішелер қарпі 10 есе жеңілдеді — 3,2 МБ-тың орнына 323 КБ.
• Маршрут нүктелеріне арналған эмодзи сол терезеде таңдалады және Windows, Android, Linux жүйелерінде және Apple құрылғыларында бірдей көрінеді.
• Хабарландырулар бойынша іздеу қоңыраушада — жаңалары және қаралғандары бойынша.
• Профильдің жаңа көрінісі: ЖИ-дің қалқымалы батырмаларын алып тастауға болады — олардың орнына профиль мәзірінде тармақ қалады. PWA мен DOC-V Desktop-та «Сілтемені көшіру» тармағы пайда болды.
• Уақытты үнемдейтін ұсақ-түйектер: журнал карточкаларының үстінде есептегіші бар «Барлығын таңдау», батырмалар тобын тікелей батырмалар тізімінен ауыстыру, бастапқы беттегі «Мониторинг» бүкіл терезеге жайылады.

🧭 Маршруттар: «Ағымдағы нүктенің орындаушылары», схема және тексеру

• «Ағымдағы нүктенің орындаушылары» айнымалысы — құжат қазір тұрған нүктенің орындаушылары. Батырмаларды делегирлеуде, «Қолжетімділікте», «Жазуда», «Хабарламада», шарттарда, бағандарда, стильдерде және журналдардың пайдаланушылық сүзгілерінде жұмыс істейді. Мысалы, маршруттың барлық нүктелеріне бір «Келісу» батырмасы немесе «мені күтуде» журнал сүзгісі.
• Маршрут схемасы: маршрут редакторында «Схема / Тізім» ауыстырғышы және «өріс қайда жазылады және оқылады» қабаттасуы бар.
• Маршрутты тексеру жоқ және бөгде нүктелерге өтулерді, шексіз циклдарды және қол жетпейтін нүктелерді табады — пайдаланушылар оларға тап болмай тұрып.
• «Пайдаланылуы» қойындысы ағаш түрінде: «түр → нүкте → жолдар», әр жолда оның өрісті жазатыны немесе оқитыны көрінеді; іздеу мен сүзгілер бар.
• Оқылатын сипаттамалар: «Жазу», «Шарт», «Қайталау» сипаттамаларында және сүзгілерде УИД-тердің орнына құжаттардың атаулары көрсетіледі. «Шарт», «Қайталау» және «Бақылау» ішіндегі кірістірілген әрекеттерге түсініктеме қалдыруға болады.

🔌 REST API: құжаттарды іріктеу және адал жауап кодтары

• «Құжаттарды іріктеу» режимі. GET-сұрау шарттарға сәйкес келетін құжаттар тізімі бар JSON қайтарады; бұл ретте өңдеу құжаты құрылмайды. Құқықтар — кілт пайдаланушысының немесе сервистің, бір сұрауға 1 000 құжатқа дейін, әрі қарай — offset арқылы.
• Пайдаланушы атынан «Іріктеу» әрекеті тек көрсетілген пайдаланушыға қолжетімді құжаттарды іріктейді.
• Бас тартулар HTTP кодымен келеді: 400 — параметр жоқ немесе JSON қате, 401 — кілт жоқ, 403 — IP тізімде жоқ, 422 — бірегей өрістің мәні бұрыннан бар немесе сақтау қатесі, 500 — ақау. Жауап денесіндегі мәтін бұрынғыдай.
• Кілт тақырыпта: X-API-Key немесе Authorization: Bearer. «Кілт тек тақырыпта» («Ключ только в заголовке») баптауы кілтті мекенжайда беруге тыйым салады, ал кілттің өзі енді журналдарға ашық мәтінмен түспейді.
• Сканерлерден қорғау: нүктесі бар мекенжайға (.env, .git/…) жүгіну IP-мекенжайды шекті күтпей, бірден бұғаттайды.

🛡️ Деректерді жазудың сенімділігі

• Сақтаулар басқа түрдегі жазу қайталауларын күтпейді: кідіріс секундтардан микросекундтарға дейін қысқарды.
• Жұмыс барысы мен жинақтарды қайта есептеу тұрақты жоғары жүктеме кезінде де жазылады, ал жұмыс барысы бір ұзын жазба салдарынан жоғалмайды.
• Бір жолдың деректеріндегі қате өріс мәндерінің бүкіл пакетін жоққа шығармайды. Қате кодтаудағы мәтін (мысалы, windows-1251-дегі жауап) енді жазуды тоқтатпайды, ал HTTP-сұрау жауапты UTF-8-ге өзі аударады.
• Шифрлауы бар «Жасырын» өріс 8 192 таңбаға дейін сақтайды.
• Түр мен журналдың «Пайдаланылуы» жоспарлағыш тапсырмаларын, жүйелік баптауларды және әрекеттерді ескереді — олар сілтеме жасайтын түр пайдаланылмайтын ретінде жойылмайды.
• Әрекеттер мен журналдардың көшірмелері өздерінің ішкі идентификаторларын алады және енді түпнұсқамен пішінді бөліспейді.
• «Ең үлкен + 1» нөмірлі «Тіркеу» жойылған құжаттардың нөмірлерін бірден босатады.

⚠️ Жаңарту алдында: мінез-құлықта не өзгерді

sha256sum lib/libkalkancryptwr-64.so

Ескеру қажет мінез-құлықтағы басқа өзгерістер:

• REST: бас тартулар 200 емес, HTTP кодымен келеді. Егер сыртқы жүйе тек жауап мәтініне сүйенсе, «200 кодымен REST бас тартулары» («Отказы REST с кодом 200») ауыстырғышын қосыңыз — ол бұрынғы мінез-құлықты қайтарады. Байланыстырылған өрісі жоқ міндетті параметр де енді тексеріледі.
• «Бүтін сан» өрісі енді үтірді қиып тастамайды: «100,12» → 100 (бұрын 10012 болатын), «1.000.000» → 1000000.
• «ЭЦП (ЕСЭДО)» әрекеті жойылды: жаңарту оны баптаулардан алып тастайды, онымен батырмалар өту батырмалары болып қалады.
• Фондық режим нәтижені жасырмайды: пайдаланушыға бірдеңе көрсететін әрекеттер («браузерде» HTTP-сұрау, файл таңдаумен импорт, ағымдағы құжатты жою, батырмадан құру және т.б.) алдыңғы планда орындалады. NCALayer мен КриптоПро-да «Фондық режим» («Фоновый режим») әрқашан өшірулі.
• Ағымдағы құжатты жойғаннан кейін блоктағы және нүктедегі төмендегі әрекеттер орындалмайды.
• «Қайталау» құжат басқа нүктеге ауыстырылған итерацияда аяқталады — ауыстыру енді жоғалмайды.
• Жаңа «Шарттарда» «Бос мән салыстырылмайды» («Пустое значение не сравнивается»): ізделетін мән бос болса, «ішінде бар», «қамтиды», «басталады», «аяқталады» және олардың терістеулері жалған болады. Ескі «Шарттар» бұрынғыдай жұмыс істейді; оларды жаңа режимге жалаушамен ауыстыруға болады.
• «ЖИ» әрекеті ақау кезінде сұрауды қайталайды, ал сәтсіз болса нәтиже өрісін тазартады — ескі жауап енді құжатқа түспейді.
• DOC-V Desktop: белсенді есептік жазбалар 10 және одан көп болса, сервер тарату үшін қосымша орнатқыштарын жүктеп алады. [Desktop] UpdateMirror параметрімен өшіріледі.

💡 DOC-V 8.5.10-ға қалай жаңартуға болады?

Жаңарту тегін: платформаның және сатып алынған модульдердің жаңартулары тегін, Software Maintenance-ке жыл сайынғы жазылым жоқ. 8.5 — DOC-V әзірлеуінің негізгі тармағы: жаңа мүмкіндіктер, соның ішінде ЖИ-көмекші мен ЖИ-әкімші, осы тармақта пайда болады. Тұрақты тармақ — DOC-V 8.4.

Жаңарту үшін DOC-V серверінде жоспарлағыш тапсырмасын ↗ іске қосыңыз. Сұрақтар туындаса, техникалық қолдауға ↗ жүгініңіз.