med-cms 0.0.1 → 1.0.0-beta.2

package/README

@@ -0,0 +1,161 @@
+# MED-CMS (v1.0.0-beta.1) 🚀
+
+`med-cms` — это автономный, монолитный медицинский движок (МИС/SaaS) «всё в одном» на базе **Express**, **Sequelize** и **SQLite3**, разработанный для управления сетями клиник, медицинским персоналом, расписанием приемов и электронными картами пациентов. 
+
+Модуль поставляется со встроенной базой данных, системой разграничения прав доступа на основе **34 медицинских специальностей** и готовым веб-интерфейсом (АРМ Врача, Личный Кабинет Пациента, Панель Суперадминистратора).
+
+---
+
+## 🌟 Ключевые возможности
+
+* **📦 Автономность «из коробки»:** База данных SQLite3 не требует установки тяжелых серверов (PostgreSQL/MySQL/MongoDB). Файл БД и таблицы создаются автоматически прямо в папке проекта.
+* **🔐 Безопасность и Сессии:** Авторизация реализована через зашифрованные JWT-токены, хранящиеся в защищенных **HttpOnly Cookie** (жесткая защита от XSS и CSRF атак). JS на клиенте не имеет доступа к токену.
+* **🩺 Матрица прав доступа (34 специальности):** Гибкое разграничение возможностей врачей (Терапевт, Хирург, Кардиохирург, Патологоанатом и др.) через кастомные Middleware. Стоматолог или Эндокринолог не смогут получить доступ к эндпоинтам назначения нейрохирургических операций.
+* **📍 Автоматический расчет участков:** При регистрации или изменении адреса проживания пациента система сама вычисляет номер его терапевтического участка и закрепленный кабинет врача.
+* **📊 Статистика болезней и МКБ-10:** Выделенный независимый справочник заболеваний в базе данных с возможностью автономной миграции и автоматическим инкрементом счетчиков заболеваемости при закрытии приемов врачами.
+
+---
+
+## 📂 Структура проекта
+
+Архитектура построена по принципу **Clean Architecture (Чистая архитектура)** с полной изоляцией слоев бэкенда и раздачей статики:
+
+```text
+med-cms/
+├── package.json              # Зависимости движка (express, sequelize, sqlite3, bcryptjs)
+├── index.js                  # Главная точка входа (Инициализация и контроль гонки процессов)
+├── index.d.ts                # TypeScript декларации для автокомплита 34 специальностей
+├── test.js                   # Скрипт локального запуска тестового сервера
+├── migrate-diseases.js       # Скрипт независимой миграции справочника МКБ-10 в SQLite
+│
+├── database/
+│   ├── config/
+│   │   └── db-init.js        # Инициализация и синхронизация таблиц/связей Sequelize
+│   ├── models/
+│   │   ├── users.js          # Таблица пользователей (Числовые автоинкрементные ID)
+│   │   ├── clinics.js        # Таблица медицинских учреждений (Больницы, Поликлиники)
+│   │   ├── user-addresses.js # Адреса пациентов с авторасчетом участков и кабинетов
+│   │   ├── diseases.js       # Изолированная таблица болезней и статистики
+│   │   └── appointments.js   # Журнал приемов (осмотры, жалобы, статусы)
+│   └── services/             # Атомарная бизнес-логика (Разделена по ролям)
+│       ├── admin/            # (create-clinic.js, manage-staff.js, db-analytics.js)
+│       ├── doctor/           # (get-schedule.js, patient-access.js, conduct-exam.js)
+│       └── patient/          # (get-profile.js, calc-district.js, book-appointment.js)
+│
+├── server/
+│   ├── server.js             # Раздельные маршрутизаторы Express (web-страницы и api)
+│   ├── midleware.js          # Валидация HttpOnly кук сессий и проверка матрицы разрешений
+│   └── permissions.js        # Карта соответствия медицинских специальностей и прав
+│
+└── public/                   # Статические файлы фронтенда (HTML, CSS, JS)
+    ├── css/                  # (auth.css, admin.css, doctor.css)
+    ├── js/                   # (auth.js, admin.js, doctor.js, patient.js)
+    └── html/                 # (login.html, dashboard-admin.html, dashboard-doctor.html, ...)
+```
+
+---
+
+## 🛠️ Установка и быстрая настройка
+
+### 1. Установка модуля
+Установите пакет в ваше Node.js приложение:
+```bash
+npm install med-cms@1.0.0-beta.1
+```
+
+> **Важно для пользователей 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();
+const PORT = process.env.PORT || 3000;
+
+// Импортируем инициализатор нашего npm-модуля
+const initMedCms = require('med-cms');
+
+async function startServer() {
+  // Запускаем медицинский движок med-cms (он сам настроит БД, роуты и статику)
+  await initMedCms(app);
+
+  app.listen(PORT, () => {
+    console.log(`🚀 Основной сервер успешно запущен на http://localhost:${PORT}`);
+  });
+}
+
+startServer();
+```
+
+---
+
+## 📊 Миграция расширенного справочника болезней (РБ)
+
+Справочник заболеваний полностью изолирован от кода ядра 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/med-login` | Публичный |
+| API Аутентификации (Вход) | `POST` | `/med/api/auth/login` | Публичный |
+| API Завершения сессии (Выход) | `POST` | `/med/api/auth/logout` | Публичный |
+| Личный кабинет Пациента | `GET` | `/med/med-patient` | `patient` |
+| Выгрузка полной медицинской карты | `GET` | `/med/api/patient/me` | `patient` |
+| Бронирование талона к врачу | `POST` | `/med/api/patient/book` | `patient` |
+| АРМ (Рабочее место) Врача | `GET` | `/med/med-doctor` | `doctor` |
+| Загрузка справочника МКБ-10 | `GET` | `/med/api/doctor/diseases-list` | `doctor`, `admin` |
+| Закрытие приема и фиксация осмотра | `POST` | `/med/api/doctor/complete-examination` | `doctor` |
+| Панель Суперадминистратора | `GET` | `/med/med-admin` | `admin` |
+| Создание новой больницы/поликлиники | `POST` | `/med/api/admin/clinics` | `admin` |
+| Регистрация врача (выдача аккаунта) | `POST` | `/med/api/admin/staff` | `admin` |
+| Мониторинг таблиц и аналитика БД | `GET` | `/med/api/admin/stats` | `admin` |
+
+---
+
+## 🛡️ Инструкция к проведению Гипертеста (Тестирование)
+
+В модуле подготовлен файл `test.js` для развертывания локальной среды. При самом первом запуске и создании чистой базы данных `db/med-cms.sqlite` скрипт автоматически генерирует мастер-аккаунт **Суперадминистратора** системы:
+
+* **Логин (Email):** `admin@medcms.ru`
+* **Пароль:** `SuperAdminPassword2026`
+* **Физический ID в базе:** `1`
+
+### Алгоритм проведения сквозного теста:
+1. Выполните миграцию справочника МКБ-10: `node migrate-diseases.js`.
+2. Запустите тестовую среду: `node test.js`.
+3. Откройте браузер на `http://localhost:3000/med/med-login` и войдите под аккаунтом админа.
+4. В левой форме добавьте поликлинику. Она запишется в SQLite под числовым `ID: 1`.
+5. Кликните на карточку «Всего клиник», чтобы развернуть интерактивную таблицу и проверить числовой ID.
+6. В правой форме зарегистрируйте аккаунт врача, выбрав созданную поликлинику №1 из выпадающего списка.
+7. Выйдите из админки, нажмите «Зарегистрироваться как пациент» и создайте профиль.
+8. В кабинете пациента выберите созданного врача, дату, время и нажмите **«Забронировать талон»**. Талон мгновенно отобразится в блоке предстоящих приемов.
+9. Авторизуйтесь под созданным врачом. Пациент появится в вашей очереди. Нажмите «Принять», заполните жалобы, выберите из подгрузившегося справочника диагноз *«Острый бронхит»* и закройте прием. Системные счетчики зафиксируют визит, а статистика болезни обновится в SQLite!
+
+---
+
+## 📄 Лицензия
+
+Проект распространяется на условиях открытой лицензии **MIT**. Разработано для создания масштабируемых и отказоустойчивых медицинских информационных систем. 🇧🇾

