Docs: начальная структура проекта Управление ИТ (ОМС)

Made-with: Cursor

.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=задать_секретный_ключ

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/`.

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).

content/README.txt

@@ -0,0 +1,2 @@
+Положите сюда HTML-файлы обучения и тестирования.
+После размещения файлов можно запросить анализ и корректировку, затем добавление серверной части.

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: