falak-app-duo 1.1.3 → 1.1.5

package/bin/falak-app-duo

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import path from "node:path";
+import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 import fs from "fs-extra";
@@ -34,6 +35,182 @@ const LOCALE_LABELS = {
 
 const EXTRA_LOCALE_FILES = ["ar.json", "de.json", "es.json", "fr.json", "it.json", "ru.json"];
 
+const ROLE_ORDER = ["master", "super_admin", "admin", "user"];
+const ROLE_META = {
+  master: { label: "roles.master.title", badge: "bg-rose-500/10 text-rose-300 ring-rose-400/30" },
+  super_admin: { label: "roles.super_admin.title", badge: "bg-amber-500/10 text-amber-300 ring-amber-400/30" },
+  admin: { label: "roles.admin.title", badge: "bg-cyan-500/10 text-cyan-300 ring-cyan-400/30" },
+  user: { label: "roles.user.title", badge: "bg-emerald-500/10 text-emerald-300 ring-emerald-400/30" },
+};
+
+const DEMO_ENTITIES = [
+  "users",
+  "products",
+  "orders",
+  "customers",
+  "invoices",
+  "payments",
+  "events",
+  "posts",
+  "messages",
+  "tasks",
+  "projects",
+  "appointments",
+];
+
+const DEMO_ROLE_SEED = {
+  master: {
+    name: "Aya El-Amin",
+    email: "master@demo.dev",
+    phone: "+201000000001",
+    country_code: "EG",
+    city: "Cairo",
+    channel: "telegram",
+    channel_handle: "@aya_master",
+    ai_model: "llama-3.3-70b-versatile",
+    ai_enabled: true,
+    telegram_username: "@aya_master",
+  },
+  super_admin: {
+    name: "Omar El-Sayed",
+    email: "superadmin@demo.dev",
+    phone: "+966500000002",
+    country_code: "SA",
+    city: "Riyadh",
+    channel: "whatsapp",
+    channel_handle: "+966500000002",
+    ai_model: "mixtral-8x7b-32768",
+    ai_enabled: true,
+    telegram_username: "",
+  },
+  admin: {
+    name: "Layla Haddad",
+    email: "admin@demo.dev",
+    phone: "+971500000003",
+    country_code: "AE",
+    city: "Dubai",
+    channel: "none",
+    channel_handle: "",
+    ai_model: "llama-3.1-8b-instant",
+    ai_enabled: false,
+    telegram_username: "",
+  },
+  user: {
+    name: "Karim Nasser",
+    email: "user@demo.dev",
+    phone: "+120200000004",
+    country_code: "US",
+    city: "New York",
+    channel: "none",
+    channel_handle: "",
+    ai_model: "gemma2-9b-it",
+    ai_enabled: false,
+    telegram_username: "",
+  },
+};
+
+const DEMO_NOTIFICATIONS = {
+  account: { email: true, push: true, sms: false, telegram: false },
+  security: { email: true, push: true, sms: true, telegram: false },
+  marketing: { email: false, push: false, sms: false, telegram: false },
+  updates: { email: true, push: false, sms: false, telegram: false },
+};
+
+function buildRolesModule(roleKeys) {
+  const lines = [];
+  lines.push("// UserRole support. Generated by the scaffolder: only the roles");
+  lines.push("// you picked at scaffold time are kept; an empty ROLES means UserRole");
+  lines.push('// support is off. `label` is a vue-i18n key (see i18n/locales/*.json).');
+  lines.push("export const ROLES = [");
+  for (const key of ROLE_ORDER.filter((k) => roleKeys.includes(k))) {
+    lines.push(`  { key: "${key}", label: "${ROLE_META[key].label}", badge: "${ROLE_META[key].badge}" },`);
+  }
+  lines.push("];");
+  return lines.join("\n") + "\n";
+}
+
+function demoSettingsFor(roleKey) {
+  const seed = roleKey ? DEMO_ROLE_SEED[roleKey] : null;
+  return {
+    notification_preferences: DEMO_NOTIFICATIONS,
+    two_factor_enabled: false,
+    ai_agent: {
+      enabled: seed ? seed.ai_enabled : false,
+      model: seed ? seed.ai_model : "llama-3.3-70b-versatile",
+      temperature: 0.7,
+      reasoning: false,
+      system_prompt: "",
+    },
+    telegram: { bot_token: "", chat_id: "", username: seed ? seed.telegram_username : "" },
+  };
+}
+
+// roleKeys == [] => a single normal demo user (no role on the account).
+function buildDemoAccountsModule(roleKeys) {
+  const chosen = ROLE_ORDER.filter((k) => roleKeys.includes(k));
+  const accounts = chosen.length
+    ? chosen.map((key) => {
+        const s = DEMO_ROLE_SEED[key];
+        return {
+          role: key,
+          email: s.email,
+          password: "password",
+          profile: {
+            name: s.name,
+            email: s.email,
+            phone: s.phone,
+            country_code: s.country_code,
+            city: s.city,
+            channel: s.channel,
+            channel_handle: s.channel_handle,
+            photo: null,
+          },
+          settings: demoSettingsFor(key),
+        };
+      })
+    : [
+        {
+          role: null,
+          email: "demo@demo.dev",
+          password: "password",
+          profile: {
+            name: "Demo User",
+            email: "demo@demo.dev",
+            phone: "+201000000009",
+            country_code: "EG",
+            city: "Cairo",
+            channel: "none",
+            channel_handle: "",
+            photo: null,
+          },
+          settings: demoSettingsFor(null),
+        },
+      ];
+  const lines = [];
+  lines.push("// Static demo accounts for testing. Generated by the scaffolder: one");
+  lines.push("// account per role you picked, or a single normal demo user when");
+  lines.push("// UserRole support is off. Each carries its full profile and default");
+  lines.push("// settings so a backend seed (or a first-login init) has everything.");
+  lines.push("export const DEMO_ACCOUNTS = [");
+  for (const account of accounts) {
+    lines.push("  " + JSON.stringify(account) + ",");
+  }
+  lines.push("];");
+  return lines.join("\n") + "\n";
+}
+
+function parseList(value) {
+  return String(value || "")
+    .split(",")
+    .map((x) => x.trim())
+    .filter(Boolean);
+}
+
+function keepCanonicalOrder(value, allowed) {
+  const picked = parseList(value);
+  return allowed.filter((item) => picked.includes(item));
+}
+
 function buildI18nModule(locales, defaultLocale) {
   const ordered = ["ar", "en", "es", "de", "fr", "ru", "it"].filter((c) => locales.includes(c));
   const lines = [];
@@ -81,8 +258,11 @@ program
   .name("falak-app")
   .description("Scaffold a Vue 3 app with Ably, Brevo, AES-256 and a Laravel API client baked in.")
   .argument("[project-name]", "Directory to create the project in")
-  .option("-y, --yes", "Skip prompts and use defaults (all services enabled)")
+  .option("-y, --yes", "Skip prompts and use defaults (services + languages only; no roles/demo)")
   .option("--no-rtl", "Exclude Arabic/RTL (English or your chosen LTR languages only)")
+  .option("--roles <list>", "Enable UserRole support with the given comma-separated roles (master,super_admin,admin,user)")
+  .option("--demo-accounts", "Include static demo accounts (per selected role, or a normal demo user without roles)")
+  .option("--demo-data <list>", "Include static demo data for the given comma-separated entities (e.g. products,orders)")
   .parse(process.argv);
 
 const [argProjectName] = program.args;
@@ -119,49 +299,141 @@ async function printBanner() {
 async function main() {
   await printBanner();
 
-  const answers = opts.yes
-    ? {
-        projectName: argProjectName || "falak-app-duo",
-        services: ["ably", "brevo"],
-        languages: ["ar"],
-        apiBaseUrl: "http://localhost:8000/api",
-      }
-    : await prompts(
-        [
-          {
-            type: argProjectName ? null : "text",
-            name: "projectName",
-            message: "Project name / folder:",
-            initial: "falak-app-duo",
-          },
-          {
-            type: "multiselect",
-            name: "services",
-            message: "Which services do you want wired up?",
-            choices: [
-              { title: "Ably (realtime, via Laravel Echo)", value: "ably", selected: true },
-              { title: "Brevo (email/SMS, via backend)", value: "brevo", selected: true },
-            ],
-            hint: "Space to toggle, Enter to confirm",
-          },
-          {
-            type: "multiselect",
-            name: "languages",
-            message: "Which languages should the app ship with? (English is always included)",
-            choices: LANGUAGE_CHOICES.map((c) =>
-              c.value === "ar" && !opts.rtl ? { ...c, selected: false } : c
-            ),
-            hint: "Space to toggle, Enter to confirm",
-          },
-          {
-            type: "text",
-            name: "apiBaseUrl",
-            message: "Laravel API base URL:",
-            initial: "http://localhost:8000/api",
-          },
-        ],
+  const defaults = {
+    projectName: argProjectName || "falak-app-duo",
+    services: ["ably", "brevo"],
+    languages: ["ar"],
+    apiBaseUrl: "http://localhost:8000/api",
+  };
+
+  const hasFeatureFlags =
+    opts.roles !== undefined || opts.demoAccounts !== undefined || opts.demoData !== undefined;
+
+  // Feature outcomes. Roles/accounts/data only come via explicit flags or
+  // interactive prompts — `--yes` keeps the minimal scaffold.
+  let roles = opts.yes ? [] : null;
+  let demoAccounts = opts.yes ? false : null;
+  let demoEntities = opts.yes ? [] : null;
+
+  let answers;
+  if (opts.yes || hasFeatureFlags) {
+    answers = { ...defaults };
+  } else {
+    answers = await prompts(
+      [
+        {
+          type: argProjectName ? null : "text",
+          name: "projectName",
+          message: "Project name / folder:",
+          initial: "falak-app-duo",
+        },
+        {
+          type: "multiselect",
+          name: "services",
+          message: "Which services do you want wired up?",
+          choices: [
+            { title: "Ably (realtime, via Laravel Echo)", value: "ably", selected: true },
+            { title: "Brevo (email/SMS, via backend)", value: "brevo", selected: true },
+          ],
+          hint: "Space to toggle, Enter to confirm",
+        },
+        {
+          type: "multiselect",
+          name: "languages",
+          message: "Which languages should the app ship with? (English is always included)",
+          choices: LANGUAGE_CHOICES.map((c) =>
+            c.value === "ar" && !opts.rtl ? { ...c, selected: false } : c
+          ),
+          hint: "Space to toggle, Enter to confirm",
+        },
+        {
+          type: "text",
+          name: "apiBaseUrl",
+          message: "Laravel API base URL:",
+          initial: "http://localhost:8000/api",
+        },
+      ],
+      { onCancel: () => process.exit(1) }
+    );
+  }
+
+  // ---- UserRole support ----
+  if (!opts.yes && hasFeatureFlags) {
+    roles = opts.roles !== undefined ? keepCanonicalOrder(opts.roles, ROLE_ORDER) : [];
+    demoAccounts = Boolean(opts.demoAccounts);
+    demoEntities = opts.demoData !== undefined ? keepCanonicalOrder(opts.demoData, DEMO_ENTITIES) : [];
+  } else if (!opts.yes) {
+    const wantRoles = (
+      await prompts(
+        {
+          type: "toggle",
+          name: "v",
+          message: "Register accounts with a role (UserRole support)?",
+          initial: true,
+          active: "yes",
+          inactive: "no",
+        },
+        { onCancel: () => process.exit(1) }
+      )
+    ).v;
+    if (wantRoles) {
+      const { r } = await prompts(
+        {
+          type: "multiselect",
+          name: "r",
+          message: "Which roles should auth support?",
+          choices: ROLE_ORDER.map((k) => ({ title: k, value: k, selected: true })),
+          hint: "Space to toggle, Enter to confirm",
+        },
+        { onCancel: () => process.exit(1) }
+      );
+      roles = r || [];
+    }
+
+    const wantAccounts = (
+      await prompts(
+        {
+          type: "toggle",
+          name: "v",
+          message: roles.length
+            ? "Create demo accounts (one per selected role)?"
+            : "Create a normal demo account?",
+          initial: true,
+          active: "yes",
+          inactive: "no",
+        },
+        { onCancel: () => process.exit(1) }
+      )
+    ).v;
+    demoAccounts = Boolean(wantAccounts);
+
+    const wantData = (
+      await prompts(
+        {
+          type: "toggle",
+          name: "v",
+          message: "Create static demo data to test with?",
+          initial: true,
+          active: "yes",
+          inactive: "no",
+        },
+        { onCancel: () => process.exit(1) }
+      )
+    ).v;
+    if (wantData) {
+      const { e } = await prompts(
+        {
+          type: "multiselect",
+          name: "e",
+          message: "Which demo-data entities should the app ship with?",
+          choices: DEMO_ENTITIES.map((k) => ({ title: k, value: k, selected: true })),
+          hint: "Space to toggle, Enter to confirm",
+        },
         { onCancel: () => process.exit(1) }
       );
+      demoEntities = e || [];
+    }
+  }
 
   // The set of locales the app ships: English is always bundled, plus the
   // languages the user picked. `--no-rtl` forces Arabic out (LTR only).
@@ -237,9 +509,45 @@ async function main() {
     await fs.writeFile(appPath, app);
   }
 
+  // UserRole support: rewrite src/data/roles.js to the picked role set. The
+  // file always stays (Register/Profile import it), just emptied when off.
+  await fs.writeFile(path.join(targetDir, "src", "data", "roles.js"), buildRolesModule(roles || []));
+
+  // Demo accounts: static module with one account per role, or a single
+  // normal demo user when roles are off. Removed entirely when not wanted.
+  const demoAccountsPath = path.join(targetDir, "src", "data", "demoAccounts.js");
+  if (demoAccounts) {
+    await fs.writeFile(demoAccountsPath, buildDemoAccountsModule(roles || []));
+  } else {
+    await fs.remove(demoAccountsPath);
+  }
+
+  // Static demo data: keep only the selected entity modules. The whole demo
+  // dir is dropped when demo data wasn't picked (nothing imports it).
+  const demoDir = path.join(targetDir, "src", "data", "demo");
+  for (const entity of DEMO_ENTITIES) {
+    if (!demoEntities || !demoEntities.includes(entity)) {
+      await fs.remove(path.join(demoDir, `${entity}.js`));
+    }
+  }
+  if (!demoEntities || (await fs.readdir(demoDir).catch(() => [])).length === 0) {
+    await fs.remove(demoDir);
+  }
+
+  const demoAccountsSummary = demoAccounts
+    ? roles && roles.length
+      ? `${roles.length} (${roles.join(", ")})`
+      : "1 (normal demo user)"
+    : "none";
+
   console.log(
     chalk.gray(`  Languages wired: ${locales.map((l) => LOCALE_LABELS[l]).join(", ")}${hasRtl ? " (RTL default)" : ""}`)
   );
+  console.log(
+    chalk.gray(
+      `  Roles: ${roles && roles.length ? roles.join(", ") : "none"} | Demo accounts: ${demoAccountsSummary} | Demo data: ${demoEntities && demoEntities.length ? demoEntities.join(", ") : "none"}`
+    )
+  );
 
   // Generate a real .env from .env.example with a fresh encryption key
   const envExamplePath = path.join(targetDir, ".env.example");
@@ -257,7 +565,7 @@ async function main() {
     )
   );
 
-  const runChoice = opts.yes
+  const runChoice = opts.yes || hasFeatureFlags
     ? "install"
     : (
         await prompts(
@@ -295,7 +603,20 @@ async function main() {
   await runInProject(targetDir, "npm", ["run", "dev"]).catch(() => {});
 }
 
-if (process.argv[1] && path.resolve(fileURLToPath(import.meta.url)) === path.resolve(process.argv[1])) {
+function isMain() {
+  const argv1 = process.argv[1];
+  if (!argv1) return false;
+  try {
+    // Resolve symlinks on both sides: npx/npm exec spawn the bin through the
+    // `node_modules/.bin/<name>` symlink, so a raw `argv[1] === import.meta.url`
+    // comparison would silently skip main() when run via npx.
+    return realpathSync(argv1) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+
+if (isMain()) {
   main().catch((err) => {
     console.error(chalk.red(err));
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "falak-app-duo",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Vue 3 boilerplate scaffolder — Ably (realtime), Brevo, AES-256, Arabic/RTL, and a Laravel API client (API key + user token auth). No Firebase, no Groq/Paymob on the frontend (Groq is backend-only; Paymob dropped).",
   "type": "module",
   "bin": {
@@ -32,5 +32,8 @@
     "ably",
     "realtime"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/templates/default/package.json

@@ -9,16 +9,20 @@
     "preview": "vite preview"
   },
   "dependencies": {
+    "@primeuix/themes": "^1.2.5",
     "ably": "^2.5.0",
     "axios": "^1.7.7",
     "crypto-js": "^4.2.0",
     "laravel-echo": "^1.16.1",
     "pinia": "^2.2.2",
+    "primeicons": "^7.0.0",
+    "primevue": "^4.5.5",
     "vue": "^3.5.0",
     "vue-i18n": "^9.14.0",
     "vue-router": "^4.4.5"
   },
   "devDependencies": {
+    "@vitejs/plugin-basic-ssl": "^1.2.0",
     "@vitejs/plugin-vue": "^5.1.4",
     "autoprefixer": "^10.4.20",
     "postcss": "^8.4.47",

package/templates/default/src/data/demo/appointments.js

@@ -0,0 +1,7 @@
+export const appointments = [
+  { id: 1, title: "Design review", attendee: "Aya El-Amin", date: "2026-09-15", time: "10:00", status: "confirmed" },
+  { id: 2, title: "Stakeholder sync", attendee: "Nour Farouk", date: "2026-09-15", time: "14:30", status: "confirmed" },
+  { id: 3, title: "Intro call", attendee: "Layla Haddad", date: "2026-09-16", time: "09:15", status: "pending" },
+  { id: 4, title: "User interview", attendee: "Omar El-Sayed", date: "2026-09-17", time: "11:45", status: "confirmed" },
+  { id: 5, title: "Sprint retro", attendee: "Karim Nasser", date: "2026-09-18", time: "16:00", status: "cancelled" },
+];

package/templates/default/src/data/demo/customers.js

@@ -0,0 +1,7 @@
+export const customers = [
+  { id: 1, name: "Aya El-Amin", email: "aya@example.com", segment: "enterprise", orders: 14, lifetime_value: 3200, created_at: "2025-11-02" },
+  { id: 2, name: "Omar El-Sayed", email: "omar@example.com", segment: "retail", orders: 6, lifetime_value: 880, created_at: "2026-01-24" },
+  { id: 3, name: "Layla Haddad", email: "layla@example.com", segment: "retail", orders: 2, lifetime_value: 428, created_at: "2026-03-18" },
+  { id: 4, name: "Karim Nasser", email: "karim@example.com", segment: "wholesale", orders: 9, lifetime_value: 5410, created_at: "2025-09-15" },
+  { id: 5, name: "Nour Farouk", email: "nour@example.com", segment: "enterprise", orders: 21, lifetime_value: 9800, created_at: "2025-07-30" },
+];

package/templates/default/src/data/demo/events.js

@@ -0,0 +1,7 @@
+export const events = [
+  { id: 1, title: "Product Launch 2026", date: "2026-10-12", venue: "Cairo Marriott", capacity: 300, booked: 214, status: "published" },
+  { id: 2, title: "Design Meetup", date: "2026-10-20", venue: "Riyadh Hub", capacity: 120, booked: 98, status: "published" },
+  { id: 3, title: "Founders Breakfast", date: "2026-11-02", venue: "Dubai Mall Lounge", capacity: 40, booked: 40, status: "sold_out" },
+  { id: 4, title: "CS Workshop", date: "2026-11-15", venue: "Online", capacity: 500, booked: 156, status: "draft" },
+  { id: 5, title: "Annual Gala", date: "2026-12-05", venue: "InterContinental", capacity: 800, booked: 512, status: "published" },
+];

package/templates/default/src/data/demo/invoices.js

@@ -0,0 +1,7 @@
+export const invoices = [
+  { id: 2001, number: "INV-2001", customer: "Aya El-Amin", amount: 1240, due_date: "2026-09-30", status: "sent", issued_at: "2026-09-01" },
+  { id: 2002, number: "INV-2002", customer: "Karim Nasser", amount: 3410, due_date: "2026-10-05", status: "partial", issued_at: "2026-09-04" },
+  { id: 2003, number: "INV-2003", customer: "Layla Haddad", amount: 428, due_date: "2026-09-20", status: "overdue", issued_at: "2026-08-05" },
+  { id: 2004, number: "INV-2004", customer: "Nour Farouk", amount: 2280, due_date: "2026-10-12", status: "sent", issued_at: "2026-09-09" },
+  { id: 2005, number: "INV-2005", customer: "Omar El-Sayed", amount: 640, due_date: "2026-10-01", status: "paid", issued_at: "2026-08-28" },
+];

package/templates/default/src/data/demo/messages.js

@@ -0,0 +1,7 @@
+export const messages = [
+  { id: 1, sender: "Aya El-Amin", channel: "email", preview: "Meeting rescheduled to 3pm…", sent_at: "2026-09-10 09:14", read: true },
+  { id: 2, sender: "Support Bot", channel: "chat", preview: "Your ticket #2918 was resolved", sent_at: "2026-09-10 10:02", read: true },
+  { id: 3, sender: "Omar El-Sayed", channel: "sms", preview: "Can you review the PR when you have a second?", sent_at: "2026-09-11 12:47", read: false },
+  { id: 4, sender: "Finance Team", channel: "email", preview: "October payroll timeline attached", sent_at: "2026-09-11 14:30", read: false },
+  { id: 5, sender: "Layla Haddad", channel: "telegram", preview: "Lunch on Thursday?", sent_at: "2026-09-12 08:05", read: false },
+];

package/templates/default/src/data/demo/orders.js

@@ -0,0 +1,7 @@
+export const orders = [
+  { id: 1001, number: "ORD-1001", customer: "Aya El-Amin", status: "paid", items: 3, total: 184, placed_at: "2026-09-01" },
+  { id: 1002, number: "ORD-1002", customer: "Omar El-Sayed", status: "pending", items: 1, total: 89, placed_at: "2026-09-03" },
+  { id: 1003, number: "ORD-1003", customer: "Layla Haddad", status: "shipped", items: 2, total: 428, placed_at: "2026-09-05" },
+  { id: 1004, number: "ORD-1004", customer: "Karim Nasser", status: "cancelled", items: 5, total: 612, placed_at: "2026-09-08" },
+  { id: 1005, number: "ORD-1005", customer: "Nour Farouk", status: "refunded", items: 1, total: 74, placed_at: "2026-09-10" },
+];

package/templates/default/src/data/demo/payments.js

@@ -0,0 +1,7 @@
+export const payments = [
+  { id: 1, method: "visa", amount: 184, status: "succeeded", reference: "PAY-8821", paid_at: "2026-09-01" },
+  { id: 2, method: "paypal", amount: 428, status: "succeeded", reference: "PAY-8843", paid_at: "2026-09-05" },
+  { id: 3, method: "mastercard", amount: 612, status: "failed", reference: "PAY-8850", paid_at: "2026-09-08" },
+  { id: 4, method: "bank_transfer", amount: 1240, status: "processing", reference: "PAY-8877", paid_at: "2026-09-09" },
+  { id: 5, method: "cash", amount: 74, status: "refunded", reference: "PAY-8892", paid_at: "2026-09-12" },
+];

package/templates/default/src/data/demo/posts.js

@@ -0,0 +1,7 @@
+export const posts = [
+  { id: 1, title: "Welcome to the new dashboard", author: "Aya El-Amin", status: "published", views: 1240, published_at: "2026-08-01" },
+  { id: 2, title: "How we cut load times by 60%", author: "Omar El-Sayed", status: "published", views: 860, published_at: "2026-08-14" },
+  { id: 3, title: "Roadmap: Q4 2026", author: "Nour Farouk", status: "draft", views: 0, published_at: null },
+  { id: 4, title: "Better onboarding in 5 steps", author: "Layla Haddad", status: "review", views: 0, published_at: null },
+  { id: 5, title: "Security hardening guide", author: "Karim Nasser", status: "published", views: 2230, published_at: "2026-09-02" },
+];

package/templates/default/src/data/demo/products.js

@@ -0,0 +1,7 @@
+export const products = [
+  { id: 1, name: "Aurora Lamp", sku: "AUR-001", category: "Home", price: 89, stock: 42, status: "in_stock" },
+  { id: 2, name: "Nimbus Headphones", sku: "NIM-014", category: "Audio", price: 149, stock: 12, status: "in_stock" },
+  { id: 3, name: "Terrace Chair", sku: "TER-022", category: "Furniture", price: 210, stock: 0, status: "out_of_stock" },
+  { id: 4, name: "Lumen Desk", sku: "LUM-008", category: "Furniture", price: 340, stock: 7, status: "in_stock" },
+  { id: 5, name: "Drift Backpack", sku: "DRI-031", category: "Travel", price: 74, stock: 96, status: "low" },
+];

package/templates/default/src/data/demo/projects.js

@@ -0,0 +1,7 @@
+export const projects = [
+  { id: 1, name: "Atlas Rebrand", owner: "Aya El-Amin", progress: 65, status: "active", deadline: "2026-11-01" },
+  { id: 2, name: "Mobile App v2", owner: "Omar El-Sayed", progress: 28, status: "active", deadline: "2026-12-15" },
+  { id: 3, name: "API V2 Migration", owner: "Karim Nasser", progress: 100, status: "done", deadline: "2026-09-01" },
+  { id: 4, name: "Marketing Site", owner: "Layla Haddad", progress: 0, status: "on_hold", deadline: "2027-01-20" },
+  { id: 5, name: "Automation Playbook", owner: "Nour Farouk", progress: 12, status: "active", deadline: "2026-10-30" },
+];

package/templates/default/src/data/demo/tasks.js

@@ -0,0 +1,7 @@
+export const tasks = [
+  { id: 1, title: "Finalize landing page copy", assignee: "Aya El-Amin", priority: "high", status: "in_progress", due_date: "2026-09-18" },
+  { id: 2, title: "Fix checkout bug #412", assignee: "Omar El-Sayed", priority: "critical", status: "todo", due_date: "2026-09-16" },
+  { id: 3, title: "Update pricing page", assignee: "Layla Haddad", priority: "medium", status: "done", due_date: "2026-09-12" },
+  { id: 4, title: "Migrate database indexes", assignee: "Karim Nasser", priority: "high", status: "todo", due_date: "2026-09-22" },
+  { id: 5, title: "Prepare Q4 roadmap", assignee: "Nour Farouk", priority: "medium", status: "in_progress", due_date: "2026-09-30" },
+];

package/templates/default/src/data/demo/users.js

@@ -0,0 +1,9 @@
+// Static demo data — users. Import in your own code, e.g.
+// `import { users } from "@/data/demo/users";`
+export const users = [
+  { id: 1, name: "Aya El-Amin", email: "aya@example.com", role: "admin", status: "active", joined_at: "2026-01-12" },
+  { id: 2, name: "Omar El-Sayed", email: "omar@example.com", role: "user", status: "active", joined_at: "2026-02-03" },
+  { id: 3, name: "Layla Haddad", email: "layla@example.com", role: "user", status: "pending", joined_at: "2026-03-18" },
+  { id: 4, name: "Karim Nasser", email: "karim@example.com", role: "user", status: "suspended", joined_at: "2026-04-09" },
+  { id: 5, name: "Nour Farouk", email: "nour@example.com", role: "master", status: "active", joined_at: "2026-05-27" },
+];

package/templates/default/src/data/demoAccounts.js

@@ -0,0 +1,135 @@
+// Static demo accounts for testing. The scaffolder rewrites this file to one
+// account per role you picked (or a single normal demo user when UserRole
+// support is off) and deletes it entirely when demo accounts aren't wanted.
+// Each account carries its full profile and default settings so a backend seed
+// (or a first-login init) has everything it needs.
+export const DEMO_ACCOUNTS = [
+  {
+    role: "master",
+    email: "master@demo.dev",
+    password: "password",
+    profile: {
+      name: "Aya El-Amin",
+      email: "master@demo.dev",
+      phone: "+201000000001",
+      country_code: "EG",
+      city: "Cairo",
+      channel: "telegram",
+      channel_handle: "@aya_master",
+      photo: null,
+    },
+    settings: {
+      notification_preferences: {
+        account: { email: true, push: true, sms: false, telegram: false },
+        security: { email: true, push: true, sms: true, telegram: false },
+        marketing: { email: false, push: false, sms: false, telegram: false },
+        updates: { email: true, push: false, sms: false, telegram: false },
+      },
+      two_factor_enabled: false,
+      ai_agent: {
+        enabled: true,
+        model: "llama-3.3-70b-versatile",
+        temperature: 0.7,
+        reasoning: false,
+        system_prompt: "",
+      },
+      telegram: { bot_token: "", chat_id: "", username: "@aya_master" },
+    },
+  },
+  {
+    role: "super_admin",
+    email: "superadmin@demo.dev",
+    password: "password",
+    profile: {
+      name: "Omar El-Sayed",
+      email: "superadmin@demo.dev",
+      phone: "+966500000002",
+      country_code: "SA",
+      city: "Riyadh",
+      channel: "whatsapp",
+      channel_handle: "+966500000002",
+      photo: null,
+    },
+    settings: {
+      notification_preferences: {
+        account: { email: true, push: true, sms: false, telegram: false },
+        security: { email: true, push: true, sms: true, telegram: false },
+        marketing: { email: false, push: false, sms: false, telegram: false },
+        updates: { email: true, push: false, sms: false, telegram: false },
+      },
+      two_factor_enabled: false,
+      ai_agent: {
+        enabled: true,
+        model: "mixtral-8x7b-32768",
+        temperature: 0.7,
+        reasoning: false,
+        system_prompt: "",
+      },
+      telegram: { bot_token: "", chat_id: "", username: "" },
+    },
+  },
+  {
+    role: "admin",
+    email: "admin@demo.dev",
+    password: "password",
+    profile: {
+      name: "Layla Haddad",
+      email: "admin@demo.dev",
+      phone: "+971500000003",
+      country_code: "AE",
+      city: "Dubai",
+      channel: "none",
+      channel_handle: "",
+      photo: null,
+    },
+    settings: {
+      notification_preferences: {
+        account: { email: true, push: true, sms: false, telegram: false },
+        security: { email: true, push: true, sms: true, telegram: false },
+        marketing: { email: false, push: false, sms: false, telegram: false },
+        updates: { email: true, push: false, sms: false, telegram: false },
+      },
+      two_factor_enabled: false,
+      ai_agent: {
+        enabled: false,
+        model: "llama-3.1-8b-instant",
+        temperature: 0.5,
+        reasoning: false,
+        system_prompt: "",
+      },
+      telegram: { bot_token: "", chat_id: "", username: "" },
+    },
+  },
+  {
+    role: "user",
+    email: "user@demo.dev",
+    password: "password",
+    profile: {
+      name: "Karim Nasser",
+      email: "user@demo.dev",
+      phone: "+120200000004",
+      country_code: "US",
+      city: "New York",
+      channel: "none",
+      channel_handle: "",
+      photo: null,
+    },
+    settings: {
+      notification_preferences: {
+        account: { email: true, push: true, sms: false, telegram: false },
+        security: { email: true, push: true, sms: true, telegram: false },
+        marketing: { email: false, push: false, sms: false, telegram: false },
+        updates: { email: true, push: false, sms: false, telegram: false },
+      },
+      two_factor_enabled: false,
+      ai_agent: {
+        enabled: false,
+        model: "gemma2-9b-it",
+        temperature: 0.8,
+        reasoning: false,
+        system_prompt: "",
+      },
+      telegram: { bot_token: "", chat_id: "", username: "" },
+    },
+  },
+];

package/templates/default/src/data/roles.js

@@ -0,0 +1,25 @@
+// UserRole support. The scaffolder rewrites this file to keep only the roles
+// you picked at scaffold time; an empty ROLES means UserRole support is off.
+// `label` and `description` are vue-i18n keys (see i18n/locales/*.json).
+export const ROLES = [
+  {
+    key: "master",
+    label: "roles.master.title",
+    badge: "bg-rose-500/10 text-rose-300 ring-rose-400/30",
+  },
+  {
+    key: "super_admin",
+    label: "roles.super_admin.title",
+    badge: "bg-amber-500/10 text-amber-300 ring-amber-400/30",
+  },
+  {
+    key: "admin",
+    label: "roles.admin.title",
+    badge: "bg-cyan-500/10 text-cyan-300 ring-cyan-400/30",
+  },
+  {
+    key: "user",
+    label: "roles.user.title",
+    badge: "bg-emerald-500/10 text-emerald-300 ring-emerald-400/30",
+  },
+];

package/templates/default/src/i18n/locales/ar.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "فلك"
   },
+  "roles": {
+    "master": {
+      "title": "رئيسي"
+    },
+    "super_admin": {
+      "title": "مشرف عام"
+    },
+    "admin": {
+      "title": "مدير"
+    },
+    "user": {
+      "title": "مستخدم"
+    }
+  },
   "common": {
     "loading": "جارٍ التحميل...",
     "saving": "جارٍ الحفظ...",
@@ -91,7 +105,8 @@
       "2": "مقبولة",
       "3": "جيدة",
       "4": "قوية"
-    }
+    },
+    "role": "الدور"
   },
   "recover": {
     "title": "استعادة كلمة المرور",
@@ -184,7 +199,8 @@
       "whatsappHandle": "رقم واتساب",
       "telegramPlaceholder": "@yourusername",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "الدور"
   },
   "security": {
     "title": "الأمان",
@@ -338,4 +354,4 @@
       "off": "معطل"
     }
   }
-}
+}

package/templates/default/src/i18n/locales/de.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "Falak"
   },
+  "roles": {
+    "master": {
+      "title": "Meister"
+    },
+    "super_admin": {
+      "title": "Super-Admin"
+    },
+    "admin": {
+      "title": "Admin"
+    },
+    "user": {
+      "title": "Benutzer"
+    }
+  },
   "common": {
     "loading": "Lädt...",
     "saving": "Speichert...",
@@ -91,7 +105,8 @@
       "2": "Mittel",
       "3": "Gut",
       "4": "Stark"
-    }
+    },
+    "role": "Rolle"
   },
   "recover": {
     "title": "Passwort wiederherstellen",
@@ -184,7 +199,8 @@
       "whatsappHandle": "WhatsApp-Nummer",
       "telegramPlaceholder": "@deinusername",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "Rolle"
   },
   "security": {
     "title": "Sicherheit",
@@ -338,4 +354,4 @@
       "off": "Deaktiviert"
     }
   }
-}
+}

package/templates/default/src/i18n/locales/en.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "Falak"
   },