package/database/config/db-init.js

@@ -0,0 +1,90 @@
+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');
+    sequelize = new Sequelize({
+      dialect: 'sqlite',
+      storage: storagePath,
+      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: {} 
+};
+
+// Перепишем функцию initDatabase, чтобы она сохраняла модели в db.models и самом объекте db
+async function initDatabase(dbPath) {
+  const instance = getSequelizeInstance(dbPath);
+  
+  try {
+    await instance.authenticate();
+    console.log(logger.DatabaseMedInfo("Успешное подключение к SQLite через Sequelize."));
+
+    // Инициализируем и сохраняем в объект
+    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);
+
+    // Запускаем связи
+    Object.keys(db.models).forEach((modelName) => {
+      if (db.models[modelName].associate) {
+        db.models[modelName].associate(db.models);
+      }
+    });
+
+    await instance.sync({ alter: true });
+    console.log(logger.DatabaseMedInfo("Все таблицы базы данных успешно синхронизированы."));
+  } catch (error) {
+    console.log(logger.DatabaseMedError('Ошибка инициализации базы данных:', error));
+    throw error;
+  }
+}
+
+module.exports = db;

package/database/models/appointments.js

@@ -0,0 +1,29 @@
+module.exports = (sequelize, DataTypes) => {
+  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 }
+  }, {
+    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' });
+  };
+
+  return Appointment;
+};

