AspNetForge.WebCore 1.0.5

AspNetForge.WebCore

Class Library + стартовый шаблон для ASP.NET Core Minimal API (.NET 8).
Содержит generic CRUD-эндпоинты, cookie-авторизацию, встроенные HTML/CSS/JS и готовый пример проекта.

Быстрый старт

dotnet new web -n MyWebApp
cd MyWebApp
dotnet add package AspNetForge.WebCore --version 1.0.5
dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 8.0.11
dotnet build

Важно: пакет рассчитан на чистый проект dotnet new web. Он заменяет Program.cs и копирует wwwroot/.

Что происходит после установки

1. Program.cs заменяется шаблонным примером (модели и DbContext находятся внутри него).
2. wwwroot/ копируется с HTML/CSS/JS.
3. appsettings.json не перезаписывается, если уже существует. Добавьте строку подключения вручную.

Настройка PostgreSQL

Откройте appsettings.json и добавьте:

{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Port=5432;Database=examdb;Username=postgres;Password=postgres"
  }
}

Создайте базу:

CREATE DATABASE examdb;

Запустите приложение:

dotnet run

Данные заполняются через формы или импорт CSV.

Возможности библиотеки

using AspNetForge.Web.Extensions;

app.MapCrud<Product, AppDbContext>("/api/products");
app.MapCrud<Order, AppDbContext>("/api/orders");
app.MapImport<Product, AppDbContext>("/api/products/import").RequireAuthorization("ManagerPlus");
app.UseForgeResources(overwrite: true);

Роли

В шаблоне используются роли: Client, Manager, Admin.
Администратор может добавлять/редактировать/удалять товары и заказы. Менеджер — пользоваться фильтрами и импортом. Клиент — только просмотр.

Если файлы не появились

Закройте Visual Studio, удалите папку obj/, откройте решение заново и нажмите Ctrl+Shift+B.

Возможные ошибки

Visual Studio предлагает запустить прошлый вариант

1. Ctrl+Shift+B — собрать проект.
2. Правый клик по проекту → Перезагрузить проект.
3. Запустить снова.

CS0234: EntityFrameworkCore не существует

dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 8.0.11

404 Not Found

Убедитесь, что в Program.cs есть:

app.UseDefaultFiles();
app.UseStaticFiles();

wwwroot пустой

При старте UseForgeResources(overwrite: true) копирует встроенные файлы. Убедитесь, что метод вызван до UseStaticFiles().

Пример DDL

CREATE TABLE "Users" (
    "Id" SERIAL PRIMARY KEY,
    "Login" TEXT NOT NULL,
    "Password" TEXT NOT NULL,
    "FullName" TEXT NOT NULL,
    "Role" TEXT NOT NULL
);

CREATE TABLE "PickupPoints" (
    "Id" SERIAL PRIMARY KEY,
    "Address" TEXT NOT NULL,
    "City" TEXT NOT NULL
);

CREATE TABLE "Products" (
    "Id" SERIAL PRIMARY KEY,
    "Article" TEXT NOT NULL,
    "Name" TEXT NOT NULL,
    "Category" TEXT NOT NULL,
    "Manufacturer" TEXT NOT NULL,
    "Supplier" TEXT NOT NULL,
    "Price" NUMERIC NOT NULL,
    "Discount" INTEGER NOT NULL,
    "Quantity" INTEGER NOT NULL,
    "Description" TEXT NOT NULL,
    "ImagePath" TEXT NOT NULL
);

CREATE TABLE "Orders" (
    "Id" SERIAL PRIMARY KEY,
    "OrderNumber" INTEGER NOT NULL,
    "OrderDate" TIMESTAMP NOT NULL,
    "ClientFullName" TEXT NOT NULL,
    "ProductId" INTEGER REFERENCES "Products"("Id"),
    "Quantity" INTEGER NOT NULL,
    "PickupPointId" INTEGER REFERENCES "PickupPoints"("Id"),
    "Discount" INTEGER NOT NULL,
    "Status" TEXT NOT NULL,
    "DeliveryDate" TIMESTAMP NOT NULL,
    "Code" INTEGER NOT NULL
);

Пример CSV для импорта товаров

Article;Name;Category;Manufacturer;Supplier;Price;Discount;Quantity;Description;ImagePath
T001;Товар 1;Категория 1;Производитель 1;Поставщик 1;1000;0;10;Описание 1;images/t1.jpg
T002;Товар 2;Категория 2;Производитель 2;Поставщик 2;2000;5;20;Описание 2;images/t2.jpg

Fallback: код файлов

Если автоматическое копирование не сработало, создайте файлы вручную. Содержимое идентично тому, что лежит в папке Sample/ исходников пакета.