From ccf249b8002517da83bcbee25de3301b3377186c Mon Sep 17 00:00:00 2001 From: Flatlogic Bot Date: Tue, 12 May 2026 13:29:30 +0000 Subject: [PATCH] Initial version --- .cursorrules | 305 + .dockerignore | 3 + .gitignore | 3 + .perm_test_apache | 0 .perm_test_exec | 0 502.html | 187 + Dockerfile | 21 + Dockerfile.dev | 85 + LICENSE | 1 + README.md | 244 + backend/.env | 1 + backend/.eslintignore | 4 + backend/.eslintrc.cjs | 15 + backend/.prettierrc | 11 + backend/.sequelizerc | 7 + backend/Dockerfile | 23 + backend/README.md | 56 + backend/package.json | 56 + backend/src/ai/LocalAIApi.js | 484 ++ backend/src/auth/auth.js | 68 + backend/src/config.js | 79 + backend/src/db/api/account_price_lists.js | 494 ++ backend/src/db/api/accounts.js | 647 +++ backend/src/db/api/cart_items.js | 533 ++ backend/src/db/api/carts.js | 544 ++ backend/src/db/api/contacts.js | 586 ++ backend/src/db/api/file.js | 87 + backend/src/db/api/inventory_items.js | 533 ++ backend/src/db/api/locations.js | 652 +++ backend/src/db/api/order_items.js | 553 ++ backend/src/db/api/orders.js | 838 +++ backend/src/db/api/permissions.js | 348 ++ backend/src/db/api/price_list_items.js | 583 ++ backend/src/db/api/price_lists.js | 518 ++ backend/src/db/api/product_categories.js | 435 ++ backend/src/db/api/products.js | 899 +++ backend/src/db/api/quote_items.js | 533 ++ backend/src/db/api/quotes.js | 697 +++ backend/src/db/api/roles.js | 418 ++ backend/src/db/api/sample_requests.js | 651 +++ backend/src/db/api/saved_list_items.js | 459 ++ backend/src/db/api/saved_lists.js | 470 ++ backend/src/db/api/shipments.js | 583 ++ backend/src/db/api/users.js | 974 ++++ backend/src/db/db.config.js | 33 + backend/src/db/migrations/1778156123354.js | 5080 +++++++++++++++++ .../migrations/20260316000000-create-files.js | 124 + ...ate-users-custom-permissions-join-table.js | 77 + backend/src/db/models/account_price_lists.js | 120 + backend/src/db/models/accounts.js | 259 + backend/src/db/models/cart_items.js | 124 + backend/src/db/models/carts.js | 152 + backend/src/db/models/contacts.js | 172 + backend/src/db/models/file.js | 53 + backend/src/db/models/index.js | 38 + backend/src/db/models/inventory_items.js | 123 + backend/src/db/models/locations.js | 221 + backend/src/db/models/order_items.js | 152 + backend/src/db/models/orders.js | 250 + backend/src/db/models/permissions.js | 87 + backend/src/db/models/price_list_items.js | 131 + backend/src/db/models/price_lists.js | 161 + backend/src/db/models/product_categories.js | 120 + backend/src/db/models/products.js | 306 + backend/src/db/models/quote_items.js | 124 + backend/src/db/models/quotes.js | 193 + backend/src/db/models/roles.js | 120 + backend/src/db/models/sample_requests.js | 175 + backend/src/db/models/saved_list_items.js | 110 + backend/src/db/models/saved_lists.js | 140 + backend/src/db/models/shipments.js | 170 + backend/src/db/models/users.js | 301 + backend/src/db/reset.js | 16 + .../db/seeders/20200430130759-admin-user.js | 66 + .../db/seeders/20200430130760-user-roles.js | 2479 ++++++++ .../db/seeders/20231127130745-sample-data.js | 12 + .../20260507130000-buyer-portal-demo-data.js | 1783 ++++++ backend/src/db/utils.js | 27 + backend/src/helpers.js | 23 + backend/src/index.js | 215 + backend/src/middlewares/check-permissions.js | 149 + backend/src/middlewares/upload.js | 11 + backend/src/routes/account_price_lists.js | 426 ++ backend/src/routes/accounts.js | 443 ++ backend/src/routes/auth.js | 207 + backend/src/routes/buyer_portal.js | 87 + backend/src/routes/cart_items.js | 438 ++ backend/src/routes/carts.js | 433 ++ backend/src/routes/contactForm.js | 0 backend/src/routes/contacts.js | 438 ++ backend/src/routes/file.js | 32 + backend/src/routes/integrations.js | 85 + backend/src/routes/inventory_items.js | 438 ++ backend/src/routes/locations.js | 451 ++ backend/src/routes/openai.js | 328 ++ backend/src/routes/order_items.js | 439 ++ backend/src/routes/orders.js | 452 ++ backend/src/routes/organizationLogin.js | 2 + backend/src/routes/permissions.js | 429 ++ backend/src/routes/pexels.js | 104 + backend/src/routes/price_list_items.js | 435 ++ backend/src/routes/price_lists.js | 433 ++ backend/src/routes/product_categories.js | 432 ++ backend/src/routes/products.js | 467 ++ backend/src/routes/quote_items.js | 438 ++ backend/src/routes/quotes.js | 436 ++ backend/src/routes/roles.js | 429 ++ backend/src/routes/sample_requests.js | 436 ++ backend/src/routes/saved_list_items.js | 432 ++ backend/src/routes/saved_lists.js | 433 ++ backend/src/routes/search.js | 52 + backend/src/routes/shipments.js | 434 ++ backend/src/routes/sql.js | 61 + backend/src/routes/users.js | 440 ++ backend/src/services/account_price_lists.js | 138 + backend/src/services/accounts.js | 138 + backend/src/services/auth.js | 312 + backend/src/services/buyer_portal.js | 1303 +++++ backend/src/services/cart_items.js | 138 + backend/src/services/carts.js | 138 + backend/src/services/contacts.js | 138 + .../emailAddressVerification.html | 52 + .../invitation/invitationTemplate.html | 55 + .../passwordReset/passwordResetEmail.html | 52 + backend/src/services/email/index.js | 44 + .../email/list/addressVerification.js | 38 + backend/src/services/email/list/invitation.js | 37 + .../src/services/email/list/passwordReset.js | 38 + backend/src/services/file.js | 213 + backend/src/services/integrations.js | 535 ++ backend/src/services/inventory_items.js | 138 + backend/src/services/locations.js | 138 + .../notifications/errors/forbidden.js | 17 + .../notifications/errors/validation.js | 18 + backend/src/services/notifications/helpers.js | 35 + backend/src/services/notifications/list.js | 104 + backend/src/services/openai.js | 80 + backend/src/services/order_items.js | 138 + backend/src/services/orders.js | 138 + backend/src/services/permissions.js | 138 + backend/src/services/price_list_items.js | 138 + backend/src/services/price_lists.js | 138 + backend/src/services/product_categories.js | 138 + backend/src/services/products.js | 138 + backend/src/services/quote_items.js | 138 + backend/src/services/quotes.js | 138 + backend/src/services/roles.js | 437 ++ backend/src/services/sample_requests.js | 138 + backend/src/services/saved_list_items.js | 138 + backend/src/services/saved_lists.js | 138 + backend/src/services/search.js | 575 ++ backend/src/services/shipments.js | 138 + backend/src/services/users.js | 171 + backend/watcher.js | 49 + backend/yarn.lock | 4470 +++++++++++++++ docker/.gitignore | 1 + docker/README.md | 46 + docker/docker-compose.yml | 58 + docker/start-backend.sh | 2 + docker/wait-for-it.sh | 182 + frontend/.eslintignore | 3 + frontend/.eslintrc.cjs | 25 + frontend/.gitignore | 33 + frontend/.prettierrc | 10 + frontend/Dockerfile | 19 + frontend/LICENSE-justboil | 21 + frontend/README.md | 92 + frontend/next-env.d.ts | 6 + frontend/next.config.mjs | 32 + frontend/package.json | 79 + frontend/postcss.config.js | 9 + frontend/prettier.config.js | 13 + frontend/public/data-sources/clients.json | 1 + frontend/public/data-sources/history.json | 1 + frontend/public/favicon.svg | 27 + frontend/public/locales/de/common.json | 55 + .../public/locales/en-GB/translation.json | 1 + .../public/locales/en-US/translation.json | 1 + frontend/public/locales/en/common.json | 52 + frontend/public/locales/en/translation.json | 1 + frontend/public/locales/es/common.json | 55 + frontend/public/locales/fr/common.json | 55 + frontend/src/._colors.ts | Bin 0 -> 163 bytes frontend/src/._menuAside.ts | Bin 0 -> 163 bytes frontend/src/._styles.ts | Bin 0 -> 163 bytes frontend/src/colors.ts | 145 + frontend/src/components/._AsideMenu.tsx | Bin 0 -> 163 bytes frontend/src/components/._AsideMenuItem.tsx | Bin 0 -> 163 bytes frontend/src/components/._AsideMenuLayer.tsx | Bin 0 -> 163 bytes frontend/src/components/._AsideMenuList.tsx | Bin 0 -> 163 bytes frontend/src/components/._CardBox.tsx | Bin 0 -> 163 bytes frontend/src/components/._FooterBar.tsx | Bin 0 -> 163 bytes frontend/src/components/._NavBar.tsx | Bin 0 -> 163 bytes frontend/src/components/._NavBarItem.tsx | Bin 0 -> 163 bytes frontend/src/components/._NavBarItemPlain.tsx | Bin 0 -> 163 bytes frontend/src/components/._Search.tsx | Bin 0 -> 163 bytes frontend/src/components/._SectionMain.tsx | Bin 0 -> 163 bytes .../._SectionTitleLineWithButton.tsx | Bin 0 -> 163 bytes .../CardAccount_price_lists.tsx | 159 + .../ListAccount_price_lists.tsx | 120 + .../TableAccount_price_lists.tsx | 463 ++ .../configureAccount_price_listsCols.tsx | 164 + .../src/components/Accounts/CardAccounts.tsx | 231 + .../src/components/Accounts/ListAccounts.tsx | 168 + .../src/components/Accounts/TableAccounts.tsx | 463 ++ .../Accounts/configureAccountsCols.tsx | 172 + frontend/src/components/AsideMenu.tsx | 32 + frontend/src/components/AsideMenuItem.tsx | 108 + frontend/src/components/AsideMenuLayer.tsx | 97 + frontend/src/components/AsideMenuList.tsx | 37 + frontend/src/components/BaseButton.tsx | 96 + frontend/src/components/BaseButtons.tsx | 38 + frontend/src/components/BaseDivider.tsx | 14 + frontend/src/components/BaseIcon.tsx | 32 + frontend/src/components/BigCalendar.tsx | 175 + frontend/src/components/CardBox.tsx | 70 + .../src/components/CardBoxComponentBody.tsx | 12 + .../src/components/CardBoxComponentEmpty.tsx | 11 + .../src/components/CardBoxComponentFooter.tsx | 10 + .../src/components/CardBoxComponentTitle.tsx | 17 + frontend/src/components/CardBoxModal.tsx | 59 + .../components/Cart_items/CardCart_items.tsx | 171 + .../components/Cart_items/ListCart_items.tsx | 128 + .../components/Cart_items/TableCart_items.tsx | 463 ++ .../Cart_items/configureCart_itemsCols.tsx | 175 + frontend/src/components/Carts/CardCarts.tsx | 183 + frontend/src/components/Carts/ListCarts.tsx | 136 + frontend/src/components/Carts/TableCarts.tsx | 505 ++ .../components/Carts/configureCartsCols.tsx | 197 + .../src/components/ChartLineSample/config.ts | 54 + .../src/components/ChartLineSample/index.tsx | 37 + frontend/src/components/ClickOutside.tsx | 35 + .../src/components/Contacts/CardContacts.tsx | 219 + .../src/components/Contacts/ListContacts.tsx | 160 + .../src/components/Contacts/TableContacts.tsx | 463 ++ .../Contacts/configureContactsCols.tsx | 236 + .../src/components/DataGridMultiSelect.tsx | 55 + frontend/src/components/DevModeBadge.tsx | 150 + .../src/components/DragDropFilePicker.tsx | 124 + frontend/src/components/ErrorBoundary.tsx | 118 + frontend/src/components/FooterBar.tsx | 31 + frontend/src/components/FormCheckRadio.tsx | 20 + .../src/components/FormCheckRadioGroup.tsx | 20 + frontend/src/components/FormField.tsx | 80 + frontend/src/components/FormFilePicker.tsx | 92 + frontend/src/components/FormImagePicker.tsx | 90 + frontend/src/components/IconRounded.tsx | 34 + frontend/src/components/ImageField.tsx | 51 + frontend/src/components/IntroGuide.tsx | 55 + .../Inventory_items/CardInventory_items.tsx | 171 + .../Inventory_items/ListInventory_items.tsx | 128 + .../Inventory_items/TableInventory_items.tsx | 463 ++ .../configureInventory_itemsCols.tsx | 171 + .../components/KanbanBoard/KanbanBoard.tsx | 51 + .../src/components/KanbanBoard/KanbanCard.tsx | 64 + .../components/KanbanBoard/KanbanColumn.tsx | 209 + frontend/src/components/LanguageSwitcher.tsx | 96 + .../src/components/ListActionsPopover.tsx | 115 + frontend/src/components/LoadingSpinner.tsx | 18 + .../components/Locations/CardLocations.tsx | 243 + .../components/Locations/ListLocations.tsx | 176 + .../components/Locations/TableLocations.tsx | 463 ++ .../Locations/configureLocationsCols.tsx | 263 + frontend/src/components/Logo/index.tsx | 15 + frontend/src/components/NavBar.tsx | 60 + frontend/src/components/NavBarItem.tsx | 132 + frontend/src/components/NavBarItemPlain.tsx | 26 + frontend/src/components/NavBarMenuList.tsx | 19 + frontend/src/components/NotificationBar.tsx | 57 + .../Order_items/CardOrder_items.tsx | 183 + .../Order_items/ListOrder_items.tsx | 136 + .../Order_items/TableOrder_items.tsx | 463 ++ .../Order_items/configureOrder_itemsCols.tsx | 190 + frontend/src/components/Orders/CardOrders.tsx | 291 + frontend/src/components/Orders/ListOrders.tsx | 208 + .../src/components/Orders/TableOrders.tsx | 513 ++ .../components/Orders/configureOrdersCols.tsx | 342 ++ frontend/src/components/OverlayLayer.tsx | 41 + frontend/src/components/Pagination.tsx | 85 + .../src/components/PasswordSetOrReset.tsx | 113 + .../Permissions/CardPermissions.tsx | 111 + .../Permissions/ListPermissions.tsx | 88 + .../Permissions/TablePermissions.tsx | 463 ++ .../Permissions/configurePermissionsCols.tsx | 83 + .../Price_list_items/CardPrice_list_items.tsx | 183 + .../Price_list_items/ListPrice_list_items.tsx | 136 + .../TablePrice_list_items.tsx | 463 ++ .../configurePrice_list_itemsCols.tsx | 196 + .../Price_lists/CardPrice_lists.tsx | 171 + .../Price_lists/ListPrice_lists.tsx | 128 + .../Price_lists/TablePrice_lists.tsx | 489 ++ .../Price_lists/configurePrice_listsCols.tsx | 112 + .../CardProduct_categories.tsx | 147 + .../ListProduct_categories.tsx | 112 + .../TableProduct_categories.tsx | 476 ++ .../configureProduct_categoriesCols.tsx | 136 + .../src/components/Products/CardProducts.tsx | 241 + .../src/components/Products/ListProducts.tsx | 250 + .../Products/ProductSkuFormContent.tsx | 268 + .../src/components/Products/TableProducts.tsx | 476 ++ .../Products/configureProductsCols.tsx | 382 ++ .../Quote_items/CardQuote_items.tsx | 171 + .../Quote_items/ListQuote_items.tsx | 128 + .../Quote_items/TableQuote_items.tsx | 463 ++ .../Quote_items/configureQuote_itemsCols.tsx | 175 + frontend/src/components/Quotes/CardQuotes.tsx | 238 + frontend/src/components/Quotes/ListQuotes.tsx | 175 + .../src/components/Quotes/TableQuotes.tsx | 511 ++ .../components/Quotes/configureQuotesCols.tsx | 198 + frontend/src/components/RichTextField.tsx | 27 + frontend/src/components/Roles/CardRoles.tsx | 123 + frontend/src/components/Roles/ListRoles.tsx | 96 + frontend/src/components/Roles/TableRoles.tsx | 463 ++ .../components/Roles/configureRolesCols.tsx | 103 + .../Sample_requests/CardSample_requests.tsx | 219 + .../Sample_requests/ListSample_requests.tsx | 160 + .../Sample_requests/TableSample_requests.tsx | 513 ++ .../configureSample_requestsCols.tsx | 253 + .../Saved_list_items/CardSaved_list_items.tsx | 147 + .../Saved_list_items/ListSaved_list_items.tsx | 112 + .../TableSaved_list_items.tsx | 463 ++ .../configureSaved_list_itemsCols.tsx | 143 + .../Saved_lists/CardSaved_lists.tsx | 159 + .../Saved_lists/ListSaved_lists.tsx | 120 + .../Saved_lists/TableSaved_lists.tsx | 476 ++ .../Saved_lists/configureSaved_listsCols.tsx | 157 + frontend/src/components/Search.tsx | 51 + frontend/src/components/SearchResults.tsx | 83 + frontend/src/components/SectionFullScreen.tsx | 27 + frontend/src/components/SectionMain.tsx | 14 + frontend/src/components/SectionTitle.tsx | 27 + .../components/SectionTitleLineWithButton.tsx | 51 + frontend/src/components/SelectField.tsx | 53 + frontend/src/components/SelectFieldMany.tsx | 67 + .../components/Shipments/CardShipments.tsx | 202 + .../components/Shipments/ListShipments.tsx | 151 + .../components/Shipments/TableShipments.tsx | 489 ++ .../Shipments/configureShipmentsCols.tsx | 212 + .../components/SmartWidget/SmartWidget.tsx | 99 + .../SmartWidget/components/AreaChart.tsx | 18 + .../components/AreaChart/ApexAreaChart.tsx | 135 + .../components/AreaChart/ChartJSAreaChart.tsx | 96 + .../SmartWidget/components/BarChart.tsx | 18 + .../components/BarChart/ApexBarChart.tsx | 131 + .../components/BarChart/ChartJSBarChart.tsx | 92 + .../SmartWidget/components/FunnelChart.tsx | 134 + .../SmartWidget/components/LineChart.tsx | 18 + .../components/LineChart/ApexLineChart.tsx | 135 + .../components/LineChart/ChartJSLineChart.tsx | 97 + .../SmartWidget/components/PieChart.tsx | 18 + .../components/PieChart/ApexPieChart.tsx | 106 + .../components/PieChart/ChartJSPieChart.tsx | 81 + .../SmartWidget/models/widget.model.ts | 35 + .../components/SmartWidget/widgetHelpers.tsx | 36 + frontend/src/components/SwitchField.tsx | 22 + .../src/components/TableSampleClients.tsx | 141 + .../src/components/Uploaders/FilesUploader.js | 150 + .../components/Uploaders/ImagesUploader.js | 237 + .../src/components/Uploaders/UploadService.js | 79 + frontend/src/components/UserAvatar.tsx | 46 + .../src/components/UserAvatarCurrentUser.tsx | 43 + frontend/src/components/UserCard.tsx | 49 + frontend/src/components/Users/CardUsers.tsx | 208 + frontend/src/components/Users/ListUsers.tsx | 155 + frontend/src/components/Users/TableUsers.tsx | 463 ++ .../components/Users/configureUsersCols.tsx | 207 + .../components/WidgetCreator/RoleSelect.tsx | 53 + .../WidgetCreator/WidgetCreator.tsx | 140 + frontend/src/config.ts | 15 + frontend/src/css/.__table.css | Bin 0 -> 163 bytes frontend/src/css/_app.css | 32 + frontend/src/css/_calendar.css | 39 + frontend/src/css/_checkbox-radio-switch.css | 59 + frontend/src/css/_helper.css | 23 + frontend/src/css/_progress.css | 21 + frontend/src/css/_rich-text.css | 1 + frontend/src/css/_scrollbars.css | 41 + frontend/src/css/_select-dropdown.css | 31 + frontend/src/css/_table.css | 117 + frontend/src/css/_theme.css | 103 + frontend/src/css/main.css | 35 + frontend/src/css/tailwind/_base.css | 1 + frontend/src/css/tailwind/_components.css | 1 + frontend/src/css/tailwind/_utilities.css | 1 + frontend/src/helpers/dataFormatter.js | 333 ++ frontend/src/helpers/fileSaver.ts | 6 + frontend/src/helpers/humanize.ts | 11 + frontend/src/helpers/notifyStateHandler.ts | 31 + frontend/src/helpers/pexels.ts | 76 + frontend/src/helpers/userPermissions.ts | 21 + frontend/src/hooks/sampleData.ts | 22 + frontend/src/hooks/useDevCompilationStatus.ts | 44 + frontend/src/i18n.ts | 21 + frontend/src/interfaces/index.ts | 109 + frontend/src/layouts/._Authenticated.tsx | Bin 0 -> 163 bytes frontend/src/layouts/Authenticated.tsx | 167 + frontend/src/layouts/BuyerPortal.tsx | 138 + frontend/src/layouts/Guest.tsx | 17 + frontend/src/menuAside.ts | 278 + frontend/src/menuNavBar.ts | 53 + frontend/src/pages/_app.tsx | 201 + .../[account_price_listsId].tsx | 560 ++ .../account_price_lists-edit.tsx | 557 ++ .../account_price_lists-list.tsx | 170 + .../account_price_lists-new.tsx | 338 ++ .../account_price_lists-table.tsx | 172 + .../account_price_lists-view.tsx | 382 ++ frontend/src/pages/accounts/[accountsId].tsx | 943 +++ frontend/src/pages/accounts/accounts-edit.tsx | 940 +++ frontend/src/pages/accounts/accounts-list.tsx | 329 ++ frontend/src/pages/accounts/accounts-new.tsx | 649 +++ .../src/pages/accounts/accounts-table.tsx | 171 + frontend/src/pages/accounts/accounts-view.tsx | 419 ++ frontend/src/pages/api/hello.js | 5 + frontend/src/pages/api/logError.ts | 83 + frontend/src/pages/buyer-login.tsx | 32 + frontend/src/pages/buyer-portal.tsx | 2835 +++++++++ .../src/pages/cart_items/[cart_itemsId].tsx | 612 ++ .../src/pages/cart_items/cart_items-edit.tsx | 609 ++ .../src/pages/cart_items/cart_items-list.tsx | 170 + .../src/pages/cart_items/cart_items-new.tsx | 386 ++ .../src/pages/cart_items/cart_items-table.tsx | 172 + .../src/pages/cart_items/cart_items-view.tsx | 394 ++ frontend/src/pages/carts/[cartsId].tsx | 734 +++ frontend/src/pages/carts/carts-edit.tsx | 731 +++ frontend/src/pages/carts/carts-list.tsx | 176 + frontend/src/pages/carts/carts-new.tsx | 434 ++ frontend/src/pages/carts/carts-table.tsx | 176 + frontend/src/pages/carts/carts-view.tsx | 557 ++ frontend/src/pages/contacts/[contactsId].tsx | 870 +++ frontend/src/pages/contacts/contacts-edit.tsx | 867 +++ frontend/src/pages/contacts/contacts-list.tsx | 170 + frontend/src/pages/contacts/contacts-new.tsx | 588 ++ .../src/pages/contacts/contacts-table.tsx | 172 + frontend/src/pages/contacts/contacts-view.tsx | 670 +++ frontend/src/pages/dashboard.tsx | 1235 ++++ frontend/src/pages/error.tsx | 35 + frontend/src/pages/forgot.tsx | 82 + frontend/src/pages/forms.tsx | 142 + frontend/src/pages/index.tsx | 652 +++ frontend/src/pages/integrations.tsx | 545 ++ .../inventory_items/[inventory_itemsId].tsx | 572 ++ .../inventory_items/inventory_items-edit.tsx | 569 ++ .../inventory_items/inventory_items-list.tsx | 166 + .../inventory_items/inventory_items-new.tsx | 397 ++ .../inventory_items/inventory_items-table.tsx | 168 + .../inventory_items/inventory_items-view.tsx | 355 ++ .../src/pages/locations/[locationsId].tsx | 1001 ++++ .../src/pages/locations/locations-edit.tsx | 998 ++++ .../src/pages/locations/locations-list.tsx | 170 + .../src/pages/locations/locations-new.tsx | 692 +++ .../src/pages/locations/locations-table.tsx | 172 + .../src/pages/locations/locations-view.tsx | 1162 ++++ frontend/src/pages/login.tsx | 374 ++ .../src/pages/order_items/[order_itemsId].tsx | 686 +++ .../pages/order_items/order_items-edit.tsx | 683 +++ .../pages/order_items/order_items-list.tsx | 170 + .../src/pages/order_items/order_items-new.tsx | 447 ++ .../pages/order_items/order_items-table.tsx | 172 + .../pages/order_items/order_items-view.tsx | 426 ++ frontend/src/pages/orders/[ordersId].tsx | 1343 +++++ frontend/src/pages/orders/orders-edit.tsx | 1340 +++++ frontend/src/pages/orders/orders-list.tsx | 679 +++ frontend/src/pages/orders/orders-new.tsx | 908 +++ frontend/src/pages/orders/orders-table.tsx | 175 + frontend/src/pages/orders/orders-view.tsx | 541 ++ frontend/src/pages/password-reset.tsx | 12 + .../src/pages/permissions/[permissionsId].tsx | 187 + .../pages/permissions/permissions-edit.tsx | 184 + .../pages/permissions/permissions-list.tsx | 162 + .../src/pages/permissions/permissions-new.tsx | 143 + .../pages/permissions/permissions-table.tsx | 160 + .../pages/permissions/permissions-view.tsx | 139 + .../price_list_items/[price_list_itemsId].tsx | 694 +++ .../price_list_items-edit.tsx | 691 +++ .../price_list_items-list.tsx | 170 + .../price_list_items/price_list_items-new.tsx | 444 ++ .../price_list_items-table.tsx | 172 + .../price_list_items-view.tsx | 443 ++ .../src/pages/price_lists/[price_listsId].tsx | 521 ++ .../pages/price_lists/price_lists-edit.tsx | 518 ++ .../pages/price_lists/price_lists-list.tsx | 298 + .../src/pages/price_lists/price_lists-new.tsx | 408 ++ .../pages/price_lists/price_lists-table.tsx | 164 + .../pages/price_lists/price_lists-view.tsx | 592 ++ frontend/src/pages/privacy-policy.tsx | 292 + .../[product_categoriesId].tsx | 427 ++ .../product_categories-edit.tsx | 424 ++ .../product_categories-list.tsx | 170 + .../product_categories-new.tsx | 285 + .../product_categories-table.tsx | 168 + .../product_categories-view.tsx | 478 ++ frontend/src/pages/products/[productsId].tsx | 1417 +++++ frontend/src/pages/products/products-edit.tsx | 109 + frontend/src/pages/products/products-list.tsx | 354 ++ frontend/src/pages/products/products-new.tsx | 77 + .../src/pages/products/products-table.tsx | 166 + frontend/src/pages/products/products-view.tsx | 1342 +++++ frontend/src/pages/profile.tsx | 470 ++ .../src/pages/quote_items/[quote_itemsId].tsx | 612 ++ .../pages/quote_items/quote_items-edit.tsx | 609 ++ .../pages/quote_items/quote_items-list.tsx | 170 + .../src/pages/quote_items/quote_items-new.tsx | 386 ++ .../pages/quote_items/quote_items-table.tsx | 172 + .../pages/quote_items/quote_items-view.tsx | 394 ++ frontend/src/pages/quotes/[quotesId].tsx | 1065 ++++ frontend/src/pages/quotes/quotes-edit.tsx | 1062 ++++ frontend/src/pages/quotes/quotes-list.tsx | 340 ++ frontend/src/pages/quotes/quotes-new.tsx | 648 +++ frontend/src/pages/quotes/quotes-table.tsx | 180 + frontend/src/pages/quotes/quotes-view.tsx | 750 +++ frontend/src/pages/register.tsx | 92 + frontend/src/pages/roles/[rolesId].tsx | 300 + frontend/src/pages/roles/roles-edit.tsx | 297 + frontend/src/pages/roles/roles-list.tsx | 162 + frontend/src/pages/roles/roles-new.tsx | 195 + frontend/src/pages/roles/roles-table.tsx | 160 + frontend/src/pages/roles/roles-view.tsx | 340 ++ .../sample_requests/[sample_requestsId].tsx | 993 ++++ .../sample_requests/sample_requests-edit.tsx | 990 ++++ .../sample_requests/sample_requests-list.tsx | 448 ++ .../sample_requests/sample_requests-new.tsx | 590 ++ .../sample_requests/sample_requests-table.tsx | 180 + .../sample_requests/sample_requests-view.tsx | 521 ++ .../saved_list_items/[saved_list_itemsId].tsx | 480 ++ .../saved_list_items-edit.tsx | 477 ++ .../saved_list_items-list.tsx | 170 + .../saved_list_items/saved_list_items-new.tsx | 282 + .../saved_list_items-table.tsx | 172 + .../saved_list_items-view.tsx | 330 ++ .../src/pages/saved_lists/[saved_listsId].tsx | 549 ++ .../pages/saved_lists/saved_lists-edit.tsx | 546 ++ .../pages/saved_lists/saved_lists-list.tsx | 174 + .../src/pages/saved_lists/saved_lists-new.tsx | 338 ++ .../pages/saved_lists/saved_lists-table.tsx | 172 + .../pages/saved_lists/saved_lists-view.tsx | 417 ++ frontend/src/pages/search.tsx | 91 + .../src/pages/shipments/[shipmentsId].tsx | 722 +++ .../src/pages/shipments/shipments-edit.tsx | 719 +++ .../src/pages/shipments/shipments-list.tsx | 788 +++ .../src/pages/shipments/shipments-new.tsx | 526 ++ .../src/pages/shipments/shipments-table.tsx | 168 + .../src/pages/shipments/shipments-view.tsx | 436 ++ frontend/src/pages/tables.tsx | 33 + frontend/src/pages/terms-of-use.tsx | 206 + frontend/src/pages/users/[usersId].tsx | 758 +++ frontend/src/pages/users/users-edit.tsx | 755 +++ frontend/src/pages/users/users-list.tsx | 166 + frontend/src/pages/users/users-new.tsx | 502 ++ frontend/src/pages/users/users-table.tsx | 164 + frontend/src/pages/users/users-view.tsx | 1257 ++++ frontend/src/pages/verify-email.tsx | 62 + .../account_price_listsSlice.ts | 231 + frontend/src/stores/accounts/accountsSlice.ts | 231 + frontend/src/stores/authSlice.ts | 124 + .../src/stores/cart_items/cart_itemsSlice.ts | 231 + frontend/src/stores/carts/cartsSlice.ts | 231 + frontend/src/stores/contacts/contactsSlice.ts | 231 + frontend/src/stores/hooks.ts | 6 + frontend/src/stores/introSteps.ts | 139 + .../inventory_items/inventory_itemsSlice.ts | 231 + .../src/stores/locations/locationsSlice.ts | 231 + frontend/src/stores/mainSlice.ts | 36 + frontend/src/stores/openAiSlice.ts | 151 + .../stores/order_items/order_itemsSlice.ts | 231 + frontend/src/stores/orders/ordersSlice.ts | 231 + .../stores/permissions/permissionsSlice.ts | 231 + .../price_list_items/price_list_itemsSlice.ts | 231 + .../stores/price_lists/price_listsSlice.ts | 231 + .../product_categoriesSlice.ts | 231 + frontend/src/stores/products/productsSlice.ts | 231 + .../stores/quote_items/quote_itemsSlice.ts | 231 + frontend/src/stores/quotes/quotesSlice.ts | 231 + frontend/src/stores/roles/rolesSlice.ts | 280 + .../sample_requests/sample_requestsSlice.ts | 231 + .../saved_list_items/saved_list_itemsSlice.ts | 231 + .../stores/saved_lists/saved_listsSlice.ts | 231 + .../src/stores/shipments/shipmentsSlice.ts | 231 + frontend/src/stores/store.ts | 65 + frontend/src/stores/styleSlice.ts | 103 + frontend/src/stores/users/usersSlice.ts | 231 + frontend/src/stores/usersSlice.ts | 117 + frontend/src/styles.ts | 106 + frontend/tailwind.config.js | 110 + frontend/tsconfig.json | 30 + frontend/yarn.lock | 3608 ++++++++++++ nginx.conf | 96 + package.json | 8 + 588 files changed, 160908 insertions(+) create mode 100644 .cursorrules create mode 100644 .dockerignore create mode 100644 .gitignore create mode 100644 .perm_test_apache create mode 100644 .perm_test_exec create mode 100644 502.html create mode 100644 Dockerfile create mode 100644 Dockerfile.dev create mode 100644 LICENSE create mode 100644 README.md create mode 100644 backend/.env create mode 100644 backend/.eslintignore create mode 100644 backend/.eslintrc.cjs create mode 100644 backend/.prettierrc create mode 100644 backend/.sequelizerc create mode 100644 backend/Dockerfile create mode 100644 backend/README.md create mode 100644 backend/package.json create mode 100644 backend/src/ai/LocalAIApi.js create mode 100644 backend/src/auth/auth.js create mode 100644 backend/src/config.js create mode 100644 backend/src/db/api/account_price_lists.js create mode 100644 backend/src/db/api/accounts.js create mode 100644 backend/src/db/api/cart_items.js create mode 100644 backend/src/db/api/carts.js create mode 100644 backend/src/db/api/contacts.js create mode 100644 backend/src/db/api/file.js create mode 100644 backend/src/db/api/inventory_items.js create mode 100644 backend/src/db/api/locations.js create mode 100644 backend/src/db/api/order_items.js create mode 100644 backend/src/db/api/orders.js create mode 100644 backend/src/db/api/permissions.js create mode 100644 backend/src/db/api/price_list_items.js create mode 100644 backend/src/db/api/price_lists.js create mode 100644 backend/src/db/api/product_categories.js create mode 100644 backend/src/db/api/products.js create mode 100644 backend/src/db/api/quote_items.js create mode 100644 backend/src/db/api/quotes.js create mode 100644 backend/src/db/api/roles.js create mode 100644 backend/src/db/api/sample_requests.js create mode 100644 backend/src/db/api/saved_list_items.js create mode 100644 backend/src/db/api/saved_lists.js create mode 100644 backend/src/db/api/shipments.js create mode 100644 backend/src/db/api/users.js create mode 100644 backend/src/db/db.config.js create mode 100644 backend/src/db/migrations/1778156123354.js create mode 100644 backend/src/db/migrations/20260316000000-create-files.js create mode 100644 backend/src/db/migrations/20260316001000-create-users-custom-permissions-join-table.js create mode 100644 backend/src/db/models/account_price_lists.js create mode 100644 backend/src/db/models/accounts.js create mode 100644 backend/src/db/models/cart_items.js create mode 100644 backend/src/db/models/carts.js create mode 100644 backend/src/db/models/contacts.js create mode 100644 backend/src/db/models/file.js create mode 100644 backend/src/db/models/index.js create mode 100644 backend/src/db/models/inventory_items.js create mode 100644 backend/src/db/models/locations.js create mode 100644 backend/src/db/models/order_items.js create mode 100644 backend/src/db/models/orders.js create mode 100644 backend/src/db/models/permissions.js create mode 100644 backend/src/db/models/price_list_items.js create mode 100644 backend/src/db/models/price_lists.js create mode 100644 backend/src/db/models/product_categories.js create mode 100644 backend/src/db/models/products.js create mode 100644 backend/src/db/models/quote_items.js create mode 100644 backend/src/db/models/quotes.js create mode 100644 backend/src/db/models/roles.js create mode 100644 backend/src/db/models/sample_requests.js create mode 100644 backend/src/db/models/saved_list_items.js create mode 100644 backend/src/db/models/saved_lists.js create mode 100644 backend/src/db/models/shipments.js create mode 100644 backend/src/db/models/users.js create mode 100644 backend/src/db/reset.js create mode 100644 backend/src/db/seeders/20200430130759-admin-user.js create mode 100644 backend/src/db/seeders/20200430130760-user-roles.js create mode 100644 backend/src/db/seeders/20231127130745-sample-data.js create mode 100644 backend/src/db/seeders/20260507130000-buyer-portal-demo-data.js create mode 100644 backend/src/db/utils.js create mode 100644 backend/src/helpers.js create mode 100644 backend/src/index.js create mode 100644 backend/src/middlewares/check-permissions.js create mode 100644 backend/src/middlewares/upload.js create mode 100644 backend/src/routes/account_price_lists.js create mode 100644 backend/src/routes/accounts.js create mode 100644 backend/src/routes/auth.js create mode 100644 backend/src/routes/buyer_portal.js create mode 100644 backend/src/routes/cart_items.js create mode 100644 backend/src/routes/carts.js create mode 100644 backend/src/routes/contactForm.js create mode 100644 backend/src/routes/contacts.js create mode 100644 backend/src/routes/file.js create mode 100644 backend/src/routes/integrations.js create mode 100644 backend/src/routes/inventory_items.js create mode 100644 backend/src/routes/locations.js create mode 100644 backend/src/routes/openai.js create mode 100644 backend/src/routes/order_items.js create mode 100644 backend/src/routes/orders.js create mode 100644 backend/src/routes/organizationLogin.js create mode 100644 backend/src/routes/permissions.js create mode 100644 backend/src/routes/pexels.js create mode 100644 backend/src/routes/price_list_items.js create mode 100644 backend/src/routes/price_lists.js create mode 100644 backend/src/routes/product_categories.js create mode 100644 backend/src/routes/products.js create mode 100644 backend/src/routes/quote_items.js create mode 100644 backend/src/routes/quotes.js create mode 100644 backend/src/routes/roles.js create mode 100644 backend/src/routes/sample_requests.js create mode 100644 backend/src/routes/saved_list_items.js create mode 100644 backend/src/routes/saved_lists.js create mode 100644 backend/src/routes/search.js create mode 100644 backend/src/routes/shipments.js create mode 100644 backend/src/routes/sql.js create mode 100644 backend/src/routes/users.js create mode 100644 backend/src/services/account_price_lists.js create mode 100644 backend/src/services/accounts.js create mode 100644 backend/src/services/auth.js create mode 100644 backend/src/services/buyer_portal.js create mode 100644 backend/src/services/cart_items.js create mode 100644 backend/src/services/carts.js create mode 100644 backend/src/services/contacts.js create mode 100644 backend/src/services/email/htmlTemplates/addressVerification/emailAddressVerification.html create mode 100644 backend/src/services/email/htmlTemplates/invitation/invitationTemplate.html create mode 100644 backend/src/services/email/htmlTemplates/passwordReset/passwordResetEmail.html create mode 100644 backend/src/services/email/index.js create mode 100644 backend/src/services/email/list/addressVerification.js create mode 100644 backend/src/services/email/list/invitation.js create mode 100644 backend/src/services/email/list/passwordReset.js create mode 100644 backend/src/services/file.js create mode 100644 backend/src/services/integrations.js create mode 100644 backend/src/services/inventory_items.js create mode 100644 backend/src/services/locations.js create mode 100644 backend/src/services/notifications/errors/forbidden.js create mode 100644 backend/src/services/notifications/errors/validation.js create mode 100644 backend/src/services/notifications/helpers.js create mode 100644 backend/src/services/notifications/list.js create mode 100644 backend/src/services/openai.js create mode 100644 backend/src/services/order_items.js create mode 100644 backend/src/services/orders.js create mode 100644 backend/src/services/permissions.js create mode 100644 backend/src/services/price_list_items.js create mode 100644 backend/src/services/price_lists.js create mode 100644 backend/src/services/product_categories.js create mode 100644 backend/src/services/products.js create mode 100644 backend/src/services/quote_items.js create mode 100644 backend/src/services/quotes.js create mode 100644 backend/src/services/roles.js create mode 100644 backend/src/services/sample_requests.js create mode 100644 backend/src/services/saved_list_items.js create mode 100644 backend/src/services/saved_lists.js create mode 100644 backend/src/services/search.js create mode 100644 backend/src/services/shipments.js create mode 100644 backend/src/services/users.js create mode 100644 backend/watcher.js create mode 100644 backend/yarn.lock create mode 100644 docker/.gitignore create mode 100644 docker/README.md create mode 100644 docker/docker-compose.yml create mode 100644 docker/start-backend.sh create mode 100644 docker/wait-for-it.sh create mode 100644 frontend/.eslintignore create mode 100644 frontend/.eslintrc.cjs create mode 100644 frontend/.gitignore create mode 100644 frontend/.prettierrc create mode 100644 frontend/Dockerfile create mode 100644 frontend/LICENSE-justboil create mode 100644 frontend/README.md create mode 100644 frontend/next-env.d.ts create mode 100644 frontend/next.config.mjs create mode 100644 frontend/package.json create mode 100644 frontend/postcss.config.js create mode 100644 frontend/prettier.config.js create mode 100644 frontend/public/data-sources/clients.json create mode 100644 frontend/public/data-sources/history.json create mode 100644 frontend/public/favicon.svg create mode 100644 frontend/public/locales/de/common.json create mode 100644 frontend/public/locales/en-GB/translation.json create mode 100644 frontend/public/locales/en-US/translation.json create mode 100644 frontend/public/locales/en/common.json create mode 100644 frontend/public/locales/en/translation.json create mode 100644 frontend/public/locales/es/common.json create mode 100644 frontend/public/locales/fr/common.json create mode 100644 frontend/src/._colors.ts create mode 100644 frontend/src/._menuAside.ts create mode 100644 frontend/src/._styles.ts create mode 100644 frontend/src/colors.ts create mode 100644 frontend/src/components/._AsideMenu.tsx create mode 100644 frontend/src/components/._AsideMenuItem.tsx create mode 100644 frontend/src/components/._AsideMenuLayer.tsx create mode 100644 frontend/src/components/._AsideMenuList.tsx create mode 100644 frontend/src/components/._CardBox.tsx create mode 100644 frontend/src/components/._FooterBar.tsx create mode 100644 frontend/src/components/._NavBar.tsx create mode 100644 frontend/src/components/._NavBarItem.tsx create mode 100644 frontend/src/components/._NavBarItemPlain.tsx create mode 100644 frontend/src/components/._Search.tsx create mode 100644 frontend/src/components/._SectionMain.tsx create mode 100644 frontend/src/components/._SectionTitleLineWithButton.tsx create mode 100644 frontend/src/components/Account_price_lists/CardAccount_price_lists.tsx create mode 100644 frontend/src/components/Account_price_lists/ListAccount_price_lists.tsx create mode 100644 frontend/src/components/Account_price_lists/TableAccount_price_lists.tsx create mode 100644 frontend/src/components/Account_price_lists/configureAccount_price_listsCols.tsx create mode 100644 frontend/src/components/Accounts/CardAccounts.tsx create mode 100644 frontend/src/components/Accounts/ListAccounts.tsx create mode 100644 frontend/src/components/Accounts/TableAccounts.tsx create mode 100644 frontend/src/components/Accounts/configureAccountsCols.tsx create mode 100644 frontend/src/components/AsideMenu.tsx create mode 100644 frontend/src/components/AsideMenuItem.tsx create mode 100644 frontend/src/components/AsideMenuLayer.tsx create mode 100644 frontend/src/components/AsideMenuList.tsx create mode 100644 frontend/src/components/BaseButton.tsx create mode 100644 frontend/src/components/BaseButtons.tsx create mode 100644 frontend/src/components/BaseDivider.tsx create mode 100644 frontend/src/components/BaseIcon.tsx create mode 100644 frontend/src/components/BigCalendar.tsx create mode 100644 frontend/src/components/CardBox.tsx create mode 100644 frontend/src/components/CardBoxComponentBody.tsx create mode 100644 frontend/src/components/CardBoxComponentEmpty.tsx create mode 100644 frontend/src/components/CardBoxComponentFooter.tsx create mode 100644 frontend/src/components/CardBoxComponentTitle.tsx create mode 100644 frontend/src/components/CardBoxModal.tsx create mode 100644 frontend/src/components/Cart_items/CardCart_items.tsx create mode 100644 frontend/src/components/Cart_items/ListCart_items.tsx create mode 100644 frontend/src/components/Cart_items/TableCart_items.tsx create mode 100644 frontend/src/components/Cart_items/configureCart_itemsCols.tsx create mode 100644 frontend/src/components/Carts/CardCarts.tsx create mode 100644 frontend/src/components/Carts/ListCarts.tsx create mode 100644 frontend/src/components/Carts/TableCarts.tsx create mode 100644 frontend/src/components/Carts/configureCartsCols.tsx create mode 100644 frontend/src/components/ChartLineSample/config.ts create mode 100644 frontend/src/components/ChartLineSample/index.tsx create mode 100644 frontend/src/components/ClickOutside.tsx create mode 100644 frontend/src/components/Contacts/CardContacts.tsx create mode 100644 frontend/src/components/Contacts/ListContacts.tsx create mode 100644 frontend/src/components/Contacts/TableContacts.tsx create mode 100644 frontend/src/components/Contacts/configureContactsCols.tsx create mode 100644 frontend/src/components/DataGridMultiSelect.tsx create mode 100644 frontend/src/components/DevModeBadge.tsx create mode 100644 frontend/src/components/DragDropFilePicker.tsx create mode 100644 frontend/src/components/ErrorBoundary.tsx create mode 100644 frontend/src/components/FooterBar.tsx create mode 100644 frontend/src/components/FormCheckRadio.tsx create mode 100644 frontend/src/components/FormCheckRadioGroup.tsx create mode 100644 frontend/src/components/FormField.tsx create mode 100644 frontend/src/components/FormFilePicker.tsx create mode 100644 frontend/src/components/FormImagePicker.tsx create mode 100644 frontend/src/components/IconRounded.tsx create mode 100644 frontend/src/components/ImageField.tsx create mode 100644 frontend/src/components/IntroGuide.tsx create mode 100644 frontend/src/components/Inventory_items/CardInventory_items.tsx create mode 100644 frontend/src/components/Inventory_items/ListInventory_items.tsx create mode 100644 frontend/src/components/Inventory_items/TableInventory_items.tsx create mode 100644 frontend/src/components/Inventory_items/configureInventory_itemsCols.tsx create mode 100644 frontend/src/components/KanbanBoard/KanbanBoard.tsx create mode 100644 frontend/src/components/KanbanBoard/KanbanCard.tsx create mode 100644 frontend/src/components/KanbanBoard/KanbanColumn.tsx create mode 100644 frontend/src/components/LanguageSwitcher.tsx create mode 100644 frontend/src/components/ListActionsPopover.tsx create mode 100644 frontend/src/components/LoadingSpinner.tsx create mode 100644 frontend/src/components/Locations/CardLocations.tsx create mode 100644 frontend/src/components/Locations/ListLocations.tsx create mode 100644 frontend/src/components/Locations/TableLocations.tsx create mode 100644 frontend/src/components/Locations/configureLocationsCols.tsx create mode 100644 frontend/src/components/Logo/index.tsx create mode 100644 frontend/src/components/NavBar.tsx create mode 100644 frontend/src/components/NavBarItem.tsx create mode 100644 frontend/src/components/NavBarItemPlain.tsx create mode 100644 frontend/src/components/NavBarMenuList.tsx create mode 100644 frontend/src/components/NotificationBar.tsx create mode 100644 frontend/src/components/Order_items/CardOrder_items.tsx create mode 100644 frontend/src/components/Order_items/ListOrder_items.tsx create mode 100644 frontend/src/components/Order_items/TableOrder_items.tsx create mode 100644 frontend/src/components/Order_items/configureOrder_itemsCols.tsx create mode 100644 frontend/src/components/Orders/CardOrders.tsx create mode 100644 frontend/src/components/Orders/ListOrders.tsx create mode 100644 frontend/src/components/Orders/TableOrders.tsx create mode 100644 frontend/src/components/Orders/configureOrdersCols.tsx create mode 100644 frontend/src/components/OverlayLayer.tsx create mode 100644 frontend/src/components/Pagination.tsx create mode 100644 frontend/src/components/PasswordSetOrReset.tsx create mode 100644 frontend/src/components/Permissions/CardPermissions.tsx create mode 100644 frontend/src/components/Permissions/ListPermissions.tsx create mode 100644 frontend/src/components/Permissions/TablePermissions.tsx create mode 100644 frontend/src/components/Permissions/configurePermissionsCols.tsx create mode 100644 frontend/src/components/Price_list_items/CardPrice_list_items.tsx create mode 100644 frontend/src/components/Price_list_items/ListPrice_list_items.tsx create mode 100644 frontend/src/components/Price_list_items/TablePrice_list_items.tsx create mode 100644 frontend/src/components/Price_list_items/configurePrice_list_itemsCols.tsx create mode 100644 frontend/src/components/Price_lists/CardPrice_lists.tsx create mode 100644 frontend/src/components/Price_lists/ListPrice_lists.tsx create mode 100644 frontend/src/components/Price_lists/TablePrice_lists.tsx create mode 100644 frontend/src/components/Price_lists/configurePrice_listsCols.tsx create mode 100644 frontend/src/components/Product_categories/CardProduct_categories.tsx create mode 100644 frontend/src/components/Product_categories/ListProduct_categories.tsx create mode 100644 frontend/src/components/Product_categories/TableProduct_categories.tsx create mode 100644 frontend/src/components/Product_categories/configureProduct_categoriesCols.tsx create mode 100644 frontend/src/components/Products/CardProducts.tsx create mode 100644 frontend/src/components/Products/ListProducts.tsx create mode 100644 frontend/src/components/Products/ProductSkuFormContent.tsx create mode 100644 frontend/src/components/Products/TableProducts.tsx create mode 100644 frontend/src/components/Products/configureProductsCols.tsx create mode 100644 frontend/src/components/Quote_items/CardQuote_items.tsx create mode 100644 frontend/src/components/Quote_items/ListQuote_items.tsx create mode 100644 frontend/src/components/Quote_items/TableQuote_items.tsx create mode 100644 frontend/src/components/Quote_items/configureQuote_itemsCols.tsx create mode 100644 frontend/src/components/Quotes/CardQuotes.tsx create mode 100644 frontend/src/components/Quotes/ListQuotes.tsx create mode 100644 frontend/src/components/Quotes/TableQuotes.tsx create mode 100644 frontend/src/components/Quotes/configureQuotesCols.tsx create mode 100644 frontend/src/components/RichTextField.tsx create mode 100644 frontend/src/components/Roles/CardRoles.tsx create mode 100644 frontend/src/components/Roles/ListRoles.tsx create mode 100644 frontend/src/components/Roles/TableRoles.tsx create mode 100644 frontend/src/components/Roles/configureRolesCols.tsx create mode 100644 frontend/src/components/Sample_requests/CardSample_requests.tsx create mode 100644 frontend/src/components/Sample_requests/ListSample_requests.tsx create mode 100644 frontend/src/components/Sample_requests/TableSample_requests.tsx create mode 100644 frontend/src/components/Sample_requests/configureSample_requestsCols.tsx create mode 100644 frontend/src/components/Saved_list_items/CardSaved_list_items.tsx create mode 100644 frontend/src/components/Saved_list_items/ListSaved_list_items.tsx create mode 100644 frontend/src/components/Saved_list_items/TableSaved_list_items.tsx create mode 100644 frontend/src/components/Saved_list_items/configureSaved_list_itemsCols.tsx create mode 100644 frontend/src/components/Saved_lists/CardSaved_lists.tsx create mode 100644 frontend/src/components/Saved_lists/ListSaved_lists.tsx create mode 100644 frontend/src/components/Saved_lists/TableSaved_lists.tsx create mode 100644 frontend/src/components/Saved_lists/configureSaved_listsCols.tsx create mode 100644 frontend/src/components/Search.tsx create mode 100644 frontend/src/components/SearchResults.tsx create mode 100644 frontend/src/components/SectionFullScreen.tsx create mode 100644 frontend/src/components/SectionMain.tsx create mode 100644 frontend/src/components/SectionTitle.tsx create mode 100644 frontend/src/components/SectionTitleLineWithButton.tsx create mode 100644 frontend/src/components/SelectField.tsx create mode 100644 frontend/src/components/SelectFieldMany.tsx create mode 100644 frontend/src/components/Shipments/CardShipments.tsx create mode 100644 frontend/src/components/Shipments/ListShipments.tsx create mode 100644 frontend/src/components/Shipments/TableShipments.tsx create mode 100644 frontend/src/components/Shipments/configureShipmentsCols.tsx create mode 100644 frontend/src/components/SmartWidget/SmartWidget.tsx create mode 100644 frontend/src/components/SmartWidget/components/AreaChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/AreaChart/ApexAreaChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/AreaChart/ChartJSAreaChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/BarChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/BarChart/ApexBarChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/BarChart/ChartJSBarChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/FunnelChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/LineChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/LineChart/ApexLineChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/LineChart/ChartJSLineChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/PieChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/PieChart/ApexPieChart.tsx create mode 100644 frontend/src/components/SmartWidget/components/PieChart/ChartJSPieChart.tsx create mode 100644 frontend/src/components/SmartWidget/models/widget.model.ts create mode 100644 frontend/src/components/SmartWidget/widgetHelpers.tsx create mode 100644 frontend/src/components/SwitchField.tsx create mode 100644 frontend/src/components/TableSampleClients.tsx create mode 100644 frontend/src/components/Uploaders/FilesUploader.js create mode 100644 frontend/src/components/Uploaders/ImagesUploader.js create mode 100644 frontend/src/components/Uploaders/UploadService.js create mode 100644 frontend/src/components/UserAvatar.tsx create mode 100644 frontend/src/components/UserAvatarCurrentUser.tsx create mode 100644 frontend/src/components/UserCard.tsx create mode 100644 frontend/src/components/Users/CardUsers.tsx create mode 100644 frontend/src/components/Users/ListUsers.tsx create mode 100644 frontend/src/components/Users/TableUsers.tsx create mode 100644 frontend/src/components/Users/configureUsersCols.tsx create mode 100644 frontend/src/components/WidgetCreator/RoleSelect.tsx create mode 100644 frontend/src/components/WidgetCreator/WidgetCreator.tsx create mode 100644 frontend/src/config.ts create mode 100644 frontend/src/css/.__table.css create mode 100644 frontend/src/css/_app.css create mode 100644 frontend/src/css/_calendar.css create mode 100644 frontend/src/css/_checkbox-radio-switch.css create mode 100644 frontend/src/css/_helper.css create mode 100644 frontend/src/css/_progress.css create mode 100644 frontend/src/css/_rich-text.css create mode 100644 frontend/src/css/_scrollbars.css create mode 100644 frontend/src/css/_select-dropdown.css create mode 100644 frontend/src/css/_table.css create mode 100644 frontend/src/css/_theme.css create mode 100644 frontend/src/css/main.css create mode 100644 frontend/src/css/tailwind/_base.css create mode 100644 frontend/src/css/tailwind/_components.css create mode 100644 frontend/src/css/tailwind/_utilities.css create mode 100644 frontend/src/helpers/dataFormatter.js create mode 100644 frontend/src/helpers/fileSaver.ts create mode 100644 frontend/src/helpers/humanize.ts create mode 100644 frontend/src/helpers/notifyStateHandler.ts create mode 100644 frontend/src/helpers/pexels.ts create mode 100644 frontend/src/helpers/userPermissions.ts create mode 100644 frontend/src/hooks/sampleData.ts create mode 100644 frontend/src/hooks/useDevCompilationStatus.ts create mode 100644 frontend/src/i18n.ts create mode 100644 frontend/src/interfaces/index.ts create mode 100644 frontend/src/layouts/._Authenticated.tsx create mode 100644 frontend/src/layouts/Authenticated.tsx create mode 100644 frontend/src/layouts/BuyerPortal.tsx create mode 100644 frontend/src/layouts/Guest.tsx create mode 100644 frontend/src/menuAside.ts create mode 100644 frontend/src/menuNavBar.ts create mode 100644 frontend/src/pages/_app.tsx create mode 100644 frontend/src/pages/account_price_lists/[account_price_listsId].tsx create mode 100644 frontend/src/pages/account_price_lists/account_price_lists-edit.tsx create mode 100644 frontend/src/pages/account_price_lists/account_price_lists-list.tsx create mode 100644 frontend/src/pages/account_price_lists/account_price_lists-new.tsx create mode 100644 frontend/src/pages/account_price_lists/account_price_lists-table.tsx create mode 100644 frontend/src/pages/account_price_lists/account_price_lists-view.tsx create mode 100644 frontend/src/pages/accounts/[accountsId].tsx create mode 100644 frontend/src/pages/accounts/accounts-edit.tsx create mode 100644 frontend/src/pages/accounts/accounts-list.tsx create mode 100644 frontend/src/pages/accounts/accounts-new.tsx create mode 100644 frontend/src/pages/accounts/accounts-table.tsx create mode 100644 frontend/src/pages/accounts/accounts-view.tsx create mode 100644 frontend/src/pages/api/hello.js create mode 100644 frontend/src/pages/api/logError.ts create mode 100644 frontend/src/pages/buyer-login.tsx create mode 100644 frontend/src/pages/buyer-portal.tsx create mode 100644 frontend/src/pages/cart_items/[cart_itemsId].tsx create mode 100644 frontend/src/pages/cart_items/cart_items-edit.tsx create mode 100644 frontend/src/pages/cart_items/cart_items-list.tsx create mode 100644 frontend/src/pages/cart_items/cart_items-new.tsx create mode 100644 frontend/src/pages/cart_items/cart_items-table.tsx create mode 100644 frontend/src/pages/cart_items/cart_items-view.tsx create mode 100644 frontend/src/pages/carts/[cartsId].tsx create mode 100644 frontend/src/pages/carts/carts-edit.tsx create mode 100644 frontend/src/pages/carts/carts-list.tsx create mode 100644 frontend/src/pages/carts/carts-new.tsx create mode 100644 frontend/src/pages/carts/carts-table.tsx create mode 100644 frontend/src/pages/carts/carts-view.tsx create mode 100644 frontend/src/pages/contacts/[contactsId].tsx create mode 100644 frontend/src/pages/contacts/contacts-edit.tsx create mode 100644 frontend/src/pages/contacts/contacts-list.tsx create mode 100644 frontend/src/pages/contacts/contacts-new.tsx create mode 100644 frontend/src/pages/contacts/contacts-table.tsx create mode 100644 frontend/src/pages/contacts/contacts-view.tsx create mode 100644 frontend/src/pages/dashboard.tsx create mode 100644 frontend/src/pages/error.tsx create mode 100644 frontend/src/pages/forgot.tsx create mode 100644 frontend/src/pages/forms.tsx create mode 100644 frontend/src/pages/index.tsx create mode 100644 frontend/src/pages/integrations.tsx create mode 100644 frontend/src/pages/inventory_items/[inventory_itemsId].tsx create mode 100644 frontend/src/pages/inventory_items/inventory_items-edit.tsx create mode 100644 frontend/src/pages/inventory_items/inventory_items-list.tsx create mode 100644 frontend/src/pages/inventory_items/inventory_items-new.tsx create mode 100644 frontend/src/pages/inventory_items/inventory_items-table.tsx create mode 100644 frontend/src/pages/inventory_items/inventory_items-view.tsx create mode 100644 frontend/src/pages/locations/[locationsId].tsx create mode 100644 frontend/src/pages/locations/locations-edit.tsx create mode 100644 frontend/src/pages/locations/locations-list.tsx create mode 100644 frontend/src/pages/locations/locations-new.tsx create mode 100644 frontend/src/pages/locations/locations-table.tsx create mode 100644 frontend/src/pages/locations/locations-view.tsx create mode 100644 frontend/src/pages/login.tsx create mode 100644 frontend/src/pages/order_items/[order_itemsId].tsx create mode 100644 frontend/src/pages/order_items/order_items-edit.tsx create mode 100644 frontend/src/pages/order_items/order_items-list.tsx create mode 100644 frontend/src/pages/order_items/order_items-new.tsx create mode 100644 frontend/src/pages/order_items/order_items-table.tsx create mode 100644 frontend/src/pages/order_items/order_items-view.tsx create mode 100644 frontend/src/pages/orders/[ordersId].tsx create mode 100644 frontend/src/pages/orders/orders-edit.tsx create mode 100644 frontend/src/pages/orders/orders-list.tsx create mode 100644 frontend/src/pages/orders/orders-new.tsx create mode 100644 frontend/src/pages/orders/orders-table.tsx create mode 100644 frontend/src/pages/orders/orders-view.tsx create mode 100644 frontend/src/pages/password-reset.tsx create mode 100644 frontend/src/pages/permissions/[permissionsId].tsx create mode 100644 frontend/src/pages/permissions/permissions-edit.tsx create mode 100644 frontend/src/pages/permissions/permissions-list.tsx create mode 100644 frontend/src/pages/permissions/permissions-new.tsx create mode 100644 frontend/src/pages/permissions/permissions-table.tsx create mode 100644 frontend/src/pages/permissions/permissions-view.tsx create mode 100644 frontend/src/pages/price_list_items/[price_list_itemsId].tsx create mode 100644 frontend/src/pages/price_list_items/price_list_items-edit.tsx create mode 100644 frontend/src/pages/price_list_items/price_list_items-list.tsx create mode 100644 frontend/src/pages/price_list_items/price_list_items-new.tsx create mode 100644 frontend/src/pages/price_list_items/price_list_items-table.tsx create mode 100644 frontend/src/pages/price_list_items/price_list_items-view.tsx create mode 100644 frontend/src/pages/price_lists/[price_listsId].tsx create mode 100644 frontend/src/pages/price_lists/price_lists-edit.tsx create mode 100644 frontend/src/pages/price_lists/price_lists-list.tsx create mode 100644 frontend/src/pages/price_lists/price_lists-new.tsx create mode 100644 frontend/src/pages/price_lists/price_lists-table.tsx create mode 100644 frontend/src/pages/price_lists/price_lists-view.tsx create mode 100644 frontend/src/pages/privacy-policy.tsx create mode 100644 frontend/src/pages/product_categories/[product_categoriesId].tsx create mode 100644 frontend/src/pages/product_categories/product_categories-edit.tsx create mode 100644 frontend/src/pages/product_categories/product_categories-list.tsx create mode 100644 frontend/src/pages/product_categories/product_categories-new.tsx create mode 100644 frontend/src/pages/product_categories/product_categories-table.tsx create mode 100644 frontend/src/pages/product_categories/product_categories-view.tsx create mode 100644 frontend/src/pages/products/[productsId].tsx create mode 100644 frontend/src/pages/products/products-edit.tsx create mode 100644 frontend/src/pages/products/products-list.tsx create mode 100644 frontend/src/pages/products/products-new.tsx create mode 100644 frontend/src/pages/products/products-table.tsx create mode 100644 frontend/src/pages/products/products-view.tsx create mode 100644 frontend/src/pages/profile.tsx create mode 100644 frontend/src/pages/quote_items/[quote_itemsId].tsx create mode 100644 frontend/src/pages/quote_items/quote_items-edit.tsx create mode 100644 frontend/src/pages/quote_items/quote_items-list.tsx create mode 100644 frontend/src/pages/quote_items/quote_items-new.tsx create mode 100644 frontend/src/pages/quote_items/quote_items-table.tsx create mode 100644 frontend/src/pages/quote_items/quote_items-view.tsx create mode 100644 frontend/src/pages/quotes/[quotesId].tsx create mode 100644 frontend/src/pages/quotes/quotes-edit.tsx create mode 100644 frontend/src/pages/quotes/quotes-list.tsx create mode 100644 frontend/src/pages/quotes/quotes-new.tsx create mode 100644 frontend/src/pages/quotes/quotes-table.tsx create mode 100644 frontend/src/pages/quotes/quotes-view.tsx create mode 100644 frontend/src/pages/register.tsx create mode 100644 frontend/src/pages/roles/[rolesId].tsx create mode 100644 frontend/src/pages/roles/roles-edit.tsx create mode 100644 frontend/src/pages/roles/roles-list.tsx create mode 100644 frontend/src/pages/roles/roles-new.tsx create mode 100644 frontend/src/pages/roles/roles-table.tsx create mode 100644 frontend/src/pages/roles/roles-view.tsx create mode 100644 frontend/src/pages/sample_requests/[sample_requestsId].tsx create mode 100644 frontend/src/pages/sample_requests/sample_requests-edit.tsx create mode 100644 frontend/src/pages/sample_requests/sample_requests-list.tsx create mode 100644 frontend/src/pages/sample_requests/sample_requests-new.tsx create mode 100644 frontend/src/pages/sample_requests/sample_requests-table.tsx create mode 100644 frontend/src/pages/sample_requests/sample_requests-view.tsx create mode 100644 frontend/src/pages/saved_list_items/[saved_list_itemsId].tsx create mode 100644 frontend/src/pages/saved_list_items/saved_list_items-edit.tsx create mode 100644 frontend/src/pages/saved_list_items/saved_list_items-list.tsx create mode 100644 frontend/src/pages/saved_list_items/saved_list_items-new.tsx create mode 100644 frontend/src/pages/saved_list_items/saved_list_items-table.tsx create mode 100644 frontend/src/pages/saved_list_items/saved_list_items-view.tsx create mode 100644 frontend/src/pages/saved_lists/[saved_listsId].tsx create mode 100644 frontend/src/pages/saved_lists/saved_lists-edit.tsx create mode 100644 frontend/src/pages/saved_lists/saved_lists-list.tsx create mode 100644 frontend/src/pages/saved_lists/saved_lists-new.tsx create mode 100644 frontend/src/pages/saved_lists/saved_lists-table.tsx create mode 100644 frontend/src/pages/saved_lists/saved_lists-view.tsx create mode 100644 frontend/src/pages/search.tsx create mode 100644 frontend/src/pages/shipments/[shipmentsId].tsx create mode 100644 frontend/src/pages/shipments/shipments-edit.tsx create mode 100644 frontend/src/pages/shipments/shipments-list.tsx create mode 100644 frontend/src/pages/shipments/shipments-new.tsx create mode 100644 frontend/src/pages/shipments/shipments-table.tsx create mode 100644 frontend/src/pages/shipments/shipments-view.tsx create mode 100644 frontend/src/pages/tables.tsx create mode 100644 frontend/src/pages/terms-of-use.tsx create mode 100644 frontend/src/pages/users/[usersId].tsx create mode 100644 frontend/src/pages/users/users-edit.tsx create mode 100644 frontend/src/pages/users/users-list.tsx create mode 100644 frontend/src/pages/users/users-new.tsx create mode 100644 frontend/src/pages/users/users-table.tsx create mode 100644 frontend/src/pages/users/users-view.tsx create mode 100644 frontend/src/pages/verify-email.tsx create mode 100644 frontend/src/stores/account_price_lists/account_price_listsSlice.ts create mode 100644 frontend/src/stores/accounts/accountsSlice.ts create mode 100644 frontend/src/stores/authSlice.ts create mode 100644 frontend/src/stores/cart_items/cart_itemsSlice.ts create mode 100644 frontend/src/stores/carts/cartsSlice.ts create mode 100644 frontend/src/stores/contacts/contactsSlice.ts create mode 100644 frontend/src/stores/hooks.ts create mode 100644 frontend/src/stores/introSteps.ts create mode 100644 frontend/src/stores/inventory_items/inventory_itemsSlice.ts create mode 100644 frontend/src/stores/locations/locationsSlice.ts create mode 100644 frontend/src/stores/mainSlice.ts create mode 100644 frontend/src/stores/openAiSlice.ts create mode 100644 frontend/src/stores/order_items/order_itemsSlice.ts create mode 100644 frontend/src/stores/orders/ordersSlice.ts create mode 100644 frontend/src/stores/permissions/permissionsSlice.ts create mode 100644 frontend/src/stores/price_list_items/price_list_itemsSlice.ts create mode 100644 frontend/src/stores/price_lists/price_listsSlice.ts create mode 100644 frontend/src/stores/product_categories/product_categoriesSlice.ts create mode 100644 frontend/src/stores/products/productsSlice.ts create mode 100644 frontend/src/stores/quote_items/quote_itemsSlice.ts create mode 100644 frontend/src/stores/quotes/quotesSlice.ts create mode 100644 frontend/src/stores/roles/rolesSlice.ts create mode 100644 frontend/src/stores/sample_requests/sample_requestsSlice.ts create mode 100644 frontend/src/stores/saved_list_items/saved_list_itemsSlice.ts create mode 100644 frontend/src/stores/saved_lists/saved_listsSlice.ts create mode 100644 frontend/src/stores/shipments/shipmentsSlice.ts create mode 100644 frontend/src/stores/store.ts create mode 100644 frontend/src/stores/styleSlice.ts create mode 100644 frontend/src/stores/users/usersSlice.ts create mode 100644 frontend/src/stores/usersSlice.ts create mode 100644 frontend/src/styles.ts create mode 100644 frontend/tailwind.config.js create mode 100644 frontend/tsconfig.json create mode 100644 frontend/yarn.lock create mode 100644 nginx.conf create mode 100644 package.json diff --git a/.cursorrules b/.cursorrules new file mode 100644 index 0000000..496b86f --- /dev/null +++ b/.cursorrules @@ -0,0 +1,305 @@ +# Cursor Rules - Group 1: Development Philosophy & Coding Conventions +1. Overall Architecture & Structure: + - Enforce a clear separation of concerns between the backend and the frontend: + - **Backend**: Use Express for routing, Passport for authentication, and Swagger for API documentation. Organize code into modules such as routes, services, and helpers. + - **Example**: + - Routes: `src/routes/auth.js` for authentication routes. + - Services: `src/services/auth.js` for authentication logic. + - Helpers: `src/helpers/wrapAsync.js` for wrapping asynchronous functions. + - **Frontend**: Use Next.js with React and TypeScript. Structure components using functional components, hooks, and layouts. + - **Example**: + - Pages: `pages/index.tsx` for the main page. + - Components: `components/Header.tsx` for the header component. + - Layouts: `layouts/MainLayout.tsx` for common page layouts. + - Ensure that backend modules and frontend components are organized for reusability and maintainability: + - **Backend**: Separate business logic into services and use middleware for common tasks. + - **Frontend**: Use reusable components and hooks to manage state and lifecycle. + +2. Coding Style & Formatting: + - For the backend (JavaScript): + • Use ES6+ features (const/let, arrow functions) consistently. + • Follow Prettier and ESLint configurations (e.g., consistent 2-space indentation, semicolons, and single quotes). + • Maintain clear asynchronous patterns with helper wrappers (e.g., wrapAsync). + - **Example from auth.js**: + ```javascript + router.post('/signin/local', wrapAsync(async (req, res) => { + const payload = await AuthService.signin(req.body.email, req.body.password, req); + res.status(200).send(payload); + })); + ``` + • Document API endpoints with inline Swagger comments to ensure API clarity and consistency. + - **Example**: + ```javascript + /** + * @swagger + * /api/auth/signin: + * post: + * summary: Sign in a user + * responses: + * 200: + * description: Successful login + */ + ``` + - For the frontend (TypeScript/React): + • Use functional components with strict typing and separation of concerns. + - **Example**: + ```typescript + const Button: React.FC<{ onClick: () => void }> = ({ onClick }) => ( + + ); + ``` + • Follow naming conventions: PascalCase for components and types/interfaces, camelCase for variables, hooks, and function names. + - **Example**: + ```typescript + const useCustomHook = () => { + const [state, setState] = useState(false); + return [state, setState]; + }; + ``` + • Utilize hooks (useEffect, useState) to manage state and lifecycle in a clear and concise manner. + - **Example**: + ```typescript + useEffect(() => { + console.log('Component mounted'); + }, []); + ``` + +3. Code Quality & Best Practices: + - Ensure code modularity by splitting complex logic into smaller, testable units. + - **Example**: In `auth.js`, routes are separated from business logic, which is handled in `AuthService`. + - Write self-documenting code and add comments where the logic is non-trivial. + - **Example**: Use descriptive function and variable names in `auth.js`, and add comments for complex asynchronous operations. + - Embrace declarative programming and adhere to SOLID principles. + - **Example**: In service functions, ensure each function has a single responsibility and dependencies are injected rather than hardcoded. + +4. Consistency & Tools Integration: + - Leverage existing tools like Prettier and ESLint to automatically enforce style and formatting rules. + - **Example**: Use `.prettierrc` and `.eslintrc.cjs` for configuration in your project. + - Use TypeScript in the frontend to ensure type safety and catch errors early. + - **Example**: Define interfaces and types in your React components to enforce strict typing. + - Maintain uniformity in API design and error handling strategies. + - **Example**: Consistently use Passport for authentication and a common error handling middleware in `auth.js`. + +## Group 2 – Naming Conventions +1. File Naming and Structure: + • Frontend: + - Page Files: Use lower-case filenames (e.g., index.tsx) as prescribed by Next.js conventions. + - **Example**: `pages/index.tsx`, `pages/about.tsx` + - Component Files: Use PascalCase for React component files (e.g., WebSiteHeader.tsx, NavBar.tsx). + - **Example**: `components/Header.tsx`, `components/Footer.tsx` + - Directories: Use clear, descriptive names (e.g., 'pages', 'components', 'WebPageComponents'). + - **Example**: `src/pages`, `src/components` + • Backend: + - Use lower-case filenames for modules (e.g., index.js, auth.js, projects.js). + - **Example**: `routes/auth.js`, `services/user.js` + - When needed, use hyphenation for clarity, but maintain consistency. + - **Example**: `helpers/wrap-async.js` + +2. Component and Module Naming: + • Frontend: + - React Components: Define components in PascalCase. + - TypeScript Interfaces/Types: Use PascalCase (e.g., WebSiteHeaderProps). + • Backend: + - Classes (if any) and constructors should be in PascalCase; most helper functions and modules use camelCase. + +3. Variable, Function, and Hook Naming: + • Use camelCase for variables and function names in both frontend and backend. + - **Example**: + ```javascript + const userName = 'John Doe'; + function handleLogin() { ... } + ``` + • Custom Hooks: Prefix with 'use' (e.g., useAuth, useForm). + - **Example**: + ```typescript + const useAuth = () => { + const [isAuthenticated, setIsAuthenticated] = useState(false); + return { isAuthenticated, setIsAuthenticated }; + }; + ``` + +4. Consistency and Readability: + • Maintain uniform naming across the project to ensure clarity and ease of maintenance. + - **Example**: Use consistent naming conventions for variables, functions, and components, such as camelCase for variables and functions, and PascalCase for components. + - **Example**: In `auth.js`, ensure that all function names clearly describe their purpose, such as `handleLogin` or `validateUserInput`. + +## Group 3 – Frontend & React Best Practices +1. Use of Functional Components & TypeScript: + • Build all components as functional components. + - **Example**: + ```typescript + const Header: React.FC = () => { + return
Header Content
; + }; + ``` + • Leverage TypeScript for static type checking and enforce strict prop and state types. + - **Example**: + ```typescript + interface ButtonProps { + onClick: () => void; + } + const Button: React.FC = ({ onClick }) => ( + + ); + ``` + +2. Effective Use of React Hooks: + • Utilize useState and useEffect appropriately with proper dependency arrays. + - **Example**: + ```typescript + const [count, setCount] = useState(0); + useEffect(() => { + console.log('Component mounted'); + }, []); + ``` + • Create custom hooks to encapsulate shared logic (e.g., useAppSelector). + - **Example**: + ```typescript + const useAuth = () => { + const [isAuthenticated, setIsAuthenticated] = useState(false); + return { isAuthenticated, setIsAuthenticated }; + }; + ``` + +3. Component Composition & Separation of Concerns: + • Separate presentational (stateless) components from container components managing logic. + - **Example**: Use `LayoutGuest` to encapsulate common page structures. + +4. Code Quality & Readability: + • Maintain consistent formatting and adhere to Prettier and ESLint rules. + • Use descriptive names for variables, functions, and components. + • Document non-trivial logic with inline comments and consider implementing error boundaries where needed. + • New code must adhere to these conventions to avoid ambiguity. + • Use descriptive names that reflect the purpose and domain, avoiding abbreviations unless standard in the project. + +## Group 4 – Backend & API Guidelines +1. API Endpoint Design & Documentation: + • Follow RESTful naming conventions; all route handlers should be named clearly and consistently. + - **Example**: Use verbs like `GET`, `POST`, `PUT`, `DELETE` to define actions, e.g., `GET /api/auth/me` to retrieve user info. + • Document endpoints with Swagger annotations to provide descriptions, expected request bodies, and response codes. + - **Example**: + ```javascript + /** + * @swagger + * /api/auth/signin: + * post: + * summary: Sign in a user + * requestBody: + * description: User credentials + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/Auth" + * responses: + * 200: + * description: Successful login + * 400: + * description: Invalid username/password supplied + */ + ``` + • Examples (for Auth endpoints): + - POST /api/auth/signin/local + • Description: Logs the user into the system. + • Request Body (application/json): + { "email": "admin@flatlogic.com", "password": "password" } + • Responses: + - 200: Successful login (returns token and user data). + - 400: Invalid username/password supplied. + - GET /api/auth/me + • Description: Retrieves current authorized user information. + • Secured via Passport JWT; uses req.currentUser. + • Responses: + - 200: Returns current user info. + - 400: Invalid credentials or missing user data. + - POST /api/auth/signup + • Description: Registers a new user. + • Request Body (application/json): + { "email": "admin@flatlogic.com", "password": "password" } + • Responses: + - 200: New user signed up successfully. + - 400: Invalid input supplied. + - 500: Server error. + +## Group 5 – Testing, Quality Assurance & Error Handling +1. Testing Guidelines: + • Write unit tests for critical backend and frontend components using frameworks such as Jest, React Testing Library, and Mocha/Chai. + - **Example**: + ```javascript + test('should return user data', async () => { + const user = await getUserData(); + expect(user).toHaveProperty('email'); + }); + ``` + • Practice test-driven development and maintain high test coverage. + • Regularly update tests following changes in business logic. + +2. Quality Assurance: + • Enforce code quality with ESLint, Prettier, and static analysis tools. + • Integrate continuous testing workflows (CI/CD) to catch issues early. + - **Example**: Use GitHub Actions for automated testing and deployment. + • Ensure documentation is kept up-to-date with the implemented code. + +3. Error Handling: + • Back-end: + - Wrap asynchronous route handlers with a helper (e.g., wrapAsync) to capture errors. + - **Example**: + ```javascript + router.post('/signin', wrapAsync(async (req, res) => { + const user = await AuthService.signin(req.body); + res.send(user); + })); + ``` + - Use centralized error handling middleware (e.g., commonErrorHandler) for uniform error responses. + • Front-end: + - Implement error boundaries in React to gracefully handle runtime errors. + - Display user-friendly error messages and log errors for further analysis. + +2. Authentication & Security: + • Protect endpoints by using Passport.js with JWT (e.g., passport.authenticate('jwt', { session: false })). + - **Example**: + ```javascript + router.get('/profile', passport.authenticate('jwt', { session: false }), (req, res) => { + res.send(req.user); + }); + ``` + • Ensure that secure routes check for existence of req.currentUser. If absent, return a ForbiddenError. + +3. Consistent Error Handling & Middleware Usage: + • Wrap asynchronous route handlers with helpers like wrapAsync for error propagation. + • Use centralized error handling middleware (e.g., commonErrorHandler) to capture and format errors uniformly. + +4. Modular Code Organization: + • Organize backend code into separate files for routes, services, and database access (e.g., auth.js, projects.js, tasks.js). + • Use descriptive, lowercase filenames for modules and routes. + +5. Endpoint Security Best Practices: + • Validate input data and sanitize requests where necessary. + • Restrict sensitive operations to authenticated users with proper role-based permissions. + + +──────────────────────────────────────── +Group 6 – Accessibility, UI, and Styling Guidelines (Updated) +──────────────────────────────────────── +1. Sidebar Styling: + • The sidebar is implemented in the authenticated layout via the AsideMenu component, with the actual element defined in AsideMenuLayer (located at frontend/src/components/AsideMenuLayer.tsx) as an