package/database/models/clinics.js

@@ -0,0 +1,22 @@
+module.exports = (sequelize, DataTypes) => {
+  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 }
+  }, { 
+    timestamps: true 
+  });
+
+  // Настройка связи прямо в таблице клиник
+  Clinic.associate = (models) => {
+    Clinic.hasMany(models.User, { foreignKey: 'ClinicId' });
+  };
+
+  return Clinic;
+};

package/database/models/diseases.js

@@ -0,0 +1,19 @@
+module.exports = (sequelize, DataTypes) => {
+  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 }
+  }, {
+    timestamps: true
+  });
+
+  // У этой модели нет прямых исходящих связей (зависит от Appointment, но связь прописана там)
+  return Disease;
+};

package/database/models/user-addresses.js

@@ -0,0 +1,22 @@
+module.exports = (sequelize, DataTypes) => {
+  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 }
+  }, {
+    timestamps: true
+  });
+
+  UserAddress.associate = (models) => {
+    UserAddress.belongsTo(models.User, { foreignKey: 'UserId', onDelete: 'CASCADE' });
+  };
+
+  return UserAddress;
+};

package/database/models/users.js

@@ -0,0 +1,36 @@
+module.exports = (sequelize, DataTypes) => {
+  const User = sequelize.define('User', {
+    id: {
+      type: DataTypes.INTEGER,
+      autoIncrement: true,
+      primaryKey: true
+    },
+    email: { type: DataTypes.STRING, allowNull: false, unique: true, validate: { isEmail: true } },
+    password: { type: DataTypes.STRING, allowNull: false },
+    fullName: { type: DataTypes.STRING, allowNull: false },
+    role: { type: DataTypes.ENUM('patient', 'doctor', 'admin'), defaultValue: 'patient', allowNull: false },
+    specialty: {
+      type: DataTypes.ENUM(
+        'Терапевт', 'Педиатр', 'Врач общей практики', 'Кардиолог', 'Невролог', 
+        'Эндокринолог', 'Гастроэнтеролог', 'Пульмонолог', 'Нефролог', 'Ревматолог', 
+        'Гематолог', 'Хирург', 'Травматолог-ортопед', 'Сосудистый хирург', 'Нейрохирург', 
+        'Кардиохирург', 'Пластический хирург', 'Офтальмолог', 'Отоларинголог', 'Дерматолог', 
+        'Стоматолог', 'Гинеколог', 'Уролог', 'Онколог', 'Инфекционист', 'Аллерголог-иммунолог', 
+        'Психиатр', 'Психотерапевт', 'Нарколог', 'Анестезиолог-реаниматолог', 'Рентгенолог', 
+        'Врач УЗД', 'Эндоскопист', 'Патологоанатом'
+      ),
+      allowNull: true 
+    },
+    isTemporaryPassword: { type: DataTypes.BOOLEAN, defaultValue: false }
+  }, { 
+    timestamps: true 
+  });
+
+  // Настройка связей пользователя
+  User.associate = (models) => {
+    User.belongsTo(models.Clinic, { foreignKey: 'ClinicId', onDelete: 'SET NULL' });
+    User.hasOne(models.UserAddress, { foreignKey: 'UserId' });
+  };
+
+  return User;
+};

package/database/services/admin/create-clinic.js

@@ -0,0 +1,19 @@
+const path = require("path");
+const Clinic = require(path.join(__dirname, '..', '..', 'models', 'clinics'));
+const createClinic = {
+  async create(clinicData) {
+    const { name, type, address, phone } = clinicData;
+    if (!name || !type || !address) {
+      throw new Error('Поля name, type и address обязательны для заполнения');
+    }
+    const candidate = await Clinic.findOne({ where: { name } });
+    if (candidate) {
+      throw new Error('Медицинское учреждение с таким названием уже зарегистрировано');
+    }
+    return await Clinic.create({ name, type, address, phone });
+  },
+  async getAll() {
+    return await Clinic.findAll({ order: [['name', 'ASC']] });
+  }
+};
+module.exports = createClinic;

package/database/services/admin/db-analytics.js

@@ -0,0 +1,34 @@
+const path = require("path")
+const User = require(path.join(__dirname, '..', '..', 'models', 'users'));
+const Clinic = require(path.join(__dirname, '..', '..', 'models', 'clinics'));
+const Disease = require(path.join(__dirname, '..', '..', 'models', 'diseases'));
+const Appointment = require(path.join(__dirname, '..', '..', 'models', 'appointments'));
+const dbAnalytics = {
+  async getStats() {
+    const totalClinics = await Clinic.count();
+    const totalPatients = await User.count({ where: { role: 'patient' } });
+    const totalStaff = await User.count({ where: { role: 'doctor' } });
+    const totalAppointments = await Appointment.count();
+    const topDiseases = await Disease.findAll({
+      limit: 5,
+      order: [['casesCount', 'DESC']],
+      attributes: ['name', 'code', 'casesCount']
+    });
+    const staffBySpecialty = await User.findAll({
+      where: { role: 'doctor' },
+      attributes: ['specialty', [User.sequelize.fn('COUNT', User.sequelize.col('id')), 'count']],
+      group: ['specialty']
+    });
+    return {
+      summary: {
+        totalClinics,
+        totalPatients,
+        totalStaff,
+        totalAppointments
+      },
+      topDiseases,
+      staffBySpecialty
+    };
+  }
+};
+module.exports = dbAnalytics;

package/database/services/admin/index.js

@@ -0,0 +1,12 @@
+const path = require("path")
+const createClinic = require(path.join(__dirname, 'create-clinic'));
+const manageStaff = require(path.join(__dirname, 'manage-staff'));
+const dbAnalytics = require(path.join(__dirname, 'db-analytics'));
+const AdminService = {
+  createClinic: createClinic.create,
+  getAllClinics: createClinic.getAll,
+  createStaffAccount: manageStaff.createAccount,
+  deleteAccount: manageStaff.deleteAccount,
+  getSystemStats: dbAnalytics.getStats
+};
+module.exports = AdminService;

