PoliticianMenuItemFactoryImpl.java

/*
 * Copyright 2010-2025 James Pether Sörling
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 *  $Id$
 *  $HeadURL$
 */
package com.hack23.cia.web.impl.ui.application.views.common.menufactory.impl;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.hack23.cia.web.impl.ui.application.views.common.menufactory.api.ApplicationMenuItemFactory;
import com.hack23.cia.web.impl.ui.application.views.common.menufactory.api.PoliticianMenuItemFactory;
import com.hack23.cia.web.impl.ui.application.views.common.menufactory.api.PoliticianRankingMenuItemFactory;
import com.hack23.cia.web.impl.ui.application.views.common.menufactory.api.pagecommands.PageCommandPoliticianConstants;
import com.hack23.cia.web.impl.ui.application.views.common.rows.RowUtil;
import com.jarektoro.responsivelayout.ResponsiveRow;
import com.vaadin.icons.VaadinIcons;
import com.vaadin.ui.MenuBar;
import com.vaadin.ui.MenuBar.MenuItem;
import com.vaadin.ui.VerticalLayout;

/**
 * The Class PoliticianMenuItemFactoryImpl.
 *
 * <p>
 * This class builds menus and overview pages for politician-related views,
 * vote histories, and more. It integrates with
 * enabling users to navigate through indicators, roles, document activities,
 * vote histories, and more. It integrates with
 * {@link ApplicationMenuItemFactory}
 * and {@link PoliticianRankingMenuItemFactory} to ensure consistent menu
 * structures within the application.
 * </p>
 */
