django-hero-gen 1.0.1 → 1.1.1

package/README.md

@@ -0,0 +1,119 @@
+# 🦸‍♂️ Django Hero Gen
+
+**Django Hero Gen** — это мощный CLI-инструмент для мгновенного развертывания фронтенда и базовой логики Django-приложений. Больше не нужно вручную копировать Bootstrap-шаблоны, настраивать Navbar или переписывать стандартные View для авторизации. Сделайте это одной командой и сэкономьте часы рутины.
+
+---
+
+## 🚀 Быстрый старт
+
+### Установка
+
+Установите пакет глобально, чтобы команда `dj-gen` была доступна в любом месте:
+
+```bash
+npm install -g django-hero-gen
+
+```
+
+Или используйте без установки через `npx`:
+
+```bash
+npx django-hero-gen <команда>
+
+```
+
+### Полная инициализация проекта
+
+Самый быстрый способ наполнить новое Django-приложение контентом. Создает все необходимые файлы одним махом:
+
+```bash
+dj-gen init
+
+```
+
+> **Что будет создано:** `base.html`, `home.html`, `create_course.html`, `my_course.html`, `views.py`, `order_views.py`, `admin.py`.
+
+---
+
+## 🛠 Доступные команды
+
+### 1. Генерация шаблонов (HTML + Bootstrap 5)
+
+Все шаблоны поддерживают наследование и адаптированы под мобильные устройства.
+
+| Команда       | Файл                 | Описание                                                                                        |
+| ------------- | -------------------- | ----------------------------------------------------------------------------------------------- |
+| `dj-gen base` | `base.html`          | **Фундамент:** Navbar с логикой Auth, Footer, системные уведомления и подключенный Bootstrap 5. |
+| `dj-gen home` | `home.html`          | **Главная:** Слайдер (Carousel) с поддержкой static и информационный блок.                      |
+| `dj-gen form` | `create_course.html` | **Формы:** Готовая разметка для рендеринга Django-форм через Bootstrap.                         |
+| `dj-gen list` | `my_course.html`     | **Личный кабинет:** Список карточек с индикаторами статуса и встроенными модальными окнами.     |
+
+---
+
+### 2. Генерация логики (Python)
+
+Готовые обработчики для типовых задач Django.
+
+- **`dj-gen auth`** — Создает `views.py`. Включает:
+- `registration_view` (с использованием CustomUserCreationForm).
+- `login_view` и `logout_view`.
+- `accept_cookies` (обработка согласия пользователя через Cookies).
+
+- **`dj-gen orders`** — Создает `order_views.py`. Чистый файл для вашей бизнес-логики заказов или курсов.
+- **`dj-gen admin`** — Создает `admin.py`. Базовый импорт и место для регистрации ваших моделей.
+
+---
+
+## 📁 Структура создаваемых файлов
+
+После выполнения команды `dj-gen init` структура вашего приложения примет следующий вид:
+
+```text
+your_app/
+├─ templates/
+│  ├─ base.html          # Базовый скелет сайта
+│  ├─ home.html          # Главная страница (extends base.html)
+│  ├─ create_course.html # Страница создания (extends base.html)
+│  └─ my_course.html     # Список объектов (extends base.html)
+├─ views.py              # Логика пользователей и аутентификации
+├─ order_views.py        # Логика обработки бизнес-задач
+└─ admin.py              # Регистрация моделей в панели управления
+
+```
+
+---
+
+## ⚙️ Важные настройки после генерации
+
+Для корректной работы созданных файлов выполните следующие шаги:
+
+1. **Настройка путей:** Убедитесь, что в `settings.py` в секции `TEMPLATES` указана папка с вашими шаблонами.
+2. **Зависимости:** Установите библиотеку для работы с формами:
+
+```bash
+pip install django-bootstrap5
+
+```
+
+И добавьте `'django_bootstrap5'` в `INSTALLED_APPS`. 3. **Маршрутизация:** Подключите созданные функции в вашем `urls.py`:
+
+```python
+from . import views, order_views
+
+urlpatterns = [
+    path('', views.home_view, name='home'),
+    path('login/', views.login_view, name='login'),
+    # и так далее...
+]
+
+```
+
+---
+
+## 📜 Лицензия
+
+Распространяется под лицензией **MIT**. Свободно для использования в коммерческих и личных проектах.
+
+---
+
+**Удачной разработки!**

package/index.js

@@ -1,58 +1,43 @@
 #!/usr/bin/env node
+const cmds = require("./src/commands");
+const [, , command] = process.argv;
 
-const fs = require("fs");
-const path = require("path");
+const actions = {
+  // Базовые шаблоны
+  base: cmds.makeBase,
+  home: cmds.makeHome,
 
-const [, , command, name] = process.argv;
+  // Страницы курсов/заявок
+  form: cmds.makeCreatePage, // создание (бывш. create)
+  list: cmds.makeListPage, // список (бывш. list)
 
-if (command === "admin") {
-  const filePath = path.join(process.cwd(), "admin.py");
-  const template = `from django.contrib import admin\n\n# Register your models here.`;
-  fs.writeFileSync(filePath, template);
-  console.log(`✅ Файл admin.py успешно создан!`);
-  process.exit(0);
-}
+  // Логика (Python)
+  auth: cmds.makeAuth, // вьюхи логина/регистрации
+  orders: cmds.makeOrders, // Теперь эта команда будет работать
+  admin: cmds.makeAdmin,
+
+  // Полная сборка
+  init: cmds.initFull,
+};
 
-if (!name) {
+if (actions[command]) {
+  actions[command]();
+} else {
   console.log(`
-Использование:
-  dj-gen page <name>  - Создать HTML шаблон
-  dj-gen view <name>  - Создать Django View
-  dj-gen admin        - Создать файл admin.py
-    `);
-  process.exit(1);
-}
+🛠️  Django-Hero CLI (v1.1.0)
 
-const templates = {
-  base: `<!DOCTYPE html>
-<html>
-<head>
-    <title>{% block title %}Django App{% endblock %}</title>
-</head>
-<body>
-    {% block content %}{% endblock %}
-</body>
-</html>`,
-  view: `from django.views.generic import TemplateView
-
-class ${name}View(TemplateView):
-    template_name = "${name.toLowerCase()}.html"`,
-};
+Команды для 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)
 
-if (command === "page") {
-  const fileName = `${name}.html`;
-  const filePath = path.join(process.cwd(), fileName);
-
-  if (fs.existsSync(filePath)) {
-    console.log(`❌ Ошибка: Файл ${fileName} уже существует!`);
-  } else {
-    fs.writeFileSync(filePath, templates.base);
-    console.log(`✅ Создан HTML шаблон: ${fileName}`);
-  }
-} else if (command === "view") {
-  const fileName = `${name.toLowerCase()}_view.py`;
-  const filePath = path.join(process.cwd(), fileName);
-
-  fs.writeFileSync(filePath, templates.view);
-  console.log(`✅ Создана View: ${fileName}`);
+Команды для Python:
+  dj-gen auth    - views.py (Логика входа, регистрации и Cookies)
+  dj-gen orders  - order_views.py (Логика управления курсами)
+  dj-gen admin   - Стандартный admin.py
+
+Глобальные команды:
+  dj-gen init    - [!] Развернуть ВСЕ файлы проекта сразу
+    `);
 }

package/package.json

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

package/src/commands.js

@@ -0,0 +1,49 @@
+const fs = require("fs");
+const path = require("path");
+
+const baseTpl = require("./templates/base");
+const homeTpl = require("./templates/home");
+const createCourseTpl = require("./templates/create_course");
+const myCourseTpl = require("./templates/my_course");
+const authViewsTpl = require("./view/auth_view");
+const orderViewsTpl = require("./view/order_view");
+
+const saveFile = (fileName, content) => {
+  const filePath = path.join(process.cwd(), fileName);
+  if (fs.existsSync(filePath)) {
+    console.log(`⚠️  Пропуск: ${fileName} (уже существует)`);
+  } else {
+    fs.writeFileSync(filePath, content);
+    console.log(`✅ Создан: ${fileName}`);
+  }
+};
+
+const makeAll = () => {
+  console.log("🚀 Развертывание полного проекта...");
+  saveFile("base.html", baseTpl());
+  saveFile("home.html", homeTpl());
+  saveFile("create_course.html", createCourseTpl());
+  saveFile("my_course.html", myCourseTpl());
+  saveFile("views.py", authViewsTpl());
+  saveFile("order_views.py", orderViewsTpl());
+  saveFile(
+    "admin.py",
+    `from django.contrib import admin\n\n# Register your models here.`
+  );
+  console.log("✨ Готово! Не забудь настроить urls.py.");
+};
+
+module.exports = {
+  makeBase: () => saveFile("base.html", baseTpl()),
+  makeHome: () => saveFile("home.html", homeTpl()),
+  makeCreatePage: () => saveFile("create_course.html", createCourseTpl()),
+  makeListPage: () => saveFile("my_course.html", myCourseTpl()),
+  makeAuth: () => saveFile("views.py", authViewsTpl()),
+  makeOrders: () => saveFile("order_views.py", orderViewsTpl()),
+  makeAdmin: () =>
+    saveFile(
+      "admin.py",
+      `from django.contrib import admin\n\n# Register your models here.`
+    ),
+  initFull: makeAll,
+};

package/src/templates/base.js

@@ -0,0 +1,93 @@
+module.exports = () => `{% load bootstrap5 %} {% load static %}
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{% block title %}Django App{% endblock %}</title>
+    {% bootstrap_css %} {% bootstrap_javascript %}
+  </head>
+  <body class="d-flex flex-column min-vh-100">
+    <header>
+      <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
+        <div class="container-fluid">
+          <a class="navbar-brand" href="#">
+            <img
+              src="{% static 'photo/logo.png' %}"
+              alt="Логотип"
+              width="44"
+              height="40"
+              class="d-inline-block align-text-top rounded-circle"
+            />
+          </a>
+          <button
+            class="navbar-toggler"
+            type="button"
+            data-bs-toggle="collapse"
+            data-bs-target="#navbarNavAltMarkup"
+            aria-controls="navbarNavAltMarkup"
+            aria-expanded="false"
+            aria-label="Toggle navigation"
+          >
+            <span class="navbar-toggler-icon"></span>
+          </button>
+          
+          <div class="collapse navbar-collapse" id="navbarNavAltMarkup">
+            <div class="navbar-nav">
+              <a
+                class="nav-link {% if request.resolver_match.url_name == 'home' %}active{% endif %}"
+                href="{% url 'home' %}"
+              >
+                Главная
+              </a>
+
+              {% if user.is_authenticated %}
+              <a
+                class="nav-link {% if request.resolver_match.url_name == 'my_course' %}active{% endif %}"
+                href="{% url 'my_course' %}"
+              >
+                Посмотреть мои заявки
+              </a>
+
+              <a
+                class="nav-link {% if request.resolver_match.url_name == 'create_course' %}active{% endif %}"
+                href="{% url 'create_course' %}"
+              >
+                Создать заявку
+              </a>
+              {% endif %}
+            </div>
+
+            <div class="navbar-nav ms-auto">
+              {% if user.is_authenticated %}
+              <a class="nav-link" href="{% url 'logout' %}">Выйти</a>
+              {% else %}
+              <a class="nav-link" href="{% url 'login' %}">Войти</a>
+              <a class="nav-link" href="{% url 'registration' %}"
+                >Регистрация</a
+              >
+              {% endif %}
+            </div>
+          </div>
+        </div>
+      </nav>
+    </header>
+    <main class="container flex-grow-1">
+      {% block content %} {% endblock content %}
+    </main>
+    <footer class="bg-dark text-light text-center py-3 mt-auto">
+      сайт © {{ year|default:2026 }}
+    </footer>
+    {% if not request.COOKIES.cookies_accepted %}
+    <div
+      class="position-fixed bottom-0 start-0 end-0 bg-dark text-white p-3 text-center"
+      style="z-index: 999"
+    >
+      Мы используем cookies для улучшения работы сайта.
+      <a href="{% url 'accept_cookies' %}" class="btn btn-sm btn-light ms-2"
+        >Принять</a
+      >
+    </div>
+    {% endif %}
+  </body>
+</html>`;

package/src/templates/create_course.js

@@ -0,0 +1,21 @@
+module.exports = () => `
+{% extends "base.html" %} 
+{% load bootstrap5 %}
+
+
+{% block content %}
+
+    <div class="container mt-4">
+
+        <h2>Создание заявки</h2>
+
+        <form method="post">
+            {% csrf_token %}
+            {% bootstrap_form form %}
+            <button type="submit" class="btn btn-primary">Отправить заявку</button>
+        </form>
+
+    </div>
+
+{% endblock content %}
+`;

package/src/templates/home.js

@@ -0,0 +1,73 @@
+module.exports = () => `{% extends "base.html" %}
+{% load bootstrap5 %}{% load static %}
+{% block content %}
+<style>
+.carousel-control-prev-icon,
+.carousel-control-next-icon {
+    filter: invert(1);
+    width: 2rem;
+    height: 2rem;
+}
+</style>
+{% bootstrap_css %} {% bootstrap_javascript %}
+
+<div id="carouselExampleAutoplaying" class="carousel slide py-5 mb-5" data-bs-ride="carousel">
+  <div class="carousel-inner">
+    <div class="carousel-item active">
+      <img src="{% static 'photo/logo.png' %}" class="d-block w-100" alt="Слайд 1">
+    </div>
+    <div class="carousel-item">
+      <img src="{% static 'photo/image13.webp' %}" class="d-block w-100" alt="Слайд 2">
+    </div>
+    <div class="carousel-item">
+      <img src="{% static 'photo/logo.png' %}" class="d-block w-100" alt="Слайд 3">
+    </div>
+  </div>
+
+  <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleAutoplaying" data-bs-slide="prev">
+    <span class="carousel-control-prev-icon" aria-hidden="true"></span>
+    <span class="visually-hidden">Предыдущий</span>
+  </button>
+  <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleAutoplaying" data-bs-slide="next">
+    <span class="carousel-control-next-icon" aria-hidden="true"></span>
+    <span class="visually-hidden">Следующий</span>
+  </button>
+</div>
+
+<div class="py-5">
+  <div class="container">
+    <h1 class="text-center mb-4">Добро пожаловать на портал «Корочки.есть»</h1>
+
+    <div class="row justify-content-center">
+      <div class="col-md-10 col-lg-8">
+        <div class="card shadow-sm p-4 border-0">
+          <p>
+            Портал <strong>«Корочки.есть»</strong> — это система для записи на онлайн-курсы
+            дополнительного профессионального образования.
+          </p>
+
+          <p>
+            Чтобы воспользоваться сервисом, необходимо пройти регистрацию.
+            После входа в систему пользователь может подать заявку, указав:
+          </p>
+
+          <ul>
+            <li>наименование курса</li>
+            <li>дату начала обучения</li>
+            <li>способ оплаты</li>
+          </ul>
+
+          <p>
+            Все заявки отправляются администратору на проверку. Он может изменить их статус.
+          </p>
+
+          <p class="mb-0">
+            С помощью портала процесс записи становится удобным и понятным.
+          </p>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+{% endblock content %}`;

package/src/templates/my_course.js

@@ -0,0 +1,99 @@
+module.exports = () => `
+{% extends "base.html" %} {% load bootstrap5 %} {% block content %}
+<div class="container my-5">
+  <div class="row">
+    {% for order in course %}
+    <div class="col-md-6 col-lg-4 mb-4">
+      <div class="card h-100">
+        <div class="card-header">
+          <h5 class="card-title mb-0">{{ order.get_course_display }}</h5>
+        </div>
+        <div class="card-body">
+          <p class="text-muted"><small>Дата: {{ order.date }}</small></p>
+          {% if order.review_text %}
+          <p><strong>Ваш отзыв:</strong> {{ order.review_text }}</p>
+          {% endif %}
+        </div>
+        <div class="card-footer">
+          <span class="badge bg-secondary">{{ order.get_status_display }}</span>
+
+          {% if order.status == 'completed' %}
+          <button
+            type="button"
+            class="btn btn-sm btn-outline-primary float-end"
+            data-bs-toggle="modal"
+            data-bs-target="#reviewModal{{ order.id }}"
+          >
+            Оставить отзыв
+          </button>
+          {% endif %}
+        </div>
+      </div>
+    </div>
+
+    <div
+      class="modal fade"
+      id="reviewModal{{ order.id }}"
+      tabindex="-1"
+      aria-hidden="true"
+    >
+      <div class="modal-dialog modal-dialog-centered">
+        <div class="modal-content">
+          <form method="post" action="{% url 'add_review' order.id %}">
+            {% csrf_token %}
+            <div class="modal-header">
+              <h5 class="modal-title">Оставить отзыв о курсе</h5>
+              <button
+                type="button"
+                class="btn-close"
+                data-bs-dismiss="modal"
+              ></button>
+            </div>
+            <div class="modal-body">
+              <textarea
+                name="review_text"
+                class="form-control"
+                rows="4"
+                placeholder="Напишите ваш отзыв..."
+                {%
+                if
+                order.review_text
+                %}readonly{%
+                endif
+                %}
+              >
+{{ order.review_text }}</textarea
+              >
+            </div>
+            <div class="modal-footer">
+              <button
+                type="button"
+                class="btn btn-secondary"
+                data-bs-dismiss="modal"
+              >
+                Закрыть
+              </button>
+
+              {% if not order.review_text %}
+              <button type="submit" class="btn btn-primary">Отправить</button>
+              {% else %}
+              <button type="button" class="btn btn-success" disabled>
+                Отзыв уже оставлен
+              </button>
+              {% endif %}
+            </div>
+          </form>
+        </div>
+      </div>
+    </div>
+
+    {% empty %}
+    <div class="col-12">
+      <div class="alert alert-info">У вас пока нет заявок</div>
+    </div>
+    {% endfor %}
+  </div>
+</div>
+{% endblock %}
+
+`;

package/src/view/auth_view.js

@@ -0,0 +1,54 @@
+module.exports = () => `
+#  view авторизации
+
+from django.shortcuts import render,redirect
+from django.contrib.auth import login
+from django.contrib.auth.forms import AuthenticationForm
+
+from accounts.forms import CustomUserCreatioForm
+
+def home_view(request):
+    return render(request,'home.html')
+
+
+def registration_vew(request):
+    if request.method == 'POST':
+        form = CustomUserCreatioForm(request.POST)
+        if form.is_valid():
+            user = form.save()
+            login(request,user)
+            return redirect('home')
+    else:
+        form = CustomUserCreatioForm()
+    
+    return render(request,'auth/registration.html',{'form':form})                
+
+
+
+
+
+def login_view(request):
+
+    if request.method == 'POST':
+        form = AuthenticationForm(request, data = request.POST)
+        if form.is_valid():
+            user= form.get_user()
+            login(request,user)
+            return redirect('home')
+        
+    else:
+        form = AuthenticationForm()
+        
+    return render(request,'auth/login.html',{'form':form})
+
+
+
+from django.shortcuts import redirect
+
+def accept_cookies(request):
+    response = redirect(request.META.get('HTTP_REFERER', 'home'))
+    response.set_cookie('cookies_accepted', 'yes', max_age=60*60*24*365)  
+    return response
+
+    
+`;

package/src/view/order_view.js

@@ -0,0 +1,40 @@
+module.exports = () => `
+# view курсов
+
+from django.shortcuts import render,redirect
+from orders.forms import OrdersForm
+from .models import Orders
+from django.contrib.auth.decorators import login_required
+from django.views.decorators.http import require_POST
+
+@login_required
+def create_order_view(request):
+    if request.method == 'POST':
+        form = OrdersForm(request.POST)
+        if form.is_valid():
+            course = form.save(commit=False)
+            course.user = request.user
+            course.save()
+            return redirect('my_course')
+    else:
+        form = OrdersForm()
+    return render (request,'orders/createOrders.html',{'form':form})                
+
+
+
+def all_order_view(request):
+    course = Orders.objects.filter(user=request.user)
+    return render (request,'orders/listOrders.html',{'course':course})             
+
+
+@require_POST
+def add_review(request, order_id):
+    order = Orders.objects.get(id=order_id, user=request.user)
+    review_text = request.POST.get('review', '').strip()
+    if review_text:
+        order.review_text = review_text
+        order.save()
+    return redirect('my_course')  
+
+    
+`;