django-hero-gen 1.2.0 → 1.3.0

package/README.md

@@ -1,125 +1,229 @@
-# 🦸‍♂️ Django Hero Gen (v1.1.11)
+> **⚠️ ДИСКЛЕЙМЕР:** Данный инструмент и руководство созданы исключительно в образовательных целях. Настоятельно рекомендуется использовать этот CLI-инструмент как средство для **подготовки к экзамену**, автоматизации рутины и изучения структуры Django, а не как способ для списывания. Понимание того, как работает сгенерированный код — залог успешной защиты!
 
-**Django Hero Gen** — это мощный CLI-инструмент для мгновенного развертывания фронтенда и базовой логики Django-приложений. Забудь о рутинном написании кода авторизации, создании моделей и копировании Bootstrap-шаблонов. Делай это одной командой.
+# 🦸‍♂️ Django Hero Gen (v1.3.0) — Demo Edition
 
----
+**Django Hero Gen** — это CLI-инструмент для молниеносного развертывания Django-проектов. Текущая версия полностью адаптирована под **PostgreSQL**, **Crispy Forms** и **локальную работу** (без интернета).
 
 ## 🚀 Быстрый старт
 
 ### Установка
 
-Установите пакет глобально, чтобы использовать команду `dj-gen` в любом месте:
+Глобальная установка (рекомендуется):
 
 ```bash
 npm install -g django-hero-gen
 
 ```
 
-Или используйте через `npx` без установки:
+Запуск через `npx`:
 
 ```bash
 npx django-hero-gen <команда>
 
 ```
 
-### Полная инициализация
+---
+
+## 🎓 Гайд: Как написать демо-проект с нуля
+
+### Шаг 1: Подготовка папки
 
-Создает основной набор файлов для быстрого старта (шаблоны + вьюхи + админка):
+1. На рабочем столе создай папку с названием `demo`.
+2. Нажми на неё правой кнопкой мыши и выбери **«Открыть с помощью Code»** (VS Code).
+3. В VS Code нажми `Ctrl + ~` (тильда), чтобы открыть терминал.
+
+### Шаг 2: Настройка окружения
+
+Скопируй и вставь эти команды в терминал по очереди:
+
+1. **Создаем виртуальное окружение:**
 
 ```bash
-dj-gen init
+python -m venv venv
 
 ```
 
----
+2. **Активируем его:**
 
-## 🛠 Доступные команды
+```bash
+venv\Scripts\activate
 
-### 1. Шаблоны HTML (Bootstrap 5)
+```
 
-Команды для создания фронтенд-части. Запускать в папке `templates`.
+_(Слева от строки ввода должно появиться `(venv)`. Это значит — всё ок!)_ 3. **Устанавливаем библиотеки:**
 
-| Команда                    | Файл                 | Описание                                        |
-| -------------------------- | -------------------- | ----------------------------------------------- |
-| `dj-gen base`              | `base.html`          | Каркас: Navbar, Footer, блоки контента.         |
-| `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`  | Страница регистрации пользователей.             |
+```bash
+pip install django psycopg2 django-crispy-forms crispy-bootstrap5
 
-### 2. Логика Python (Django)
+```
 
-Команды для генерации серверной части. Запускать в папке приложения.
+### Шаг 3: Настройка базы данных (Слоник)
 
-**Вьюхи и Админка:**
+1. Запусти **pgAdmin 4** (синий слоник) на рабочем столе.
+2. Нажми правой кнопкой на `Databases` -> `Create` -> `Database...`.
+3. В поле `Database` напиши название: **`db_demo`**.
+4. Нажми `Save`. На этом работа в pgAdmin закончена.
 
-- `dj-gen auth_view` — Создает `views.py` (Авторизация, Регистрация, Cookies).
-- `dj-gen orders_view` — Создает `order_views.py` (Бизнес-логика заказов/курсов).
-- `dj-gen admin` — Стандартный `admin.py` для регистрации моделей.
+### Шаг 4: Создание структуры проекта
 
-**Модели и Формы:**
+В терминале VS Code:
+
+1. **Создаем проект:** `django-admin startproject project .` (точка в конце важна!).
+2. **Создаем приложения:**
+
+```bash
+python manage.py startapp accounts
+python manage.py startapp orders
 
-- `dj-gen modelsUser` — `models.py` с кастомным пользователем (AbstractUser).
-- `dj-gen modelsOrders` — `models.py` с моделью заявок/курсов.
-- `dj-gen userForm` — `forms.py` для регистрации и профиля.
-- `dj-gen orderForm` — `forms.py` для создания заявок.
+```
 
