From 2de0d2cfbd55e9661bc37d0d40cf188db2894fa6 Mon Sep 17 00:00:00 2001
From: cursor-agent <agent@gen7x.local>
Date: Mon, 16 Mar 2026 07:33:20 +0000
Subject: [PATCH] =?UTF-8?q?Docs:=20=D0=BD=D0=B0=D1=87=D0=B0=D0=BB=D1=8C?=
 =?UTF-8?q?=D0=BD=D0=B0=D1=8F=20=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=82=D1=83?=
 =?UTF-8?q?=D1=80=D0=B0=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0=20?=
 =?UTF-8?q?=D0=A3=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D0=B5=20?=
 =?UTF-8?q?=D0=98=D0=A2=20(=D0=9E=D0=9C=D0=A1)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Made-with: Cursor
---
 .env.example       | 12 ++++++++++
 HISTORY.md         | 14 ++++++++++++
 README.md          | 57 ++++++++++++++++++++++++++++++++++++++++++++++
 content/README.txt |  2 ++
 docker-compose.yml | 25 ++++++++++++++++++++
 5 files changed, 110 insertions(+)
 create mode 100644 .env.example
 create mode 100644 HISTORY.md
 create mode 100644 README.md
 create mode 100644 content/README.txt
 create mode 100644 docker-compose.yml

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..2cd74b4
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,12 @@
+# Управление ИТ (ОМС) — система дистанционного обучения
+# Скопировать в .env и при необходимости изменить значения
+
+# База данных (будет использоваться серверной частью)
+# POSTGRES_HOST=db
+# POSTGRES_PORT=5432
+# POSTGRES_DB=lms_it_oms
+# POSTGRES_USER=lms
+# POSTGRES_PASSWORD=задать_пароль
+
+# Приложение
+# SECRET_KEY=задать_секретный_ключ
diff --git a/HISTORY.md b/HISTORY.md
new file mode 100644
index 0000000..06842f1
--- /dev/null
+++ b/HISTORY.md
@@ -0,0 +1,14 @@
+# История изменений — Управление ИТ (ОМС)
+
+## 2025-03-16 12:00 UTC – Создание проекта
+
+**Проблема:** нужна система дистанционного обучения «Управление ИТ (ОМС)» с HTML-контентом и последующей серверной частью для учёта сотрудников и результатов тестов.
+
+**Решение:** создан проект в `/opt/lms-it-oms/` с каталогом `content/` для размещения HTML-файлов.
+
+**Изменения:**
+- Создана структура проекта.
+- Добавлены README.md, HISTORY.md, .env.example, docker-compose.yml (базовые).
+- Каталог `content/` предназначен для HTML обучения и тестирования.
+
+**Проверка:** наличие каталога `/opt/lms-it-oms/content/`.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ce13d7d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# Управление ИТ (ОМС) — система дистанционного обучения
+
+Система дистанционного обучения с фиксацией прохождения обучения и результатов тестирования сотрудников.
+
+## Назначение
+
+- Раздача контента обучения и тестирования (HTML).
+- Фиксация ФИО сотрудника при старте обучения и при прохождении теста.
+- Сохранение результатов тестирования в базе данных.
+
+## Требования и зависимости
+
+- Docker, Docker Compose
+- (Планируется) PostgreSQL для хранения записей о прохождении и результатах тестов
+
+## Установка и настройка
+
+1. Скопировать `.env.example` в `.env` и при необходимости задать переменные.
+2. Запуск: `docker compose up -d` (после добавления серверной части).
+
+## Конфигурация
+
+См. `.env.example`. Переменные задаются в `.env` (файл не коммитится).
+
+## Структура проекта
+
+```
+/opt/lms-it-oms/
+├── README.md
+├── HISTORY.md
+├── .env.example
+├── docker-compose.yml
+├── content/          # HTML-файлы обучения и тестирования (положить сюда для анализа)
+└── (backend/ и static/ — будут добавлены при реализации серверной части)
+```
+
+### Куда положить HTML для анализа
+
+**Положите ваши HTML-файлы обучения и тестирования в каталог:**
+
+```
+/opt/lms-it-oms/content/
+```
+
+После размещения файлов можно запросить анализ и корректировку контента, а затем — добавление серверной части для учёта ФИО и результатов тестов.
+
+## Логирование
+
+(Будет описано после внедрения серверной части.)
+
+## Резервное копирование
+
+Volumes проекта будут добавлены в `/opt/gen7x/backup/include-volumes.txt`.
+
+## История изменений
+
+См. [HISTORY.md](HISTORY.md).
diff --git a/content/README.txt b/content/README.txt
new file mode 100644
index 0000000..c4feba6
--- /dev/null
+++ b/content/README.txt
@@ -0,0 +1,2 @@
+Положите сюда HTML-файлы обучения и тестирования.
+После размещения файлов можно запросить анализ и корректировку, затем добавление серверной части.
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..16f3605
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,25 @@
+# Управление ИТ (ОМС) — система дистанционного обучения
+# Серверная часть и БД будут добавлены после размещения HTML-контента
+
+version: "3.9"
+
+services:
+  # Заглушка: после добавления backend и БД здесь появятся app и db
+  # app:
+  #   build: .
+  #   ports:
+  #     - "8000:8000"
+  #   env_file: .env
+  #   depends_on:
+  #     - db
+  # db:
+  #   image: postgres:15-alpine
+  #   environment:
+  #     POSTGRES_DB: ${POSTGRES_DB}
+  #     POSTGRES_USER: ${POSTGRES_USER}
+  #     POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+  #   volumes:
+  #     - lms_it_oms_data:/var/lib/postgresql/data
+
+# volumes:
+#   lms_it_oms_data: