11.1K ·GitHub
Что это такое?
Упрощённый клон Jira: веб-приложение с клиентом на React/Babel и API на Node/TypeScript. Его сделал консультант по React как витрину современной, приближенной к реальности кодовой базы на React — чтобы её читали и учились по ней, а не как боевой продукт.
Упрощённый клон Jira: веб-приложение с клиентом на React/Babel и API на Node/TypeScript. Его сделал консультант по React как витрину современной, приближенной к реальности кодовой базы на React — чтобы её читали и учились по ней, а не как боевой продукт.Это работающее приложение, которое можно запустить, или просто пример кода?Это полностью работающее приложение, которое запускается локально: клиент и API стартуют как два отдельных npm-процесса, а данными служит ваша собственная база PostgreSQL. При этом автор всё равно называет его витринным проектом — многих вещей, которые нужны настоящему продукту, там намеренно нет.
Это полностью работающее приложение, которое запускается локально: клиент и API стартуют как два отдельных npm-процесса, а данными служит ваша собственная база PostgreSQL. При этом автор всё равно называет его витринным проектом — многих вещей, которые нужны настоящему продукту, там намеренно нет.Как его запустить?Установите PostgreSQL и создайте базу данных с именем jiradevelopment, клонируйте репозиторий, создайте файл /api/.env на основе .env.example, указав там логин и пароль от вашей базы, затем выполните npm run install-dependencies. Запустите API командой npm start в папке /api, а клиент — командой npm start в папке /client в другой вкладке терминала.
Установите PostgreSQL и создайте базу данных с именем jiradevelopment, клонируйте репозиторий, создайте файл /api/.env на основе .env.example, указав там логин и пароль от вашей базы, затем выполните npm run install-dependencies. Запустите API командой npm start в папке /api, а клиент — командой npm start в папке /client в другой вкладке терминала.Что должно быть установлено заранее?PostgreSQL, а также Node и npm для обоих приложений — больше ничего. Docker и внешние сервисы не используются; просто вписываете данные для подключения к базе в файл /api/.env.
PostgreSQL, а также Node и npm для обоих приложений — больше ничего. Docker и внешние сервисы не используются; просто вписываете данные для подключения к базе в файл /api/.env.Чего не хватает по сравнению с настоящей Jira?Четыре вещи, по словам автора: нет миграций (TypeORM сам создаёт схему при каждом запуске), нет настоящей аутентификации (любой, кто обратится к API без учётных данных, получит токен и демонстрационные данные), неполная доступность для людей с ограниченными возможностями и нет юнит- и интеграционных тестов — только end-to-end тесты на Cypress.
Четыре вещи, по словам автора: нет миграций (TypeORM сам создаёт схему при каждом запуске), нет настоящей аутентификации (любой, кто обратится к API без учётных данных, получит токен и демонстрационные данные), неполная доступность для людей с ограниченными возможностями и нет юнит- и интеграционных тестов — только end-to-end тесты на Cypress.Чем кодовая база на React интересна для изучения?Только функциональные компоненты с хуками, простое управление локальным состоянием без redux или mobx, собственные лёгкие UI-компоненты вроде datepicker, модального окна и элементов форм, а также собственная настройка webpack вместо create-react-app — плюс структура проекта, которую автор называет проверенной и масштабируемой.
Только функциональные компоненты с хуками, простое управление локальным состоянием без redux или mobx, собственные лёгкие UI-компоненты вроде datepicker, модального окна и элементов форм, а также собственная настройка webpack вместо create-react-app — плюс структура проекта, которую автор называет проверенной и масштабируемой.Как тестируется проект?End-to-end тестами на Cypress. Нужно создать вторую базу данных с именем jiratest, запустить API командой npm run start:test и выполнить npm run test:cypress из папки клиента.
End-to-end тестами на Cypress. Нужно создать вторую базу данных с именем jiratest, запустить API командой npm run start:test и выполнить npm run test:cypress из папки клиента.Зачем автор его создал?Он занимается консалтингом по React и считает, что большинство показательных React-проектов слишком простые; он хотел кодовую базу с достаточной сложностью, чтобы она давала ценные знания React-разработчикам любого уровня, оставаясь при этом относительно понятной.
Он занимается консалтингом по React и считает, что большинство показательных React-проектов слишком простые; он хотел кодовую базу с достаточной сложностью, чтобы она давала ценные знания React-разработчикам любого уровня, оставаясь при этом относительно понятной.What are similar projects?realworld, todomvc, TypeScript-React-Starter, open-saas, react-starter-kit, js-stack-from-scratch, core, wasp
realworld, todomvc, TypeScript-React-Starter, open-saas, react-starter-kit, js-stack-from-scratch, core, waspWhich topics is it in?cypress, showcase, project-management, full-stack, hooks, webpack, state-management, examples, ui-components, testing, postgresql, backend
cypress, showcase, project-management, full-stack, hooks, webpack, state-management, examples, ui-components, testing, postgresql, backend