argon2-utils 1.0.0

package/native/src/app.module.ts

@@ -0,0 +1,16 @@
+import { Module } from '@nestjs/common';
+import { DatabaseModule } from './database/database.module';
+import { AuthModule } from './auth/auth.module';
+import { ApplicationsModule } from './applications/applications.module'; // МЕНЯТЬ: название модуля под свою тему
+import { ReviewsModule } from './reviews/reviews.module'; // МЕНЯТЬ: название модуля под свою тему
+
+// Корневой модуль — подключаем все модули сюда
+@Module({
+  imports: [
+    DatabaseModule,   // подключение к БД (не менять)
+    AuthModule,       // авторизация (не менять)
+    ApplicationsModule, // МЕНЯТЬ: своя предметная область
+    ReviewsModule,      // МЕНЯТЬ: своя предметная область
+  ],
+})
+export class AppModule {}

package/native/src/applications/applications.controller.ts

@@ -0,0 +1,47 @@
+import { Controller, Get, Post, Patch, Delete, Body, Param, UseGuards, Request } from '@nestjs/common';
+import { ApplicationsService } from './applications.service';
+import { JwtAuthGuard } from '../auth/jwt-auth.guard';
+
+// МЕНЯТЬ: 'applications' на своё название маршрута (например 'orders')
+// @UseGuards(JwtAuthGuard) — все роуты требуют авторизации
+@UseGuards(JwtAuthGuard)
+@Controller('applications')
+export class ApplicationsController {
+  constructor(private readonly svc: ApplicationsService) {}
+
+  // POST /applications — создать запись
+  // МЕНЯТЬ: поля body под свою тему
+  @Post()
+  create(@Request() req, @Body() body: {
+    course_name: string;        // МЕНЯТЬ
+    desired_start_date: string; // МЕНЯТЬ
+    payment_method: string;     // МЕНЯТЬ
+  }) {
+    return this.svc.create(req.user.id, body); // req.user.id — id из JWT токена
+  }
+
+  // GET /applications/my — мои записи (важно: /my должен быть выше /:id)
+  @Get('my')
+  findMy(@Request() req) {
+    return this.svc.findByUser(req.user.id);
+  }
+
+  // GET /applications — все записи (для администратора)
+  @Get()
+  findAll(@Request() req) {
+    return this.svc.findAll();
+  }
+
+  // PATCH /applications/:id/status — сменить статус
+  // МЕНЯТЬ: 'status' если другое поле обновляется
+  @Patch(':id/status')
+  updateStatus(@Param('id') id: string, @Body() body: { status: string }, @Request() req) {
+    return this.svc.updateStatus(+id, body.status, req.user.is_admin);
+  }
+
+  // DELETE /applications/:id — удалить запись
+  @Delete(':id')
+  delete(@Param('id') id: string, @Request() req) {
+    return this.svc.delete(+id, req.user.id, req.user.is_admin);
+  }
+}

package/native/src/applications/applications.module.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { ApplicationsController } from './applications.controller';
+import { ApplicationsService } from './applications.service';
+
+// Модуль заявок — регистрирует контроллер и сервис
+// МЕНЯТЬ: переименовать класс, контроллер и сервис под свою тему
+// Не забыть добавить этот модуль в app.module.ts → imports
+@Module({
+  controllers: [ApplicationsController],
+  providers: [ApplicationsService],
+})
+export class ApplicationsModule {}

package/native/src/applications/applications.service.ts

@@ -0,0 +1,71 @@
+import { Injectable, Inject, ForbiddenException, NotFoundException } from '@nestjs/common';
+import { Pool } from 'pg';
+import { DB_POOL } from '../database/database.module';
+
+// МЕНЯТЬ: переименовать класс под свою тему (например OrdersService)
+@Injectable()
+export class ApplicationsService {
+  constructor(@Inject(DB_POOL) private readonly pool: Pool) {}
+
+  // CREATE — создать новую запись
+  // МЕНЯТЬ: поля dto, таблицу applications, колонки INSERT
+  async create(userId: number, dto: {
+    course_name: string;        // МЕНЯТЬ: своё поле
+    desired_start_date: string; // МЕНЯТЬ: своё поле
+    payment_method: string;     // МЕНЯТЬ: своё поле
+  }) {
+    const result = await this.pool.query(
+      `INSERT INTO applications (user_id, course_name, desired_start_date, payment_method)
+       VALUES ($1, $2, $3, $4) RETURNING *`,
+      [userId, dto.course_name, dto.desired_start_date, dto.payment_method],
+    );
+    return result.rows[0];
+  }
+
+  // READ — получить записи текущего пользователя (с отзывом через LEFT JOIN)
+  // МЕНЯТЬ: таблицу applications, поля SELECT
+  async findByUser(userId: number) {
+    const result = await this.pool.query(
+      `SELECT a.*, r.review_text, r.id as review_id
+       FROM applications a
+       LEFT JOIN reviews r ON r.application_id = a.id
+       WHERE a.user_id = $1
+       ORDER BY a.created_at DESC`,
+      [userId],
+    );
+    return result.rows;
+  }
+
+  // READ — получить все записи (для администратора)
+  // МЕНЯТЬ: таблицу applications, поля SELECT
+  async findAll() {
+    const result = await this.pool.query(
+      `SELECT a.*, u.login, u.full_name, u.email, u.phone
+       FROM applications a
+       JOIN users u ON u.id = a.user_id
+       ORDER BY a.created_at DESC`,
+    );
+    return result.rows;
+  }
+
+  // UPDATE — сменить статус записи (только администратор)
+  // МЕНЯТЬ: таблицу applications, поле status
+  async updateStatus(id: number, status: string, isAdmin: boolean) {
+    if (!isAdmin) throw new ForbiddenException('Только для администратора');
+    const result = await this.pool.query(
+      `UPDATE applications SET status = $1 WHERE id = $2 RETURNING *`,
+      [status, id],
+    );
+    if (result.rows.length === 0) throw new NotFoundException('Запись не найдена');
+    return result.rows[0];
+  }
+
+  // DELETE — удалить запись
+  async delete(id: number, userId: number, isAdmin: boolean) {
+    const check = await this.pool.query('SELECT * FROM applications WHERE id = $1', [id]);
+    if (check.rows.length === 0) throw new NotFoundException('Запись не найдена');
+    if (!isAdmin && check.rows[0].user_id !== userId) throw new ForbiddenException('Нет доступа');
+    await this.pool.query('DELETE FROM applications WHERE id = $1', [id]);
+    return { success: true };
+  }
+}

package/native/src/auth/auth.controller.ts

@@ -0,0 +1,26 @@
+import { Controller, Post, Body } from '@nestjs/common';
+import { AuthService } from './auth.service';
+
+// Роуты: POST /auth/register и POST /auth/login
+@Controller('auth')
+export class AuthController {
+  constructor(private readonly authService: AuthService) {}
+
+  // МЕНЯТЬ: поля body если другие поля при регистрации
+  @Post('register')
+  register(@Body() body: {
+    login: string;
+    password: string;
+    full_name: string; // МЕНЯТЬ
+    phone: string;     // МЕНЯТЬ
+    email: string;     // МЕНЯТЬ
+  }) {
+    return this.authService.register(body);
+  }
+
+  // Не менять
+  @Post('login')
+  login(@Body() body: { login: string; password: string }) {
+    return this.authService.login(body.login, body.password);
+  }
+}

package/native/src/auth/auth.module.ts

@@ -0,0 +1,19 @@
+import { Module } from '@nestjs/common';
+import { JwtModule } from '@nestjs/jwt';
+import { AuthController } from './auth.controller';
+import { AuthService } from './auth.service';
+import { JwtStrategy } from './jwt.strategy';
+
+// Модуль авторизации — не менять
+@Module({
+  imports: [
+    JwtModule.register({
+      secret: process.env.JWT_SECRET || 'supersecretkey123', // секрет в .env
+      signOptions: { expiresIn: '8h' }, // токен живёт 8 часов
+    }),
+  ],
+  controllers: [AuthController],
+  providers: [AuthService, JwtStrategy],
+  exports: [AuthService],
+})
+export class AuthModule {}

package/native/src/auth/auth.service.ts

@@ -0,0 +1,62 @@
+import { Injectable, UnauthorizedException, ConflictException, Inject } from '@nestjs/common';
+import { JwtService } from '@nestjs/jwt';
+import { Pool } from 'pg';
+import * as bcrypt from 'bcryptjs';
+import { DB_POOL } from '../database/database.module';
+
+@Injectable()
+export class AuthService {
+  constructor(
+    @Inject(DB_POOL) private readonly pool: Pool, // инжектируем пул БД
+    private readonly jwtService: JwtService,
+  ) {}
+
+  // Регистрация нового пользователя
+  // МЕНЯТЬ: поля dto если у тебя другие поля в таблице users
+  async register(dto: {
+    login: string;
+    password: string;
+    full_name: string; // МЕНЯТЬ: своё поле
+    phone: string;     // МЕНЯТЬ: своё поле
+    email: string;     // МЕНЯТЬ: своё поле
+  }) {
+    // Проверяем что логин не занят
+    const exists = await this.pool.query('SELECT id FROM users WHERE login = $1', [dto.login]);
+    if (exists.rows.length > 0) {
+      throw new ConflictException('Пользователь с таким логином уже существует');
+    }
+
+    // Хешируем пароль (10 — сложность хеширования)
+    const hash = await bcrypt.hash(dto.password, 10);
+
+    // МЕНЯТЬ: поля INSERT и VALUES под свою таблицу users
+    const result = await this.pool.query(
+      `INSERT INTO users (login, password_hash, full_name, phone, email)
+       VALUES ($1, $2, $3, $4, $5) RETURNING id, login, full_name, email, is_admin`,
+      [dto.login, hash, dto.full_name, dto.phone, dto.email],
+    );
+
+    const user = result.rows[0];
+    // Создаём JWT токен с данными пользователя
+    const token = this.jwtService.sign({ id: user.id, login: user.login, is_admin: user.is_admin });
+    return { token, user };
+  }
+
+  // Вход в систему
+  async login(login: string, password: string) {
+    const result = await this.pool.query('SELECT * FROM users WHERE login = $1', [login]);
+    const user = result.rows[0];
+
+    if (!user) throw new UnauthorizedException('Неверный логин или пароль');
+
+    // Сравниваем пароль с хешем в БД
+    const valid = await bcrypt.compare(password, user.password_hash);
+    if (!valid) throw new UnauthorizedException('Неверный логин или пароль');
+
+    const token = this.jwtService.sign({ id: user.id, login: user.login, is_admin: user.is_admin });
+    return {
+      token,
+      user: { id: user.id, login: user.login, full_name: user.full_name, is_admin: user.is_admin },
+    };
+  }
+}

package/native/src/auth/jwt-auth.guard.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+import { AuthGuard } from '@nestjs/passport';
+
+// Guard для проверки JWT-токена на бэкенде
+// Используется как @UseGuards(JwtAuthGuard) над контроллером или отдельным роутом
+// Не менять — работает автоматически через passport-jwt
+@Injectable()
+export class JwtAuthGuard extends AuthGuard('jwt') {}

package/native/src/auth/jwt.strategy.ts

@@ -0,0 +1,20 @@
+import { Injectable } from '@nestjs/common';
+import { PassportStrategy } from '@nestjs/passport';
+import { ExtractJwt, Strategy } from 'passport-jwt';
+
+// Стратегия JWT — читает токен из заголовка Authorization: Bearer <token>
+// Не менять
+@Injectable()
+export class JwtStrategy extends PassportStrategy(Strategy) {
+  constructor() {
+    super({
+      jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
+      secretOrKey: process.env.JWT_SECRET || 'supersecretkey123',
+    });
+  }
+
+  // Возвращает payload токена — доступен через @Request() req как req.user
+  async validate(payload: { id: number; login: string; is_admin: boolean }) {
+    return payload;
+  }
+}

package/native/src/database/database.module.ts

@@ -0,0 +1,26 @@
+import { Module, Global } from '@nestjs/common';
+import { Pool } from 'pg';
+
+export const DB_POOL = 'DB_POOL'; // токен для инжекции пула в сервисы
+
+// Создаём пул подключений к PostgreSQL из .env файла
+const dbProvider = {
+  provide: DB_POOL,
+  useFactory: () => {
+    return new Pool({
+      host: process.env.DB_HOST || 'localhost',
+      port: parseInt(process.env.DB_PORT || '5432'),
+      user: process.env.DB_USER || 'postgres',
+      password: process.env.DB_PASSWORD || 'postgres',
+      database: process.env.DB_NAME || 'examen_db', // МЕНЯТЬ: имя БД в .env
+    });
+  },
+};
+
+// @Global() — модуль доступен во всём приложении без повторного импорта
+@Global()
+@Module({
+  providers: [dbProvider],
+  exports: [dbProvider],
+})
+export class DatabaseModule {}

package/native/src/database/init.sql

@@ -0,0 +1,45 @@
+-- =====================================================
+-- СКРИПТ СОЗДАНИЯ ТАБЛИЦ
+-- Запустить ОДИН РАЗ в pgAdmin → Query Tool
+-- Или через: psql -U postgres -d имя_бд -f init.sql
+-- =====================================================
+
+-- Таблица пользователей — НЕ МЕНЯТЬ структуру (login, password_hash нужны для авторизации)
+CREATE TABLE IF NOT EXISTS users (
+  id SERIAL PRIMARY KEY,
+  login VARCHAR(50) UNIQUE NOT NULL,       -- логин для входа (латиница + цифры)
+  password_hash VARCHAR(255) NOT NULL,     -- bcrypt-хэш пароля
+  full_name VARCHAR(200) NOT NULL,         -- ФИО пользователя
+  phone VARCHAR(20) NOT NULL,              -- телефон формата 8(XXX)XXX-XX-XX
+  email VARCHAR(100) NOT NULL,             -- email
+  is_admin BOOLEAN DEFAULT FALSE,          -- флаг администратора
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- МЕНЯТЬ: 'applications' → своё название таблицы
+-- МЕНЯТЬ: поля course_name, desired_start_date, payment_method → свои поля
+-- МЕНЯТЬ: CHECK (payment_method IN ('cash', 'transfer')) → свои значения
+-- МЕНЯТЬ: CHECK (status IN ('new', 'in_progress', 'completed')) → свои статусы
+CREATE TABLE IF NOT EXISTS applications (
+  id SERIAL PRIMARY KEY,
+  user_id INTEGER REFERENCES users(id) ON DELETE CASCADE, -- НЕ МЕНЯТЬ
+  course_name VARCHAR(200) NOT NULL,                      -- МЕНЯТЬ: своё поле
+  desired_start_date DATE NOT NULL,                       -- МЕНЯТЬ: тип DATE или VARCHAR
+  payment_method VARCHAR(20) NOT NULL CHECK (payment_method IN ('cash', 'transfer')), -- МЕНЯТЬ
+  status VARCHAR(30) DEFAULT 'new' CHECK (status IN ('new', 'in_progress', 'completed')), -- МЕНЯТЬ статусы
+  created_at TIMESTAMP DEFAULT NOW()                      -- НЕ МЕНЯТЬ
+);
+
+-- МЕНЯТЬ: 'reviews' → своё название таблицы (comments, feedback и т.д.)
+-- МЕНЯТЬ: 'review_text TEXT' → своё поле
+-- МЕНЯТЬ: ссылку application_id на свою таблицу заявок
+CREATE TABLE IF NOT EXISTS reviews (
+  id SERIAL PRIMARY KEY,
+  application_id INTEGER REFERENCES applications(id) ON DELETE CASCADE, -- МЕНЯТЬ имя таблицы
+  user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,               -- НЕ МЕНЯТЬ
+  review_text TEXT NOT NULL,                                            -- МЕНЯТЬ имя поля
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- После создания таблиц запустить: node create-admin.js
+-- Это создаст администратора login=Admin, password=KorokNET

package/native/src/main.ts

@@ -0,0 +1,11 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import * as dotenv from 'dotenv';
+dotenv.config(); // загружает .env файл
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.enableCors({ origin: 'http://localhost:4200' }); // МЕНЯТЬ: порт фронтенда
+  await app.listen(process.env.PORT || 3000); // порт бэкенда в .env
+}
+bootstrap();

package/native/src/reviews/reviews.controller.ts

@@ -0,0 +1,30 @@
+import { Controller, Post, Get, Delete, Body, Param, UseGuards, Request } from '@nestjs/common';
+import { ReviewsService } from './reviews.service';
+import { JwtAuthGuard } from '../auth/jwt-auth.guard';
+
+// МЕНЯТЬ: 'reviews' на своё название (например 'comments', 'feedback')
+// @UseGuards(JwtAuthGuard) — все роуты требуют авторизации
+@UseGuards(JwtAuthGuard)
+@Controller('reviews')
+export class ReviewsController {
+  constructor(private readonly svc: ReviewsService) {}
+
+  // POST /reviews — создать отзыв (авторизованный пользователь)
+  // МЕНЯТЬ: поля body под свою тему
+  @Post()
+  create(@Request() req, @Body() body: { application_id: number; review_text: string }) {
+    return this.svc.create(req.user.id, body); // req.user.id — из JWT-токена
+  }
+
+  // GET /reviews/:applicationId — получить отзывы по заявке
+  @Get(':applicationId')
+  findByApplication(@Param('applicationId') id: string) {
+    return this.svc.findByApplication(+id); // +id конвертирует строку в число
+  }
+
+  // DELETE /reviews/:id — удалить отзыв
+  @Delete(':id')
+  delete(@Param('id') id: string) {
+    return this.svc.delete(+id);
+  }
+}

package/native/src/reviews/reviews.module.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { ReviewsController } from './reviews.controller';
+import { ReviewsService } from './reviews.service';
+
+// Модуль отзывов — регистрирует контроллер и сервис
+// МЕНЯТЬ: переименовать класс, контроллер и сервис под свою тему
+// Не забыть добавить этот модуль в app.module.ts → imports
+@Module({
+  controllers: [ReviewsController],
+  providers: [ReviewsService],
+})
+export class ReviewsModule {}

package/native/src/reviews/reviews.service.ts

@@ -0,0 +1,35 @@
+import { Injectable, Inject } from '@nestjs/common';
+import { Pool } from 'pg';
+import { DB_POOL } from '../database/database.module';
+
+// МЕНЯТЬ: переименовать под свою тему (например CommentsService, FeedbackService)
+@Injectable()
+export class ReviewsService {
+  constructor(@Inject(DB_POOL) private readonly pool: Pool) {}
+
+  // CREATE — оставить отзыв
+  // МЕНЯТЬ: таблицу reviews, поля INSERT
+  async create(userId: number, dto: { application_id: number; review_text: string }) {
+    const result = await this.pool.query(
+      `INSERT INTO reviews (application_id, user_id, review_text)
+       VALUES ($1, $2, $3) RETURNING *`,
+      [dto.application_id, userId, dto.review_text],
+    );
+    return result.rows[0];
+  }
+
+  // READ — получить отзывы по записи
+  async findByApplication(applicationId: number) {
+    const result = await this.pool.query(
+      'SELECT * FROM reviews WHERE application_id = $1',
+      [applicationId],
+    );
+    return result.rows;
+  }
+
+  // DELETE — удалить отзыв
+  async delete(id: number) {
+    await this.pool.query('DELETE FROM reviews WHERE id = $1', [id]);
+    return { success: true };
+  }
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "argon2-utils",
+  "version": "1.0.0",
+  "description": "Argon2 hashing utilities for Node.js",
+  "main": "index.js",
+  "types": "./index.d.ts",
+  "keywords": [
+    "argon2",
+    "hashing",
+    "crypto",
+    "password"
+  ],
+  "author": "",
+  "license": "MIT"
+}