AndcultureCode.DotnetReact.Boilerplate

Andculturecode.dotnetreact.boilerplate

Кодовое имя: гравитационные сапоги (GB)

---

Начиная

Технологии

• Dotnet Core 6.0
• Узел 8.16
• NPM 6
• React 16.13
• SQL Server 2017+
• TypeScript 3.8

Настройка разработки

1. Базы данных

SQLServer 2017 (ожидающее утверждение: может быть PostgreSQL)

1. Установите Microsoft SQL Server 2017

2. Создать следующую базу данных

   • Развитие: GravityBootsApi (см. Подробности см. Appsettings.json.)

3. Настройте пользователя.

   • Получите учетные данные из файла appsettings.json , указанного выше.
   • Щелкните правой кнопкой мыши на безопасность, затем выберите «Новый»> «Войти»
     • Добавьте имя входа в систему
     • Выберите аутентификацию SQL Server
       • Добавить пароль
       • Deselect Searce Password Policy и истечение срока действия пароля
   • Выберите роли сервера из выбора страницы
     • Локальная разработка: выберите все
   • Выберите отображение пользователя из выбора страницы
     • Как для разработки, так и для тестовых баз данных:
       • Локальная разработка: выберите все участники роли

2. Бэкэнд: Dotnet Core Csharp

Установите Dotnet Core 3.1 SDK & Runtime

3. Frontend: React TypeScript

Установите Nodejs 8.16 / NPM 6

4. CLI

Существует центральный and-cli используемый для управления сборками, тестами, развертываниями и т. Д. Для различных аспектов проекта.

Установите инструмент and-cli найденный по адресу andcultureCode.cli

Ниже приведены несколько основ, которые вы можете начать, но есть еще много команд и вариантов управления этим и другими проектами, найденными в and-cli .

• and-cli dotnet --restore -восстановить решение Dotnet
• and-cli dotnet - Продолжительный проект Бэкэнд
• and-cli dotnet-test --by-project -Продолжая Бэкэнд Автоматизированные тесты
• and-cli dotnet -- --cli test db migrate -Migrate тестовую базу данных (очистите и восстановите проект перед запуском. Готово с: and-cli dotnet -cRb )
• and-cli migration --add MigrationName -генерирует миграцию базы данных EF CORE на основе изменений в первом коде.
• and-cli migration --run MigrationName -запускает (или возвращается) указанную миграцию базы данных EF Core Migration
• and-cli webpack - Floundend Frontend
• and-cli webpack-test -Запуск тестов на фронта
• and-cli webpack --restore -восстановить зависимости NPM для Frontend
• npm run all-tests - запускает все тестовые наборы (Backend, функциональный, фронт) и запускает сборку рассказов (запустите от корня репо)
• cd frontend && npm run cypress:open - Run Function Test Suite Интерактивно
• cd frontend && npm run cypress:open:working - Запустите функциональный набор тестов интерактивно против работы
• cd frontend && npm run cypress:run - run function test suite без головы.
• cd frontend && npm run cypress:run:working - run funcation test suite без головы.
• cd frontend && npm run test:debug -Запускает подключение к веб-сокетам для простой редакции независимой интерактивной отладки https://create-react-app.dev/docs/debugging-tests/

5. Начало работы

Восстановите пакеты Dotnet (только в первый раз)

 and-cli dotnet --restore

Восстановить модули узлов NPM (только в первый раз)

 and-cli webpack --restore

Запустить сервер dotnet

 and-cli dotnet

Запустить сервер WebPack

 and-cli webpack

Откройте свой браузер и перейдите к:

 https://localhost:5001

Документация

Инженерная документация

Инженерная документация охватывает кодовую базу (то есть шаблоны, стиль и лучшие практики), разработку программного обеспечения, создание и развертывание проекта.

• Архитектура
• Фоновые работы: Hangfire
• Кэширование
• Кодовые конвенции
• Сущности
• Фронтальная архитектура
• GIT Workflow
• Схема
• Общий фоновый механизм работы
• Сборник рассказов / Kop
• Документация по чванству

Внешние ресурсы

Внешние ресурсы охватывают требования, архитектуру, проектирование и управление проектами высокого уровня для проекта.

• Документация API
• Джира

Добавление документации

• Вот наше руководство по стилю документации и шаблон для начала.
• Документация должна быть написана с помощью Markdown и должна иметь расширение .md . Bitbucket имеет руководство по синтаксису Markdown для справки.
• Для получения информации о написании документов, перейдите, чтобы написать документы.

Участники

Спасибо этим замечательным людям (ключ эмодзи):

Уинтон Дешонг ️ ? ?

Брэндон Скотт ️ ?

Дилан Джастис ️ ?

Стефани Лейтч ?

Этот проект следует за спецификацией всех контролей. Взносы любого вида приветствуются!