kyrylo-burmelov / bsa-2022-guruhub

BSA-2022 | GuruHub

ℹ️ General Info

This is the repository responsible for GuruHub's apps.

🏭 Applications

• Backend — GuruHub's application backend.

  To work properly, fill in the .env file. Use the .env.example file as an example.

• Frontend — GuruHub's application frontend.

  To work properly, fill in the .env file. Use the .env.example file as an example.

• Shared — GuruHub's application common modules for reuse.

🖍 Requirements

• NodeJS (16.x.x);
• NPM (8.x.x);
• PostgreSQL (14.2)
• run npx simple-git-hooks at the root of the project, before the start (it will set the pre-commit hook for any commits).

🏃‍♂️ Simple Start

1. npm run install:all at the root
2. Fill ENVs
3. npx simple-git-hooks at the root
4. npm run start:dev at the root
5. Enjoy <3

Architecture

🏗 Application Schema

TODO

💽 DB Schema

erDiagram
  users {
      int id
      string email
      text  password_hash
      text password_salt
      dateTime created_at
      dateTime updated_at
  }

🧑‍💻 CI

🗜 Tools

🌑 Backend

• Fastify – a backend framework.
• Knex – a query builder.
• Objection – an ORM.

🌕 Frontend

• React – a frontend library.
• Redux + Redux Toolkit – a state manager.

🥊 Code quality

• simple-git-hooks — a tool that lets you easily manage git hooks.
• lint-staged — run linters on git staged files.
• editorconfig — helps maintain consistent coding styles for multiple developers working on the same project across various editors and IDEs.
• prettier — an opinionated code formatter.
• ls-lint — file and directory name linter.
• eslint – find problems in your JS code
• stylelint – Find and fix problems in your CSS code

🗞 Git

📊 Branches

• production - production source code.
• development - staging source code.

🌳 Branch flow

<type>/<project-prefix><ticket-number>-<short-desc>

Types:

• task
• fix

Examples:

• task/design5-add-signin-page
• task/blog12-add-filters
• fix/design16-fix-signup-validation

🗂 Commit flow

<project-prefix>-<ticket-number>: <modifier> <desc>

Modifiers:

• + (add)
• * (edit)
• - (remove)

Examples:

• blog-5: + form component
• design-12: * filter markup
• blog-16: - require prop for nickname field

📦 CD

Handled by GitHub Actions.