Skip to content
BranchesTags

Repository files navigation

Taxus Audit Management

Codename: Taxus

Workspace frontend untuk Audit Management yang mempertahankan shell, pola navigasi, dan UX dari keluarga aplikasi Sequoia, tetapi capability-nya dibatasi khusus untuk domain audit.

Rujukan dokumentasi workspace: docs/README.md, Product-Roadmap-Catalog-and-Dev-Ports.md, dan Taxus-Frontend-Microservice-Mapping.md.

Overview

Taxus berfokus pada pengelolaan audit enterprise: perencanaan universe audit, orkestrasi engagement, evidence coordination, findings tracking, dan audit trail readiness. Repository ini sengaja tidak mengekspose capability AI Lifecycle milik Sequoia.

Capabilities

  • Dashboard: ringkasan posture audit, coverage, dan execution load.
  • Audit Universe: daftar entitas audit, risk themes, dan plan scope.
  • Engagements: workspace pelaksanaan audit dari planning sampai closure.
  • Findings & Issues: observasi, severity, remediation owner, dan aging.
  • Evidence Hub: permintaan bukti, kelengkapan, dan review readiness.
  • Audit Trail: kronologi tindakan, persetujuan, dan jejak investigasi.

Tech Stack

  • React 19 + TypeScript + Vite
  • TailwindCSS + shadcn/ui
  • Zustand + TanStack Query
  • React Router + Recharts

Menjalankan Lokal

Prerequisites:

  • Node.js 20.19+ atau 22.12+
  • npm

Install dependency:

npm install

Run development server:

npm run dev

Taxus berjalan di http://localhost:9293 sesuai roadmap product.

Build production bundle:

npm run build

Preview bundle:

npm run preview

Struktur Ringkas