+  "roles": {
+    "master": {
+      "title": "Master"
+    },
+    "super_admin": {
+      "title": "Super Admin"
+    },
+    "admin": {
+      "title": "Admin"
+    },
+    "user": {
+      "title": "User"
+    }
+  },
   "common": {
     "loading": "Loading...",
     "saving": "Saving...",
@@ -91,7 +105,8 @@
       "2": "Fair",
       "3": "Good",
       "4": "Strong"
-    }
+    },
+    "role": "Role"
   },
   "recover": {
     "title": "Recover password",
@@ -184,7 +199,8 @@
       "whatsappHandle": "WhatsApp number",
       "telegramPlaceholder": "@yourusername",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "Role"
   },
   "security": {
     "title": "Security",
@@ -338,4 +354,4 @@
       "off": "Disabled"
     }
   }
-}
+}

package/templates/default/src/i18n/locales/es.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "Falak"
   },
+  "roles": {
+    "master": {
+      "title": "Maestro"
+    },
+    "super_admin": {
+      "title": "Super Adm."
+    },
+    "admin": {
+      "title": "Admin"
+    },
+    "user": {
+      "title": "Usuario"
+    }
+  },
   "common": {
     "loading": "Cargando...",
     "saving": "Guardando...",
@@ -91,7 +105,8 @@
       "2": "Aceptable",
       "3": "Buena",
       "4": "Fuerte"
-    }
+    },
+    "role": "Rol"
   },
   "recover": {
     "title": "Recuperar contraseña",
@@ -184,7 +199,8 @@
       "whatsappHandle": "Número de WhatsApp",
       "telegramPlaceholder": "@tuusuario",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "Rol"
   },
   "security": {
     "title": "Seguridad",
@@ -338,4 +354,4 @@
       "off": "Desactivado"
     }
   }
-}
+}

package/templates/default/src/i18n/locales/fr.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "Falak"
   },
+  "roles": {
+    "master": {
+      "title": "Maître"
+    },
+    "super_admin": {
+      "title": "Super Admin"
+    },
+    "admin": {
+      "title": "Admin"
+    },
+    "user": {
+      "title": "Utilisateur"
+    }
+  },
   "common": {
     "loading": "Chargement...",
     "saving": "Enregistrement...",
@@ -91,7 +105,8 @@
       "2": "Moyen",
       "3": "Bon",
       "4": "Fort"
-    }
+    },
+    "role": "Rôle"
   },
   "recover": {
     "title": "Récupérer le mot de passe",
@@ -184,7 +199,8 @@
       "whatsappHandle": "Numéro WhatsApp",
       "telegramPlaceholder": "@votrenomdutilisateur",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "Rôle"
   },
   "security": {
     "title": "Sécurité",
@@ -338,4 +354,4 @@
       "off": "Désactivé"
     }
   }
-}
+}

package/templates/default/src/i18n/locales/it.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "Falak"
   },
+  "roles": {
+    "master": {
+      "title": "Master"
+    },
+    "super_admin": {
+      "title": "Super Admin"
+    },
+    "admin": {
+      "title": "Admin"
+    },
+    "user": {
+      "title": "Utente"
+    }
+  },
   "common": {
     "loading": "Caricamento...",
     "saving": "Salvataggio...",
@@ -91,7 +105,8 @@
       "2": "Discreta",
       "3": "Buona",
       "4": "Forte"
-    }
+    },
+    "role": "Ruolo"
   },
   "recover": {
     "title": "Recupera password",
@@ -184,7 +199,8 @@
       "whatsappHandle": "Numero WhatsApp",
       "telegramPlaceholder": "@tuonomeutente",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "Ruolo"
   },
   "security": {
     "title": "Sicurezza",
@@ -338,4 +354,4 @@
       "off": "Disattivo"
     }
   }
