med-cms 1.0.0-beta.2 → 1.0.0

package/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2026 RPM-programmer (github) / prm-programmer (npmjs)
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or 
+without fee is hereby granted, provided that the above copyright notice and this permission 
+notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR 
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# MED-CMS (v1.0.0)
+
+> ## `med-cms` — Это автономный медецинский движок для управления сетями клиник, персоналом и расписание приймов и т.д. Написан `med-cms` на node.js с использованием **express**, **sequelize**
+
+### Модуль поставляется со встроенной базой данных, системой разграничения прав доступа на основе **34 медицинских специальностей** и готовым веб-интерфейсом (АРМ Врача, Личный Кабинет Пациента, Панель Суперадминистратора), а также готовой главной страницей
+
+---
+
+## Ключевые возможности
+
+- **Автономность** База данных SQLite3 не требует установки тяжелых серверов (PostgreSQL/MySQL/MongoDB). Файл БД и таблицы создаются автоматически прямо в папке проекта.
+- **Безопасность и Сессии:** Авторизация реализована через зашифрованные JWT-токены, хранящиеся в защищенных **HttpOnly Cookie**. JS на клиенте не имеет доступа к токену.
+- **Матрица прав доступа (34 специальности):** Гибкое разграничение возможностей врачей. Стоматолог или Эндокринолог не смогут получить доступ к эндпоинтам назначения нейрохирургических операций — то-есть не к своим данным
+- **Автоматический расчет участков:** При регистрации или изменении адреса проживания пациента система сама вычисляет номер его терапевтического участка и закрепленный кабинет врача. Участки настраиваются админом.
+- **Статистика болезней и МКБ-10:** Выделенный независимый справочник заболеваний в базе данных с возможностью автономной миграции и автоматическим инкрементом счетчиков заболеваемости при закрытии приемов врачами.
+- **Возможность управлять новостями** А админ панеле есть форма позволяющая выкладывать новости.
+- **Автозапись в `.env`** При запуске проекта код проверяет есть ли `.env` и настройки в нём, если то записывает настройки в него.
+
+---
+
+## Установка и быстрая настройка
+
+### 1. Установка модуля
+
+#### Установите пакет в ваше Node.js приложение:
+
+```bash
+npm install med-cms
+# или
+yarn add med-cms
+```
+
+> **Важно для пользователей Linux:** Пакетам `sequelize` и `sqlite3` иногда требуются компиляторы C++ для сборки бинарных файлов под вашу архитектуру ядра. Перед развертыванием убедитесь, что в системе установлены базовые утилиты сборки:
+>
+> ```bash
+> sudo apt update && sudo apt install -y build-essential python3
+> ```
+
+### 2. Подключение в Express
+
+#### Для интеграции CMS в ваш Express-сервер импортируйте функцию инициализации и передайте туда ваш инстанс `app`:
+
+```javascript
+const express = require("express");
+require("dotenv").config();
+
+const app = express();
+
+// Импортируем инициализатор нашего npm-модуля
+const MI = require("med-cms");
+
+// здесь ваши роуты ...
+app.get("/", async (req, res) => {
+  res.end("HELLO!");
+});
+
+(async function startServer() {
+  // Запускаем медицинский движок med-cms
+  // требуется асинхронность из-за запросов в к бд
+  await MI(app);
+
+  app.listen(3000, () => {
+    console.log(`Сервер успешно запущен!`);
+  });
+})();
+```
+
+---
+
+## Миграция расширенного справочника болезней (РБ)
+
+### Справочник заболеваний полностью изолирован от кода ядра CMS. Для наполнения пустой таблицы `Diseases` актуальными и социально значимыми кодами МКБ-10 для Республики Беларусь, запустите команду миграции перед стартом основного сервера:
+
+```bash
+node node_modules/med-cms/migrate-diseases.js
+# или
+node node_modules\med-cms\migrate-diseases.js
+```
+
+### Это наполнит отдельную таблицу базы данных 18 распространенными диагнозами (ОРВИ, Острый бронхит, Внебольничная пневмония, Артериальная гипертензия, Остеохондроз, Эндемический зоб и др.), которые автоматически начнут подтягиваться в HTML-тег `<select>` на рабочем месте врача.
+
+---
+
+## Роли и Маршрутизация (API & Web)
+
+### Архитектура роутера жестко разделяет отдачу интерфейсов и данных, исключая ошибки парсинга `JSON.parse` в браузере:
+
+- **Интерфейс (Web-страницы):** `http://localhost:3000/med/...`
+- **Данные (JSON API):** `http://localhost:3000/med/api/...`
+
+### Матрица маршрутов
+
+| Действие                     | Метод | Маршрут (URL)                             | Доступ (Роль) |
+| :--------------------------- | :---- | :---------------------------------------- | :------------ |
+| Страница авторизации и входа | `GET` | `/med/html/login.html` (или `/med/login`) | Публичный     |
+| Главная страница             | `GET` | `/med/html/home.html` (или `/med/home`)   | Публичный     |
+
+---
+
+### Алгоритм проведения инициялизации:
+
+1. Выполните миграцию справочника болезней: `node node_modules/med-cms/migrate-diseases.js` или `node node_modules\med-cms\migrate-diseases.js`.
+2. Откройте браузер на `http://localhost:3000/med/home` и нажмите на кнопку **`вход`**.
+3. Авторизируйтесь (заполните поля почты и пароля) (данные можно узнать в настройках `.env`)
+4. В левой форме добавьте поликлинику. Она запишется в SQLite под числовым `ID: 1`.
+5. Кликните на карточку «Всего клиник», чтобы развернуть интерактивную таблицу и проверить числовой ID.
+6. В правой форме зарегистрируйте аккаунт врача, выбрав созданную поликлинику №1 из выпадающего списка.
+7. Выйдите из админки, нажмите «Зарегистрироваться как пациент» и создайте профиль.
+8. В кабинете пациента выберите созданного врача, дату, время и нажмите **«Забронировать талон»**. Талон мгновенно отобразится в блоке предстоящих приемов.
+9. Авторизуйтесь под созданным врачом. Пациент появится в вашей очереди. Нажмите «Принять», заполните жалобы, выберите из подгрузившегося справочника диагноз _«Острый бронхит»_ и закройте прием. Системные счетчики зафиксируют визит, а статистика болезни обновится в SQLite.
+10. Также можете с аккаунта админа настроить участки и новости!
+
+---
+
+## Лицензия
+
+### Проект распространяется на условиях открытой лицензии [**ISC**](LICENSE.txt). Разработано [RPM-programmer](https://github.com/RPM-programmer/) для создания масштабируемых и отказоустойчивых медицинских информационных систем.

package/database/config/db-init.js

@@ -1,88 +1,102 @@
-const { Sequelize, DataTypes } = require('sequelize');
-const path = require('path');
+// Полностью рабочий database/config/db-init.js с динамическим расширением модели
+
+const { Sequelize, DataTypes } = require("sequelize");
+const path = require("path");
 const logger = require("custom-color-logs").print;
 
 let sequelize;
 
 function getSequelizeInstance(dbPath) {
   if (!sequelize) {
-    const storagePath = dbPath || path.join(process.cwd(), 'med-cms.sqlite');
+    const storagePath = dbPath || path.join(process.cwd(), "med-cms.sqlite");
     sequelize = new Sequelize({
-      dialect: 'sqlite',
+      dialect: "sqlite",
       storage: storagePath,
-      logging: false
+      logging: false,
     });
   }
   return sequelize;
 }
 
-async function initDatabase(dbPath) {
-  const instance = getSequelizeInstance(dbPath);
-  
-  try {
-    await instance.authenticate();
-    console.log(logger.DatabaseMedInfo("Успешное подключение к SQLite через Sequelize."));
-
-    // 1. Импортируем функции моделей и сразу инициализируем их инстансом sequelize
-    const models = {
-      Clinic: require(path.join(__dirname, '..', 'models', 'clinics'))(instance, DataTypes),
-      User: require(path.join(__dirname, '..', 'models', 'users'))(instance, DataTypes),
-      UserAddress: require(path.join(__dirname, '..', 'models', 'user-addresses'))(instance, DataTypes),
-      Disease: require(path.join(__dirname, '..', 'models', 'diseases'))(instance, DataTypes),
-      Appointment: require(path.join(__dirname, '..', 'models', 'appointments'))(instance, DataTypes)
-    };
-
-    // 2. Автоматически запускаем связи, которые мы прописали внутри файлов таблиц
-    Object.keys(models).forEach((modelName) => {
-      if (models[modelName].associate) {
-        models[modelName].associate(models);
-      }
-    });
-
-    await instance.sync({ alter: true });
-    console.log(logger.DatabaseMedInfo("Все таблицы базы данных успешно синхронизированы."));
-  } catch (error) {
-    console.log(logger.DatabaseMedError('Ошибка инициализации базы данных:', error));
-    throw error;
-  }
-}
-
-// В самом конце вашего database/config/db-init.js вместо старого exports:
-
 const db = {
   getSequelizeInstance,
   initDatabase,
-  get sequelize() { return sequelize; },
-  // Динамически прокидываем модели наружу, чтобы они были доступны как db.User, db.Clinic и т.д.
-  models: {} 
+  get sequelize() {
+    return sequelize;
+  },
+  models: {},
 };
 
-// Перепишем функцию initDatabase, чтобы она сохраняла модели в db.models и самом объекте db
 async function initDatabase(dbPath) {
   const instance = getSequelizeInstance(dbPath);
-  
+
   try {
     await instance.authenticate();
-    console.log(logger.DatabaseMedInfo("Успешное подключение к SQLite через Sequelize."));
+    console.log(
+      logger.DatabaseMedInfo("Успешное подключение к SQLite через Sequelize."),
+    );
+
+    // 1. Инициализируем базовые модели из фабрик
+    db.models.Clinic = db.Clinic = require(
+      path.join(__dirname, "..", "models", "clinics"),
+    )(instance, DataTypes);
+    db.models.User = db.User = require(
+      path.join(__dirname, "..", "models", "users"),
+    )(instance, DataTypes);
+    db.models.UserAddress = db.UserAddress = require(
+      path.join(__dirname, "..", "models", "user-addresses"),
+    )(instance, DataTypes);
+    db.models.Disease = db.Disease = require(
+      path.join(__dirname, "..", "models", "diseases"),
+    )(instance, DataTypes);
+    db.models.Appointment = db.Appointment = require(
+      path.join(__dirname, "..", "models", "appointments"),
+    )(instance, DataTypes);
+    db.models.District = db.District = require(
+      path.join(__dirname, "..", "models", "districts"),
+    )(instance, DataTypes);
+    db.models.News = db.News = require(
+      path.join(__dirname, "..", "models", "news"),
+    )(instance, DataTypes);
+    // =========================================================================
+    // 🔥 ДИНАМИЧЕСКИЙ ХАК: Расширяем модель User прямо в памяти до синхронизации!
+    // =========================================================================
+
+    // А) Принудительно внедряем колонку должностей (position), которой нет в файле
+    db.User.rawAttributes.position = {
+      type: DataTypes.STRING,
+      allowNull: true,
+      defaultValue: "Пациент",
+    };
+    db.User.refreshAttributes(); // Заставляем Sequelize пересобрать схему модели
+
+    // Б) Снимаем жесткие ограничения ENUM с поля specialty, превращая его в гибкую строку
+    db.User.rawAttributes.specialty = {
+      type: DataTypes.STRING,
+      allowNull: true,
+    };
+    db.User.refreshAttributes(); // Синхронизируем изменения атрибутов
 
-    // Инициализируем и сохраняем в объект
-    db.models.Clinic = db.Clinic = require(path.join(__dirname, '..', 'models', 'clinics'))(instance, DataTypes);
-    db.models.User = db.User = require(path.join(__dirname, '..', 'models', 'users'))(instance, DataTypes);
-    db.models.UserAddress = db.UserAddress = require(path.join(__dirname, '..', 'models', 'user-addresses'))(instance, DataTypes);
-    db.models.Disease = db.Disease = require(path.join(__dirname, '..', 'models', 'diseases'))(instance, DataTypes);
-    db.models.Appointment = db.Appointment = require(path.join(__dirname, '..', 'models', 'appointments'))(instance, DataTypes);
+    // =========================================================================
 
-    // Запускаем связи
+    // 2. Безопасно запускаем связи (Associations) между всеми таблицами
     Object.keys(db.models).forEach((modelName) => {
       if (db.models[modelName].associate) {
         db.models[modelName].associate(db.models);
       }
     });
 
+    // 3. Синхронизируем базу данных с учётом динамически добавленных полей
     await instance.sync({ alter: true });
-    console.log(logger.DatabaseMedInfo("Все таблицы базы данных успешно синхронизированы."));
+    console.log(
+      logger.DatabaseMedInfo(
+        "Все таблицы базы данных успешно синхронизированы.",
+      ),
+    );
   } catch (error) {
-    console.log(logger.DatabaseMedError('Ошибка инициализации базы данных:', error));
+    console.log(
+      logger.DatabaseMedError("Ошибка инициализации базы данных:", error),
+    );
     throw error;
   }
 }

package/database/models/appointments.js

@@ -1,28 +1,43 @@
 module.exports = (sequelize, DataTypes) => {
-  const Appointment = sequelize.define('Appointment', {
-    id: {
-      type: DataTypes.UUID,
-      defaultValue: DataTypes.UUIDV4,
-      primaryKey: true
+  const Appointment = sequelize.define(
+    "Appointment",
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+      date: { type: DataTypes.DATEONLY, allowNull: false },
+      time: { type: DataTypes.STRING, allowNull: false },
+      status: {
+        type: DataTypes.ENUM("ожидается", "завершен", "отменен"),
+        defaultValue: "ожидается",
+        allowNull: false,
+      },
+      complaints: { type: DataTypes.TEXT, allowNull: true },
+      objectively: { type: DataTypes.TEXT, allowNull: true },
+      doctorNotes: { type: DataTypes.TEXT, allowNull: true },
     },
-    date: { type: DataTypes.DATEONLY, allowNull: false },
-    time: { type: DataTypes.STRING, allowNull: false },
-    status: {
-      type: DataTypes.ENUM('ожидается', 'завершен', 'отменен'),
-      defaultValue: 'ожидается',
-      allowNull: false
+    {
+      timestamps: true,
     },
-    complaints: { type: DataTypes.TEXT, allowNull: true },
-    objectively: { type: DataTypes.TEXT, allowNull: true },
-    doctorNotes: { type: DataTypes.TEXT, allowNull: true }
-  }, {
-    timestamps: true
-  });
+  );
 
   Appointment.associate = (models) => {
-    Appointment.belongsTo(models.User, { as: 'Patient', foreignKey: 'PatientId', onDelete: 'CASCADE' });
-    Appointment.belongsTo(models.User, { as: 'Doctor', foreignKey: 'DoctorId', onDelete: 'CASCADE' });
-    Appointment.belongsTo(models.Disease, { foreignKey: 'DiseaseId', onDelete: 'SET NULL' });
+    Appointment.belongsTo(models.User, {
+      as: "Patient",
+      foreignKey: "PatientId",
+      onDelete: "CASCADE",
+    });
+    Appointment.belongsTo(models.User, {
+      as: "Doctor",
+      foreignKey: "DoctorId",
+      onDelete: "CASCADE",
+    });
+    Appointment.belongsTo(models.Disease, {
+      foreignKey: "DiseaseId",
+      onDelete: "SET NULL",
+    });
   };
 
   return Appointment;

package/database/models/clinics.js

@@ -1,21 +1,33 @@
 module.exports = (sequelize, DataTypes) => {
-  const Clinic = sequelize.define('Clinic', {
-    id: {
-      type: DataTypes.INTEGER,
-      autoIncrement: true,
-      primaryKey: true
+  const Clinic = sequelize.define(
+    "Clinic",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        autoIncrement: true,
+        primaryKey: true,
+      },
+      name: { type: DataTypes.STRING, allowNull: false, unique: true },
+      type: {
+        type: DataTypes.ENUM(
+          "больница",
+          "поликлиника",
+          "станция скорой помощи",
+          "частный медицинский центр",
+        ),
+        allowNull: false,
+      },
+      address: { type: DataTypes.STRING, allowNull: false },
+      phone: { type: DataTypes.STRING, allowNull: true },
     },
-    name: { type: DataTypes.STRING, allowNull: false, unique: true },
-    type: { type: DataTypes.ENUM('больница', 'поликлиника', 'станция скорой помощи', 'частный медицинский центр'), allowNull: false },
-    address: { type: DataTypes.STRING, allowNull: false },
-    phone: { type: DataTypes.STRING, allowNull: true }
-  }, { 
-    timestamps: true 
-  });
+    {
+      timestamps: true,
+    },
+  );
 
   // Настройка связи прямо в таблице клиник
   Clinic.associate = (models) => {
-    Clinic.hasMany(models.User, { foreignKey: 'ClinicId' });
+    Clinic.hasMany(models.User, { foreignKey: "ClinicId" });
   };
 
   return Clinic;

package/database/models/diseases.js

@@ -1,18 +1,26 @@
 module.exports = (sequelize, DataTypes) => {
-  const Disease = sequelize.define('Disease', {
-    id: {
-      type: DataTypes.INTEGER,
-      autoIncrement: true,
-      primaryKey: true
+  const Disease = sequelize.define(
+    "Disease",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        autoIncrement: true,
+        primaryKey: true,
+      },
+      name: { type: DataTypes.STRING, allowNull: false, unique: true },
+      code: { type: DataTypes.STRING, allowNull: false, unique: true },
+      treatmentRecommendations: { type: DataTypes.TEXT, allowNull: true },
+      recommendedMedications: { type: DataTypes.TEXT, allowNull: true },
+      casesCount: {
+        type: DataTypes.INTEGER,
+        defaultValue: 0,
+        allowNull: false,
+      },
     },
-    name: { type: DataTypes.STRING, allowNull: false, unique: true },
-    code: { type: DataTypes.STRING, allowNull: false, unique: true },
-    treatmentRecommendations: { type: DataTypes.TEXT, allowNull: true },
-    recommendedMedications: { type: DataTypes.TEXT, allowNull: true },
-    casesCount: { type: DataTypes.INTEGER, defaultValue: 0, allowNull: false }
-  }, {
-    timestamps: true
-  });
+    {
+      timestamps: true,
+    },
+  );
 
   // У этой модели нет прямых исходящих связей (зависит от Appointment, но связь прописана там)
   return Disease;

package/database/models/districts.js

@@ -0,0 +1,55 @@
+module.exports = (sequelize, DataTypes) => {
+  const District = sequelize.define(
+    "District",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        autoIncrement: true,
+        primaryKey: true,
+      },
+      name: {
+        type: DataTypes.STRING, // Например: "Терапевтический участок №3"
+        allowNull: false,
+      },
+      city: {
+        type: DataTypes.STRING, // Например: "Минск"
+        allowNull: false,
+      },
+      street: {
+        type: DataTypes.STRING, // Например: "Машерова"
+        allowNull: false,
+        set(value) {
+          this.setDataValue("street", value.toLowerCase().trim());
+        },
+      },
+      // Диапазон обслуживаемых домов (например: "1-20" или "все")
+      houses: {
+        type: DataTypes.STRING,
+        allowNull: false,
+        defaultValue: "все",
+      },
+      cabinet: {
+        type: DataTypes.STRING, // Например: "Кабинет №302"
+        allowNull: false,
+      },
+      doctorName: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        defaultValue: "Врач не назначен",
+      },
+    },
+    {
+      timestamps: true,
+    },
+  );
+
+  District.associate = (models) => {
+    // ЖЕСТКАЯ ПРИВЯЗКА: Участок и его кабинет принадлежат конкретному учреждению
+    District.belongsTo(models.Clinic, {
+      foreignKey: "ClinicId",
+      onDelete: "CASCADE",
+    });
+  };
+
+  return District;
+};

package/database/models/news.js

@@ -0,0 +1,25 @@
+module.exports = (sequelize, DataTypes) => {
+  const News = sequelize.define(
+    "News",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        autoIncrement: true,
+        primaryKey: true,
+      },
+      title: {
+        type: DataTypes.STRING,
+        allowNull: false,
+      },
+      content: {
+        type: DataTypes.TEXT,
+        allowNull: false,
+      },
+    },
+    {
+      timestamps: true,
+    },
+  );
+
+  return News;
+};

package/database/models/user-addresses.js

@@ -1,21 +1,28 @@
 module.exports = (sequelize, DataTypes) => {
-  const UserAddress = sequelize.define('UserAddress', {
-    id: {
-      type: DataTypes.UUID,
-      defaultValue: DataTypes.UUIDV4,
-      primaryKey: true
+  const UserAddress = sequelize.define(
+    "UserAddress",
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+      city: { type: DataTypes.STRING, allowNull: false },
+      street: { type: DataTypes.STRING, allowNull: false },
+      houseNumber: { type: DataTypes.STRING, allowNull: false },
+      assignedDistrict: { type: DataTypes.STRING, allowNull: true },
+      assignedCabinet: { type: DataTypes.STRING, allowNull: true },
     },
-    city: { type: DataTypes.STRING, allowNull: false },
-    street: { type: DataTypes.STRING, allowNull: false },
-    houseNumber: { type: DataTypes.STRING, allowNull: false },
-    assignedDistrict: { type: DataTypes.STRING, allowNull: true },
-    assignedCabinet: { type: DataTypes.STRING, allowNull: true }
-  }, {
-    timestamps: true
-  });
+    {
+      timestamps: true,
+    },
+  );
 
   UserAddress.associate = (models) => {
-    UserAddress.belongsTo(models.User, { foreignKey: 'UserId', onDelete: 'CASCADE' });
+    UserAddress.belongsTo(models.User, {
+      foreignKey: "UserId",
+      onDelete: "CASCADE",
+    });
   };
 
   return UserAddress;