-**Настройки и Маршруты:**
+3. **Создаем папки для дизайна:** `mkdir static templates`.
 
-- `dj-gen settings` — Готовый блок настроек для `settings.py`.
-- `dj-gen authUrls` — `urls.py` для логики аккаунтов.
-- `dj-gen ordersUrls` — `urls.py` для логики заказов.
+- _Важно:_ скопируй файлы `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
+python manage.py makemigrations
+python manage.py migrate
+python manage.py runserver
+
+```
+
+---
 
-При использовании `dj-gen init` в папке вашего приложения:
+## 📁 Примерная структура проекта может отличаться
 
 ```text
-your_app/
-├─ templates/
-│  ├─ base.html          # Базовый шаблон
-│  ├─ home.html          # Главная страница
-│  ├─ login.html         # Вход
-│  ├─ registration.html  # Регистрация
-│  ├─ create_course.html # Форма создания
-│  └─ my_course.html     # Список объектов
-├─ views.py              # Логика Auth
-├─ order_views.py        # Логика Orders
-├─ models.py             # Модели
-├─ forms.py              # Формы
-├─ urls.py               # Маршруты
-└─ admin.py              # Админка
+demo/
+├── venv/                  # Окружение
+├── static/                # Сюда положи Bootstrap!
+│   ├── css/bootstrap.min.css
+│   └── js/bootstrap.bundle.min.js
+├── templates/             # HTML шаблоны
+├── accounts/              # Логика пользователей
+├── orders/                # Логика заданий
+├── project/               # Настройки
+└── manage.py
 
 ```
 
 ---
 
-## ⚙️ Важные настройки
+## 🐘 Лайфхак для схем
 
-Для работы сгенерированного кода убедитесь, что в вашем окружении установлены:
+Если на экзамене нужна **ER-диаграмма**:
 
-1. **Python зависимости:**
+1. В **pgAdmin** нажми правой кнопкой на базу `db_demo`.
+2. Выбери **ERD Tool**.
+3. Программа сама нарисует связи. Сделай скриншот для отчета!
 
-```bash
-pip install django-bootstrap5 django-phonenumber-field
+---
 
-```
+## 🛠 Все доступные команды
+
+### 1. HTML-шаблоны (Bootstrap 5)
+
+> Запускать **в папке `templates/`**
+
+| Команда                    | Файл                 | Описание                                      |
+| -------------------------- | -------------------- | --------------------------------------------- |
+| `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)
+
+> Запускать **в папке приложения**
 
-2. **В settings.py:**
+#### 📌 Views и Admin
 
-- Добавьте `'bootstrap5'` и `'phonenumber_field'` в `INSTALLED_APPS`.
-- Укажите `AUTH_USER_MODEL = 'имя_вашего_приложения.CustomUser'`.
-- Проверьте пути в `TEMPLATES` и `STATICFILES_DIRS`.
+- `dj-gen auth_view`
+  ➜ `views.py`
+  Авторизация, регистрация, cookies, login / logout
+
+- `dj-gen orders_view`
+  ➜ `order_views.py`
+  CRUD-логика курсов / заявок
+
+- `dj-gen admin`
+  ➜ `admin.py`
+  Регистрация моделей в админке
+
+---
+
+#### 📌 Модели
+
+- `dj-gen modelUser`
+  ➜ `models.py`
+  Кастомный пользователь (`AbstractUser`)
+
+- `dj-gen modelOrders`
+  ➜ `models.py`
+  Модель курсов / заявок
 
 ---
 
-## 📜 Лицензия
+#### 📌 Формы
 
-Лицензия **MIT**. Автор: **asappaholik**.
+- `dj-gen userForm`
+  ➜ `forms.py`
+  Форма регистрации и профиля пользователя
 
-**Удачной разработки и успешных экзаменов!**
+- `dj-gen orderForm`
+  ➜ `forms.py`
+  Форма создания заявки / курса
 
 ---
+
+#### 📌 URLs
+
+- `dj-gen authUrls`
+  ➜ `urls.py`
+  Маршруты аутентификации
+
+- `dj-gen ordersUrls`
+  ➜ `urls.py`
+  Маршруты курсов / заявок
+
+---
+
+## 📜 Лицензия и Автор
+
+**MIT License** | Автор: **[https://t.me/asapaholik](https://t.me/asapaholik)**
+
+🔥 **Удачи! Ты справишься!**

package/package.json

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

package/src/admin/admin.js

@@ -0,0 +1,10 @@
+module.exports = () => `
+from django.contrib import admin
+from .models import Orders
+
+@admin.register(Orders)
+class OrdersAdmin(admin.ModelAdmin):
+    list_display = ('user', 'course', 'date', 'payment', 'status')
+    list_filter = ('status', 'payment', 'course')
+
+`;

package/src/commands.js

@@ -16,6 +16,7 @@ const userFormTpl = require("./forms/user_form");
 const orderFormTpl = require("./forms/order_form");
 const loginPageTpl = require("./templates/login");
 const registrationPageTpl = require("./templates/registration");
+const adminTpl = require("./admin/admin");
 
 const saveFile = (fileName, content) => {
   const filePath = path.join(process.cwd(), fileName);
@@ -35,10 +36,7 @@ const makeAll = () => {
   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.`,