-}
+}

package/templates/default/src/i18n/locales/ru.json

@@ -2,6 +2,20 @@
   "app": {
     "name": "Falak"
   },
+  "roles": {
+    "master": {
+      "title": "Мастер"
+    },
+    "super_admin": {
+      "title": "Супер админ"
+    },
+    "admin": {
+      "title": "Администратор"
+    },
+    "user": {
+      "title": "Пользователь"
+    }
+  },
   "common": {
     "loading": "Загрузка...",
     "saving": "Сохранение...",
@@ -91,7 +105,8 @@
       "2": "Средний",
       "3": "Хороший",
       "4": "Надёжный"
-    }
+    },
+    "role": "Роль"
   },
   "recover": {
     "title": "Восстановление пароля",
@@ -184,7 +199,8 @@
       "whatsappHandle": "Номер WhatsApp",
       "telegramPlaceholder": "@yourusername",
       "whatsappPlaceholder": "+201234567890"
-    }
+    },
+    "role": "Роль"
   },
   "security": {
     "title": "Безопасность",
@@ -338,4 +354,4 @@
       "off": "Выключено"
     }
   }
-}
+}

package/templates/default/src/main.js

@@ -1,5 +1,8 @@
 import { createApp } from "vue";
 import { createPinia } from "pinia";
