PHPackages avtocod/specs - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. avtocod/specs ActiveLibrary[Utility & Helpers](/categories/utility) avtocod/specs ============= Specifications repository v5.15.0(1mo ago)557.1k↓38.4%17[2 PRs](https://github.com/avtocod/specs/pulls)1MITTypeScriptCI passing Since Nov 30Pushed 1mo ago7 watchersCompare [ Source](https://github.com/avtocod/specs)[ Packagist](https://packagist.org/packages/avtocod/specs)[ RSS](/packages/avtocod-specs/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)DependenciesVersions (229)Used By (1) [![avtocod](https://avatars1.githubusercontent.com/u/32733112?s=70&v=4)](https://avatars1.githubusercontent.com/u/32733112?s=70&v=4) Публичные спецификации проекта "Автокод" ---------------------------------------- [](#публичные-спецификации-проекта-автокод) [![Release version](https://camo.githubusercontent.com/f83a13b510ac8605626aff5981dca1de76a5f83799e7990470d0d03f8245ed2b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6176746f636f642f73706563732e7376673f7374796c653d666f722d7468652d6261646765266d61784167653d35)](https://camo.githubusercontent.com/f83a13b510ac8605626aff5981dca1de76a5f83799e7990470d0d03f8245ed2b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6176746f636f642f73706563732e7376673f7374796c653d666f722d7468652d6261646765266d61784167653d35)[![Release date](https://camo.githubusercontent.com/2d4c3f5111e48c9a07c0321e54bfd5e8032e4b08f48e675d9e9c2153405574f4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652f6176746f636f642f73706563732e7376673f7374796c653d666f722d7468652d6261646765266d61784167653d35)](https://camo.githubusercontent.com/2d4c3f5111e48c9a07c0321e54bfd5e8032e4b08f48e675d9e9c2153405574f4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652f6176746f636f642f73706563732e7376673f7374796c653d666f722d7468652d6261646765266d61784167653d35)[![Commits since latest release](https://camo.githubusercontent.com/cd79fdcec3a634a744164fd0af21e707fff999d277e27eec1fa90932b5638f32/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6d6d6974732d73696e63652f6176746f636f642f73706563732f6c61746573742e7376673f7374796c653d666f722d7468652d6261646765266d61784167653d35)](https://camo.githubusercontent.com/cd79fdcec3a634a744164fd0af21e707fff999d277e27eec1fa90932b5638f32/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6d6d6974732d73696e63652f6176746f636f642f73706563732f6c61746573742e7376673f7374796c653d666f722d7468652d6261646765266d61784167653d35) Данный репозиторий содержит публичные спецификации, связанные с проектом "Автокод". ### Поля данных отчёта (филды) [](#поля-данных-отчёта-филды) Поля данных (далее по тексту - *филдлы*) обладают следующими свойствами: - Филд имеет уникальный путь *(`path`)*; - Пути *(`path`)* филдов являются фиксированными; - Имя филда данных состоит из букв латинского алфавита в нижнем регистре; - При необходимости разделить имя филда данных на составные слова используется символ "подчеркивания" (`_`); - Для группировки различных филдов используется нотация с помощью точки (`.`); - Глубина "вложенности" нотаций может быть произвольной; - Для указания того, что элемент пути филда является массивом используется обозначение `[]` (добавляется в конец группы филда). - Для указания **типа данных**, которые может содержать филд могут использоваться следующие ключевые слова - `array`, `boolean`, `float`, `integer`, `object`, `string`, `null`; - Каждый филд может быть `null`. > Пример нотации с помощью точки: > > Имеется набор филдов: `name`, `year`, `vin`, `owner_name`. Все они относятся к базовым характеристикам ТС, кроме `owner_name`, который относится к данным владельца. В этом случае их именование будет иметь следующий вид: `base.name`, `base.year`, `base.vin`, `owner.owner_name`. > Пример использования указателя массива: > > Отчёт содержит набор данных о датах и местах прохождения технического осмотра ТС. Филды этих данных имеют вид `diagnostic_card.items[].date` и `diagnostic_card.items[].place` соответственно. Это означает, что `diagnostic_card.items[]` - это массив, элементами которого являются объекты, имеющие ключи `date` и `place`. **Описание всех филдов** вы можете найти [в данном файле](./fields/default/fields_list.json), **[json-schema](https://json-schema.org) отчёта** располагается в [этом файле](./reports/default/json-schema.json). Примеры отчётов: [с данными](./reports/default/examples/full.json), [без данных](./reports/default/examples/empty.json). ### Типы идентификаторов [](#типы-идентификаторов) Для создания отчёта необходимо передать тип и значение идентификатора (VIN-код, номер СТС и т.п.). Поддерживаемые типы идентификаторов и их описания перечислены в [данном файле](./identifiers/default/types_list.json). ### Имена источников [](#имена-источников) Для формирования данных отчёта происходят обращения к различным источникам. Каждый источник обладает следующими свойствами: - Имя источника состоит из букв латинского алфавита в нижнем регистре; - Для группировки различных источников используется нотация с помощью точки (`.`); - Каждый источник наполняет данными фиксированный набор филдов; - Если несколько источников наполняют данными одни и те же филды - в отчёт попадают данные от того источника, который нами считается наиболее доверительным. Со всеми поддерживаемыми нами источниками вы можете ознакомиться в [данном файле](./sources/default/sources_list.json). ### Идентификаторы марок и моделей транспортных средств [](#идентификаторы-марок-и-моделей-транспортных-средств) Отчет *может* содержать данные о марках и моделях транспортных средств, включая их уникальные идентификаторы, состоящие из символов `A-Z`, цифр и символа `_`. Со всеми поддерживаемыми нами идентификаторами вы можете ознакомиться в файлах [марок](./vehicles/default/marks.json) и [моделей](./vehicles/default/). > Модели поделены по категориям типа ТС. Пример: [models\_bus.json](./vehicles/default/models_bus.json) - автобусы. С идентификаторами типов моделей вы можете ознакомится в [файле спецификации](vehicles/default/types.json). Обновления и версионирование ---------------------------- [](#обновления-и-версионирование) Данные, содержащиеся в данном репозитории обновляются с течением времени. Измененные состояния фиксируются с помощью [тэгирования](https://git-scm.com/book/en/v2/Git-Basics-Tagging) с присвоением соответствующего значения версии. Значения версий присваиваются в соответствии с правилами [семантического версионирования](https://semver.org/lang/ru/). На данный момент существуют 3 мажорные версии: - `v1` - устаревшая *(не поддерживается с 22 июня 2018 года)*; - `v2` - устаревшая *(не поддерживается с 19 февраля 2019 года)*; - `v3` - актуальная. Для того, что бы получать уведомления об изменениях - **подпишитесь** на них, перейдя по **[этой ссылке](https://github.com/avtocod/specs/subscription)**. SDK --- [](#sdk) Список `SDK` для удобного доступа к данным спецификациям: - **PHP** [`avtocod/specs-php`](https://github.com/avtocod/specs-php) Поддержка --------- [](#поддержка) Если у вас возникли какие-либо проблемы при работе с данным репозиторием, пожалуйста, создайте соответствующий `issue` [перейдя по данной ссылке](https://github.com/avtocod/specs/issues/new/choose). ### Health Score 63 — FairBetter than 99% of packages Maintenance89 Actively maintained with recent releases Popularity38 Limited adoption so far Community27 Small or concentrated contributor base Maturity83 Battle-tested with a long release history Bus Factor3 3 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~13 days Recently: every ~38 days Total 225 Last Release 54d ago Major Versions v1.x-dev → v2.0.02018-06-16 v2.13.0 → v3.0.02019-02-19 v3.164.0 → v4.0.02025-03-12 v4.7.0 → v5.0.02025-07-22 PHP version history (6 changes)v1.1.0PHP ^5.6 || >=7.0 <=7.3 v2.0.0PHP ^5.6.4 || >=7.0 <=7.3 v2.11.0PHP >=7.0 v3.7.0PHP >=7.1.3 v3.17.0PHP ^7.1.3 v3.30.0PHP ^7.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/6119929?v=4)[Eldario](/maintainers/eldario)[@eldario](https://github.com/eldario) ![](https://avatars.githubusercontent.com/u/52275?v=4)[Zaboday](/maintainers/zaboday)[@Zaboday](https://github.com/Zaboday) --- Top Contributors [![Zaboday](https://avatars.githubusercontent.com/u/52275?v=4)](https://github.com/Zaboday "Zaboday (168 commits)")[![Reallife](https://avatars.githubusercontent.com/u/356993?v=4)](https://github.com/Reallife "Reallife (67 commits)")[![yurichechulin](https://avatars.githubusercontent.com/u/54947685?v=4)](https://github.com/yurichechulin "yurichechulin (59 commits)")[![tarampampam](https://avatars.githubusercontent.com/u/7326800?v=4)](https://github.com/tarampampam "tarampampam (56 commits)")[![bend-is](https://avatars.githubusercontent.com/u/63018907?v=4)](https://github.com/bend-is "bend-is (51 commits)")[![Yuri364](https://avatars.githubusercontent.com/u/2154704?v=4)](https://github.com/Yuri364 "Yuri364 (42 commits)")[![DenSul](https://avatars.githubusercontent.com/u/7234995?v=4)](https://github.com/DenSul "DenSul (19 commits)")[![EddieOrbit](https://avatars.githubusercontent.com/u/47664840?v=4)](https://github.com/EddieOrbit "EddieOrbit (14 commits)")[![eldario](https://avatars.githubusercontent.com/u/6119929?v=4)](https://github.com/eldario "eldario (5 commits)")[![jetexe](https://avatars.githubusercontent.com/u/4963272?v=4)](https://github.com/jetexe "jetexe (2 commits)")[![Belobokovm](https://avatars.githubusercontent.com/u/44295507?v=4)](https://github.com/Belobokovm "Belobokovm (1 commits)")[![EvgnEkb](https://avatars.githubusercontent.com/u/69976014?v=4)](https://github.com/EvgnEkb "EvgnEkb (1 commits)") --- Tags avtocodspecificationsspecsavtocodSpecifications ### Embed Badge ![Health badge](/badges/avtocod-specs/health.svg) ``` [![Health](https://phpackages.com/badges/avtocod-specs/health.svg)](https://phpackages.com/packages/avtocod-specs) ``` ### Alternatives [christianklisch/slim-minify Minify html output in slim framework 3831.9k1](/packages/christianklisch-slim-minify)[cyber-duck/silverstripe-google-tag-manager Add Tag Manager data layer, events, and ecommerce support for SilverStripe 1528.0k](/packages/cyber-duck-silverstripe-google-tag-manager) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)