-  );
+  saveFile("admin.py", adminTpl());
   console.log("✨ Готово! Не забудь настроить urls.py.");
 };
 
@@ -48,7 +46,7 @@ module.exports = {
   makeCreatePage: () => saveFile("create_course.html", createCourseTpl()),
   makeListPage: () => saveFile("my_course.html", myCourseTpl()),
   makeAuth: () => saveFile("views.py", authViewsTpl()),
-  makeOrders: () => saveFile("order_views.py", orderViewsTpl()),
+  makeOrders: () => saveFile("views.py", orderViewsTpl()),
   makeModelOrders: () => saveFile("models.py", modelOrdersTpl()),
   makeModelUser: () => saveFile("models.py", modelUserTpl()),
   makeSettings: () => saveFile("settings.py", coreSettingsTpl()),
@@ -57,12 +55,9 @@ module.exports = {
   makeUserForm: () => saveFile("forms.py", userFormTpl()),
   makeOrderForm: () => saveFile("forms.py", orderFormTpl()),
   makeLoginPage: () => saveFile("login.html", loginPageTpl()),
+  makeAdmin: () => saveFile("admin.py", adminTpl()),
   makeRegistrationPage: () =>
     saveFile("registration.html", registrationPageTpl()),
-  makeAdmin: () =>
-    saveFile(
-      "admin.py",
-      `from django.contrib import admin\n\n# Register your models here.`,
-    ),
+
   initFull: makeAll,
 };

package/src/model/user_model.js

@@ -2,26 +2,15 @@ module.exports = () => `
 # Модель базы данных авторизации
 from django.db import models
 from django.contrib.auth.models import AbstractUser
-from phonenumber_field.modelfields import PhoneNumberField
-from django.core.validators import RegexValidator
+
 
 class CustomUser(AbstractUser):
     
-    login_validator = RegexValidator(
-        regex=r'^[a-zA-Z0-9]{6,}$',
-        message='(латиница и цифры, не менее 6 символов)'
-    )
-    
-    full_name_validator = RegexValidator(
-        regex=r'^[а-яА-ЯёЁ\s]+$',
-        message='(символы кириллицы и пробелы)'
-    )
-    
     username = models.CharField(
         unique=True,
         max_length=120,
         verbose_name='Логин',
-        validators=[login_validator]
+
         )
     
     
@@ -34,9 +23,11 @@ class CustomUser(AbstractUser):
     full_name = models.CharField(
         max_length=120,
         verbose_name='ФИО',
-        validators=[full_name_validator]
     )
     
-    phone = PhoneNumberField(region='RU', verbose_name='Номер телефона')
+    phone = models.CharField(
+        max_length=20,
+        verbose_name='Номер телефона'
+    )
  
 `;

package/src/settings/core_settings.js

@@ -2,7 +2,7 @@ module.exports = () => `
 """
 Django settings for project project.
 
-Generated by 'django-admin startproject' using Django 4.2.24.
+Generated by 'django-admin startproject' using Django 4.2.27.
 
 For more information on this file, see
 https://docs.djangoproject.com/en/4.2/topics/settings/
@@ -21,7 +21,7 @@ BASE_DIR = Path(__file__).resolve().parent.parent
 # See https://docs.djangoproject.com/en/4.2/howto/deployment/checklist/
 
 # SECURITY WARNING: keep the secret key used in production secret!
-SECRET_KEY = 'django-insecure-rokcncxrv9se5e=ma8#vlb9gds&^-ayvj1e1d&!v8fnb*f@a59'
+SECRET_KEY = 'django-insecure-=n27(^4l^ake6@5y2*s9*j%tw&!o9vi%z7e4_2w6bmm737k!87'
 
 # SECURITY WARNING: don't run with debug turned on in production!
 DEBUG = True
@@ -40,9 +40,8 @@ INSTALLED_APPS = [
     'django.contrib.staticfiles',
     'accounts',
     'orders',
-    'bootstrap5',
-    'phonenumber_field',
-    
+    'crispy_forms',
+    'crispy_bootstrap5',
 ]
 
 MIDDLEWARE = [
@@ -81,8 +80,13 @@ WSGI_APPLICATION = 'project.wsgi.application'
 
 DATABASES = {
     'default': {
-        'ENGINE': 'django.db.backends.sqlite3',
-        'NAME': BASE_DIR / 'db.sqlite3',
+       'ENGINE': 'django.db.backends.postgresql',
+        'NAME':'demo2',
+        'USER':'postgres',
+        'PASSWORD':'0405',
+        'HOST':'localhost',
+        'PORT':'5432',
+        
     }
 }
 
@@ -122,15 +126,15 @@ USE_TZ = True
 # https://docs.djangoproject.com/en/4.2/howto/static-files/
 
 STATIC_URL = 'static/'
-
 STATICFILES_DIRS = [
-    BASE_DIR / "static",
+    BASE_DIR / 'static',
 ]
-
 # Default primary key field type
 # https://docs.djangoproject.com/en/4.2/ref/settings/#default-auto-field
 
 DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
-
 AUTH_USER_MODEL = 'accounts.CustomUser'
+
+CRISPY_ALLOWED_TEMPLATE_PACKS = "bootstrap5"
+CRISPY_TEMPLATE_PACK = "bootstrap5"
 `;

package/src/templates/base.js

@@ -1,4 +1,7 @@
-module.exports = () => `{% load bootstrap5 %} {% load static %}
+module.exports = () => `
+{% load static %}
+{% load crispy_forms_tags %}
+
 <!DOCTYPE html>
 <html lang="en">
   <head>

package/src/templates/create_course.js

@@ -1,6 +1,6 @@
 module.exports = () => `
 {% extends "base.html" %} 
-{% load bootstrap5 %}
+{% load crispy_forms_tags %}
 
 
 {% block content %}
@@ -11,7 +11,7 @@ module.exports = () => `
 
         <form method="post">
             {% csrf_token %}
-            {% bootstrap_form form %}
+            {% crispy form %}
             <button type="submit" class="btn btn-primary">Отправить заявку</button>
         </form>
 

package/src/templates/home.js

@@ -1,5 +1,6 @@
 module.exports = () => `{% extends "base.html" %}
-{% load bootstrap5 %}{% load static %}
+{% load crispy_forms_tags %}
+{% load static %}
 {% block content %}
 <style>
 .carousel-control-prev-icon,
@@ -19,7 +20,6 @@ module.exports = () => `{% extends "base.html" %}
         height: 250px;
     }
 </style>