+import PrimeVue from "primevue/config";
+import Aura from "@primeuix/themes/aura";
+import "primeicons/primeicons.css";
 import App from "./App.vue";
 import router from "./router";
 import i18n from "./i18n";
@@ -7,6 +10,14 @@ import "./assets/main.css";
 
 const app = createApp(App);
 
+app.use(PrimeVue, {
+  theme: {
+    preset: Aura,
+    options: {
+      cssLayer: false,
+    },
+  },
+});
 app.use(createPinia());
 app.use(router);
 app.use(i18n);

package/templates/default/src/stores/auth.js

@@ -19,6 +19,11 @@ export const useAuthStore = defineStore("auth", {
     userToken: loadToken(),
     user: null,
   }),
+  getters: {
+    // Role is part of the user account; comes from the API user payload
+    // (or was picked at registration when UserRole support is enabled).
+    role: (state) => state.user?.role || null,
+  },
   actions: {
     setToken(token) {
       this.userToken = token;

package/templates/default/src/views/Profile.vue

@@ -4,10 +4,13 @@ import { useI18n } from "vue-i18n";
 import { useAuthStore } from "@/stores/auth";
 import GlassCard from "@/components/GlassCard.vue";
 import { countries, citiesFor } from "@/data/locations";
+import { ROLES } from "@/data/roles";
 
 const { t } = useI18n();
 const auth = useAuthStore();
 
+const roleInfo = computed(() => ROLES.find((r) => r.key === auth.user?.role));
+
 const form = ref({
   name: "",
   email: "",
@@ -78,6 +81,16 @@ onMounted(async () => {
     <div class="mb-8 animate-fade-in-up motion-reduce:animate-none">
       <div class="section-head">
         <h1 class="text-2xl font-bold text-white">{{ t("profile.title") }}</h1>
+        <span
+          v-if="roleInfo"
+          class="mt-2 inline-flex w-fit items-center gap-1.5 rounded-full px-2.5 py-1 text-[11px] font-semibold uppercase tracking-wide ring-1"
+          :class="roleInfo.badge"
+        >
+          <span class="relative inline-flex h-1.5 w-1.5">
+            <span class="relative inline-flex h-1.5 w-1.5 rounded-full bg-current opacity-80"></span>
+          </span>
+          {{ t(roleInfo.label) }}
+        </span>
       </div>
       <p class="mt-1 text-sm text-gray-400">{{ t("profile.subtitle") }}</p>
     </div>

package/templates/default/src/views/Register.vue

@@ -6,6 +6,7 @@ import { useAuthStore } from "@/stores/auth";
 import AuthLayout from "@/components/AuthLayout.vue";
 import SocialIcon from "@/components/SocialIcon.vue";
 import { useRipple } from "@/composables/useRipple";
+import { ROLES } from "@/data/roles";
 
 const { t, locale } = useI18n();
 const router = useRouter();
@@ -20,6 +21,9 @@ const showPassword = ref(false);
 const error = ref("");
 const loading = ref(false);
 const socialBusy = ref("");
+// When UserRole support is on, new accounts carry a role; ROLES is empty when
+// the feature was not picked at scaffold time.
+const role = ref(ROLES[0]?.key || "");
 
 const { ripples, spawnRipple, removeRipple } = useRipple();
 
@@ -45,14 +49,16 @@ async function submit() {
   }
   loading.value = true;
   try {
-    await auth.register({
+    const payload = {
       name: name.value,
       identifier: email.value.trim(),
       email: email.value.trim(),
       phone: phone.value.trim(),
       password: password.value,
       locale: locale.value,
-    });
+    };
+    if (ROLES.length) payload.role = role.value;
+    await auth.register(payload);
     router.push({ name: "home" });
   } catch (e) {
     error.value = t("register.error");
@@ -117,6 +123,15 @@ async function social(provider) {
         />
       </label>
 
+      <label v-if="ROLES.length > 1" class="block">
+        <span class="field-label">{{ t("register.role") }}</span>
+        <select v-model="role" class="glass-select">
+          <option v-for="r in ROLES" :key="r.key" :value="r.key">
+            {{ t(r.label) }}
+          </option>
+        </select>
+      </label>
+
       <div class="grid grid-cols-1 gap-4 sm:grid-cols-2">
         <label class="block">
           <span class="field-label">{{ t("register.email") }}</span>

package/templates/default/vite.config.js

@@ -1,12 +1,13 @@
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
+import basicSsl from "@vitejs/plugin-basic-ssl";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 export default defineConfig({
-  plugins: [vue()],
+  plugins: [vue(), basicSsl()],
   resolve: {
     alias: {
       "@": path.resolve(__dirname, "src"),