React + Django based web portal for editing RSForm schemas. This readme file is used mostly to document project dependencies # ❤️ Contributing notes !BEFORE PUSHING INTO MAIN! - use Test config in VSCode to run tests before pushing commits / requests - cd rsconcept/frontend & npm run build # ✨ Frontend stack & Tooling [Vite + React + Typescript]

npm install

  - axios
  - clsx
  - react-icons
  - react-router-dom 
  - react-toastify
  - react-loader-spinner
  - react-tabs
  - react-intl
  - react-select
  - react-error-boundary
  - react-pdf
  - react-tooltip
  - js-file-download
  - framer-motion
  - reagraph
  - @tanstack/react-table
  - @uiw/react-codemirror
  - @uiw/codemirror-themes
  - @lezer/lr

npm install -D

  - tailwindcss
  - postcss
  - autoprefixer
  - eslint-plugin-simple-import-sort
  - eslint-plugin-tsdoc
  - jest
  - ts-jest
  - @types/jest
  - @lezer/generator

VS Code plugins

  - ESLint
  - Colorize
  - Code Spell Checker (eng + rus)
  - Backticks
  - Svg Preview
  - TODO Highlight v2

Google fonts

  - Fira Code
  - Rubik
  - Geologica
  - Noto Sans Math

# ✨ Backend stack & Tooling [Django + PostgreSQL/SQLite] - [ConceptCore](https://github.com/IRBorisov/ConceptCore)

requirements

  - django
  - djangorestframework
  - django-cors-headers
  - django-filter
  - drf-spectacular
  - tzdata
  - gunicorn
  - coreapi
  - psycopg2-binary
  - pymorphy3
  - razdel

requirements_dev

  - coverage
  - pylint
  - mypy
  - djangorestframework-stubs[compatible-mypy]

VS Code plugins

  - Pylance
  - Pylint
  - Django

# ✨ DevOps - Docker compose - PowerShell - Certbot - Docker VSCode extension # Developer Notes ## 🔭 Local build (Windows 10+) - this is main developers build - Install Python 3.12, NodeJS, VSCode, Docker Desktop - copy import wheels from ConceptCore to rsconcept/backend/import - run rsconcept/backend/LocalEnvSetup.ps1 - use VSCode configs in root folder to start development ## 🔭 Development build - this build does not use HTTPS and nginx for networking - backend and frontend debugging is supported - hmr (hot updates) for frontend - run via 'docker compose -f "docker-compose-dev.yml" up --build -d' - populate initial data: 'scripts/dev/PopulateDevData.ps1' ## Local production build - this build is same as production except not using production secrets and working on localhost - provide TLS certificate (can be self-signed) 'nginx/cert/local-cert.pem' and 'nginx/cert/local-key.pem' - run via 'docker compose -f "docker-compose-prod-local.yml" up --build -d' ## 📦 Production build - provide proper pyconcept wheel (ConceptCore) at 'rsconcept/backend/import/\*.whl' - provide secrets: 'secrets/db_password.txt', 'django_key.txt', 'email_host.txt', 'email_password.txt', 'email_user.txt' - check if you need to change SSL/TLS and PORT in 'rsconcept\backend\.env.prod' - setup domain names for application and API in configs: 'frontend\env\.env.production', 'rsconcept\backend\.env.dev', 'nginx\production.conf' - provide privacy policy document in PDF: 'frontend/public/privacy.pdf' - use certbot to obtain certificates via 'docker compose -f "docker-compose-prod.yml" run --rm certbot certonly --webroot --webroot-path /var/www/certbot/ -d portal.acconcept.ru api.portal.acconcept.ru' - run via 'docker compose -f "docker-compose-prod.yml" up --build -d' - update via 'bash scripts/prod/UpdateProd.sh'