@goplusvn/core 0.1.0 → 0.1.2

package/src/infrastructure/logger/types.ts

@@ -0,0 +1,25 @@
+// Logger Types
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+
+export interface LoggerOptions {
+  /** Logger name/context for identification */
+  name?: string;
+  /** Minimum log level */
+  level?: LogLevel;
+  /** Enable file output */
+  enableFile?: boolean;
+  /** Directory for log files */
+  dirname?: string;
+}
+
+export interface LogContext {
+  [key: string]: unknown;
+}
+
+export interface Logger {
+  trace(message: string, context?: LogContext): void;
+  debug(message: string, context?: LogContext): void;
+  info(message: string, context?: LogContext): void;
+  warn(message: string, context?: LogContext): void;
+  error(message: string, context?: LogContext): void;
+}

package/src/layout/index.tsx

@@ -0,0 +1,185 @@
+// @goerp/core/layout
+// Layout components for GoERP applications
+//
+// NOTE: This module contains basic layout shells.
+// Full layout components (sidebar, header, navigation) should be migrated
+// from packages/shared/layout as needed.
+
+"use client";
+
+import * as React from "react";
+import { cn } from "../utils";
+
+// ============================================================================
+// AppShell - Main application container
+// ============================================================================
+
+export interface AppShellProps {
+  children: React.ReactNode;
+  sidebar?: React.ReactNode;
+  header?: React.ReactNode;
+  footer?: React.ReactNode;
+  className?: string;
+}
+
+export function AppShell({
+  children,
+  sidebar,
+  header,
+  footer,
+  className,
+}: AppShellProps) {
+  return (
+    <div className={cn("flex min-h-screen", className)}>
+      {sidebar}
+      <div className="flex flex-1 flex-col">
+        {header}
+        <main className="flex-1">{children}</main>
+        {footer}
+      </div>
+    </div>
+  );
+}
+
+// ============================================================================
+// Header
+// ============================================================================
+
+export interface HeaderProps {
+  children?: React.ReactNode;
+  className?: string;
+  sticky?: boolean;
+}
+
+export function Header({ children, className, sticky = true }: HeaderProps) {
+  return (
+    <header
+      className={cn(
+        "border-b bg-background",
+        sticky && "sticky top-0 z-50",
+        className,
+      )}
+    >
+      {children}
+    </header>
+  );
+}
+
+// ============================================================================
+// Sidebar
+// ============================================================================
+
+export interface SidebarProps {
+  children?: React.ReactNode;
+  className?: string;
+  collapsed?: boolean;
+  width?: string | number;
+  collapsedWidth?: string | number;
+}
+
+export function Sidebar({
+  children,
+  className,
+  collapsed = false,
+  width = 280,
+  collapsedWidth = 68,
+}: SidebarProps) {
+  const sidebarWidth = collapsed ? collapsedWidth : width;
+
+  return (
+    <aside
+      className={cn("border-r bg-background transition-all", className)}
+      style={{
+        width:
+          typeof sidebarWidth === "number" ? `${sidebarWidth}px` : sidebarWidth,
+      }}
+    >
+      {children}
+    </aside>
+  );
+}
+
+// ============================================================================
+// Footer
+// ============================================================================
+
+export interface FooterProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export function Footer({ children, className }: FooterProps) {
+  return (
+    <footer className={cn("border-t bg-background", className)}>
+      {children}
+    </footer>
+  );
+}
+
+// ============================================================================
+// PageContainer
+// ============================================================================
+
+export interface PageContainerProps {
+  children: React.ReactNode;
+  className?: string;
+  title?: string;
+  description?: string;
+}
+
+export function PageContainer({
+  children,
+  className,
+  title,
+  description,
+}: PageContainerProps) {
+  return (
+    <div className={cn("w-full px-4 md:px-6 lg:px-8 py-6", className)}>
+      {(title || description) && (
+        <div className="mb-6">
+          {title && <h1 className="text-2xl font-bold">{title}</h1>}
+          {description && (
+            <p className="text-muted-foreground">{description}</p>
+          )}
+        </div>
+      )}
+      {children}
+    </div>
+  );
+}
+
+// ============================================================================
+// Breadcrumb
+// ============================================================================
+
+export interface BreadcrumbItem {
+  label: string;
+  href?: string;
+}
+
+export interface BreadcrumbProps {
+  items: BreadcrumbItem[];
+  className?: string;
+}
+
+export function Breadcrumb({ items, className }: BreadcrumbProps) {
+  return (
+    <nav className={cn("flex items-center space-x-2 text-sm", className)}>
+      {items.map((item, index) => (
+        <React.Fragment key={index}>
+          {index > 0 && <span className="text-muted-foreground">/</span>}
+          {item.href ? (
+            <a
+              href={item.href}
+              className="text-muted-foreground hover:text-foreground"
+            >
+              {item.label}
+            </a>
+          ) : (
+            <span className="font-medium">{item.label}</span>
+          )}
+        </React.Fragment>
+      ))}
+    </nav>
+  );
+}

