Category: ROCKEN Documentation

  • Story 1.1.1.4. CRM. Company. Merge Duplicate Companies

    Content

    General info

    Feature: Merge Duplicate Companies
    Description: This feature allows users to merge duplicate company records into a single entry by selecting the duplicates and clicking a merge button. The system should consolidate the information into one record and remove the duplicates from the list.

    User story

    As a CRM User [Admin, BM, Consultant, HoR, HoC, Recruiter]
    I want to be able to merge duplicate company records
    So that I can maintain a clean and accurate company list without redundant entries.


    RT-4200

    Получение подробных данных проблемы…
    СТАТУС

    Visual design:

    Company list https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/Rocken-Design?node-id=58203-68552&t=MIaVLDcVgHlBqxJL-4

    Company details https://www.figma.com/proto/I5CXH7H3ICD0vfA1kPbcVf/ROCKEN-jobs-%2F-talent?node-id=46705-310258&t=hi9yEFy0y8uUSlNC-0&scaling=min-zoom&content-scaling=fixed&page-id=20792%3A100687&starting-point-node-id=21491%3A133215&show-proto-sidebar=1

    Acceptance criteria

    01

    Scenario 1: Merge Duplicate Companies

    Given I am an authenticated CRM User
    When I navigate to the "Company List" page
    AND I click merge button image-20240817-145336.png on original company
    AND I select duplicated companies
    AND I click merge button in modal window image-20240817-150922.png
    Then I should see a confirmation message indicating the companies were merged successfully
    AND the duplicate companies should be removed from the list
    AND the remaining record should have consolidated information from the merged companies: inherited orders, vacancies, publications, staff, unpopulated text fields in maternal company to be populated with inherited data. If maternal companies’ text fields were populated before the merge, they remain as they were and are not overwritten.

    02

    OOS Scenario 2: Merge with Validation

    Given I am an authenticated Admin User
    When I navigate to the "Company List" page
    AND I select multiple companies for merging
    AND one or more selected companies have conflicting information
    Then I should be prompted to resolve conflicts before proceeding with the merge
    AND I should see an option to review and confirm how to handle conflicting information

    03

    Scenario 3: No Duplicate Selected

    Given I am an authenticated CRM User
    When I navigate to the "Company List" page
    AND didn’t select any duplicated companies
    Then the "Merge" button is not active
    AND I on hover see a message indicating that at least one duplicated company need to be selected for merging

    04

    Scenario 4: Merge Duplicate Companies on detail page

    Given I am an authenticated CRM User
    When I navigate to the "Company view" page
    AND I click merge button image-20240817-145336.png
    AND I select duplicated companies
    AND I click merge button in modal window image-20240817-150922.png
    Then I should see a confirmation message indicating the companies were merged successfully
    AND the duplicate companies should be removed from the list
    AND the remaining record should have consolidated information from the merged companies: inherited orders, vacancies, publications, staff, unpopulated text fields in maternal company to be populated with inherited data. If maternal companies’ text fields were populated before the merge, they remain as they were and are not overwritten

    image-20240817-151010.png

    merge only companies from one market

  • Story 1.1.1.3. Company list Management CRUD

    Content

    General info

    Feature: Company List Management
    Description: This feature allows users to manage a list of companies by creating new entries, viewing existing ones, updating details, and deleting records as needed.

    User story

    As a CRM User [Admin, Consultant, BM, HoR, HoC, Recruiter, Customer support]
    I want to be able to create, view, update, and delete company records
    So that I can maintain an accurate and up-to-date list of companies in the system.

    Visual design:

    https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/ROCKEN-jobs-%2F-talent?node-id=21124-112520&t=hi9yEFy0y8uUSlNC-4

    Acceptance criteria

    01

    Scenario 1: Create a Company

    Given I am an authenticated CRM User
    When I navigate to the "Company List" page
    AND I click on the “+” "Add New Company" button
    AND I fill out the required fields (Company Name, type, parent company, industry, Rocken contact, Job link, Phone Number, Email, Company size, website)
    AND I click on the "Create" button
    Then I should see a confirmation message indicating the company was created successfully
    AND the new company should appear in the company list with the provided details
    AND the page of the company is opened automatically

    image-20240817-131150.png

    image-20240817-131604.png

    02

    Scenario 2: View a Company

    Given I am an authenticated CRM User
    When I navigate to the "Company List" page
    AND I select a company from the list by clicking on the name of the company
    Then I should see the detailed information for the selected company

    image-20240817-132406.png

    03

    Scenario 3: Update a Company

    Given I am an authenticated CRM User
    When I navigate to the "Company List" page
    AND I select a company from the list
    AND I click on the "Edit" button image-20240817-134027.png
    AND I update the desired fields (e.g., industry, Phone Number)
    AND I click on the "Save update" button
    Then I should see a confirmation message “Edits are saved“ indicating the company was updated successfully
    AND the company list should reflect the updated details

    image-20240817-133549.png

    image-20240817-133633.png

    image-20240817-133722.png

    04

    Scenario 4: Delete a Company

    Given I am an authenticated Admin User
    When I navigate to the "Company List" page
    AND I select a company from the list
    AND I click on the "Delete" button image-20240817-134015.png
    AND I confirm the deletion in the confirmation dialog
    Then I should see a confirmation message indicating the company was deleted successfully
    AND the company should no longer appear in the company list

    image-20240817-134004.png

    05

    Scenario 5: View Company List

    Given I am an authenticated CRM User
    When I navigate to the "Company List" page
    Then I should see a list of all companies
    AND each entry in the list should show the company name, status, industries, and other relevant details

    image-20240817-131150.png
  • Story 1.1.1.2. CRM. Company list filters

    Content

    General info

    This feature focuses on implementing a filtering mechanism within the company list table in the CRM system. Users should be able to apply filters to various columns (e.g., Industry, Status, rocken contact) to narrow down the list of companies displayed. The filtering functionality should be intuitive, allowing users to quickly find the companies that meet their specific criteria.

    User story

    As a CRM user,
    I want to filter the company list table by different attributes,
    So that I can easily find companies that meet specific criteria.


    RT-5237

    Получение подробных данных проблемы…
    СТАТУС

    Visual design:

    https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/ROCKEN-jobs-%2F-talent?node-id=21124-112520&t=3zsWVPzXmyXbANx6-4

    Acceptance criteria

    01

    Scenario: Opening the Filters panel
    Given I am on the company List page
    When I click on the "Filters" link
    Then the filters panel should open on the right side of the screen, displaying filter options such as

    1. Title / Titel

    2. Keyword / Keyword

    3. Industries / Branchen

    4. Rocken contact / Rocken Kontakt

    5. Client level / Kundenlevel

    6. Company size / Unternehmensgrösse

    7. Cooperation status (KT) / Status der Zusammenarbeit (KT)

    8. Company type / Unternehmenstyp

    9. Assignment / Nicht zugewiesen anzeigen

    10. OOS Market / Markt

    image-20241121-152218.png

    02

    Scenario: User interact with the filter panel
    Given user in filter panel,
    When clear/add/search some items
    Then have common behaviour of the field described here: Story 1.0.12.5. CRM. Filter panel

    #

    Filter Field

    Acceptance Criteria

    Query

    https://api.staging.rockengroup.com/api-documentation-2000#/Company/get_api_v1_companies_list

    01

    Title

     

    Scenario: User interact with the field
    Given user in filter panel,
    When search some items (name of company)
    Then have common behaviour of the field described here: Story 1.0.12.6. CRM. Title field filter

    titles[]

    02

    Keyword

    Scenario: User applies a keyword filter.
    Given the user enters a custom keyword,
    When it is find info in any company fields without suggestions
    AND data matches with keyword ,
    Then relevant results are displayed

    Select type:

    • multi select OOS

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags

    search by all fields in companies

    03

    Industry

    Scenario: User applies an industry filter.
    Given the user types an industry,
    When matches exist,
    Then suggestions are displayed.

    Select type:

    • multi select

    • multi tags

    • search

    • suggestions

    • custom tags OOS

    industries[]

    04

    Rocken Contact

    Scenario: User applies a Rocken contact filter.
    Given the user selects Rocken contact,
    When the selection is made,
    Then the results reflect the selected status.

    Select type:

    • multi select

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags OOS

    05

    Client level

    Scenario: User applies a Client level filter.
    Given the user selects Client level,
    When the selection is made,
    Then the results reflect the selected status.

    Select type:

    • multi select

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags OOS

    should be added to API by backend developer

    06

    Company Size

    Scenario: User applies Company size filter.
    Given the user selects Company size,
    When the selection is made,
    Then the results reflect the selected status.

    Select type:

    • multi select

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags OOS

    sizes[]

    Available values : 1-20, 21-50, 51-100, 101-200, 201-500, 501-1000, 1001-10000, 10001+

    07

    Cooperation Status (KT)

    Scenario: User applies Cooperation status filter.
    Given the user selects Cooperation status,
    When the selection is made,
    Then the results reflect the selected status.

    Select type:

    • multi select

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags OOS

    cooperation_statuses[]

    08

    Company Type

    Scenario: User applies Company type filter.
    Given the user selects Company type,
    When the selection is made,
    Then the results reflect the selected status.

    Select type:

    • multi select

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags OOS

    should be added to API by backend developer

    09

    Assignment

    Scenario: User applies Assignment filter.
    Given the user selects Assignment,
    When the selection is made,
    Then the results reflect the selected status.

    Select type:

    • multi select

    • multi tags

    • search OOS

    • suggestions OOS

    • custom tags OOS

    should be added to API by backend developer

    All (default)

    Select options:

    Unassigned

    Assigned

    10

    Market OOS

    Scenario: User filters by country.
    Given country options exist,
    When one is selected,
    Then only companies in that country are displayed.

    Select type:

    • single select

    • single tag

    • search OOS

    • suggestions OOS

    • custom tags OOS

    should be added to API by backend developer

  • Story 1.1.1.1. CRM. Company list page

    Content

    General info

    This feature involves creating a dynamic and user-friendly table within the CRM system that displays a list of companies. The table will include columns for various company attributes such as name, client level (status), vacancies, processes, cooperation status, site, industries, and rocken contact. Users should be able to sort, filter, and search within the table to quickly find the relevant companies. The table should also support pagination for easy navigation through large datasets.

    User story

    As a CRM user,
    I want to view, search, and manage a list of companies in a table format,
    So that I can efficiently manage company information and make informed decisions.


    RT-6078

    Получение подробных данных проблемы…
    СТАТУС

    Visual design:

    https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/Rocken-Design?node-id=58203-68552&t=QKDY3vrnbfvvmGMx-4

    Acceptance criteria

    01

    Scenario 1: Display Company List Table

    Given I am logged into the CRM,

    When I navigate to the "Companies" section,

    Then I should see a table displaying a list of all companies with columns for name with country flag, client level (status), vacancies, processes, cooperation status, site, industries, and rocken contact

    image-20241220-072213.png

    02

    Scenario 2: Pagination of Company List

    Given: I am viewing the company list table,

    When: the number of companies exceeds the default page limit (10 per page),

    Then: I should see pagination controls at the bottom of the table,

    AND I should be able to navigate between different pages of the company list.

    image-20240816-064458.png

    03

    Given: I am viewing the company list table,

    When: I click on a company’s name,

    Then: I should be redirected to that company’s detailed profile page.

  • Epic 1.1.1. CRM. Company list view

    Content

    General info

    Page with a list of companies that work with Rocken. Rocken earns money on candidates who are a good fit for companies.

    Epic ticket: RT-5253 - Получение подробных данных проблемы… СТАТУС

    User stories

    Visual design

    https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/ROCKEN-jobs-%2F-talent?node-id=21124-112524&t=ZBa44UX1z6m4z1f7-4

  • 1.11. CRM. Task manager

    Content

    General info

    Purpose:

    • Guide employees on their priorities and required actions.

    • Create tasks from notifications that trigger specific actions.

    Task Creation:

    • Automatic Task Generation: Tasks generated from notifications.

    • Manual Task Creation: Employees can manually create tasks with details like title, description, deadline, and assignee.

    • Recurring Tasks: Options to set tasks to recur at specific intervals.

    • Subtasks and Dependencies: Ability to break down larger tasks into subtasks and set dependencies.

    Task Categories and Specific Tasks:

    Consultant/Account Management:

    • Vacancies:

      • Check Vacancy: Created when a vacancy seems to be offline.

      • Reopened Vacancy: Created when a vacancy is no longer reserved by other consultants. and is in the categories of consultant

      • New Vacancy to Match: Created when a new vacancy is attached to a consultant, and is the same categories as consultant

      • Vacancy not Matched for 1 Week: Reminder to match a vacancy after 1 week, attached to consultant

      • New Matching Candidate: Alert for new candidates matching specific vacancies.

    • Processes:

      • Follow Up: Triggered if a company hasn't responded in 2 weeks.

      • Process Status Change: Notifies changes in process status (e.g., interview stages).

      • New Message: Alerts about new messages from candidates or companies.

      • Feedback to Collect Candidate Interview: Reminder to collect feedback post-interview.

      • Brief candidate: Interview/trial Day: Information about upcoming interview(trial day, task to brief candidate 24hrs before event..

    Recruiting

    • Candidate Management:

      • Account Deactivation: When a candidate wants to deactivate their account.

      • Profile Changes: Alerts when a candidate's profile is updated.

      • Unresponsive Candidates: Reminders when candidates do not respond within 3 days.

    • Application Management:

      • New or Reapplied Applicants: Alerts for new or returning applicants.

      • Interview Updates: Notifications about interview statuses and interview (internal) comping up.

      • Publications: Notification if a publication goes offline.

    Tasks for Everyone:

    • KT Reminders: Alerts for upcoming KT events.

    Content Team:

    • Profile Creation: Tasks for creating new candidate profiles based on recruiter requests.

    Marketing

    • Campaign Launch: Tasks for launching new marketing campaigns.

    • Social Media Update: Notifications for updating social media platforms.

    • Content Approval: Tasks for content review and approval

    Admin

    • Skill Requests: Candidates can request to add new skills to their profiles.

    Manual Task Creation

    • Users can create tasks manually with options to:

      • Assign tasks to other employees.

      • Attach relevant files or documents.

      • Set tasks to recur at specified intervals.

      • Provide title, description, deadline, and assignee details.

    ___________________________________________________________________

    All Notifications:

    • Search Bar: For searching notifications.

    • Filter Options: For filtering notifications by type, date, etc.

    • Notification List: Display all notifications with actionable links.

    Mockups and Design Resources


    Detailed Mockup Suggestion

    Header Section (Top of the Screen)

    • Search Bar:

      • Location: Centered at the top of the screen.

      • Functionality: Allows advanced search capabilities with keyword search.

      • Design: Clear input field with a magnifying glass icon on the left.

    • Filter Options:

      • Location: Next to the search bar.

      • Design: Dropdown menus for each filter category (e.g., categories, priority, deadlines, statuses).

      • Functionality: Allows users to narrow down search results by selecting specific filters.

    Left Sidebar (Task Management Area)

    • Section Headers:

      • Design: Bold, larger font for headers.

      • Headers:

        • Consultant/Account Management

        • Recruiting

        • Tasks for Everyone

        • Content Team

        • Marketing

        • Admin

    • Collapsible Categories:

      • Design: Expandable/collapsible lists under each section header with a small arrow icon indicating the expandable nature.

      • Functionality: Users can click to expand or collapse categories.

      • Example Structure:

        • [Consultancy]

          • Vacancies:

            • Check Vacancy

            • Reopened Vacancy

            • New Vacancy to Match

            • Vacancy not Matched for 1 Week

            • New Matching Candidate

          • Processes:

            • Follow Up

            • Process Status Change

            • New Message

            • Feedback to Collect Candidate Interview

            • Brief candidate: Interview/trial Day

        • [Recruiting:]

          • Candidate Management:

            • Account Deactivation

            • Profile Changes

            • Unresponsive Candidates

          • Application Management:

            • New or Reapplied Applicants

            • Interview Updates

            • Publications

        • [Tasks for Everyone:]

          • KT Reminders

        • [Content Team:]

          • Profile Creation

        • [Marketing:]

          • Task Assignment

          • Campaign Launch

          • Social Media Update

          • Content Approval

        • [Admin:]

          • Skill Requests

    Main Content Area

    • Dashboard:

      • Layout: Customizable widgets arranged in a grid format.

      • Widgets:

        • Task statistics (e.g., number of tasks completed, pending tasks).

        • Upcoming deadlines.

        • Task distribution by category.

      • Design: Color-coded indicators for urgency and deadlines (e.g., red for urgent tasks, green for completed tasks).

      • Functionality: Widgets can be added, removed, or rearranged based on user preferences.

    • Task List:

      • Layout: Displayed below the dashboard widgets.

      • Features:

        • Section at the top for pinned or favorite tasks.

        • Dropdown menu for sorting tasks by different parameters such as deadline, priority, creation date, and assignee.

      • Design: Clear and readable list format with icons indicating task type and status.

    Right Sidebar (All Notifications Display and Calendar)

    • All Notifications Display:

      • Layout: Vertical list on the right side, taking up half of the right sidebar height.

      • Sorting: Tasks and notifications sorted by newest first.

      • Features:

        • Each task item displays basic information (title, due date, assignee).

        • Option to expand each task item for more details (e.g., description, subtasks, attachments).

        • Unseen Tasks Indicator:

          • Small badge showing the number of unseen tasks, displayed next to the header.

        • Clickable Link:

          • “View All Notifications” link at the bottom of the sidebar, leading to a dedicated notifications page for detailed viewing and management.

    • Calendar:

      • Layout: Positioned below the All Notifications Display, taking up the remaining half of the right sidebar height.

      • Default View: Monthly view with options to switch to daily or weekly views.

      • Features:

        • Drag-and-Drop:

          • Functionality to move tasks to different dates.

        • Event Creation:

          • Button to add new tasks or events directly from the calendar view.

        • Sync Options:

          • Button to sync with external calendars like Google Calendar, Outlook, etc.

      • Design: Clean calendar layout with tasks displayed on their respective due dates. Different colors for different task categories for easy visual distinction. Hover effect to show task details on the calendar.

    All Notifications Page (Accessible via Link)

    • Notification List:

      • Layout: Detailed list of notifications with actionable links.

      • Features:

        • Each notification displays basic information (type, date, description).

        • Actionable links for quick task creation or updates.

        • Pagination controls at the bottom for easy navigation through multiple pages of notifications.

    • Search and Filter Options:

      • Location: At the top of the notifications page.

      • Features:

        • Search bar for searching notifications by keywords.

        • Filter options to narrow down notifications by type, date, etc.

        • Clear button to reset filters and search terms.

      • Design: Consistent with the main search bar and filters in the header section. Dropdown filters with icons for each filter type.

    Visual Elements

    • Color Scheme:

      • Primary Colors: Blue for actionable items, red for urgent tasks, green for completed tasks, and yellow for tasks due soon.

      • Background: Light gray for a clean and modern look.

      • Text: Dark gray for readability, with black for headings.

      • Hover Effects: Slightly darker shades of the primary colors to indicate interactive elements.

    • Icons:

      • Relevant icons for each category and task type to improve visual recognition.

      • Examples:

        • Envelope icon for messages.

        • Clock icon for deadlines.

        • Checkmark for completed tasks.

      • Icons are styled consistently with a flat design and use the primary color scheme.

  • Story 2.2.9.10. RT. Profile preview. Action buttons for company staff

    Content

    General info

     

    User story

    As a company staff user

    I want to approve (invite to the interview) or reject suggested candidates

    So that helps to proceed with a process and hire a candidate

    Visual design:

    https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/ROCKEN-jobs-%2F-talent?node-id=47279-64002&t=G6SrkU6LBKdPIADw-4

     

     

    Acceptance criteria

     

    01

    Given: Email to the company staff about candidate

    When: open profile preview by company staff

    Then: see 3 buttons for interact with this profile on general and interview tabs

    old system popup:

    image-20240808-145753.png

    For new system it’s not needed – OOS

    image-20240808-064152.png

    image-20240808-064807.png

    02

    Given: profile preview

    When: click interested

    Then: modal with suggested dates and time for interview
    AND show successful message
    AND process continue with status company accepted
    AND candidate approved on the page with a date

    Old system:

    image-20240808-150040.png

    New system:

    image-20240808-071828.pngimage-20240808-064941.png

    03

    Given: profile preview

    When: click NOT interested

    Then: see the modal window with rejection reasons
    AND process finished with the status company rejected
    AND candidate was rejected on the page with a date but action button didn’t changed

    Old system:

    image-20240808-150838.png

    New system:

    image-20240808-150902.pngimage-20240808-064955.png

    04

    Given: profile preview

    When: click follow-up question

    Then: process continues with the status company enquiry
    AND see the modal window

    old system:

    image-20240808-150334.png

    new system:

    image-20240808-135821.png

    05

    Given: profile preview

    When: click icon chat right-bellow

    Then: see the modal window

    image-20240808-065207.png

    06

    Given: popup to candidate

    When: click Cancel OR X

    Then: modal window is closed

    07

    Given: modal window to consultant

    When: type message
    AND click Send message

    Then: consultant receives the message
    AND show successful message

    image-20240808-065443.png

    08

    Given: profile preview

    When: scroll down

    Then: see action buttons sticky to the bottom page

    image-20240808-065631.png

    09

    Given: profile preview

    When: move the cursor out of the window

    Then: see the modal window let us know

    image-20240808-071708.png

  • Story 1.7.2.13. CRM. User tab “Team hierarchy”

    Content

    General info

    The "Team Hierarchy" tab provides users with a visual representation of the team hierarchy within the CRM. This tab displays the organizational structure, showing how users are related in terms of reporting lines and team organization.

    User story

    As a [CRM user],
    I want to view the team hierarchy on the User View Page,
    So that I can understand the organizational structure and reporting lines.

    Visual design

    ?

     

    Acceptance criteria

     

    01

    Scenario: Viewing Team Hierarchy
    GIVEN I am on the User View Page,
    WHEN I navigate to the "Team Hierarchy" tab,
    THEN I should see a visual representation of the team hierarchy, showing reporting lines and organizational structure.

    02

    Scenario: Interacting with the Hierarchy
    GIVEN I am on the "Team Hierarchy" tab,
    WHEN I click on a user in the hierarchy,
    THEN I should be taken to that user’s detail view or see additional details about their role within the organization.

    03

    Given: open CRM user view page (HoR)

    When: click on the tab “Team hierarchy”

    Then: See the ability to view team members (recruiters) for this HoR

     

    04

    Given: open CRM user view page (Hoc)

    When: click on the tab “Team hierarchy”

    Then: See the ability to view team members (consultants) for this HoC

  • Story 2.4.1.10. RT. Interview. Interview footer

    Content

    General info


    RT-4638

    Получение подробных данных проблемы…
    СТАТУС

    User story

    As a candidate

    I want to change the view mode or language, visit about, or contact pages

    So that helps to interact with the page in more convenient way

    Visual design

    https://www.figma.com/design/I5CXH7H3ICD0vfA1kPbcVf/ROCKEN-jobs-%2F-talent?node-id=50162-85102&t=3g6qXhcznHegkz82-4

    Acceptance criteria

    01

    Given: interview pages

    When: select English language

    Then: language is changed

    image-20240807-133326.png

    02

    Given: interview pages

    When: select dark theme

    Then: dark theme is applied

    03

    Given: interview pages

    When: click on links
    Datenshutz / AGB
    About
    Contact

    Then: redirect to relevant pages