From efc521245b49566b2b4d8504259f4509d9905ab1 Mon Sep 17 00:00:00 2001
From: Artem Proskurnev <tema@altlinux.org>
Date: Wed, 14 Sep 2022 17:38:46 +0300
Subject: [PATCH] Init

---
 .gitignore        |  2 ++
 README.md         |  1 +
 hostname-rules.md | 75 +++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 78 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 hostname-rules.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..02498b5
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+*.backup
+*~
diff --git a/README.md b/README.md
index d4dfa95..3205d37 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,3 @@
 # doc-standart
 
+Стандарт именования
diff --git a/hostname-rules.md b/hostname-rules.md
new file mode 100644
index 0000000..5ed705e
--- /dev/null
+++ b/hostname-rules.md
@@ -0,0 +1,75 @@
+# Правила составления имени устройства
+
+При назначении имён устройствам (hostname), необходимо придерживаться следующих правил.
+
+## Полное именование
+
+Шаблон имени состоит из полей, разделённых знаком «-»
+
+```Поле1-Поле2-Поле3-Поле4```
+
+Максимально возможное количество полей: 4
+
+### Поле1
+
+Содержит информацию о типе устройства и школе. Так же может содержать информацию о типе использования.
+
+#### Структура
+
+```xyyyy``` или ```sxyyyy```
+
+x - тип устройства|yyyy - школа|s - тип использования
+---|---|---
+**с** - компьютер (системный блок+монитор)|Номер или сокращение|Первый символ s (student) означает использование устройства в качестве компьютера ученика
+**n** - ноутбук|Примеры:| 
+**m** - моноблок|1111|
+**p** - интерактивная панель|kur (Курчатовская)|
+**t** - планшет|cg (Цифровая гимназия)|
+**e** - embeded устройство (Raspberry Pi, например)|
+
+### Поле2
+
+Содержит информацию о учебном корпусе. Можно указывать либо номер, либо сокращение. Например: sol == Солнце, mars == Марс, 3 == корпус 3
+
+### Поле3
+
+Содержит информацию о помещении, где располагается устройство. Можно указывать либо номер, либо сокращение. Например: ip1 == ИТ полигон 1, 3 == кабинет 3
+
+### Поле4
+
+Содержит номер устройства. При наличии поля 2 и поля 3 указывается номер устройства в кабинете. Данный вариант является стандартом для компьютерных классов.
+
+Пример 1: ```hostnamectl hostname smсg-2-l2-1```
+
+(моноблок ученика из лаборатории No2 в корпусе No 2 Цифровой гимназии)
+
+Пример 2: ```hostnamectl hostname n1111-5-308-0```
+
+(ноутбук учителя из кабинета 308 в корпусе No 5 школы No 1111)
+
+Пример 3: ```hostnamectl hostname sm4444-sol-111-6```
+
+(моноблок ученика под номером 6 из кабинета 111 УК «Солнце» школы No 4444)
+
+Пример 4: ```hostnamectl hostname mkras-7-13-0```
+
+(моноблок учителя под номером 10 из кабинета 13 УК No7 школы Красовка)
+
+## Именование без полей 2 и 3
+
+При отсутствии поля 3 и/или поля 2, поле 4 может содержать принятую в ОУ сквозную нумерацию устройств по всему корпусу или по всей школе с использованием собственных правил.
+
+При удалении полей возможны только следующие варианты именований:
+
+```Поле1-Поле2-Поле4``` и ```Поле1-Поле4```
+
+Никакие другие варианты неприемлемы.
+
+Пример 1: ```hostnamectl hostname mсg-f6732```
+
+(моноблок с собственным идентификатором *f6732* Цифровой гимназии)
+
+Пример 2: ```hostnamectl hostname n1111-5-548```
+
+(ноутбук с номером *548* корпусе No 5 школы No 1111)
+