package/database/services/admin/manage-staff.js

@@ -0,0 +1,41 @@
+const path = require("path")
+const User = require(path.join(__dirname, '..', '..', 'models', 'users'));
+const Clinic = require(path.join(__dirname, '..', '..', 'models', 'clinics'));
+const bcrypt = require('bcrypt');
+const manageStaff = {
+    async createAccount(staffData) {
+    const { email, rawPassword, fullName, medicalProfile } = staffData;
+    const ClinicId = staffData.ClinicId || staffData.clinicId;
+    if (!email || !rawPassword || !fullName || !medicalProfile || !ClinicId) {
+      throw new Error('Необходимо заполнить обязательные поля: email, rawPassword, fullName, medicalProfile, clinicId');
+    }
+    const clinicExists = await Clinic.findByPk(ClinicId);
+    if (!clinicExists) {
+      throw new Error(`Медицинское учреждение с ID №${ClinicId} не найдено.`);
+    }
+    const candidate = await User.findOne({ where: { email } });
+    if (candidate) {
+      throw new Error('Сотрудник с таким email уже зарегистрирован');
+    }
+    let finalPosition = 'Врач';
+    let finalSpecialty = medicalProfile;
+    const purePositions = ['Главврач', 'Медсестра', 'Врач скорой помощи', 'Фельдшер', 'Регистратор'];
+    if (purePositions.includes(medicalProfile)) {
+      finalPosition = medicalProfile;
+      finalSpecialty = 'Общий медицинский профиль';
+    }
+    const hashedPassword = await bcrypt.hash(rawPassword, 10);
+    const newStaff = await User.create({
+      email,
+      password: hashedPassword,
+      fullName,
+      role: 'doctor', 
+      position: finalPosition,
+      specialty: finalSpecialty,
+      ClinicId: Number(ClinicId),
+      isTemporaryPassword: true 
+    });
+    return newStaff;
+  }
+};
+module.exports = manageStaff;

package/database/services/doctor/conduct-exam.js

@@ -0,0 +1,33 @@
+const path = require("path")
+const Appointment = require(path.join(__dirname, '..', '..', 'models', 'appointments'));
+const Disease = require(path.join(__dirname, '..', '..', 'models', 'diseases'));
+const conductExam = {
+  async saveResult(examData) {
+    const { appointmentId, complaints, objectively, doctorNotes, diseaseId } = examData;
+    if (!appointmentId) {
+      throw new Error('ID приема обязателен для сохранения результатов');
+    }
+    const appointment = await Appointment.findByPk(appointmentId);
+    if (!appointment) {
+      throw new Error('Указанный прием не найден');
+    }
+    if (appointment.status === 'завершен') {
+      throw new Error('Этот прием уже был успешно завершен ранее');
+    }
+    appointment.complaints = complaints;
+    appointment.objectively = objectively;
+    appointment.doctorNotes = doctorNotes;
+    appointment.status = 'завершен';
+    if (diseaseId) {
+      const disease = await Disease.findByPk(diseaseId);
+      if (!disease) {
+        throw new Error('Указанная болезнь не найдена в справочнике диагнозов');
+      }
+      appointment.DiseaseId = diseaseId;
+      await disease.increment('casesCount', { by: 1 });
+    }
+    await appointment.save();
+    return appointment;
+  }
+};
+module.exports = conductExam;

package/database/services/doctor/get-schedule.js

@@ -0,0 +1,23 @@
+const path = require("path")
+const Appointment = require(path.join(__dirname, '..', '..', 'models', 'appointments'));
+const User = require(path.join(__dirname, '..', '..', 'models', 'users'));
+const getSchedule = {
+  async byDoctorId(doctorId) {
+    if (!doctorId) {
+      throw new Error('ID врача не указан');
+    }
+    return await Appointment.findAll({
+      where: { 
+        DoctorId: doctorId, 
+        status: 'ожидается' 
+      },
+      include: [{ 
+        model: User, 
+        as: 'Patient', 
+        attributes: ['id', 'fullName', 'email'] 
+      }],
+      order: [['date', 'ASC'], ['time', 'ASC']]
+    });
+  }
+};
+module.exports = getSchedule;

package/database/services/doctor/index.js

@@ -0,0 +1,10 @@
+const path = require("path")
+const getSchedule = require(path.join(__dirname, 'get-schedule'));
+const patientAccess = require(path.join(__dirname, 'patient-access'));
+const conductExam = require(path.join(__dirname, 'conduct-exam'));
+const DoctorService = {
+  getMySchedule: getSchedule.byDoctorId,
+  getPatientHistory: patientAccess.getHistory,
+  saveExamination: conductExam.saveResult
+};
+module.exports = DoctorService;

package/database/services/doctor/patient-access.js

@@ -0,0 +1,34 @@
+const path = require("path");
+const User = require(path.join(__dirname, '..', '..', 'models', 'users'));
+const Appointment = require(path.join(__dirname, '..', '..', 'models', 'appointments'));
+const Disease = require(path.join(__dirname, '..', '..', 'models', 'diseases'));
+const UserAddress = require(path.join(__dirname, '..', '..', 'models', 'user-addresses'));
+const patientAccess = {
+  async getHistory(patientId) {
+    if (!patientId) {
+      throw new Error('ID пациента не указан');
+    }
+    const patient = await User.findByPk(patientId, {
+      attributes: ['id', 'fullName', 'email'],
+      include: [
+        { 
+          model: UserAddress,
+          attributes: ['city', 'street', 'houseNumber', 'assignedDistrict', 'assignedCabinet']
+        },
+        { 
+          model: Appointment, 
+          as: 'PatientAppointments',
+          where: { status: 'завершен' },
+          include: [{ model: Disease, attributes: ['name', 'code'] }],
+          required: false
+        }
+      ],
+      order: [[{ model: Appointment, as: 'PatientAppointments' }, 'date', 'DESC']]
+    });
+    if (!patient) {
+      throw new Error('Пациент не найден в базе данных');
+    }
+    return patient;
+  }
+};
+module.exports = patientAccess;

package/database/services/patient/book-appointment.js

@@ -0,0 +1,45 @@
+const path = require("path")
+const Appointment = require(path.join(__dirname, '..', '..', 'models', 'appointments'));
+const User = require(path.join(__dirname, '..', '..', 'models', 'users'));
+const bookAppointment = {
+  async create(patientId, appointmentData) {
+    const { doctorId, date, time } = appointmentData;
+    if (!doctorId || !date || !time) {
+      throw new Error('Необходимо выбрать врача, дату и время приема');
+    }
+    const doctor = await User.findOne({ where: { id: doctorId, role: 'doctor' } });
+    if (!doctor) {
+      throw new Error('Указанный врач не найден в системе или не имеет прав на прием');
+    }
+    const isSlotBusy = await Appointment.findOne({
+      where: {
+        DoctorId: doctorId,
+        date: date,
+        time: time,
+        status: 'ожидается'
+      }
+    });
+    if (isSlotBusy) {
+      throw new Error(`Время ${time} на дату ${date} к врачу ${doctor.fullName} уже занято. Выберите другой слот.`);
+    }
+    const isPatientDoubleBooked = await Appointment.findOne({
+      where: {
+        PatientId: patientId,
+        DoctorId: doctorId,
+        date: date,
+        status: 'ожидается'
+      }
+    });
+    if (isPatientDoubleBooked) {
+      throw new Error(`Вы уже записаны к врачу ${doctor.fullName} на дату ${date}. Нельзя бронировать несколько талонов на один день.`);
+    }
+    return await Appointment.create({
+      date,
+      time,
+      status: 'ожидается',
+      PatientId: patientId,
+      DoctorId: doctorId
+    });
+  }
+};
+module.exports = bookAppointment;