commit 2de0d2cfbd55e9661bc37d0d40cf188db2894fa6 Author: cursor-agent Date: Mon Mar 16 07:33:20 2026 +0000 Docs: начальная структура проекта Управление ИТ (ОМС) Made-with: Cursor 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: