@tera-system/pro 0.1.4 → 0.2.0

package/core/tera-system/semgrep-rules/README.md

@@ -1,32 +0,0 @@
-# Semgrep Rules — Tera System
-
-قواعد Semgrep الخاصة بمنظومة Tera لجودة وأمان الكود.
-
-## كيفية الاستخدام
-
-### كـ MCP (للاستخدام من العملاء)
-```bash
-# MCP Server مضبوط مسبقاً — العملاء يستدعون semgrep_scan مباشرة
-```
-
-### كـ CLI (للمراجعة اليدوية)
-```bash
-# فحص المشروع كاملاً
-semgrep --config=tera-system/semgrep-rules/ --metrics=off .
-
-# فحص ملفات محددة
-semgrep --config=tera-system/semgrep-rules/ --metrics=off path/to/file
-```
-
-## الملفات
-
-| الملف | الغرض | Severity |
-|-------|-------|----------|
-| `tera-security.yml` | قواعد أمنية — Secrets, Injection, Eval | ERROR |
-| `tera-standards.yml` | قواعد جودة — Console.log, TODOs, حجم الدوال | WARNING / INFO |
-
-## تطوير القواعد
-
-- القواعد مبدئية — تُوسع حسب الاحتياج
-- أي إضافة/تعديل → يحتاج SYSTEM_CHANGE_PROPOSAL
-- يُفضل اختبار القاعدة على Semgrep Playground قبل الإضافة

package/core/tera-system/semgrep-rules/tera-security.yml

@@ -1,66 +0,0 @@
-rules:
-  - id: tera-no-hardcoded-secrets
-    message: >
-      SECURITY [QG-SEC-001]: لا تخزن مفاتيح أو ConnectionStrings أو Secrets في الكود.
-      استخدم User Secrets / Environment Variables / Azure Key Vault / أي آلية آمنة معتمدة.
-    severity: ERROR
-    languages:
-      - csharp
-      - javascript
-      - typescript
-      - python
-    patterns:
-      - pattern: |
-          $VAR = "..."
-      - metavariable-regex:
-          metavariable: $VAR
-          regex: (?i).*(password|secret|connection.?string|api.?key|apikey|passwd|pwd|credential).*
-
-  - id: tera-no-eval
-    pattern: eval(...)
-    message: >
-      SECURITY [QG-SEC-004]: eval() ممنوع — يشكل خطر حقن كود.
-      استخدم بديلاً آمناً.
-    languages:
-      - javascript
-      - typescript
-      - python
-    severity: ERROR
-
-  - id: tera-sql-concatenation
-    message: >
-      SECURITY [QG-SEC-003]: خطر SQL Injection — لا تركب استعلامات SQL يدوياً.
-      استخدم Parameterized Queries / Entity Framework / Dapper مع parameters.
-    severity: ERROR
-    languages:
-      - csharp
-      - javascript
-      - typescript
-      - python
-      - java
-    patterns:
-      - pattern: '"..." + $VAR'
-      - metavariable-regex:
-          metavariable: $VAR
-          regex: (?i).*
-
-  - id: tera-exposed-credentials
-    message: >
-      SECURITY [QG-SEC-001]: لا تخزن مفاتيح أو توكنز أو API Keys بشكل صريح في الكود.
-    severity: ERROR
-    languages:
-      - csharp
-      - javascript
-      - typescript
-      - python
-      - java
-    patterns:
-      - pattern-either:
-          - pattern: |
-              $VAR = "=...="
-          - pattern: |
-              $VAR = "sk-..."
-          - pattern: |
-              $VAR = "ghp_..."
-          - pattern: |
-              $VAR = "AKIA..."

package/core/tera-system/semgrep-rules/tera-standards.yml

@@ -1,49 +0,0 @@
-rules:
-  - id: tera-console-log
-    message: >
-      QUALITY: لا تترك console.log / print / Console.WriteLine في كود الإنتاج.
-      استخدم مكتبة logging رسمية (Serilog, Winston, structlog, loguru).
-    severity: WARNING
-    languages:
-      - csharp
-      - javascript
-      - typescript
-      - python
-    patterns:
-      - pattern-either:
-          - pattern: console.log(...)
-          - pattern: console.error(...)
-          - pattern: console.warn(...)
-          - pattern: Console.WriteLine(...)
-          - pattern: Console.Write(...)
-          - pattern: print(...)
-
-  - id: tera-todo-left
-    pattern: TODO
-    message: >
-      QUALITY: في TODO / FIXME / HACK متروك في الكود.
-      إما أنجزه الآن، أو سجله كـ Task/Clearing Issue في TASK_REGISTRY.
-    severity: INFO
-    languages:
-      - csharp
-      - javascript
-      - typescript
-      - python
-      - java
-      - go
-
-  - id: tera-debug-statement
-    message: >
-      QUALITY: debugger / Debug statements متروكة في الكود.
-      لا يجوز تسليم كود إنتاج وفيه debugger breakpoints.
-    severity: ERROR
-    languages:
-      - csharp
-      - javascript
-      - typescript
-    patterns:
-      - pattern-either:
-          - pattern: debugger
-          - pattern: Debug.WriteLine(...)
-          - pattern: Debug.Print(...)
-          - pattern: Debugger.Break()

package/core/tera-system/teranoo-ui/README.md

@@ -1,48 +0,0 @@
-# Teranoo UI Registry 🎨
-
-المكونات المعتمدة لتطبيقات Tera — مبنية على [shadcn/ui](https://ui.shadcn.com).
-
-## الاستخدام
-
-### المتطلبات
-- Next.js + TypeScript + Tailwind CSS
-- تم تشغيل `npx shadcn@latest init` في المشروع
-
-### إضافة مكونات shadcn/ui الأساسية
-```bash
-npx shadcn@latest add button card input label form select table dropdown-menu dialog tabs
-```
-
-### إضافة مكونات Teranoo UI
-```bash
-npx shadcn@latest add button --registry=./tera-system/teranoo-ui
-npx shadcn@latest add dashboard-layout --registry=./tera-system/teranoo-ui
-npx shadcn@latest add kpi-card --registry=./tera-system/teranoo-ui
-```
-
-### تطبيق ثيم Tera
-انسخ ملف `styles/teranoo-theme.css` إلى مجلد المشروع وأضف الـ import:
-```css
-@import './styles/teranoo-theme.css';
-```
-
-## قائمة المكونات
-
-| المكون | الوصف | يستخدم shadcn/ui |
-|--------|-------|-------------------|
-| `button` | زر Tera الأساسي | ✅ shadcn button |
-| `card` | بطاقة محتوى | ✅ shadcn card |
-| `dashboard-layout` | هيكل لوحة تحكم كامل | ❌ (هيكل مركب) |
-| `data-table` | جدول متقدم | ✅ shadcn table |
-| `kpi-card` | بطاقة KPI | ✅ shadcn card |
-| `sidebar` | قائمة جانبية | ❌ (مخصص) |
-| `stats-card` | بطاقة إحصائية | ✅ shadcn card |
-| `page-header` | عنوان صفحة | ❌ (مخصص) |
-| `search-input` | حقل بحث | ✅ shadcn input |
-| `empty-state` | حالة فراغ | ❌ (مخصص) |
-
-## المبدأ
-
-> استخدم مكونات shadcn/ui أولاً.
-> استخدم Teranoo UI Registry للمكونات المخصصة المتكررة.
-> اكتب من الصفر فقط لما لا يوجد في الاثنين.

package/core/tera-system/teranoo-ui/components/button.tsx

@@ -1,51 +0,0 @@
-import * as React from "react"
-import { Slot } from "@radix-ui/react-slot"
-import { cva, type VariantProps } from "class-variance-authority"
-
-const buttonVariants = cva(
-  "inline-flex items-center justify-center whitespace-nowrap rounded-[var(--teranoo-radius)] text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--teranoo-ring)] focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
-  {
-    variants: {
-      variant: {
-        default: "bg-[var(--teranoo-primary)] text-[var(--teranoo-primary-foreground)] hover:bg-[var(--teranoo-primary-hover)]",
-        destructive: "bg-[var(--teranoo-danger)] text-white hover:bg-red-600",
-        outline: "border border-[var(--teranoo-border)] bg-[var(--teranoo-background)] hover:bg-[var(--teranoo-muted)]",
-        secondary: "bg-[var(--teranoo-secondary)] text-[var(--teranoo-secondary-foreground)] hover:bg-[var(--teranoo-secondary)]/80",
-        ghost: "hover:bg-[var(--teranoo-muted)]",
-        link: "text-[var(--teranoo-primary)] underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-10 px-4 py-2",
-        sm: "h-9 rounded-md px-3",
-        lg: "h-11 rounded-md px-8",
-        icon: "h-10 w-10",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-      size: "default",
-    },
-  }
-)
-
-export interface ButtonProps
-  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {
-  asChild?: boolean
-}
-
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button"
-    return (
-      <Comp
-        className={buttonVariants({ variant, size, className })}
-        ref={ref}
-        {...props}
-      />
-    )
-  }
-)
-Button.displayName = "Button"
-
-export { Button, buttonVariants }

package/core/tera-system/teranoo-ui/components/card.tsx

@@ -1,49 +0,0 @@
-import * as React from "react"
-
-const Card = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div
-      ref={ref}
-      className="rounded-[var(--teranoo-radius)] border border-[var(--teranoo-border)] bg-[var(--teranoo-background)] shadow-[var(--teranoo-shadow)]"
-      {...props}
-    />
-  )
-)
-Card.displayName = "Card"
-
-const CardHeader = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className="flex flex-col space-y-1.5 p-6" {...props} />
-  )
-)
-CardHeader.displayName = "CardHeader"
-
-const CardTitle = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLHeadingElement>>(
-  ({ className, ...props }, ref) => (
-    <h3 ref={ref} className="text-2xl font-semibold leading-none tracking-tight" {...props} />
-  )
-)
-CardTitle.displayName = "CardTitle"
-
-const CardDescription = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLParagraphElement>>(
-  ({ className, ...props }, ref) => (
-    <p ref={ref} className="text-sm text-[var(--teranoo-muted-foreground)]" {...props} />
-  )
-)
-CardDescription.displayName = "CardDescription"
-
-const CardContent = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className="p-6 pt-0" {...props} />
-  )
-)
-CardContent.displayName = "CardContent"
-
-const CardFooter = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className="flex items-center p-6 pt-0" {...props} />
-  )
-)
-CardFooter.displayName = "CardFooter"
-
-export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }

package/core/tera-system/teranoo-ui/components/dashboard-layout.tsx

@@ -1,36 +0,0 @@
-import * as React from "react"
-import { Sidebar } from "./sidebar"
-import type { SidebarItem } from "./sidebar"
-
-interface DashboardLayoutProps {
-  sidebarItems: SidebarItem[]
-  children: React.ReactNode
-  header?: React.ReactNode
-  footer?: React.ReactNode
-}
-
-export function DashboardLayout({ sidebarItems, children, header, footer }: DashboardLayoutProps) {
-  const [collapsed, setCollapsed] = React.useState(false)
-
-  return (
-    <div className="flex h-screen overflow-hidden bg-[var(--teranoo-muted)]" dir="rtl">
-      <Sidebar
-        items={sidebarItems}
-        collapsed={collapsed}
-        onToggle={() => setCollapsed(!collapsed)}
-        footer={footer}
-      />
-
-      <main className="flex-1 flex flex-col overflow-hidden">
-        {header && (
-          <header className="border-b border-[var(--teranoo-border)] bg-[var(--teranoo-background)] px-6 py-3">
-            {header}
-          </header>
-        )}
-        <div className="flex-1 overflow-y-auto p-6">
-          {children}
-        </div>
-      </main>
-    </div>
-  )
-}

package/core/tera-system/teranoo-ui/components/data-table.tsx

@@ -1,146 +0,0 @@
-import * as React from "react"
-
-interface Column<T> {
-  key: string
-  header: string
-  render?: (item: T) => React.ReactNode
-  sortable?: boolean
-}
-
-interface DataTableProps<T> {
-  columns: Column<T>[]
-  data: T[]
-  searchable?: boolean
-  pageSize?: number
-}
-
-export function DataTable<T extends Record<string, any>>({
-  columns,
-  data,
-  searchable = true,
-  pageSize = 10,
-}: DataTableProps<T>) {
-  const [search, setSearch] = React.useState("")
-  const [page, setPage] = React.useState(1)
-  const [sortKey, setSortKey] = React.useState<string | null>(null)
-  const [sortDir, setSortDir] = React.useState<"asc" | "desc">("asc")
-
-  // تصفية
-  const filtered = React.useMemo(() => {
-    if (!search) return data
-    return data.filter((item) =>
-      columns.some((col) =>
-        String(item[col.key]).toLowerCase().includes(search.toLowerCase())
-      )
-    )
-  }, [data, search, columns])
-
-  // ترتيب
-  const sorted = React.useMemo(() => {
-    if (!sortKey) return filtered
-    return [...filtered].sort((a, b) => {
-      const aVal = a[sortKey]
-      const bVal = b[sortKey]
-      if (aVal < bVal) return sortDir === "asc" ? -1 : 1
-      if (aVal > bVal) return sortDir === "asc" ? 1 : -1
-      return 0
-    })
-  }, [filtered, sortKey, sortDir])
-
-  // تقسيم الصفحات
-  const totalPages = Math.ceil(sorted.length / pageSize)
-  const paged = sorted.slice((page - 1) * pageSize, page * pageSize)
-
-  const handleSort = (key: string) => {
-    if (sortKey === key) {
-      setSortDir(sortDir === "asc" ? "desc" : "asc")
-    } else {
-      setSortKey(key)
-      setSortDir("asc")
-    }
-  }
-
-  return (
-    <div className="space-y-4">
-      {/* بحث */}
-      {searchable && (
-        <div className="relative max-w-sm">
-          <input
-            value={search}
-            onChange={(e) => { setSearch(e.target.value); setPage(1) }}
-            placeholder="بحث..."
-            className="flex h-10 w-full rounded-[var(--teranoo-radius)] border border-[var(--teranoo-border)] bg-[var(--teranoo-background)] px-3 py-2 pr-10 text-sm"
-          />
-        </div>
-      )}
-
-      {/* جدول */}
-      <div className="rounded-[var(--teranoo-radius)] border border-[var(--teranoo-border)] overflow-hidden">
-        <table className="w-full text-sm">
-          <thead className="bg-[var(--teranoo-muted)]">
-            <tr>
-              {columns.map((col) => (
-                <th
-                  key={col.key}
-                  onClick={() => col.sortable && handleSort(col.key)}
-                  className={`px-4 py-3 text-right font-medium text-[var(--teranoo-muted-foreground)] ${
-                    col.sortable ? "cursor-pointer hover:text-[var(--teranoo-foreground)]" : ""
-                  }`}
-                >
-                  {col.header}
-                  {sortKey === col.key && (
-                    <span className="mr-1">{sortDir === "asc" ? "↑" : "↓"}</span>
-                  )}
-                </th>
-              ))}
-            </tr>
-          </thead>
-          <tbody className="bg-[var(--teranoo-background)]">
-            {paged.length === 0 ? (
-              <tr>
-                <td colSpan={columns.length} className="px-4 py-12 text-center text-[var(--teranoo-muted-foreground)]">
-                  لا توجد بيانات
-                </td>
-              </tr>
-            ) : (
-              paged.map((item, i) => (
-                <tr key={i} className="border-t border-[var(--teranoo-border)] hover:bg-[var(--teranoo-muted)]">
-                  {columns.map((col) => (
-                    <td key={col.key} className="px-4 py-3">
-                      {col.render ? col.render(item) : item[col.key]}
-                    </td>
-                  ))}
-                </tr>
-              ))
-            )}
-          </tbody>
-        </table>
-      </div>
-
-      {/* Pagination */}
-      {totalPages > 1 && (
-        <div className="flex items-center justify-between">
-          <p className="text-sm text-[var(--teranoo-muted-foreground)]">
-            صفحة {page} من {totalPages}
-          </p>
-          <div className="flex gap-2">
-            <button
-              onClick={() => setPage(p => Math.max(1, p - 1))}
-              disabled={page === 1}
-              className="px-3 py-1 rounded border border-[var(--teranoo-border)] text-sm disabled:opacity-50"
-            >
-              السابق
-            </button>
-            <button
-              onClick={() => setPage(p => Math.min(totalPages, p + 1))}
-              disabled={page === totalPages}
-              className="px-3 py-1 rounded border border-[var(--teranoo-border)] text-sm disabled:opacity-50"
-            >
-              التالي
-            </button>
-          </div>
-        </div>
-      )}
-    </div>
-  )
-}

package/core/tera-system/teranoo-ui/components/empty-state.tsx

@@ -1,31 +0,0 @@
-import * as React from "react"
-
-interface EmptyStateProps {
-  icon?: React.ReactNode
-  title: string
-  description?: string
-  action?: React.ReactNode
-}
-
-export function EmptyState({ icon, title, description, action }: EmptyStateProps) {
-  return (
-    <div className="flex flex-col items-center justify-center py-16 text-center">
-      {icon && (
-        <div className="mb-4 h-16 w-16 rounded-full bg-[var(--teranoo-muted)] flex items-center justify-center">
-          {icon}
-        </div>
-      )}
-      <h3 className="text-lg font-semibold">{title}</h3>
-      {description && (
-        <p className="mt-1 text-sm text-[var(--teranoo-muted-foreground)] max-w-sm">
-          {description}
-        </p>
-      )}
-      {action && (
-        <div className="mt-4">
-          {action}
-        </div>
-      )}
-    </div>
-  )
-}

package/core/tera-system/teranoo-ui/components/kpi-card.tsx

@@ -1,42 +0,0 @@
-import * as React from "react"
-import { Card, CardContent } from "./card"
-
-interface KpiCardProps {
-  title: string
-  value: string | number
-  change?: number
-  changeLabel?: string
-  icon?: React.ReactNode
-  variant?: "default" | "success" | "warning" | "danger"
-}
-
-export function KpiCard({ title, value, change, changeLabel, icon, variant = "default" }: KpiCardProps) {
-  const changeColor = change
-    ? change > 0
-      ? "text-[var(--teranoo-success)]"
-      : "text-[var(--teranoo-danger)]"
-    : "text-[var(--teranoo-muted-foreground)]"
-
-  return (
-    <Card>
-      <CardContent className="p-6">
-        <div className="flex items-center justify-between">
-          <div className="space-y-1">
-            <p className="text-sm text-[var(--teranoo-muted-foreground)]">{title}</p>
-            <p className="text-3xl font-bold">{value}</p>
-            {change !== undefined && (
-              <p className={`text-sm ${changeColor}`}>
-                {change > 0 ? "+" : ""}{change}% {changeLabel}
-              </p>
-            )}
-          </div>
-          {icon && (
-            <div className="h-12 w-12 rounded-full bg-[var(--teranoo-muted)] flex items-center justify-center">
-              {icon}
-            </div>
-          )}
-        </div>
-      </CardContent>
-    </Card>
-  )
-}

package/core/tera-system/teranoo-ui/components/page-header.tsx

@@ -1,25 +0,0 @@
-import * as React from "react"
-
-interface PageHeaderProps {
-  title: string
-  description?: string
-  children?: React.ReactNode
-}
-
-export function PageHeader({ title, description, children }: PageHeaderProps) {
-  return (
-    <div className="flex items-center justify-between pb-6">
-      <div className="space-y-1">
-        <h1 className="text-2xl font-bold tracking-tight">{title}</h1>
-        {description && (
-          <p className="text-sm text-[var(--teranoo-muted-foreground)]">{description}</p>
-        )}
-      </div>
-      {children && (
-        <div className="flex items-center gap-2">
-          {children}
-        </div>
-      )}
-    </div>
-  )
-}

package/core/tera-system/teranoo-ui/components/search-input.tsx

@@ -1,40 +0,0 @@
-import * as React from "react"
-
-interface SearchInputProps extends React.InputHTMLAttributes<HTMLInputElement> {
-  onClear?: () => void
-}
-
-export const SearchInput = React.forwardRef<HTMLInputElement, SearchInputProps>(
-  ({ className, onClear, value, ...props }, ref) => {
-    return (
-      <div className="relative">
-        <svg
-          className="absolute right-3 top-1/2 -translate-y-1/2 h-4 w-4 text-[var(--teranoo-muted-foreground)]"
-          xmlns="http://www.w3.org/2000/svg"
-          viewBox="0 0 24 24"
-          fill="none"
-          stroke="currentColor"
-          strokeWidth="2"
-        >
-          <circle cx="11" cy="11" r="8" />
-          <path d="m21 21-4.3-4.3" />
-        </svg>
-        <input
-          ref={ref}
-          value={value}
-          className="flex h-10 w-full rounded-[var(--teranoo-radius)] border border-[var(--teranoo-border)] bg-[var(--teranoo-background)] px-3 py-2 pr-10 text-sm ring-offset-background placeholder:text-[var(--teranoo-muted-foreground)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--teranoo-ring)] focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50"
-          {...props}
-        />
-        {value && onClear && (
-          <button
-            onClick={onClear}
-            className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-[var(--teranoo-muted-foreground)] hover:text-[var(--teranoo-foreground)]"
-          >
-            ×
-          </button>
-        )}
-      </div>
-    )
-  }
-)
-SearchInput.displayName = "SearchInput"