-{% bootstrap_css %} {% bootstrap_javascript %}
 
 <div id="carouselExampleAutoplaying" class="carousel slide py-5 mb-5" data-bs-ride="carousel" data-bs-interval="400">
   <div class="carousel-inner">

package/src/templates/login.js

@@ -1,10 +1,11 @@
-module.exports = () => ` {% extends 'base.html' %} {% load bootstrap5 %} {%
+module.exports =
+  () => ` {% extends 'base.html' %} {% load crispy_forms_tags %} {%
 block content %}
 
 <div class="container">
   <form method="post">
-    {% csrf_token %} {% bootstrap_form form %}
-    <button class="btn-primary">Войти</button>
+    {% csrf_token %} {% crispy form %}
+    <button class="btn btn-primary">Войти</button>
   </form>
   <div><a href="{% url 'registration' %}"></a></div>
 </div>

package/src/templates/my_course.js

@@ -1,6 +1,6 @@
 module.exports = () => `
 {% extends "base.html" %}
-{% load bootstrap5 %}
+{% load crispy_forms_tags %}
 
 {% block content %}
 <div class="container my-5">

package/src/templates/registration.js

@@ -1,10 +1,11 @@
-module.exports = () => ` {% extends 'base.html' %} {% load bootstrap5 %} {%
+module.exports =
+  () => ` {% extends 'base.html' %} {% load crispy_forms_tags %} {%
 block content %}
 
 <div class="container">
   <form method="post">
-    {% csrf_token %} {% bootstrap_form form %}
-    <button class="btn-primary">Зарегистрироваться</button>
+    {% csrf_token %} {% crispy form %}
+    <button class="btn btn-primary">Зарегистрироваться</button>
   </form>
   <div><a href="{% url 'login' %}"></a></div>
 </div>