Admin/Partners

[IrynaZavushchak]

As an Admin I want to view and manage partners in a table and create new partners, so that I can ensure up-to-date information about project partners for users.   Mockup 


Acceptance Criteria

1. Access to the Team Section. 
 The administrator can access the Partners section in the admin panel.

2. Team Table Display. 
 The admin panel displays the Partners table with the following columns:


• Title | Назва
• Link | Посилання
• Logo | Лого
• Social medias | Соціальні мережі
• Actions: Edit, Delete | Дії: Редагувати, Видалити

3. Table Functionalities 3.1. Sorting (User Story #2464-2): -Default sorting: by the last modification date (latest modified items appear first). -Alphabetical sorting (A → Z, Z → A) for: Title. 3.2. Search (User Story #2464-3): by Title. 3.3. Filtering (User Story #2464-4): by Key partners - "All" and Key partners (displayed as a dropdown). The default selection is All. 3.4. Pagination is implemented for the partner table (User Story #2464-5). 3.5. Editing Partner: Clicking the Edit icon opens the edit modal, which has the same fields and requirements as the Add Partner modal. The administrator can modify and save changes by clicking the Save button, the system updates the data, and displays a notification: EN: "The partner was successfully updated" UA: "Партнера успішно оновлено" 3.6. Deleting Partner: Clicking the Delete icon opens a confirmation modal: EN: "Are you sure you want to delete the partner?" UA: "Ви впевнені, що хочете видалити партнера?" The confirmation modal contains two buttons: "Confirm" | "Підтвердити" – confirms and deletes the partner. "Cancel" | "Скасувати" – cancels the action and closes the modal.
If Confirm is clicked, the system displays a notification: EN: "Partner successfully deleted" UA: "Партнера успішно видалено"

4. Partner Fields and Validation 4.1. Check-box “Key partner” | “Ключовий партнер”. The administrator can mark a member as a "Key partner" via a checkbox. If a member was marked as a "Key partner," he appears on the main page in the “Our partner” | "Наші партнери" section and the top of the Partners Page on the website. 4.2. Check-box “Visible for everyone” | “Видимий для віх”. The administrator can mark a member as "Visible for everyone" via a checkbox. If a partner is marked as "Visible for everyone", they appear on every History code page in the Partner Slider at the bottom of the site. 4.3. Title Field: Length: 1–100 characters. Allowed: Cyrillic & Latin letters, special characters (‘, -), spaces. It has a character counter. The field cannot be empty. The system cannot add more than 100 characters. 4.3.1. If the administrator tries to add more than 100 characters, highlights the field in red, and displays an error message under the field: EN: "Maximum of 100 characters" UA: "Не більше 100 символів" 4.3.2 If the field has invalid characters, the system highlights the field in red and displays an error message under the field: EN: "Only letters, spaces, hyphens (-), and apostrophes (') are allowed" UA: "Дозволені лише літери, пробіли, дефіси (-) та апострофи (')" 4.3.3. If the field is empty, the system highlights the field in red and displays an error message under the field: EN: "Enter title" UA: "Введіть назву" 4.4. Link Field (optional). Length: 1–255 characters. Allowed: Latin letters, numbers, and special characters. It has a character counter. The system can't add more than 255 characters.
 4.4.1. If the field is empty, the system highlights the field in red and displays an error message under the field: EN: "Enter link" UA: "Введіть посилання" 4.4.2. If the administrator adds more than 255 characters, highlights the field in red, and displays an error message under the field: EN: "Maximum of 255 characters" UA: "Не більше 255 символів" 4.4.3. If the field has invalid characters, the system highlights the field in red and displays an error message under the field:
EN: "Invalid link" UA: "Некоректне посилання" 4.5. Link Title (disable by default). If the administrator filled the Link Field, the Link Title Field becomes enabled. Length: 1–100 characters. Allowed: Latin letters, numbers, and special characters. It has a character counter. The field can't be empty. The system cannot add more than 100 characters. 4.5.1. If the field is empty, the system highlights the field in red and displays an error message under the field: EN: "Enter link title" UA: "Введіть назву посилання" 4.6.3. If the administrator adds more than 100 characters, highlights the field in red, and displays an error message under the field: EN: "Maximum of 100 characters" UA: "Не більше 100 символів" 4.6. Description (optional): Length: Up to 450 characters. Allowed: Cyrillic & Latin letters, numbers, special characters, spaces. It has a character counter. The system cannot add more than 450 characters. If the administrator tries to add more than 450 characters, the field is highlighted in red, and an error message is displayed under the field: EN: "Maximum of 450 characters" UA: "Не більше 450 символів" 4.7. Logo Upload. (User Story #2465-5.6). Please note: for Partner Page, use “Logo” instead of “Image”. 4.8. History code selector. A dropdown list for selecting an existing History code. 4.9. Social Media Select and Link Field. (User Story #834-4.6). Available social media for partner page: YouTube, Instagram, Facebook, X, Ваш сайт.

5. Creating a Partner 5.1. The administrator clicks the “Add Partner” | “Додати партнера” button in the Partners section. 5.2. The system opens the “Add Partner” | “Додати партнера” modal. 5.3. The administrator must fill in the required fields per Section 4: Partner Fields and Validation. 5.4. Saving Partner:
If required fields are filled, the “Save” | “Зберегти” button changes from disabled to enabled state. The administrator clicks the button, and the system saves the new partner to the table and displays a success notification: EN: "The partner was successfully added and published" UA: "Партнера успішно додано та опубліковано" 5.5. After the administrator clicks the “Save” | “Зберегти” button, the modal closes automatically. 5.6. The system must check the unique value Title fields. If the value already exists, the system displays a confirmation modal: EN: "This partner already exists. Replace an existing partner?" UA: "Партнер команди вже існує. Замінити існуючого партнера?" The confirmation modal contains two buttons: "Confirm" | "Підтвердити" – confirms and replaces the partner. "Cancel" | "Скасувати" – cancels the action and returns the modal.
If Confirm is clicked, the system displays a notification: EN: "Partner successfully replaced" UA: "Партнера успішно замінено" 5.7. Canceling Partner Creation: The administrator can cancel partner creation by clicking the cross button; the modal closes automatically. 5.7.1. The X button has a tooltip: EN: Don’t forget to save it!" UA: "Не забудьте зберегти!"

Epic link Epic(Admin/Other pages)