BuildLinkFullstack

Моно-репозиторий для fullstack-проекта BuildLink: современный сервис объявлений с авторизацией, CRUD, поиском и тестами.

О проекте

BuildLink — учебно-боевой pet-проект для демонстрации лучших практик Node.js/Express, SvelteKit, MongoDB, TypeScript, E2E и unit-тестирования. Подходит как основа для реальных сервисов.

Архитектура

• Backend: REST API на Express + MongoDB, JWT-аутентификация, валидация, тесты (Jest, Supertest)
• Frontend: SvelteKit, TailwindCSS, Playwright E2E, современный UI/UX
• Моно-репозиторий: единый git, единые правила оформления, строгий ESLint/Prettier

graph TD;
  A[Пользователь] -- HTTP(S) --> B[Frontend SvelteKit]
  B -- REST --> C[Backend Express]
  C -- MongoDB --> D[(БД)]

Основные возможности

• Регистрация, вход, JWT-сессии
• CRUD объявлений (создание, редактирование, удаление, просмотр)
• Поиск и фильтрация
• Защита API, валидация, обработка ошибок
• E2E и unit-тесты, CI-ready

Технологии

• Node.js 20+, Express, TypeScript, MongoDB, Mongoose
• SvelteKit, TailwindCSS, Playwright, ESLint, Prettier
• Jest, Supertest, mongodb-memory-server

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

git clone https://github.com/FrankFMY/BuildLinkFullstack.git
cd BuildLinkFullstack
# Backend
cd Backend && npm install
# Svelte frontend
cd ../Svelte && npm install

Подробности — в README модулей:

• Backend/README.md
• Svelte/README.md

Структура репозитория

• Backend/ — сервер, API, тесты, документация
• Svelte/ — клиент, UI, E2E, документация
• .gitignore, README.md — служебные файлы

Вклад и развитие

• Любые PR приветствуются! Соблюдайте стиль, пишите тесты, не коммитьте секреты.
• Вопросы и баги — через Issues.

FAQ

• Где переменные окружения? — В файлах .env (см. примеры в модулях)
• Как запустить тесты? — npm test в нужном модуле
• Как деплоить? — Любой Node.js-хостинг, MongoDB Atlas или локально

Проект для демонстрации fullstack-подхода. Используйте, дорабатывайте, делитесь опытом!