@Service
public final class PoliticianMenuItemFactoryImpl extends AbstractMenuItemFactoryImpl
                implements PoliticianMenuItemFactory {

        /** Menu labels. */
        private static final String BALLOT_DECISION_SUMMARY_TEXT = "Ballot Decision Summary";

        /** The Constant BALLOTS_TEXT. */
        private static final String BALLOTS_TEXT = "Ballots";

        /** The Constant DOCUMENT_ACTIVITY_TEXT. */
        private static final String DOCUMENT_ACTIVITY_TEXT = "Document Activity";

        /** The Constant DOCUMENT_HISTORY_TEXT. */
        private static final String DOCUMENT_HISTORY_TEXT = "Document History";

        /** The Constant DOCUMENTS_TEXT. */
        private static final String DOCUMENTS_TEXT = "Documents";

        /** The Constant INDICATORS_TEXT. */
        private static final String INDICATORS_TEXT = "Indicators";

        /** The Constant OVERVIEW_TEXT. */
        private static final String OVERVIEW_TEXT = "Overview";

        /** The Constant PAGE_VISIT_HISTORY_TEXT. */
        private static final String PAGE_VISIT_HISTORY_TEXT = "Page Visit History";

        /** The Constant POLITICIAN_RANKING. */
        private static final String POLITICIAN_RANKING = "Politician Ranking";

        /** The Constant ROLE_GHANT_TEXT. */
        private static final String ROLE_GHANT_TEXT = "Role Gantt";

        /** The Constant ROLE_LIST. */
        private static final String ROLE_LIST = "Role List";

        /** The Constant ROLES_TEXT. */
        private static final String ROLES_TEXT = "Roles";

        /** The Constant TOTAL_EXPERIENCE. */
        private static final String TOTAL_EXPERIENCE = "Total Experience";

        /** The Constant VOTE_HISTORY. */
        private static final String VOTE_HISTORY = "Vote History";

        /** Descriptions (~50 characters). */
        private static final String INDICATORS_DESCRIPTION = "Key performance indicators.";

        /** The Constant TOTAL_EXPERIENCE_DESCRIPTION. */
        private static final String TOTAL_EXPERIENCE_DESCRIPTION = "Summary of political experience.";

        /** The Constant ROLE_LIST_DESCRIPTION. */
        private static final String ROLE_LIST_DESCRIPTION = "Detailed list of roles.";

        /** The Constant ROLE_GHANT_DESCRIPTION. */
        private static final String ROLE_GHANT_DESCRIPTION = "Gantt chart of roles.";

        /** The Constant DOCUMENT_ACTIVITY_DESCRIPTION. */
        private static final String DOCUMENT_ACTIVITY_DESCRIPTION = "Activity by document type.";

        /** The Constant DOCUMENT_HISTORY_DESCRIPTION. */
        private static final String DOCUMENT_HISTORY_DESCRIPTION = "History of document access.";

        /** The Constant VOTE_HISTORY_DESCRIPTION. */
        private static final String VOTE_HISTORY_DESCRIPTION = "Summary of voting records.";

        /** The Constant BALLOT_DECISION_SUMMARY_DESCRIPTION. */
        private static final String BALLOT_DECISION_SUMMARY_DESCRIPTION = "Overview of ballot decisions.";

        /** The Constant PAGE_VISIT_HISTORY_DESCRIPTION. */
        private static final String PAGE_VISIT_HISTORY_DESCRIPTION = "History of page visits.";

        /** The application menu item factory. */
        @Autowired
        private ApplicationMenuItemFactory applicationMenuItemFactory;

        /** The politician ranking menu item factory. */
        @Autowired
        private PoliticianRankingMenuItemFactory politicianRankingMenuItemFactory;

        /**
         * Instantiates a new politician menu item factory impl.
         */
        public PoliticianMenuItemFactoryImpl() {
                super();
        }

        /**
         * Creates the overview page with quick-access links to various
         * politician-related
         * views such as indicators, roles, document activities, and vote histories.
         *
         * @param panelContent the {@link VerticalLayout} container that holds the
         *                     overview
         *                     content. New UI components (buttons/links) will be added
         *                     here.
         * @param pageId       the identifier for the current page context.
         */
        @Override
        public void createOverviewPage(final VerticalLayout panelContent, final String pageId) {
                final ResponsiveRow grid = RowUtil.createGridLayout(panelContent);

                createButtonLink(grid, INDICATORS_TEXT, VaadinIcons.CHART,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_VIEW_INDICATORS.createItemPageCommand(pageId),
                                INDICATORS_DESCRIPTION);

                createButtonLink(grid, TOTAL_EXPERIENCE, VaadinIcons.USER_CLOCK,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_ROLE_SUMMARY.createItemPageCommand(pageId),
                                TOTAL_EXPERIENCE_DESCRIPTION);

                createButtonLink(grid, ROLE_LIST, VaadinIcons.LIST,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_ROLE_LIST.createItemPageCommand(pageId),
                                ROLE_LIST_DESCRIPTION);

                createButtonLink(grid, ROLE_GHANT_TEXT, VaadinIcons.USER_CLOCK,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_ROLE_GHANT.createItemPageCommand(pageId),
                                ROLE_GHANT_DESCRIPTION);

                createButtonLink(grid, DOCUMENT_ACTIVITY_TEXT, VaadinIcons.FILE_TEXT,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_DOCUMENT_HISTORY.createItemPageCommand(pageId),
                                DOCUMENT_ACTIVITY_DESCRIPTION);

                createButtonLink(grid, DOCUMENT_HISTORY_TEXT, VaadinIcons.CHART,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_DOCUMENT_HISTORY.createItemPageCommand(pageId),
                                DOCUMENT_HISTORY_DESCRIPTION);

                createButtonLink(grid, VOTE_HISTORY, VaadinIcons.CHECK_CIRCLE,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_BALLOT_HISTORY.createItemPageCommand(pageId),
                                VOTE_HISTORY_DESCRIPTION);

                createButtonLink(grid, BALLOT_DECISION_SUMMARY_TEXT, VaadinIcons.CHECK,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_BALLOT_HISTORY.createItemPageCommand(pageId),
                                BALLOT_DECISION_SUMMARY_DESCRIPTION);

                createButtonLink(grid, PAGE_VISIT_HISTORY_TEXT, VaadinIcons.CHART,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_VIEW_OVERVIEW.createItemPageCommand(pageId),
                                PAGE_VISIT_HISTORY_DESCRIPTION);
        }

        /**
         * Creates the politician menu bar and integrates it into the main application
         * menu.
         * Adds politician ranking topics and specific politician-related menu items.
         *
         * @param menuBar the main application {@link MenuBar} to which the politician
         *                menu will be added.
         * @param pageId  the identifier for the current page context.
         */
        @Override
        public void createPoliticianMenuBar(final MenuBar menuBar, final String pageId) {
                initApplicationMenuBar(menuBar);
                applicationMenuItemFactory.addRankingMenu(menuBar);
                politicianRankingMenuItemFactory.createPoliticianRankingTopics(
                                menuBar.addItem(POLITICIAN_RANKING, VaadinIcons.USER, null));

                final MenuItem politicianItem = menuBar.addItem("Politician " + pageId, VaadinIcons.USER, null);

                politicianItem.addItem(OVERVIEW_TEXT, VaadinIcons.DASHBOARD,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_VIEW_OVERVIEW.createItemPageCommand(pageId));

                politicianItem.addItem(INDICATORS_TEXT, VaadinIcons.CHART,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_VIEW_INDICATORS.createItemPageCommand(pageId));

                final MenuItem rolesItem = politicianItem.addItem(ROLES_TEXT, VaadinIcons.TAGS, null);

                rolesItem.addItem(TOTAL_EXPERIENCE, VaadinIcons.USER_CLOCK,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_ROLE_SUMMARY.createItemPageCommand(pageId));

                rolesItem.addItem(ROLE_LIST, VaadinIcons.LIST,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_ROLE_LIST.createItemPageCommand(pageId));

                rolesItem.addItem(ROLE_GHANT_TEXT, VaadinIcons.USER_CLOCK,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_ROLE_GHANT.createItemPageCommand(pageId));

                final MenuItem documentItem = politicianItem.addItem(DOCUMENTS_TEXT, VaadinIcons.FILE_TEXT, null);

                documentItem.addItem(DOCUMENT_ACTIVITY_TEXT, VaadinIcons.FILE_TEXT,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_DOCUMENT_HISTORY.createItemPageCommand(pageId));

                documentItem.addItem(DOCUMENT_HISTORY_TEXT, VaadinIcons.CHART,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_DOCUMENT_HISTORY.createItemPageCommand(pageId));

                final MenuItem ballotItem = politicianItem.addItem(BALLOTS_TEXT, VaadinIcons.CHECK, null);

                ballotItem.addItem(VOTE_HISTORY, VaadinIcons.CHECK_CIRCLE,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_BALLOT_HISTORY.createItemPageCommand(pageId));

                ballotItem.addItem(BALLOT_DECISION_SUMMARY_TEXT, VaadinIcons.CHECK,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_BALLOT_HISTORY.createItemPageCommand(pageId));

                politicianItem.addItem(PAGE_VISIT_HISTORY_TEXT, VaadinIcons.CHART,
                                PageCommandPoliticianConstants.COMMAND_POLITICIAN_VIEW_OVERVIEW.createItemPageCommand(pageId));
        }}