package/src/navigation/index.ts

@@ -0,0 +1,91 @@
+// @goerp/core/navigation
+// Core navigation utilities for GoERP platform
+// Consolidated from packages/shared/navigation
+
+import type {
+  NavigationType,
+  NavigationRootItem,
+  NavigationNestedItem,
+} from "../types";
+
+/**
+ * Filter navigation items based on permissions recursively
+ */
+export function filterNavigationItems(
+  items: NavigationRootItem[],
+  accessibleCodes: Set<string>,
+): NavigationRootItem[];
+export function filterNavigationItems(
+  items: NavigationNestedItem[],
+  accessibleCodes: Set<string>,
+): NavigationNestedItem[];
+export function filterNavigationItems(
+  items: NavigationRootItem[] | NavigationNestedItem[],
+  accessibleCodes: Set<string>,
+): (NavigationRootItem | NavigationNestedItem)[] {
+  return items.reduce<(NavigationRootItem | NavigationNestedItem)[]>(
+    (acc, item) => {
+      // If admin (special wildcard), show everything
+      if (accessibleCodes.has("*")) {
+        acc.push(item);
+        return acc;
+      }
+
+      // Default Deny: If resource is defined AND resource is not accessible
+      // If resource is missing, we consider it public (as per comment below)
+      if (item.resource && !accessibleCodes.has(item.resource)) {
+        return acc;
+      }
+
+      // Handle nested items
+      if ("items" in item && item.items) {
+        const filteredChildren = filterNavigationItems(
+          item.items as (NavigationRootItem | NavigationNestedItem)[],
+          accessibleCodes,
+        );
+
+        // Only add parent if it has visible children
+        if (filteredChildren.length > 0) {
+          acc.push({
+            ...item,
+            items: filteredChildren,
+          });
+        }
+      } else {
+        // Leaf node (link) - already checked resource above
+        // If no resource defined, assume public/visible
+        acc.push(item);
+      }
+
+      return acc;
+    },
+    [],
+  );
+}
+
+/**
+ * Filter navigation tree based on permissions
+ */
+export function filterNavigationTree(
+  navigation: NavigationType[],
+  accessibleCodes: Set<string>,
+): NavigationType[] {
+  if (accessibleCodes.has("*")) {
+    return navigation;
+  }
+
+  const filteredNavigation: NavigationType[] = [];
+
+  for (const group of navigation) {
+    const filteredItems = filterNavigationItems(group.items, accessibleCodes);
+
+    if (filteredItems.length > 0) {
+      filteredNavigation.push({
+        ...group,
+        items: filteredItems,
+      });
+    }
+  }
+
+  return filteredNavigation;
+}

package/src/notification/index.ts

@@ -0,0 +1,14 @@
+export {
+  notificationService,
+  NotificationServiceImpl,
+} from "./notification-service";
+export { InMemoryStorage } from "./storage";
+export type {
+  Notification,
+  NotificationType,
+  NotificationChannel,
+  NotificationStatus,
+  CreateNotificationInput,
+  NotificationStorage,
+  NotificationServiceOptions,
+} from "./types";

package/src/notification/notification-service.ts

