@tera-system/core 0.1.0

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

@@ -0,0 +1,32 @@
+# 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

@@ -0,0 +1,66 @@
+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

@@ -0,0 +1,49 @@
+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

@@ -0,0 +1,48 @@
+# 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

@@ -0,0 +1,51 @@
+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

@@ -0,0 +1,49 @@
+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

@@ -0,0 +1,36 @@
+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

@@ -0,0 +1,146 @@
+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

@@ -0,0 +1,31 @@
+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

@@ -0,0 +1,42 @@
+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

@@ -0,0 +1,25 @@
+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

@@ -0,0 +1,40 @@
+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"