med-cms 1.0.0-beta.2 → 1.0.0

package/README

@@ -1,161 +0,0 @@
-# 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/test.js

@@ -1,27 +0,0 @@
-const express = require('express');
-const path = require('path');
-const initMedCms = require('./index.js'); // Импортируем наш модуль через главную точку входа
-const chalk = require("chalk-palette");
-const app = express();
-const PORT = process.env.PORT || 3000;
-
-(async()=>{
-    await initMedCms(app);
-    app.use((req, res) => {
-        res.status(404).send('<h1>404 | Медицинский модуль: Страница не найдена</h1>');
-    });
-    app.listen(PORT, () => {
-        console.log('\n==================================================');
-        console.log(`🚀 ТЕСТОВЫЙ СЕРВЕР MED-CMS УСПЕШНО ЗАПУЩЕН!`);
-        console.log(chalk.url(`🔗 Откройте в браузере: http://localhost:${PORT}`));
-        console.log('==================================================\n');
-        console.log('📝 ИНСТРУКЦИЯ ДЛЯ ТЕСТИРОВАНИЯ:');
-        console.log('1. Перейдите по ссылке, откроется страница входа.');
-        console.log('2. Нажмите "Зарегистрироваться как пациент" и создайте тестовый аккаунт.');
-        console.log('3. Проверьте в консоли разработчика (F12 -> Application -> Cookies), что кука med_auth_token установилась.');
-        console.log('4. Чтобы зайти под Админом или Врачом, вы можете использовать созданный файл test-database.sqlite.\n');
-    });
-})()
-
-
-