AspNetForge.WebCore 1.0.6

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.6
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, SQL DDL.txt и блок-схема.vsdx копируются в корень проекта.

Важно: регистрация не предусмотрена. После установки откроется страница авторизации.

Настройка PostgreSQL

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

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

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

CREATE DATABASE examdb;

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

dotnet run

Данные заполняются через формы на страницах товаров и заказов.

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

app.MapCrud<Product, AppDbContext>("/api/products");
app.MapCrud<Order, AppDbContext>("/api/orders");
app.MapCrud<PickupPoint, AppDbContext>("/api/pickuppoints");
app.MapCrud<User, AppDbContext>("/api/users");

Роли

В шаблоне используется роль 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 пустой

Файлы копируются из пакета при сборке через MSBuild targets.

Пример DDL

Файл SQL DDL.txt копируется в корень проекта при сборке.

CREATE TABLE "Products" (
    "Id" SERIAL,
    "Article" VARCHAR(10) NOT NULL UNIQUE PRIMARY KEY,
    "Name" VARCHAR(50) NOT NULL,
    "Measure" VARCHAR(10) NOT NULL,
    "Count" INT NOT NULL,
    "Supplier" VARCHAR(50) NOT NULL,
    "Producer" VARCHAR(50) NOT NULL,
    "Category" VARCHAR(50) NOT NULL,
    "Discount" INT NOT NULL,
    "QuantityInStock" INT NOT NULL,
    "Description" VARCHAR(200) NOT NULL,
    "Photo" VARCHAR(50) NOT NULL
);

CREATE TABLE "Users" (
    "Id" SERIAL PRIMARY KEY,
    "Role" VARCHAR(50) NOT NULL,
    "FullName" VARCHAR(100) NOT NULL,
    "Login" VARCHAR(50) NOT NULL UNIQUE,
    "Password" VARCHAR(50) NOT NULL
);

CREATE TABLE "Adresses" (
    "Id" SERIAL PRIMARY KEY,
    "Address" VARCHAR(100) NOT NULL UNIQUE
);

CREATE TABLE "Orders" (
    "Id" SERIAL PRIMARY KEY,
    "Number" INT NOT NULL,
    "OrderDate" DATE NOT NULL,
    "DeliveryDate" DATE NOT NULL,
    "AddressId" INT NOT NULL,
    "ClientId" INT NOT NULL,
    "Code" INT NOT NULL UNIQUE,
    "Status" VARCHAR(50) NOT NULL,
    FOREIGN KEY ("ClientId") REFERENCES "Users"("Id"),
    FOREIGN KEY ("AddressId") REFERENCES "Adresses"("Id")
);

CREATE TABLE "OrderItems" (
    "Id" SERIAL PRIMARY KEY,
    "OrderId" INT NOT NULL,
    "Article" VARCHAR(10) NOT NULL,
    "Quantity" INT NOT NULL,
    FOREIGN KEY ("OrderId") REFERENCES "Orders"("Id"),
    FOREIGN KEY ("Article") REFERENCES "Products"("Article")
);

Fallback: код файлов

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