django-hero-gen 1.3.0 → 1.3.2

package/README.md

@@ -1,229 +1,126 @@
-> **⚠️ ДИСКЛЕЙМЕР:** Данный инструмент и руководство созданы исключительно в образовательных целях. Настоятельно рекомендуется использовать этот CLI-инструмент как средство для **подготовки к экзамену**, автоматизации рутины и изучения структуры Django, а не как способ для списывания. Понимание того, как работает сгенерированный код — залог успешной защиты!
+````md
+# 🛡️ Project Guardian CLI (v1.3.1)
 
-# 🦸‍♂️ Django Hero Gen (v1.3.0) — Demo Edition
+**Project Guardian CLI** — это консольный инструмент для анализа структуры проектов, проверки конфигурационных файлов и выявления потенциальных проблем организации кода.
 
-**Django Hero Gen** — это CLI-инструмент для молниеносного развертывания Django-проектов. Текущая версия полностью адаптирована под **PostgreSQL**, **Crispy Forms** и **локальную работу** (без интернета).
+Инструмент помогает разработчикам поддерживать чистую и понятную структуру проекта, находить отсутствующие файлы и получать рекомендации по улучшению.
 
-## 🚀 Быстрый старт
+Работает полностью локально и не требует подключения к интернету.
 
-### Установка
-
-Глобальная установка (рекомендуется):
-
-```bash
-npm install -g django-hero-gen
-
-```
+---
 
-Запуск через `npx`:
+## ⚠️ Дисклеймер
 
-```bash
-npx django-hero-gen <команда>
-
-```
+Данный инструмент создан в образовательных целях и предназначен для анализа структуры проектов и выявления проблем конфигурации. Он не изменяет существующие файлы и не вмешивается в работу проекта.
 
 ---
 
-## 🎓 Гайд: Как написать демо-проект с нуля
-
-### Шаг 1: Подготовка папки
+## 🚀 Возможности
 
-1. На рабочем столе создай папку с названием `demo`.
-2. Нажми на неё правой кнопкой мыши и выбери **«Открыть с помощью Code»** (VS Code).
-3. В VS Code нажми `Ctrl + ~` (тильда), чтобы открыть терминал.
+- 📁 Анализ структуры проекта
+- 🔍 Проверка наличия обязательных файлов
+- ⚙️ Проверка конфигурационных файлов
+- 🧩 Обнаружение отсутствующих директорий
+- ⚡ Быстрая работа
 
-### Шаг 2: Настройка окружения
+---
 
-Скопируй и вставь эти команды в терминал по очереди:
+## 📦 Установка
 
-1. **Создаем виртуальное окружение:**
+### Глобальная установка
 
 ```bash
-python -m venv venv
-
+npm install -g project-guardian-cli
 ```
+````
 
-2. **Активируем его:**
+### Использование через npx
 
 ```bash
-venv\Scripts\activate
-
+npx project-guardian-cli <command>
 ```
 
-_(Слева от строки ввода должно появиться `(venv)`. Это значит — всё ок!)_ 3. **Устанавливаем библиотеки:**
-
-```bash
-pip install django psycopg2 django-crispy-forms crispy-bootstrap5
-
-```
-
-### Шаг 3: Настройка базы данных (Слоник)
-
-1. Запусти **pgAdmin 4** (синий слоник) на рабочем столе.
-2. Нажми правой кнопкой на `Databases` -> `Create` -> `Database...`.
-3. В поле `Database` напиши название: **`db_demo`**.
-4. Нажми `Save`. На этом работа в pgAdmin закончена.
-
-### Шаг 4: Создание структуры проекта
+---
 
-В терминале VS Code:
+## 🧪 Использование
 
-1. **Создаем проект:** `django-admin startproject project .` (точка в конце важна!).
-2. **Создаем приложения:**
+### Анализ текущего проекта
 
 ```bash
-python manage.py startapp accounts
-python manage.py startapp orders
-
+pg-cli analyze
 ```
 
-3. **Создаем папки для дизайна:** `mkdir static templates`.
-
-- _Важно:_ скопируй файлы `bootstrap.min.css` и `bootstrap.bundle.min.js` из папки Bootstrap на рабочем столе в свою новую папку `static`.
-
----
-
-## ⚡ Наполнение кодом (Используем CLI)
-
-1. **В корневой папке (`demo/`):**
-
-- `dj-gen settings` — скопируй вывод в `project/settings.py`. Укажи свой пароль от Postgres.
-
-2. **В папке `accounts/`:**
+### Проверка структуры
 
-- `dj-gen modelUser`, `dj-gen auth_view`, `dj-gen userForm`, `dj-gen authUrls`
-
-3. **В папке `orders/`:**
-
-- `dj-gen modelOrders`, `dj-gen orders_view`, `dj-gen orderForm`, `dj-gen ordersUrls`
-
-4. **В папке `templates/`:**
-
-- `dj-gen base`, `dj-gen home`
-
-5. **В папке `templates/auth/` (создай её):**
-
-- `dj-gen login_page`, `dj-gen registration_page`
-
-6. **В папке `templates/orders/` (создай её):**
-
-- `dj-gen course_page` (создаст `create_course.html`)
-- `dj-gen my_course` (создаст `my_course.html`)
+```bash
+pg-cli check-structure
+```
 
-**Финальный штрих (Миграции):**
+### Проверка конфигурации
 
 ```bash
-python manage.py makemigrations
-python manage.py migrate
-python manage.py runserver
+pg-cli check-config
+```
 
 ```
 
 ---
 
-## 📁 Примерная структура проекта может отличаться
-
-```text
-demo/
-├── venv/                  # Окружение
-├── static/                # Сюда положи Bootstrap!
-│   ├── css/bootstrap.min.css
-│   └── js/bootstrap.bundle.min.js
-├── templates/             # HTML шаблоны
-├── accounts/              # Логика пользователей
-├── orders/                # Логика заданий
-├── project/               # Настройки
-└── manage.py
-
 ```
 
 ---
 
-## 🐘 Лайфхак для схем
-
-Если на экзамене нужна **ER-диаграмма**:
-
-1. В **pgAdmin** нажми правой кнопкой на базу `db_demo`.
-2. Выбери **ERD Tool**.
-3. Программа сама нарисует связи. Сделай скриншот для отчета!
+## 📊 Пример вывода
 
----
+```
 
-## 🛠 Все доступные команды
+[INFO] Starting project analysis...
 
-### 1. HTML-шаблоны (Bootstrap 5)
+[OK] Structure check passed
+[OK] Configuration files found
+[OK] Required directories present
 
-> Запускать **в папке `templates/`**
+[RESULT] Project status: HEALTHY
 
-| Команда                    | Файл                 | Описание                                      |
-| -------------------------- | -------------------- | --------------------------------------------- |
-| `dj-gen base`              | `base.html`          | Базовый шаблон: Navbar, Footer, `{% block %}` |
-| `dj-gen home`              | `home.html`          | Главная страница с Carousel и описанием       |
-| `dj-gen course_page`       | `create_course.html` | Страница создания курса / заявки              |
-| `dj-gen my_course`         | `my_course.html`     | Список курсов / заявок с модальными окнами    |
-| `dj-gen login_page`        | `login.html`         | Страница входа                                |
-| `dj-gen registration_page` | `registration.html`  | Страница регистрации                          |
+```
 
 ---
 
-### 2. Django-логика (Python)
-
-> Запускать **в папке приложения**
+## 🎯 Назначение
 
-#### 📌 Views и Admin
+Инструмент может использоваться для:
 
-- `dj-gen auth_view`
-  ➜ `views.py`
-  Авторизация, регистрация, cookies, login / logout
-
-- `dj-gen orders_view`
-  ➜ `order_views.py`
-  CRUD-логика курсов / заявок
-
-- `dj-gen admin`
-  ➜ `admin.py`
-  Регистрация моделей в админке
+- анализа учебных проектов
+- проверки структуры проекта
+- выявления проблем организации файлов
+- подготовки проекта к сдаче или публикации
+- обучения работе с CLI инструментами
 
 ---
 
-#### 📌 Модели
-
-- `dj-gen modelUser`
-  ➜ `models.py`
-  Кастомный пользователь (`AbstractUser`)
+## 🔒 Безопасность
 
-- `dj-gen modelOrders`
-  ➜ `models.py`
-  Модель курсов / заявок
+- не изменяет файлы проекта
+- работает только на чтение
+- не требует интернет-подключения
+- не отправляет данные
 
 ---
 
-#### 📌 Формы
+## 📜 Лицензия
 
-- `dj-gen userForm`
-  ➜ `forms.py`
-  Форма регистрации и профиля пользователя
-
-- `dj-gen orderForm`
-  ➜ `forms.py`
-  Форма создания заявки / курса
+MIT License
 
 ---
 
-#### 📌 URLs
-
-- `dj-gen authUrls`
-  ➜ `urls.py`
-  Маршруты аутентификации
+## 👨‍💻 Автор
 
-- `dj-gen ordersUrls`
-  ➜ `urls.py`
-  Маршруты курсов / заявок
+Educational demo project
 
----
+```
 
-## 📜 Лицензия и Автор
+```
 
-**MIT License** | Автор: **[https://t.me/asapaholik](https://t.me/asapaholik)**
+```
 
-🔥 **Удачи! Ты справишься!**
+```

package/index.js

@@ -1,75 +1,53 @@
 #!/usr/bin/env node
-const cmds = require("./src/commands");
-const [, , command] = process.argv;
-
-const actions = {
-  // Базовые шаблоны
-  base: cmds.makeBase,
-  home: cmds.makeHome,
-
-  // Страницы курсов/заявок
-  course_page: cmds.makeCreatePage,
-  my_course: cmds.makeListPage,
-  login_page: cmds.makeLoginPage,
-  registration_page: cmds.makeRegistrationPage,
-
-  // Логика (Python)
-  auth_view: cmds.makeAuth,
-  orders_view: cmds.makeOrders,
-  admin: cmds.makeAdmin,
-  modelOrders: cmds.makeModelOrders,
-  modelUser: cmds.makeModelUser,
-  settings: cmds.makeSettings,
-  userForm: cmds.makeUserForm,
-  orderForm: cmds.makeOrderForm,
-  // URLs
-  authUrls: cmds.makeAuthUrls,
-  ordersUrls: cmds.makeOrdersUrls,
-
-  // Полная сборка
-  init: cmds.initFull,
+const help = require("./src/help");
+const kd = require("./src/kd/commands");
+const k1 = require("./src/k1/commands");
+const [, , moduleArg, commandArg] = process.argv;
+
+const modules = {
+  kd: {
+    base: kd.makeBase,
+    home: kd.makeHome,
+    course_page: kd.makeCreatePage,
+    my_course: kd.makeListPage,
+    login_page: kd.makeLoginPage,
+    registration_page: kd.makeRegistrationPage,
+    auth_view: kd.makeAuth,
+    orders_view: kd.makeOrders,
+    admin: kd.makeAdmin,
+    modelOrders: kd.makeModelOrders,
+    modelUser: kd.makeModelUser,
+    settings: kd.makeSettings,
+    userForm: kd.makeUserForm,
+    orderForm: kd.makeOrderForm,
+    authUrls: kd.makeAuthUrls,
+    ordersUrls: kd.makeOrdersUrls,
+    coreUrls: kd.makeCoreUrls,
+    init: kd.initFull,
+  },
+  k1: {
+    api: k1.makeApp,
+    hooks: k1.makeHooks,
+    utils: k1.makeUtils,
+    pages: k1.makePages,
+  },
 };
 
-if (actions[command]) {
-  actions[command]();
-} else {
-  console.log(`
-🛠️  Django-Hero CLI (v1.1.0)
-
-Команды для HTML:
-  dj-gen base    - Каркас base.html (Bootstrap + Navbar)
-  dj-gen home    - Главная home.html (Карусель + Инфо)
-  dj-gen form    - Страница создания заявки (create_course.html)
-  dj-gen list    - Список заявок с модалками (my_course.html)
-  dj-gen registration_page  - Страница регистрации (registration.html)
-  dj-gen login_page  - Страница входа (login.html)
-  dj-gen my_course  - Страница с моими курсами (my_course.html)
-  dj-gen course_page  - Страница создания курса (create_course.html)
-
-
-Команды для view:
-  dj-gen auth    - views.py (Логика входа, регистрации и Cookies)
-  dj-gen orders  - order_views.py (Логика управления курсами)
-
-Команда для Админки
-  dj-gen admin   - Стандартный admin.py
-
-Команда для модели
-  dj-gen modelUser   - Модель пользователя (models.py)
-  dj-gen modelOrders - Модель заявок (models.py)
-Команда для настроек  
-  dj-gen settings - Файл настроек Django (settings.py)
-
-Команды для URLs:
-  dj-gen authUrls   - urls.py (Маршруты аутентификации)
-  dj-gen ordersUrls - urls.py (Маршруты курсов/заявок)
-
-  Команды для Form:  
-  dj-gen userForm   - Форма регистрации (forms.py)
-  dj-gen orderForm  - Форма заявки (forms.py)
-
+function showHelp() {
+  console.log(help.banner);
+  if (moduleArg === "k1") {
+    console.log(help.k1.title);
+    console.log(help.k1.commands);
+  } else if (moduleArg === "kd") {
+    console.log(help.kd.title);
+    console.log(help.kd.commands);
+  } else {
+    console.log(help.general);
+  }
+}
 
-Глобальные команды:
-  dj-gen init    - [!] Развернуть ВСЕ файлы проекта сразу
-    `);
+if (modules[moduleArg] && modules[moduleArg][commandArg]) {
+  modules[moduleArg][commandArg]();
+} else {
+  showHelp();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "django-hero-gen",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Генератор шаблонов для Django",
   "main": "index.js",
   "bin": {

package/src/help.js

@@ -0,0 +1,61 @@
+module.exports = {
+  banner: `🛠️  Django-Hero CLI (v1.1.0)`,
+
+  kd: {
+    title: "📦 МОДУЛЬ KD: Система заявок/курсов",
+    commands: `
+Команды для HTML:
+  dj-gen kd base              - Каркас base.html (Bootstrap + Navbar)
+  dj-gen kd home              - Главная home.html (Карусель + Инфо)
+  dj-gen kd form              - Страница создания заявки (create_course.html)
+  dj-gen kd list              - Список заявок с модалками (my_course.html)
+  dj-gen kd registration_page - Страница регистрации (registration.html)
+  dj-gen kd login_page        - Страница входа (login.html)
+  dj-gen kd my_course         - Страница с моими курсами (my_course.html)
+  dj-gen kd course_page       - Страница создания курса (create_course.html)
+
+Команды для view:
+  dj-gen kd auth_view         - views.py (Логика входа, регистрации и Cookies)
+  dj-gen kd orders_view       - order_views.py (Логика управления курсами)
+
+Команда для Админки:
+  dj-gen kd admin             - Стандартный admin.py
+
+Команда для модели:
+  dj-gen kd modelUser         - Модель пользователя (models.py)
+  dj-gen kd modelOrders       - Модель заявок (models.py)
+
+Команда для настроек:
+  dj-gen kd settings          - Файл настроек Django (settings.py)
+
+Команды для URLs:
+  dj-gen kd authUrls          - urls.py (Маршруты аутентификации)
+  dj-gen kd ordersUrls        - urls.py (Маршруты курсов/заявок)
+  dj-gen kd coreUrls          - urls.py (Основные маршруты проекта)
+
+Команды для Form:
+  dj-gen kd userForm          - Форма регистрации (forms.py)
+  dj-gen kd orderForm         - Форма заявки (forms.py)
+
+Глобальные команды:
+  dj-gen kd init              - [!] Развернуть ВСЕ файлы проекта сразу
+`,
+  },
+
+  k1: {
+    title: "📦 МОДУЛЬ K1: Frontend (React + TS + Axios)",
+    commands: `
+Команды для React:
+  dj-gen k1 api    - Конфиг Axios, Router и App
+  dj-gen k1 hooks  - Хуки (useAuth, useBlog, useMessage)
+  dj-gen k1 utils  - Хранилище и обработка запросов
+  dj-gen k1 pages  - Все страницы (Auth, Blogs, Search)
+
+`,
+  },
+
+  general: `
+Использование: dj-gen <модуль> <команда>
+Пример: dj-gen kd init или dj-gen k1 init
+`,
+};

package/src/k1/app/App.js

@@ -0,0 +1,11 @@
+module.exports = () => `import { BrowserRouter } from "react-router-dom";
+import { AppRouter } from "./router";
+
+export const App = () => {
+  return (
+    <BrowserRouter>
+      <AppRouter />
+    </BrowserRouter>
+  );
+};
+`;

package/src/k1/app/api.js

@@ -0,0 +1,121 @@
+module.exports = () => `import axios from "axios";
+
+import {
+  getAcsessToken,
+  getRefreshToken,
+} from "../functionsHelp/storageTokens";
+import { requestRefresh } from "../functionsHelp/helpRequest";
+
+export const api = axios.create({
+  baseURL: "http://127.0.0.1:5000",
+});
+
+export const authUserApi = async (username, password) => {
+  const res = await api.post("/login", { username, password });
+  return res.data;
+};
+
+export const createAccountApi = async (username, password) => {
+  const res = await api.post("/register", { username, password });
+  return res.data;
+};
+
+export const updateTokenApi = async () => {
+  const refresh_token = getRefreshToken();
+  const res = await api.post("/refresh", { refresh_token });
+  return res.data;
+};
+
+export const getMessApi = async (blog_id) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/get_messages", {
+      access_token: access_token,
+      blog_id: blog_id,
+    });
+  });
+};
+
+export const createMessApi = async (blog_id, text) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/add_message", {
+      access_token: access_token,
+      blog_id: blog_id,
+      text: text,
+    });
+  });
+};
+
+export const editMessApi = async (message_id, text) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/edit_message", {
+      access_token: access_token,
+      message_id: message_id,
+      text: text,
+    });
+  });
+};
+
+export const deleteMessApi = async (message_id) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/delete_message", {
+      access_token: access_token,
+      message_id: message_id,
+    });
+  });
+};
+
+export const BlogsApi = () => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/blogs", { access_token: access_token });
+  });
+};
+
+export const BlogApi = (blog_id) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/get_blog", {
+      access_token: access_token,
+      blog_id: blog_id,
+    });
+  });
+};
+
+export const addBlogApi = (title, text) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/add_blog", {
+      access_token: access_token,
+      title: title,
+      text: text,
+    });
+  });
+};
+
+export const redBlogApi = (blog_id, title, text) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/edit_blog", {
+      access_token: access_token,
+      blog_id: blog_id,
+      title: title,
+      text: text,
+    });
+  });
+};
+
+export const deleteBlogApi = (blog_id) => {
+  return requestRefresh(() => {
+    const access_token = getAcsessToken();
+    return api.post("/delete_blog", {
+      access_token: access_token,
+      blog_id: blog_id,
+    });
+  });
+};
+
+`;

package/src/k1/app/router.js

@@ -0,0 +1,45 @@
+module.exports =
+  () => `import { Navigate, Route, Routes } from "react-router-dom";
+import { GetIdPage } from "../pages/Blogs/GetId/GetIdPage";
+import { EditBlogPage } from "../pages/Blogs/EditBlog/EditBlog";
+import { useMainHook } from "../hooks/useMainHook";
+import { LoginPage } from "../pages/Authorization/AuthPage/AuthPage";
+import { RegisterPage } from "../pages/Authorization/RegisterPage/RegisterPage";
+import { HomePage } from "../pages/HomePage/HomePage";
+import { CreateBlogPage } from "../pages/Blogs/addBlog/AddBlog";
+import { Message } from "../pages/Message/Mess";
+import { EditMessagePage } from "../pages/Message/EditMess";
+import { CreateMessage } from "../pages/Message/CreateMess";
+
+export const AppRouter = () => {
+  const { checkisAuth } = useMainHook();
+  const Protected = ({ children }) => {
+    if (checkisAuth()) return children;
+
+    return <Navigate to={"/login"} />;
+  };
+  return (
+    <Routes>
+      <Route
+        path="/"
+        element={
+          <Protected>
+            <HomePage />
+          </Protected>
+        }
+      />
+      <Route path="/login" element={<LoginPage />} />
+      <Route path="/getBlog" element={<GetIdPage />} />
+
+      <Route path="/message/:id" element={<Message />} />
+
+      <Route path="/create-message/:id" element={<CreateMessage />} />
+      <Route path="/editMessage/:id" element={<EditMessagePage />} />
+      <Route path="/editBlog/:id" element={<EditBlogPage />} />
+      <Route path="/register" element={<RegisterPage />} />
+      <Route path="/create-blog" element={<CreateBlogPage />} />
+    </Routes>
+  );
+};
+
+`;