MenuProviderExtension

package com.auraboot.framework.plugin.extension;

public interface MenuProviderExtension extends ExtensionPoint {

    /**
     * 本提供者贡献到的菜单组。
     * 常用组名："main-sidebar"、"header-menu"、"user-menu"、"settings-menu"
     */
    String getMenuGroup();

    /**
     * 返回给定上下文下需要添加的菜单项。
     */
    List<MenuItem> getMenuItems(MenuContext context);

    /**
     * 守卫方法。返回 false 则本次不贡献任何项。
     * 默认：true（始终激活）。
     */
    default boolean isActive(MenuContext context) {
        return true;
    }

    /**
     * 在菜单组内的排序。值越小越靠前。
     * 默认：100。
     */
    default int getOrder() {
        return 100;
    }

    record MenuContext(
            Long tenantId,
            String pluginId,
            String namespace,
            Long userId,
            List<String> userRoles,
            List<String> userPermissions,
            Map<String, Object> settings
    ) {
        public boolean hasRole(String role) { ... }
        public boolean hasPermission(String permission) { ... }
    }

    record MenuItem(
            String key,
            String label,
            String icon,
            String path,
            String target,          // 默认 "_self"
            int order,              // 默认 100
            List<MenuItem> children,
            List<String> requiredRoles,
            List<String> requiredPermissions,
            Map<String, Object> metadata
    ) {}
}

@Extension
public class BillingMenuProvider implements MenuProviderExtension {

    @Override
    public String getMenuGroup() {
        return "main-sidebar";
    }

    @Override
    public boolean isActive(MenuContext context) {
        // 仅当当前用户持有 billing.invoice.view 权限时显示
        return context.hasPermission("billing.invoice.view");
    }

    @Override
    public List<MenuItem> getMenuItems(MenuContext context) {
        return List.of(
            MenuItem.builder()
                .key("billing-invoices")
                .label("Invoices")
                .icon("receipt")
                .path("/billing/invoices")
                .order(100)
                .requiredPermissions(List.of("billing.invoice.view"))
                .build(),
            MenuItem.builder()
                .key("billing-payments")
                .label("Payments")
                .icon("credit-card")
                .path("/billing/payments")
                .order(110)
                .requiredPermissions(List.of("billing.payment.view"))
                .build()
        );
    }

    @Override
    public int getOrder() {
        return 50; // 排在默认提供者之前
    }
}