@@ -0,0 +1,120 @@
+import type {
+  CreateNotificationInput,
+  Notification,
+  NotificationServiceOptions,
+  NotificationStorage,
+} from "./types";
+import { InMemoryStorage } from "./storage/in-memory";
+import { createLogger } from "../infrastructure/logger";
+import { eventBus } from "../infrastructure/event-bus";
+
+const logger = createLogger("NotificationService");
+
+/**
+ * NotificationService - sends and manages user notifications
+ *
+ * @example
+ * ```typescript
+ * import { notificationService } from '@goerp/core/notification';
+ *
+ * // Send notification
+ * await notificationService.send({
+ *   userId: 'manager-123',
+ *   title: 'Purchase Order cần duyệt',
+ *   content: 'PO-001 chờ phê duyệt',
+ *   type: 'approval',
+ *   link: '/purchase-orders/PO-001'
+ * });
+ *
+ * // Get unread notifications
+ * const unread = await notificationService.getUnread('manager-123');
+ *
+ * // Mark as read
+ * await notificationService.markAsRead('notification-id');
+ * ```
+ */
+class NotificationServiceImpl {
+  private storage: NotificationStorage;
+
+  constructor(options: NotificationServiceOptions = {}) {
+    this.storage = options.storage || new InMemoryStorage();
+  }
+
+  /** Set custom storage implementation */
+  setStorage(storage: NotificationStorage): void {
+    this.storage = storage;
+  }
+
+  /** Send a notification */
+  async send(input: CreateNotificationInput): Promise<Notification> {
+    const notification: Notification = {
+      id: crypto.randomUUID(),
+      userId: input.userId,
+      title: input.title,
+      content: input.content,
+      type: input.type || "info",
+      channel: input.channel || "in-app",
+      status: "sent",
+      link: input.link,
+      metadata: input.metadata,
+      createdAt: new Date(),
+    };
+
+    await this.storage.save(notification);
+
+    logger.debug("Notification sent", {
+      id: notification.id,
+      userId: notification.userId,
+      type: notification.type,
+    });
+
+    // Emit event for real-time updates
+    eventBus.emit("notification.sent", { notification });
+
+    return notification;
+  }
+
+  /** Get all notifications for a user */
+  async getAll(userId: string): Promise<Notification[]> {
+    return this.storage.findByUserId(userId);
+  }
+
+  /** Get unread notifications for a user */
+  async getUnread(userId: string): Promise<Notification[]> {
+    return this.storage.findByUserId(userId, { unreadOnly: true });
+  }
+
+  /** Get unread count for a user */
+  async getUnreadCount(userId: string): Promise<number> {
+    const unread = await this.getUnread(userId);
+    return unread.length;
+  }
+
+  /** Get a notification by ID */
+  async getById(id: string): Promise<Notification | null> {
+    return this.storage.findById(id);
+  }
+
+  /** Mark a notification as read */
+  async markAsRead(id: string): Promise<void> {
+    await this.storage.markAsRead(id);
+    eventBus.emit("notification.read", { id });
+  }
+
+  /** Mark all notifications as read for a user */
+  async markAllAsRead(userId: string): Promise<void> {
+    await this.storage.markAllAsRead(userId);
+    eventBus.emit("notification.allRead", { userId });
+  }
+
+  /** Delete a notification */
+  async delete(id: string): Promise<void> {
+    await this.storage.delete(id);
+  }
+}
+
+// Singleton instance
+export const notificationService = new NotificationServiceImpl();
+
+// Export class for testing
+export { NotificationServiceImpl };

package/src/notification/storage/in-memory.ts

@@ -0,0 +1,56 @@
+import type { Notification, NotificationStorage } from "../types";
+
+/**
+ * In-memory notification storage for development/testing
+ * In production, replace with database storage
+ */
+export class InMemoryStorage implements NotificationStorage {
+  private notifications = new Map<string, Notification>();
+
+  async save(notification: Notification): Promise<void> {
+    this.notifications.set(notification.id, notification);
+  }
+
+  async findByUserId(
+    userId: string,
+    options?: { unreadOnly?: boolean },
+  ): Promise<Notification[]> {
+    const result: Notification[] = [];
+
+    for (const notification of this.notifications.values()) {
+      if (notification.userId === userId) {
+        if (options?.unreadOnly && notification.status === "read") {
+          continue;
+        }
+        result.push(notification);
+      }
+    }
+
+    return result.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+  }
+
+  async findById(id: string): Promise<Notification | null> {
+    return this.notifications.get(id) || null;
+  }
+
+  async markAsRead(id: string): Promise<void> {
+    const notification = this.notifications.get(id);
+    if (notification) {
+      notification.status = "read";
+      notification.readAt = new Date();
+    }
+  }
+
+  async markAllAsRead(userId: string): Promise<void> {
+    for (const notification of this.notifications.values()) {
+      if (notification.userId === userId && notification.status !== "read") {
+        notification.status = "read";
+        notification.readAt = new Date();
+      }
+    }
+  }
+
+  async delete(id: string): Promise<void> {
+    this.notifications.delete(id);
+  }
+}

package/src/notification/storage/index.ts

@@ -0,0 +1 @@
+export { InMemoryStorage } from "./in-memory";

package/src/notification/types.ts

@@ -0,0 +1,51 @@
+// Notification Types
+export type NotificationType =
+  | "info"
+  | "warning"
+  | "error"
+  | "success"
+  | "approval";
+export type NotificationChannel = "in-app" | "email" | "sms";
+export type NotificationStatus = "pending" | "sent" | "read" | "failed";
+
+export interface Notification {
+  id: string;
+  userId: string;
+  title: string;
+  content: string;
+  type: NotificationType;
+  channel: NotificationChannel;
+  status: NotificationStatus;
+  /** Link to navigate when clicked */
+  link?: string;
+  /** Additional metadata */
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  readAt?: Date;
+}
+
+export interface CreateNotificationInput {
+  userId: string;
+  title: string;
+  content: string;
+  type?: NotificationType;
+  channel?: NotificationChannel;
+  link?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface NotificationStorage {
+  save(notification: Notification): Promise<void>;
+  findByUserId(
+    userId: string,
+    options?: { unreadOnly?: boolean },
+  ): Promise<Notification[]>;
+  findById(id: string): Promise<Notification | null>;
+  markAsRead(id: string): Promise<void>;
+  markAllAsRead(userId: string): Promise<void>;
+  delete(id: string): Promise<void>;
+}
+
+export interface NotificationServiceOptions {
+  storage?: NotificationStorage;
+}