# DEMO Shop

Простой учебный проект: магазин с товарами, складами и заказами.
Сайт + серверная часть (API) в одном проекте.

Рабочий сайт: https://demo.triron.ru

## Что умеет

- Вход и регистрация. Новому человеку дается роль Client.
- 6 разделов: Товары, Категории, Склады, Остатки, Пользователи, Заказы.
- Везде можно добавлять, изменять и удалять записи.
- В заказе можно смотреть товары и добавлять новые.
- Внизу экрана всплывают короткие сообщения (что сохранилось, где ошибка).

## Что внутри

```
DEMO/
  Controllers/      серверные адреса (API), по одному файлу на таблицу
    AuthController.cs       вход и регистрация
    ProductsController.cs   товары
    CategoriesController.cs категории
    WarehousesController.cs склады
    StocksController.cs     остатки
    UsersController.cs      пользователи
    OrdersController.cs     заказы
    OrderItemsController.cs товары внутри заказов
    RolesController.cs      роли
  Data/
    AppDbContext.cs        список всех таблиц базы
    AppDbContextFactory.cs подключение для миграций
  Models/           классы таблиц: Product, Category, Warehouse,
                    Stock, User, Role, Order, OrderItem
  Migrations/       история создания базы (одна общая миграция)
  wwwroot/          сайт, который видит человек
    index.html      разметка: вход, меню, таблицы, окно формы
    style.css       простые стили, светлый дизайн
    script.js       весь код сайта с понятными комментариями
  Program.cs        главный файл: запускает все и создает базу
  appsettings.json  настройки, там строка подключения к базе
```

База данных: SQLite, файл `DemoDB.db`. Создается сам при первом запуске,
ничего ставить не надо. При старте сами добавляются роли Admin и Client.

## Как запустить у себя

Нужен только .NET 10 SDK.

```
cd DEMO
dotnet restore
dotnet run
```

Открыть в браузере: `http://localhost:5000`
(точный адрес покажет само окно запуска).

База создастся сама. Дальше нажмите "Зарегистрироваться" на сайте.

## Адреса API

Все адреса начинаются одинаково, дальше свое для каждой таблицы.

| Что сделать | Как вызвать | Что отдать |
|---|---|---|
| Войти | POST /api/auth/login | логин и пароль |
| Зарегистрироваться | POST /api/auth/register | логин и пароль |
| Список товаров | GET /api/products | ничего |
| Добавить товар | POST /api/products | название, цена, categoryId |
| Изменить товар | PUT /api/products/5 | то же самое (5 это номер) |
| Удалить товар | DELETE /api/products/5 | ничего |

Точно так же работают остальные таблицы, только адрес другой:

- /api/categories (поле name)
- /api/warehouses (поля name, address)
- /api/stocks (поля productId, warehouseId, quantity)
- /api/users (поля login, password, roleId)
- /api/orders (поля userId, date, status)
- /api/orderitems (поля orderId, productId, quantity, price)
- /api/roles (поле name)

Статусы заказа: New, Processing, Completed, Cancelled.

## Как это стоит на сервере

- Сервер: Ubuntu 24.04, стоит .NET 10 SDK.
- Код лежит в /opt/demo (копия этого репозитория).
- Собранный проект лежит в /opt/demo/publish.
- Служба называется demo, смотрит на 127.0.0.1:5001.
- Снаружи сайт отдает nginx через https://demo.triron.ru.
- Сертификат от Let's Encrypt, продлевается сам.

Проверить что служба жива:

```
systemctl status demo.service
curl http://127.0.0.1:5001/api/roles
```

## Как обновить сайт на сервере

```
cd /opt/demo
git pull origin master
cd DEMO
dotnet publish -c Release -o /opt/demo/publish
systemctl restart demo.service
```

База при этом не теряется, миграции применяются сами.

## Если что-то не работает

1. Служба не запустилась: `journalctl -u demo.service -n 50` покажет ошибку.
2. Сайт не открывается снаружи: `nginx -t` проверит настройки,
   `systemctl reload nginx` перезагрузит их.
3. Ошибка про базу: удалите файл DemoDB.db рядом с запуском
   и перезапустите, база создастся заново (все данные пропадут).