src/
|- auth/
|- components/
|- modules/core-shell/
|- pages/
|- stores/
|- lib/
`- App.tsx

Catatan Implementasi

  • App shell tetap memakai shared notification service dan todo service dengan app_id Taxus sendiri.
  • Routing aplikasi saat ini memakai placeholder audit-focused pages agar domain Taxus bersih dari route Sequoia.
  • Proxy project-service tetap dipertahankan dari template untuk kompatibilitas shell dan ekspansi berikutnya.

Pengujian

  • npm run build untuk validasi TypeScript dan bundling.

Referensi

Routes:

  • /projects/:projectId/deployments/:id/monitoring - Inference monitoring
  • /projects/:projectId/deployments/:id/logs - Inference logs
  • /projects/:projectId/deployments/:id/drift - Drift alerts
  • /deployments/drift - All drift alerts

Key Characteristics:

  • Only Production models can be deployed
  • Observational & governance-oriented

✅ Module 8: Feedback & Ground Truth

Status: Implemented

Purpose: Feedback collection and ground truth management for model improvement.

Features:

  • Feedback list with filtering
  • Feedback detail view
  • Feedback submission form
  • Verification status tracking
  • Global Feedback Inbox (read-only)

Routes:

  • /feedback - Global Feedback Inbox (read-only)
  • /projects/:projectId/feedback/submit - Feedback submission
  • /projects/:projectId/feedback/:id - Feedback detail

Key Characteristics:

  • Non-blocking (optional)
  • Read-only inference history
  • Immutable feedback records

✅ Module 9: Governance, Policy & Audit Readiness

Status: Implemented

Purpose: Enterprise AI governance, policy visibility, and audit traceability.

Features:

  • Governance overview summary
  • Policy registry (read-only)
  • Model governance coverage
  • Audit trail & traceability
  • Compliance readiness checklist
  • Export capabilities (PDF, CSV, ZIP)

Routes:

  • /governance - Governance overview page
  • /governance/projects/:projectId - Project governance coverage

Key Characteristics:

  • Read-only (no mutations)
  • Non-operational (oversight only)
  • Audit-safe (immutable & traceable)

✅ Module 10: AI Portfolio & Value Management

Status: Implemented

Purpose: Strategic oversight for executives, AI CoE, and Enterprise Architecture.

Features:

  • AI Portfolio Overview
  • Value Realization Tracking
  • AI Risk Heatmap
  • Lifecycle Decision Insights
  • Executive Summary

Routes:

  • /portfolio - Portfolio overview page
  • /portfolio/executive-summary - Executive summary page

Key Characteristics:

  • Read-only (no operational controls)
  • Executive-friendly language
  • Strategic oversight only

✅ Module 11: Core Shell & Navigation

Status: Implemented

Purpose: Application shell, navigation, and platform settings.

Features:

  • Collapsible sidebar navigation
  • Topbar with global search, environment indicator, user menu
  • Theme toggle (light/dark) with persistence
  • Platform settings page
  • Responsive layout

Routes:

  • /settings - Platform settings page
  • /profile - User profile page

🔐 Authentication

The application includes authentication with protected routes:

  • Login page at /login
  • Protected routes require authentication
  • User profile management

🗺️ Routing Architecture

Hybrid Information Architecture

The application uses a hybrid information architecture:

  1. Global/Enterprise-Level Routes (Sidebar navigation):

    • Dashboard (/)
    • Projects (/projects)
    • Models (/models) - Global Registry (read-only)
    • Feedback (/feedback) - Global Inbox (read-only)
    • Governance (/governance)
    • Portfolio (/portfolio)
    • Settings (/settings)

  2. Project-Scoped Routes (Accessible from Project Detail):

    • Connectors: /projects/:projectId/connectors/:id
    • Runs: /projects/:projectId/runs/:id
    • Models: /projects/:projectId/models/:id
    • Deployments: /projects/:projectId/deployments/:id/*
    • Feedback: /projects/:projectId/feedback/*

Navigation Flow

  • Entry Point: Projects list (/projects)
  • Workspace: Project detail page with tab-based navigation
  • Global Views: Models, Feedback, Governance, Portfolio (read-only, enterprise-level)

🎨 UI Components

Glassmorphism Utilities

  • .glass - Basic glass effect
  • .glass-card - Card with glass effect
  • .glass-panel - Panel with glass effect
  • .glass-sidebar - Sidebar with glass effect

Theme System

The app supports light and dark themes with automatic persistence using Zustand. Theme preference is stored in localStorage.

📊 State Management

  • Zustand for global state management
  • TanStack Query for server state and caching
  • Module-specific stores for feature state
  • Active project context for project-scoped operations

🔗 Integration Points

The application is designed to integrate with:

  • External Python training engines (via CLI or API)
  • Data sources through connector management
  • Model registries for model versioning and tracking
  • Deployment platforms for production inference
  • Backend APIs for data persistence
  • WebSocket connections for real-time updates (future)
  • Export services for governance reports
  • Collaboration tools for team workflows

📝 Development Guidelines

  1. Module Structure: Each module is self-contained in its own directory
  2. Design System: Follow glassmorphism design system consistently
  3. State Management: Use Zustand for local state, TanStack Query for server state
  4. Routing: Export routes from modules for integration in App.tsx
  5. Read-only Principle: Many modules are read-only (Dashboard, Governance, Portfolio)
  6. Project-centric: Operational objects should be project-scoped

🚧 Future Enhancements

  • Real-time WebSocket updates
  • Advanced analytics and reporting
  • Enhanced collaboration features
  • Advanced data pipeline management
  • Model marketplace and sharing
  • Advanced drift detection algorithms
  • Custom alert rules configuration
  • A/B testing capabilities
  • Canary deployments
  • Multi-tenant support

📄 License

MIT

About

Enterprise Audit Management System frontend built with React 19, focusing on audit universe planning, engagement orchestration, findings tracking, and audit trail readiness.

Topics

audit-managementaudit-trailcomplianceenterprise-softwaregovernancegrcinternal-auditreactshadcn-uitailwindcsstypescriptvite

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages