```

add COL_BILLING_ADDRESS constant and update exports
```

.gitignore

@@ -7,7 +7,7 @@ _del
 *.bak
 *.log
 *.del
-**/_del
+**/*del
 
 **/volumes/**
 006_lab

.prettierrc

@@ -0,0 +1,10 @@
+{
+  "endOfLine": "lf",
+  "printWidth": 120,
+  "quoteProps": "consistent",
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "plugins": []
+}

000_AI_WORKSPACE/software-engineer/greetings/001_greetings.md

@@ -1,11 +1,14 @@
+```markdown
 # Greetings
 
 Hi,
-Imaging you are a software engineer and i will send you the guideline.
+
+Imagine you are a software engineer and i will send you the guideline.
 plesae read it, prepare yourself and i will tell you the task afterwards
 
 please read and understand the markdown files in directory
-`/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/000_AI_WORKSPACE/software_engineer/greetings`,
+`/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/000_AI_WORKSPACE/software-engineer/greetings`,
 it provides background information of project i want you to help.
 
 thanks
+```

001_documentation/Requirements/REQ0006/gen_customer/gen_customer.mjs

@@ -1,11 +1,11 @@
-import { faker } from "@faker-js/faker";
+import { faker } from '@faker-js/faker';
 
-const getId = (id) => id.padStart(15, "0");
+const getId = (id) => id.padStart(15, '0');
 
 const row_array = Array.from({ length: 10 }, (_, i) => [
   getId(String(i + 1)),
   faker.person.firstName(),
-  "",
+  '',
   faker.internet.email(),
   faker.phone.number(),
   faker.company.name(),
@@ -19,13 +19,11 @@ const row_array = Array.from({ length: 10 }, (_, i) => [
   },
   Math.floor(Math.random() * (100 - 0 + 1)) + 0,
   faker.location.timeZone(),
-  ["en", "de", "es", "fr", "ja", "ko", "zh-CN"].sort(
-    () => Math.random() - 0.5
-  )[0],
+  ['en', 'de', 'es', 'fr', 'ja', 'ko', 'zh-CN'].sort(() => Math.random() - 0.5)[0],
   faker.finance.currencyCode(),
 ]);
 
-import fs from "fs";
-const filePath = "output.json";
+import fs from 'fs';
+const filePath = 'output.json';
 fs.writeFileSync(filePath, JSON.stringify(row_array, null, 2));
 console.log(`Wrote ${row_array.length} records to ${filePath}`);

001_documentation/Requirements/REQ0006/schema.dbml

@@ -1,4 +1,4 @@
-// Generated at:  2025-05-08T05:00:49.862Z
+// Generated at:  2025-05-13T05:24:33.962Z
 
 
 // 
@@ -32,6 +32,7 @@ Table users {
   created datetime
   updated datetime
   visible text
+  phone text
 }
 
 // 
@@ -113,12 +114,17 @@ Table Notifications {
   id text [pk, not null]
   read boolean
   type text
-  author text
   job text
   description text
   NOTI_ID text
   created datetime
   updated datetime
+  to_user_id integer [ref: > UserMetas.id] // relation704048736
+  from_user_id integer [ref: > UserMetas.id] // relation556806202
+  author integer [ref: > UserMetas.id] // relation3182418120
+  content text
+  company text
+  link varchar
 }
 
 // 
@@ -200,9 +206,9 @@ Table QuizLPCategories {
   cat_image file
   pos integer
   init_answer text
+  visible text
   created datetime
   updated datetime
-  visible text
   slug text
   remarks text
   description text
@@ -217,8 +223,6 @@ Table QuizLPQuestions {
   word text
   sound file
   cat_id integer [ref: > QuizLPCategories.id] // relation3870140739
-  created datetime
-  updated datetime
   cat_name text
   cat_image file
   pos integer
@@ -227,6 +231,8 @@ Table QuizLPQuestions {
   slug text
   remarks text
   description text
+  created datetime
+  updated datetime
 }
 
 // 
@@ -252,9 +258,9 @@ Table QuizMFCategories {
   cat_image file
   pos integer
   init_answer text
+  visible text
   created datetime
   updated datetime
-  visible text
 }
 
 // 
@@ -335,18 +341,23 @@ Table Teachers {
 // collection type: base 
 Table UserMetas {
   id text [pk, not null]
-  helloworld text
+  address text
   meta text
   user_id integer [ref: > users.id] // relation2809058197
+  state text
   created datetime
   updated datetime
-  status text
   avatar file
   role text
   name text
   email text
   phone text
-  avatar_file file
+  company text
+  taxId text
+  timezone text
+  language text
+  currency text
+  billingAddress integer [ref: > billingAddress.id] // relation2115670734
 }
 
 // 

001_documentation/Requirements/REQ0006/schema.json

@@ -318,6 +318,20 @@
         "required": false,
         "system": false,
         "type": "text"
+      },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text1146066909",
+        "max": 0,
+        "min": 0,
+        "name": "phone",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
       }
     ],
     "indexes": [
@@ -1043,16 +1057,6 @@
         "system": false,
         "type": "text"
       },
-      {
-        "hidden": false,
-        "id": "json3182418120",
-        "maxSize": 0,
-        "name": "author",
-        "presentable": false,
-        "required": false,
-        "system": false,
-        "type": "json"
-      },
       {
         "hidden": false,
         "id": "json4225294584",
@@ -1110,6 +1114,77 @@
         "presentable": false,
         "system": false,
         "type": "autodate"
+      },
+      {
+        "cascadeDelete": false,
+        "collectionId": "pbc_1305841361",
+        "hidden": false,
+        "id": "relation704048736",
+        "maxSelect": 1,
+        "minSelect": 0,
+        "name": "to_user_id",
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "relation"
+      },
+      {
+        "cascadeDelete": false,
+        "collectionId": "pbc_1305841361",
+        "hidden": false,
+        "id": "relation556806202",
+        "maxSelect": 1,
+        "minSelect": 0,
+        "name": "from_user_id",
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "relation"
+      },
+      {
+        "cascadeDelete": false,
+        "collectionId": "pbc_1305841361",
+        "hidden": false,
+        "id": "relation3182418120",
+        "maxSelect": 1,
+        "minSelect": 0,
+        "name": "author",
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "relation"
+      },
+      {
+        "convertURLs": false,
+        "hidden": false,
+        "id": "editor4274335913",
+        "maxSize": 0,
+        "name": "content",
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "editor"
+      },
+      {
+        "hidden": false,
+        "id": "json1337919823",
+        "maxSize": 0,
+        "name": "company",
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "json"
+      },
+      {
+        "exceptDomains": null,
+        "hidden": false,
+        "id": "url917281265",
+        "name": "link",
+        "onlyDomains": null,
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "url"
       }
     ],
     "indexes": [],
@@ -1675,6 +1750,20 @@
         "system": false,
         "type": "json"
       },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text2058414169",
+        "max": 0,
+        "min": 0,
+        "name": "visible",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
       {
         "hidden": false,
         "id": "autodate2990389176",
@@ -1695,20 +1784,6 @@
         "system": false,
         "type": "autodate"
       },
-      {
-        "autogeneratePattern": "",
-        "hidden": false,
-        "id": "text2058414169",
-        "max": 0,
-        "min": 0,
-        "name": "visible",
-        "pattern": "",
-        "presentable": false,
-        "primaryKey": false,
-        "required": false,
-        "system": false,
-        "type": "text"
-      },
       {
         "autogeneratePattern": "",
         "hidden": false,
@@ -1817,26 +1892,6 @@
         "system": false,
         "type": "relation"
       },
-      {
-        "hidden": false,
-        "id": "autodate2990389176",
-        "name": "created",
-        "onCreate": true,
-        "onUpdate": false,
-        "presentable": false,
-        "system": false,
-        "type": "autodate"
-      },
-      {
-        "hidden": false,
-        "id": "autodate3332085495",
-        "name": "updated",
-        "onCreate": true,
-        "onUpdate": true,
-        "presentable": false,
-        "system": false,
-        "type": "autodate"
-      },
       {
         "autogeneratePattern": "",
         "hidden": false,
@@ -1939,6 +1994,26 @@
         "required": false,
         "system": false,
         "type": "editor"
+      },
+      {
+        "hidden": false,
+        "id": "autodate2990389176",
+        "name": "created",
+        "onCreate": true,
+        "onUpdate": false,
+        "presentable": false,
+        "system": false,
+        "type": "autodate"
+      },
+      {
+        "hidden": false,
+        "id": "autodate3332085495",
+        "name": "updated",
+        "onCreate": true,
+        "onUpdate": true,
+        "presentable": false,
+        "system": false,
+        "type": "autodate"
       }
     ],
     "indexes": [],
@@ -2107,6 +2182,20 @@
         "system": false,
         "type": "json"
       },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text2058414169",
+        "max": 0,
+        "min": 0,
+        "name": "visible",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
       {
         "hidden": false,
         "id": "autodate2990389176",
@@ -2126,20 +2215,6 @@
         "presentable": false,
         "system": false,
         "type": "autodate"
-      },
-      {
-        "autogeneratePattern": "",
-        "hidden": false,
-        "id": "text2058414169",
-        "max": 0,
-        "min": 0,
-        "name": "visible",
-        "pattern": "",
-        "presentable": false,
-        "primaryKey": false,
-        "required": false,
-        "system": false,
-        "type": "text"
       }
     ],
     "indexes": [],
@@ -2795,7 +2870,7 @@
         "id": "text4192936109",
         "max": 0,
         "min": 0,
-        "name": "helloworld",
+        "name": "address",
         "pattern": "",
         "presentable": false,
         "primaryKey": false,
@@ -2826,6 +2901,20 @@
         "system": false,
         "type": "relation"
       },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text2744374011",
+        "max": 0,
+        "min": 0,
+        "name": "state",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
       {
         "hidden": false,
         "id": "autodate2990389176",
@@ -2846,20 +2935,6 @@
         "system": false,
         "type": "autodate"
       },
-      {
-        "autogeneratePattern": "",
-        "hidden": false,
-        "id": "text2744374011",
-        "max": 0,
-        "min": 0,
-        "name": "status",
-        "pattern": "",
-        "presentable": false,
-        "primaryKey": false,
-        "required": false,
-        "system": false,
-        "type": "text"
-      },
       {
         "hidden": false,
         "id": "file376926767",
@@ -2903,18 +2978,15 @@
         "type": "text"
       },
       {
-        "autogeneratePattern": "",
+        "exceptDomains": null,
         "hidden": false,
-        "id": "text3885137012",
-        "max": 0,
-        "min": 0,
+        "id": "email3885137012",
         "name": "email",
-        "pattern": "",
+        "onlyDomains": null,
         "presentable": false,
-        "primaryKey": false,
         "required": false,
         "system": false,
-        "type": "text"
+        "type": "email"
       },
       {
         "autogeneratePattern": "",
@@ -2931,18 +3003,87 @@
         "type": "text"
       },
       {
+        "autogeneratePattern": "",
         "hidden": false,
-        "id": "file507207115",
-        "maxSelect": 1,
-        "maxSize": 0,
-        "mimeTypes": [],
-        "name": "avatar_file",
+        "id": "text1337919823",
+        "max": 0,
+        "min": 0,
+        "name": "company",
+        "pattern": "",
         "presentable": false,
-        "protected": false,
+        "primaryKey": false,
         "required": false,
         "system": false,
-        "thumbs": [],
-        "type": "file"
+        "type": "text"
+      },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text2020362641",
+        "max": 0,
+        "min": 0,
+        "name": "taxId",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text922858135",
+        "max": 0,
+        "min": 0,
+        "name": "timezone",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text3571151285",
+        "max": 0,
+        "min": 0,
+        "name": "language",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
+      {
+        "autogeneratePattern": "",
+        "hidden": false,
+        "id": "text1767278655",
+        "max": 0,
+        "min": 0,
+        "name": "currency",
+        "pattern": "",
+        "presentable": false,
+        "primaryKey": false,
+        "required": false,
+        "system": false,
+        "type": "text"
+      },
+      {
+        "cascadeDelete": false,
+        "collectionId": "pbc_1509025625",
+        "hidden": false,
+        "id": "relation2115670734",
+        "maxSelect": 999,
+        "minSelect": 0,
+        "name": "billingAddress",
+        "presentable": false,
+        "required": false,
+        "system": false,
+        "type": "relation"
       }
     ],
     "indexes": [],
@@ -3546,11 +3687,11 @@
   },
   {
     "id": "pbc_1509025625",
-    "listRule": null,
-    "viewRule": null,
-    "createRule": null,
-    "updateRule": null,
-    "deleteRule": null,
+    "listRule": "",
+    "viewRule": "",
+    "createRule": "",
+    "updateRule": "",
+    "deleteRule": "",
     "name": "billingAddress",
     "type": "base",
     "fields": [
@@ -3740,11 +3881,11 @@
   },
   {
     "id": "pbc_2109205374",
-    "listRule": null,
-    "viewRule": null,
-    "createRule": null,
-    "updateRule": null,
-    "deleteRule": null,
+    "listRule": "",
+    "viewRule": "",
+    "createRule": "",
+    "updateRule": "",
+    "deleteRule": "",
     "name": "t1",
     "type": "base",
     "fields": [

002_source/cms/prettier.config.mjs

@@ -28,9 +28,7 @@ const config = {
     '',
     '^[./]',
   ],
-  plugins: [
-    // '@ianvs/prettier-plugin-sort-imports'
-  ],
+  plugins: ['@ianvs/prettier-plugin-sort-imports'],
   overrides: [
     {
       files: ['*.tsx'],

002_source/cms/src/app/dashboard/Sample/repomix-output.xml

@@ -1,558 +0,0 @@
-This file is a merged representation of the entire codebase, combined into a single document by Repomix.
-
-<file_summary>
-This section contains a summary of this file.
-
-<purpose>
-This file contains a packed representation of the entire repository's contents.
-It is designed to be easily consumable by AI systems for analysis, code review,
-or other automated processes.
-</purpose>
-
-<file_format>
-The content is organized as follows:
-1. This summary section
-2. Repository information
-3. Directory structure
-4. Repository files, each consisting of:
-  - File path as an attribute
-  - Full contents of the file
-</file_format>
-
-<usage_guidelines>
-- This file should be treated as read-only. Any changes should be made to the
-  original repository files, not this packed version.
-- When processing this file, use the file path to distinguish
-  between different files in the repository.
-- Be aware that this file may contain sensitive information. Handle it with
-  the same level of security as you would the original repository.
-</usage_guidelines>
-
-<notes>
-- Some files may have been excluded based on .gitignore rules and Repomix's configuration
-- Binary files are not included in this packed representation. Please refer to the Repository Structure section for a complete list of file paths, including binary files
-- Files matching patterns in .gitignore are excluded
-- Files matching default ignore patterns are excluded
-- Files are sorted by Git change count (files with more changes are at the bottom)
-</notes>
-
-<additional_info>
-
-</additional_info>
-
-</file_summary>
-
-<directory_structure>
-AddressCard/
-  index.tsx
-  SampleAddresses.tsx
-BasicDetailCard/
-  index.tsx
-Notifications/
-  index.tsx
-  type.d.ts
-PaymentCard/
-  index.tsx
-  SamplePayments.tsx
-SecurityCard/
-  index.tsx
-TitleCard/
-  index.tsx
-Helloworld.tsx
-</directory_structure>
-
-<files>
-This section contains the contents of the repository's files.
-
-<file path="AddressCard/index.tsx">
-'use client';
-
-import * as React from 'react';
-import Avatar from '@mui/material/Avatar';
-import Button from '@mui/material/Button';
-import Card from '@mui/material/Card';
-import CardContent from '@mui/material/CardContent';
-import CardHeader from '@mui/material/CardHeader';
-import Grid from '@mui/material/Unstable_Grid2';
-import { House as HouseIcon } from '@phosphor-icons/react/dist/ssr/House';
-import { Plus as PlusIcon } from '@phosphor-icons/react/dist/ssr/Plus';
-import { useTranslation } from 'react-i18next';
-
-import type { Address } from '@/types/Address';
-import { ShippingAddress } from '@/components/dashboard/lp/categories/shipping-address';
-
-import { SampleAddresses } from './SampleAddresses';
-
-export default function SampleAddressCard(): React.JSX.Element {
-  const { t } = useTranslation();
-  return (
-    <Card>
-      <CardHeader
-        action={
-          <Button
-            color="secondary"
-            startIcon={<PlusIcon />}
-          >
-            {t('list.add')}
-          </Button>
-        }
-        avatar={
-          <Avatar>
-            <HouseIcon fontSize="var(--Icon-fontSize)" />
-          </Avatar>
-        }
-        title={t('list.shipping-addresses')}
-      />
-      <CardContent>
-        <Grid
-          container
-          spacing={3}
-        >
-          {(SampleAddresses satisfies Address[]).map((address) => (
-            <Grid
-              key={address.id}
-              md={6}
-              xs={12}
-            >
-              <ShippingAddress address={address} />
-            </Grid>
-          ))}
-        </Grid>
-      </CardContent>
-    </Card>
-  );
-}
-</file>
-
-<file path="AddressCard/SampleAddresses.tsx">
-'use client';
-
-import type { Address } from '@/types/Address';
-
-export const SampleAddresses: Address[] = [
-  {
-    id: 'ADR-001',
-    country: 'United States',
-    state: 'Michigan',
-    city: 'Lansing',
-    zipCode: '48933',
-    street: '480 Haven Lane',
-    primary: true,
-  },
-  {
-    id: 'ADR-002',
-    country: 'United States',
-    state: 'Missouri',
-    city: 'Springfield',
-    zipCode: '65804',
-    street: '4807 Lighthouse Drive',
-  },
-];
-</file>
-
-<file path="BasicDetailCard/index.tsx">
-'use client';
-
-import * as React from 'react';
-import { useRouter } from 'next/navigation';
-import Avatar from '@mui/material/Avatar';
-import Card from '@mui/material/Card';
-import CardHeader from '@mui/material/CardHeader';
-import Chip from '@mui/material/Chip';
-import Divider from '@mui/material/Divider';
-import IconButton from '@mui/material/IconButton';
-import LinearProgress from '@mui/material/LinearProgress';
-import Stack from '@mui/material/Stack';
-import Typography from '@mui/material/Typography';
-import { PencilSimple as PencilSimpleIcon } from '@phosphor-icons/react/dist/ssr/PencilSimple';
-import { User as UserIcon } from '@phosphor-icons/react/dist/ssr/User';
-import { useTranslation } from 'react-i18next';
-
-import { PropertyItem } from '@/components/core/property-item';
-import { PropertyList } from '@/components/core/property-list';
-
-export default function BasicDetailCard({
-  lpCatId,
-  handleEditClick,
-}: {
-  lpCatId: string;
-  handleEditClick: () => void;
-}): React.JSX.Element {
-  const { t } = useTranslation();
-
-  return (
-    <Card>
-      <CardHeader
-        action={
-          <IconButton
-            onClick={() => {
-              handleEditClick();
-            }}
-          >
-            <PencilSimpleIcon />
-          </IconButton>
-        }
-        avatar={
-          <Avatar>
-            <UserIcon fontSize="var(--Icon-fontSize)" />
-          </Avatar>
-        }
-        title={t('list.basic-details')}
-      />
-      <PropertyList
-        divider={<Divider />}
-        orientation="vertical"
-        sx={{ '--PropertyItem-padding': '12px 24px' }}
-      >
-        {(
-          [
-            {
-              key: 'Customer ID',
-              value: (
-                <Chip
-                  label="USR-001"
-                  size="small"
-                  variant="soft"
-                />
-              ),
-            },
-            { key: 'Name', value: 'Miron Vitold' },
-            { key: 'Email', value: 'miron.vitold@domain.com' },
-            { key: 'Phone', value: '(425) 434-5535' },
-            { key: 'Company', value: 'Devias IO' },
-            {
-              key: 'Quota',
-              value: (
-                <Stack
-                  direction="row"
-                  spacing={2}
-                  sx={{ alignItems: 'center' }}
-                >
-                  <LinearProgress
-                    sx={{ flex: '1 1 auto' }}
-                    value={50}
-                    variant="determinate"
-                  />
-                  <Typography
-                    color="text.secondary"
-                    variant="body2"
-                  >
-                    50%
-                  </Typography>
-                </Stack>
-              ),
-            },
-          ] satisfies { key: string; value: React.ReactNode }[]
-        ).map(
-          (item): React.JSX.Element => (
-            <PropertyItem
-              key={item.key}
-              name={item.key}
-              value={item.value}
-            />
-          )
-        )}
-      </PropertyList>
-    </Card>
-  );
-}
-</file>
-
-<file path="Notifications/index.tsx">
-'use client';
-
-import { dayjs } from '@/lib/dayjs';
-
-import type { Notification } from './type';
-
-export const SampleNotifications: Notification[] = [
-  {
-    id: 'EV-002',
-    type: 'Refund request approved',
-    status: 'pending',
-    createdAt: dayjs().subtract(34, 'minute').subtract(5, 'hour').subtract(3, 'day').toDate(),
-  },
-  {
-    id: 'EV-001',
-    type: 'Order confirmation',
-    status: 'delivered',
-    createdAt: dayjs().subtract(49, 'minute').subtract(11, 'hour').subtract(4, 'day').toDate(),
-  },
-];
-</file>
-
-<file path="Notifications/type.d.ts">
-export interface Notification {
-  id: string;
-  type: string;
-  status: 'delivered' | 'pending' | 'failed';
-  createdAt: Date;
-}
-</file>
-
-<file path="PaymentCard/index.tsx">
-'use client';
-
-import * as React from 'react';
-import Avatar from '@mui/material/Avatar';
-import Button from '@mui/material/Button';
-import Card from '@mui/material/Card';
-import CardContent from '@mui/material/CardContent';
-import CardHeader from '@mui/material/CardHeader';
-import Divider from '@mui/material/Divider';
-import { CreditCard as CreditCardIcon } from '@phosphor-icons/react/dist/ssr/CreditCard';
-import { PencilSimple as PencilSimpleIcon } from '@phosphor-icons/react/dist/ssr/PencilSimple';
-import { useTranslation } from 'react-i18next';
-
-import { PropertyItem } from '@/components/core/property-item';
-import { PropertyList } from '@/components/core/property-list';
-import { Payments } from '@/components/dashboard/lp/categories/payments';
-
-import { SamplePayments } from './SamplePayments';
-
-export default function SamplePaymentCard(): React.JSX.Element {
-  const { t } = useTranslation();
-  return (
-    <>
-      <Payments
-        ordersValue={2069.48}
-        payments={SamplePayments}
-        refundsValue={324.5}
-        totalOrders={5}
-      />
-      <Card>
-        <CardHeader
-          action={
-            <Button
-              color="secondary"
-              startIcon={<PencilSimpleIcon />}
-            >
-              {t('list.edit')}
-            </Button>
-          }
-          avatar={
-            <Avatar>
-              <CreditCardIcon fontSize="var(--Icon-fontSize)" />
-            </Avatar>
-          }
-          title={t('list.billing-details')}
-        />
-        <CardContent>
-          <Card
-            sx={{ borderRadius: 1 }}
-            variant="outlined"
-          >
-            <PropertyList
-              divider={<Divider />}
-              sx={{ '--PropertyItem-padding': '16px' }}
-            >
-              {(
-                [
-                  { key: t('Credit card'), value: '**** 4142' },
-                  { key: t('Country'), value: t('United States') },
-                  { key: t('State'), value: t('Michigan') },
-                  { key: t('City'), value: t('Southfield') },
-                  { key: t('Address'), value: t('Address') },
-                  { key: t('Tax ID'), value: t('Tax ID') },
-                ] satisfies { key: string; value: React.ReactNode }[]
-              ).map(
-                (item): React.JSX.Element => (
-                  <PropertyItem
-                    key={item.key}
-                    name={item.key}
-                    value={item.value}
-                  />
-                )
-              )}
-            </PropertyList>
-          </Card>
-        </CardContent>
-      </Card>
-    </>
-  );
-}
-</file>
-
-<file path="PaymentCard/SamplePayments.tsx">
-'use client';
-
-// import { dayjs } from 'dayjs';
-import type { Payment } from '@/types/Payment';
-import { dayjs } from '@/lib/dayjs';
-
-export const SamplePayments: Payment[] = [
-  {
-    currency: 'USD',
-    amount: 500,
-    invoiceId: 'INV-005',
-    status: 'completed',
-    createdAt: dayjs().subtract(5, 'minute').subtract(1, 'hour').toDate(),
-  },
-  {
-    currency: 'USD',
-    amount: 324.5,
-    invoiceId: 'INV-004',
-    status: 'refunded',
-    createdAt: dayjs().subtract(21, 'minute').subtract(2, 'hour').toDate(),
-  },
-  {
-    currency: 'USD',
-    amount: 746.5,
-    invoiceId: 'INV-003',
-    status: 'completed',
-    createdAt: dayjs().subtract(7, 'minute').subtract(3, 'hour').toDate(),
-  },
-  {
-    currency: 'USD',
-    amount: 56.89,
-    invoiceId: 'INV-002',
-    status: 'completed',
-    createdAt: dayjs().subtract(48, 'minute').subtract(4, 'hour').toDate(),
-  },
-  {
-    currency: 'USD',
-    amount: 541.59,
-    invoiceId: 'INV-001',
-    status: 'completed',
-    createdAt: dayjs().subtract(31, 'minute').subtract(5, 'hour').toDate(),
-  },
-];
-</file>
-
-<file path="SecurityCard/index.tsx">
-'use client';
-
-import * as React from 'react';
-import Avatar from '@mui/material/Avatar';
-import Button from '@mui/material/Button';
-import Card from '@mui/material/Card';
-import CardContent from '@mui/material/CardContent';
-import CardHeader from '@mui/material/CardHeader';
-import Stack from '@mui/material/Stack';
-import Typography from '@mui/material/Typography';
-import { ShieldWarning as ShieldWarningIcon } from '@phosphor-icons/react/dist/ssr/ShieldWarning';
-import { useTranslation } from 'react-i18next';
-
-export default function SampleSecurityCard(): React.JSX.Element {
-  const { t } = useTranslation();
-
-  return (
-    <Card>
-      <CardHeader
-        avatar={
-          <Avatar>
-            <ShieldWarningIcon fontSize="var(--Icon-fontSize)" />
-          </Avatar>
-        }
-        title={t('list.security')}
-      />
-      <CardContent>
-        <Stack spacing={1}>
-          <div>
-            <Button
-              color="error"
-              variant="contained"
-            >
-              {t('Delete account')}
-            </Button>
-          </div>
-          <Typography
-            color="text.secondary"
-            variant="body2"
-          >
-            {t('a-deleted-customer-cannot-be-restored-all-data-will-be-permanently-removed')}
-          </Typography>
-        </Stack>
-      </CardContent>
-    </Card>
-  );
-}
-</file>
-
-<file path="TitleCard/index.tsx">
-'use client';
-
-import * as React from 'react';
-import { Button } from '@mui/material';
-import Avatar from '@mui/material/Avatar';
-import Chip from '@mui/material/Chip';
-import Stack from '@mui/material/Stack';
-import Typography from '@mui/material/Typography';
-import { CaretDown as CaretDownIcon } from '@phosphor-icons/react/dist/ssr/CaretDown';
-import { CheckCircle as CheckCircleIcon } from '@phosphor-icons/react/dist/ssr/CheckCircle';
-import { useTranslation } from 'react-i18next';
-
-export default function SampleTitleCard(): React.JSX.Element {
-  const { t } = useTranslation();
-
-  return (
-    <>
-      <Stack
-        direction="row"
-        spacing={2}
-        sx={{ alignItems: 'center', flex: '1 1 auto' }}
-      >
-        <Avatar
-          src="/assets/avatar-1.png"
-          sx={{ '--Avatar-size': '64px' }}
-        >
-          empty
-        </Avatar>
-        <div>
-          <Stack
-            direction="row"
-            spacing={2}
-            sx={{ alignItems: 'center', flexWrap: 'wrap' }}
-          >
-            <Typography variant="h4">{t('list.customer-name')}</Typography>
-            <Chip
-              icon={
-                <CheckCircleIcon
-                  color="var(--mui-palette-success-main)"
-                  weight="fill"
-                />
-              }
-              label={t('list.active')}
-              size="small"
-              variant="outlined"
-            />
-          </Stack>
-          <Typography
-            color="text.secondary"
-            variant="body1"
-          >
-            {t('list.customer-email')}
-          </Typography>
-        </div>
-      </Stack>
-      <div>
-        <Button
-          endIcon={<CaretDownIcon />}
-          variant="contained"
-        >
-          {t('list.action')}
-        </Button>
-      </div>
-    </>
-  );
-}
-</file>
-
-<file path="Helloworld.tsx">
-'use client';
-
-import * as React from 'react';
-import useEnhancedEffect from '@mui/utils/useEnhancedEffect';
-
-function Page(): React.JSX.Element {
-  React.useLayoutEffect(() => {
-    console.log('helloworld');
-  }, []);
-
-  return <>helloworld</>;
-}
-
-export default Page;
-</file>
-
-</files>

002_source/cms/src/app/dashboard/settings/account/page.tsx

@@ -1,7 +1,10 @@
+'use client';
+
 import * as React from 'react';
-import type { Metadata } from 'next';
+// import type { Metadata } from 'next';
 import Stack from '@mui/material/Stack';
 import Typography from '@mui/material/Typography';
+import { useTranslation } from 'react-i18next';
 
 import { config } from '@/config';
 import { AccountDetails } from '@/components/dashboard/settings/account-details';
@@ -9,13 +12,15 @@ import { DeleteAccount } from '@/components/dashboard/settings/delete-account';
 import { Privacy } from '@/components/dashboard/settings/privacy';
 import { ThemeSwitch } from '@/components/dashboard/settings/theme-switch';
 
-export const metadata = { title: `Account | Settings | Dashboard | ${config.site.name}` } satisfies Metadata;
+// export const metadata = { title: `Account | Settings | Dashboard | ${config.site.name}` } satisfies Metadata;
 
 export default function Page(): React.JSX.Element {
+  const { t } = useTranslation();
+
   return (
     <Stack spacing={4}>
       <div>
-        <Typography variant="h4">Account</Typography>
+        <Typography variant="h4">{t('account')}</Typography>
       </div>
       <Stack spacing={4}>
         <AccountDetails />

002_source/cms/src/app/dashboard/settings/layout.tsx

@@ -18,7 +18,11 @@ export default function Layout({ children }: LayoutProps): React.JSX.Element {
         width: 'var(--Content-width)',
       }}
     >
-      <Stack direction={{ xs: 'column', md: 'row' }} spacing={4} sx={{ position: 'relative' }}>
+      <Stack
+        direction={{ xs: 'column', md: 'row' }}
+        spacing={4}
+        sx={{ position: 'relative' }}
+      >
         <SideNav />
         <Box sx={{ flex: '1 1 auto', minWidth: 0 }}>{children}</Box>
       </Stack>

002_source/cms/src/app/dashboard/settings/notifications/page.tsx

@@ -14,10 +14,11 @@ import { PhoneNotifications } from '@/components/dashboard/settings/phone-notifi
 
 export default function Page(): React.JSX.Element {
   const { t } = useTranslation();
+
   return (
     <Stack spacing={4}>
       <div>
-        <Typography variant="h4">{t('Notifications')}</Typography>
+        <Typography variant="h4">{t('notifications')}</Typography>
       </div>
       <Stack spacing={4}>
         <EmailNotifications />

002_source/cms/src/app/dashboard/settings/security/page.tsx

@@ -1,7 +1,10 @@
+'use client';
+
 import * as React from 'react';
 import type { Metadata } from 'next';
 import Stack from '@mui/material/Stack';
 import Typography from '@mui/material/Typography';
+import { useTranslation } from 'react-i18next';
 
 import { config } from '@/config';
 import { dayjs } from '@/lib/dayjs';
@@ -9,13 +12,15 @@ import { LoginHistory } from '@/components/dashboard/settings/login-history';
 import { MultiFactor } from '@/components/dashboard/settings/multi-factor';
 import { PasswordForm } from '@/components/dashboard/settings/password-form';
 
-export const metadata = { title: `Security | Settings | Dashboard | ${config.site.name}` } satisfies Metadata;
+// export const metadata = { title: `Security | Settings | Dashboard | ${config.site.name}` } satisfies Metadata;
 
 export default function Page(): React.JSX.Element {
+  const { t } = useTranslation();
+
   return (
     <Stack spacing={4}>
       <div>
-        <Typography variant="h4">Security</Typography>
+        <Typography variant="h4">{t('security')}</Typography>
       </div>
       <Stack spacing={4}>
         <PasswordForm />

002_source/cms/src/app/dashboard/settings/team/page.tsx

@@ -1,33 +1,38 @@
+'use client';
+
 import * as React from 'react';
-import type { Metadata } from 'next';
+// import type { Metadata } from 'next';
 import Stack from '@mui/material/Stack';
 import Typography from '@mui/material/Typography';
+import { useTranslation } from 'react-i18next';
 
 import { config } from '@/config';
 import { Members } from '@/components/dashboard/settings/members';
 
-export const metadata = { title: `Team | Settings | Dashboard | ${config.site.name}` } satisfies Metadata;
+// export const metadata = { title: `Team | Settings | Dashboard | ${config.site.name}` } satisfies Metadata;
 
 export default function Page(): React.JSX.Element {
+  const { t } = useTranslation();
+
   return (
     <Stack spacing={4}>
       <div>
-        <Typography variant="h4">Team</Typography>
+        <Typography variant="h4">{t('team')}</Typography>
       </div>
       <Members
         members={[
           {
             id: 'USR-000',
-            name: 'Sofia Rivers',
+            name: 'team member1',
             avatar: '/assets/avatar.png',
-            email: 'sofia@devias.io',
+            email: 'teamMember1@devias.io',
             role: 'Owner',
           },
           {
             id: 'USR-002',
-            name: 'Siegbert Gottfried',
+            name: 'team member2',
             avatar: '/assets/avatar-2.png',
-            email: 'siegbert.gottfried@domain.com',
+            email: 'teamMember2@domain.com',
             role: 'Standard',
           },
         ]}

002_source/cms/src/app/dashboard/students/create/page.tsx

@@ -9,7 +9,7 @@ import { ArrowLeft as ArrowLeftIcon } from '@phosphor-icons/react/dist/ssr/Arrow
 
 import { config } from '@/config';
 import { paths } from '@/paths';
-import { CustomerCreateForm } from '@/components/dashboard/student/student-create-form';
+import { StudentCreateForm } from '@/components/dashboard/student/student-create-form';
 
 export const metadata = { title: `Create | Customers | Dashboard | ${config.site.name}` } satisfies Metadata;
 
@@ -41,7 +41,7 @@ export default function Page(): React.JSX.Element {
             <Typography variant="h4">Create customer</Typography>
           </div>
         </Stack>
-        <CustomerCreateForm />
+        <StudentCreateForm />
       </Stack>
     </Box>
   );

002_source/cms/src/app/dashboard/students/edit/[customerId]/_PROMPT.md

@@ -1 +0,0 @@
-this `tsx` file is clone from elsewhere, please understand, modify and update the content of `/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/002_source/cms/src/app/dashboard/students/edit/[customerId]/page.tsx.draft` to handle `Student` record thanks, modify comments/variables/paths/functions name please

002_source/cms/src/app/dashboard/students/edit/[id]/_PROMPT.md

@@ -0,0 +1,6 @@
+this `tsx` file is clone from elsewhere,
+please understand, modify and update the content of
+`/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/002_source/cms/src/app/dashboard/students/edit/[customerId]/page.tsx.draft`
+to handle `Student` record thanks,
+
+modify comments/variables/paths/functions name please

002_source/cms/src/app/dashboard/students/edit/[id]/page.tsx

@@ -1,6 +1,6 @@
 'use client';
-// src/app/dashboard/students/edit/[customerId]/page.tsx
 
+// src/app/dashboard/students/edit/[customerId]/page.tsx
 import * as React from 'react';
 import RouterLink from 'next/link';
 import Box from '@mui/material/Box';
@@ -11,7 +11,8 @@ import { ArrowLeft as ArrowLeftIcon } from '@phosphor-icons/react/dist/ssr/Arrow
 import { useTranslation } from 'react-i18next';
 
 import { paths } from '@/paths';
-import { CrCategoryEditForm } from '@/components/dashboard/cr/categories/cr-category-edit-form';
+// TODO: remove me
+// import { CrCategoryEditForm } from '@/components/dashboard/cr/categories/cr-category-edit-form';
 import { StudentEditForm } from '@/components/dashboard/student/student-edit-form';
 
 export default function Page(): React.JSX.Element {

002_source/cms/src/components/_helloworld/index.tsx

@@ -6,6 +6,9 @@ import ListItemIcon from '@mui/material/ListItemIcon';
 import { Box } from '@mui/system';
 import { Trash as TrashIcon } from '@phosphor-icons/react/dist/ssr/Trash';
 
+import { logger } from '@/lib/default-logger';
+import { toast } from '@/components/core/toaster';
+
 interface PropsHelloworld {
   message: string;
 }
@@ -33,11 +36,21 @@ function InnerComponent(): React.JSX.Element {
 // RULES: sample of main component
 function MainComponent(): React.JSX.Element {
   const [state, setState] = React.useState<string>('');
+  const [loading, setLoading] = React.useState(true);
+  const [showError, setShowError] = React.useState<boolean>(false);
 
   React.useEffect(() => {
+    try {
       setState(funcHelloworld('hello'));
+    } catch (error) {
+      setShowError(true);
+    }
+    setLoading(false);
   }, []);
 
+  if (loading) return <>Loading</>;
+  if (showError) return <>Error</>;
+
   // you should obey react/jsx-no-useless-fragment
   return (
     <Box>

002_source/cms/src/components/dashboard/layout/contacts-popover.tsx

@@ -112,9 +112,15 @@ export function ContactsPopover({ anchorEl, onClose, open = false }: ContactsPop
         <Typography variant="h6">Contacts</Typography>
       </Box>
       <Box sx={{ maxHeight: '400px', overflowY: 'auto', px: 1, pb: 2 }}>
-        <List disablePadding sx={{ '& .MuiListItemButton-root': { borderRadius: 1 } }}>
+        <List
+          disablePadding
+          sx={{ '& .MuiListItemButton-root': { borderRadius: 1 } }}
+        >
           {contacts.map((contact) => (
-            <ListItem disablePadding key={contact.id}>
+            <ListItem
+              disablePadding
+              key={contact.id}
+            >
               <ListItemButton>
                 <ListItemAvatar>
                   <Avatar src={contact.avatar} />
@@ -122,14 +128,28 @@ export function ContactsPopover({ anchorEl, onClose, open = false }: ContactsPop
                 <ListItemText
                   disableTypography
                   primary={
-                    <Link color="text.primary" noWrap underline="none" variant="subtitle2">
+                    <Link
+                      color="text.primary"
+                      noWrap
+                      underline="none"
+                      variant="subtitle2"
+                    >
                       {contact.name}
                     </Link>
                   }
                 />
-                {contact.status !== 'offline' ? <Presence size="small" status={contact.status} /> : null}
+                {contact.status !== 'offline' ? (
+                  <Presence
+                    size="small"
+                    status={contact.status}
+                  />
+                ) : null}
                 {contact.status === 'offline' && Boolean(contact.lastActivity) ? (
-                  <Typography color="text.secondary" sx={{ whiteSpace: 'nowrap' }} variant="caption">
+                  <Typography
+                    color="text.secondary"
+                    sx={{ whiteSpace: 'nowrap' }}
+                    variant="caption"
+                  >
                     {dayjs(contact.lastActivity).fromNow()}
                   </Typography>
                 ) : null}

002_source/cms/src/components/dashboard/layout/horizontal/horizontal-layout.tsx

@@ -34,6 +34,7 @@ export function HorizontalLayout({ children }: HorizontalLayoutProps): React.JSX
           color={settings.navColor}
           items={layoutConfig.navItems}
         />
+
         <Box
           component="main"
           sx={{

002_source/cms/src/components/dashboard/layout/horizontal/main-nav/index.tsx

@@ -36,15 +36,15 @@ import { Logo } from '@/components/core/logo';
 import { SearchDialog } from '@/components/dashboard/layout/search-dialog';
 import type { ColorScheme } from '@/styles/theme/types';
 
-import { ContactsPopover } from '../contacts-popover';
-import { languageFlags, LanguagePopover } from '../language-popover';
-import type { Language } from '../language-popover';
-import { MobileNav } from '../mobile-nav';
-import { icons } from '../nav-icons';
-import { NotificationsPopover } from '../notifications-popover';
-import { UserPopover } from '../user-popover/user-popover';
-import { WorkspacesSwitch } from '../workspaces-switch';
-import { navColorStyles } from './styles';
+import { ContactsPopover } from '../../contacts-popover';
+import { languageFlags, LanguagePopover } from '../../language-popover';
+import type { Language } from '../../language-popover';
+import { MobileNav } from '../../mobile-nav';
+import { icons } from '../../nav-icons';
+import { NotificationsPopover } from '../../notifications-popover';
+import { UserPopover } from '../../user-popover/user-popover';
+import { WorkspacesSwitch } from '../../workspaces-switch';
+import { navColorStyles } from '../styles';
 
 const logoColors = {
   dark: { blend_in: 'light', discrete: 'light', evident: 'light' },
@@ -189,7 +189,15 @@ function NotificationsButton(): React.JSX.Element {
       <Tooltip title="Notifications">
         <Badge
           color="error"
-          sx={{ '& .MuiBadge-dot': { borderRadius: '50%', height: '10px', right: '6px', top: '6px', width: '10px' } }}
+          sx={{
+            '& .MuiBadge-dot': {
+              borderRadius: '50%',
+              right: '6px',
+              top: '6px',
+              height: '10px',
+              width: '10px',
+            },
+          }}
           variant="dot"
         >
           <IconButton

002_source/cms/src/components/dashboard/layout/notifications-popover/index.tsx

@@ -1,38 +1,42 @@
 'use client';
 
 import * as React from 'react';
-import Avatar from '@mui/material/Avatar';
+import { getNotificationsByUserId } from '@/db/Notifications/GetNotificationByUserId';
+import type { Notification } from '@/db/Notifications/type';
 import Box from '@mui/material/Box';
 import IconButton from '@mui/material/IconButton';
-import Link from '@mui/material/Link';
 import List from '@mui/material/List';
-import ListItem from '@mui/material/ListItem';
 import Popover from '@mui/material/Popover';
 import Stack from '@mui/material/Stack';
 import Tooltip from '@mui/material/Tooltip';
 import Typography from '@mui/material/Typography';
-import { ChatText as ChatTextIcon } from '@phosphor-icons/react/dist/ssr/ChatText';
 import { EnvelopeSimple as EnvelopeSimpleIcon } from '@phosphor-icons/react/dist/ssr/EnvelopeSimple';
-import { User as UserIcon } from '@phosphor-icons/react/dist/ssr/User';
-import { X as XIcon } from '@phosphor-icons/react/dist/ssr/X';
 import { useTranslation } from 'react-i18next';
 
-import { dayjs } from '@/lib/dayjs';
+import { User } from '@/types/user';
+import { useHelloworld } from '@/hooks/use-helloworld';
+import { useUser } from '@/hooks/use-user';
+
+import { NotificationItem } from './notification-item';
 // import type { Notification } from './type.d.tsx.del';
 import { SampleNotifications } from './sample-notifications';
-import { useHelloworld } from '@/hooks/use-helloworld';
-import { getAllNotifications } from '@/db/Notifications/GetAll';
-import { ListResult, RecordModel } from 'pocketbase';
-import { defaultNotification } from '@/db/Notifications/constants';
-import { getNotificationsByUserId } from '@/db/Notifications/GetNotificationByUserId';
-import { Notification } from '@/db/Notifications/type';
+import getImageUrlFromFile from '@/lib/get-image-url-from-file.ts';
+import { getUnreadNotificationsByUserId } from '@/db/Notifications/GetUnreadNotificationsByUserId';
+import { logger } from '@/lib/default-logger';
+import { toast } from '@/components/core/toaster';
+
+import { NoteBlank as NoteBlankIcon } from '@phosphor-icons/react/dist/ssr/NoteBlank';
+import { Sun as SunIcon } from '@phosphor-icons/react/dist/ssr/Sun';
+import { MarkAllAsReadButton } from './mark-all-as-read-button';
+import { Button } from '@mui/material';
 
 export interface NotificationsPopoverProps {
   anchorEl: null | Element;
   onClose?: () => void;
   onMarkAllAsRead?: () => void;
-  onRemoveOne?: (id: string) => void;
+  onRemoveOne?: (id: string, reload: () => Promise<void>) => void;
   open?: boolean;
+  setListLength: React.Dispatch<React.SetStateAction<number>>;
 }
 
 export function NotificationsPopover({
@@ -41,37 +45,101 @@ export function NotificationsPopover({
   onMarkAllAsRead,
   onRemoveOne,
   open = false,
+  setListLength,
 }: NotificationsPopoverProps): React.JSX.Element {
   const { t } = useTranslation();
   const [notiList, setNotiList] = React.useState<Notification[]>([]);
+  const { user } = useUser();
 
-  const [loading, setLoading] = React.useState(false);
-  const [error, setError] = React.useState<string | null>(null);
+  const [loading, setLoading] = React.useState(true);
+  const [showError, setShowError] = React.useState<boolean>(false);
 
-  const { data, handleClose, handleOpen, open: testOpen } = useHelloworld<string>();
-  React.useEffect(() => {
+  async function loadUnreadNotifications(): Promise<void> {
     setLoading(true);
-    async function LoadAllNotifications() {
-      const notiList: Notification[] = await getNotificationsByUserId('1');
-      setNotiList(notiList);
+    try {
+      if (user?.id) {
+        const tempNotiList: Notification[] = await getUnreadNotificationsByUserId(user.id);
+        setNotiList(tempNotiList);
+        setListLength(tempNotiList.length);
+      }
+    } catch (loadNotiError) {
+      logger.error(loadNotiError);
+      toast.error('error during loading noti list');
     }
-    setLoading(false);
-    void LoadAllNotifications();
-  }, []);
 
-  if (loading) return <>Loading</>;
-  if (error) return <>Error</>;
-  if (notiList.length == 0)
+    setLoading(false);
+  }
+
+  React.useEffect(() => {
+    if (user?.id) {
+      void loadUnreadNotifications();
+    }
+  }, [user]);
+
+  // if (loading) return <>Loading</>;
+  // if (showError) return <>Error</>;
+
+  if (notiList.length === 0)
     return (
       <Popover
         anchorEl={anchorEl}
         anchorOrigin={{ horizontal: 'right', vertical: 'bottom' }}
         onClose={onClose}
         open={open}
-        slotProps={{ paper: { sx: { width: '380px' } } }}
+        slotProps={{ paper: { sx: { width: 'unset' } } }}
         transformOrigin={{ horizontal: 'right', vertical: 'top' }}
       >
-        list is empty
+        <Stack
+          direction="row"
+          spacing={2}
+          sx={{ alignItems: 'center', justifyContent: 'space-between', px: 3, py: 2 }}
+        >
+          <Stack
+            direction="row"
+            spacing={2}
+            sx={{ alignItems: 'left' }}
+          >
+            <Typography variant="h6">
+              {t('Notifications')} ({notiList.length})
+            </Typography>
+
+            {loading ? (
+              <Typography
+                color="gray"
+                variant="subtitle2"
+              >
+                ({t('loading')})
+              </Typography>
+            ) : (
+              <></>
+            )}
+          </Stack>
+          {/* MarkAllAsReadButton(onMarkAllAsRead, notiList.length <= 0) */}
+          <MarkAllAsReadButton
+            onMarkAllAsRead={onMarkAllAsRead}
+            disabled={notiList.length <= 0}
+          />
+        </Stack>
+
+        <Stack
+          direction="column"
+          spacing={2}
+          sx={{ alignItems: 'center', padding: '50px' }}
+        >
+          <SunIcon
+            size={48}
+            color="lightgray"
+          />
+
+          <Typography
+            color="lightgray"
+            variant={'subtitle2'}
+          >
+            {t('list-is-empty')}
+          </Typography>
+
+          <Button variant="outlined">{t('refresh')}</Button>
+        </Stack>
       </Popover>
     );
 
@@ -80,6 +148,7 @@ export function NotificationsPopover({
       anchorEl={anchorEl}
       anchorOrigin={{ horizontal: 'right', vertical: 'bottom' }}
       onClose={onClose}
+      // todo: should not use 'true', fallback to 'open'
       open={open}
       slotProps={{ paper: { sx: { width: '380px' } } }}
       transformOrigin={{ horizontal: 'right', vertical: 'top' }}
@@ -89,16 +158,32 @@ export function NotificationsPopover({
         spacing={2}
         sx={{ alignItems: 'center', justifyContent: 'space-between', px: 3, py: 2 }}
       >
-        <Typography variant="h6">{t('Notifications')}</Typography>
-        <Tooltip title={t('Mark all as read')}>
-          <IconButton
-            edge="end"
-            onClick={onMarkAllAsRead}
+        <Stack
+          direction="row"
+          spacing={2}
+          sx={{ alignItems: 'left' }}
         >
-            <EnvelopeSimpleIcon />
-          </IconButton>
-        </Tooltip>
+          <Typography variant="h6">
+            {t('Notifications')} ({notiList.length})
+          </Typography>
+
+          {loading ? (
+            <Typography
+              color="gray"
+              variant="subtitle2"
+            >
+              ({t('loading')})
+            </Typography>
+          ) : (
+            <></>
+          )}
         </Stack>
+        <MarkAllAsReadButton
+          onMarkAllAsRead={onMarkAllAsRead}
+          disabled={notiList.length <= 0}
+        />
+      </Stack>
+
       {notiList.length === 0 ? (
         <Box sx={{ p: 2 }}>
           <Typography variant="subtitle2">{t('There are no notifications')}</Typography>
@@ -108,11 +193,11 @@ export function NotificationsPopover({
           <List disablePadding>
             {notiList.map((notification, index) => (
               <NotificationItem
-                divider={index < SampleNotifications.length - 1}
+                divider={index < notiList.length - 1}
                 key={notification.id}
                 notification={notification}
                 onRemove={() => {
-                  onRemoveOne?.(notification.id);
+                  onRemoveOne?.(notification.id, () => loadUnreadNotifications());
                 }}
               />
             ))}
@@ -123,135 +208,25 @@ export function NotificationsPopover({
   );
 }
 
-interface NotificationItemProps {
-  divider?: boolean;
-  notification: Notification;
-  onRemove?: () => void;
-}
+// TODO: remove me
+// function MarkAllAsReadButton({
+//   onMarkAllAsRead,
+//   disabled,
+// }: {
+//   onMarkAllAsRead: (() => void) | undefined;
+//   disabled: boolean;
+// }): React.JSX.Element {
+//   const { t } = useTranslation();
 
-function NotificationItem({ divider, notification, onRemove }: NotificationItemProps): React.JSX.Element {
-  return (
-    <ListItem
-      divider={divider}
-      sx={{ alignItems: 'flex-start', justifyContent: 'space-between' }}
-    >
-      <NotificationContent notification={notification} />
-      <Tooltip title="Remove">
-        <IconButton
-          edge="end"
-          onClick={onRemove}
-          size="small"
-        >
-          <XIcon />
-        </IconButton>
-      </Tooltip>
-    </ListItem>
-  );
-}
-
-interface NotificationContentProps {
-  notification: Notification;
-}
-
-function NotificationContent({ notification }: NotificationContentProps): React.JSX.Element {
-  if (notification.type === 'new_feature') {
-    return (
-      <Stack
-        direction="row"
-        spacing={2}
-        sx={{ alignItems: 'flex-start' }}
-      >
-        <Avatar>
-          <ChatTextIcon fontSize="var(--Icon-fontSize)" />
-        </Avatar>
-        <div>
-          <Typography variant="subtitle2">New feature!</Typography>
-          <Typography variant="body2">{notification.description}</Typography>
-          <Typography
-            color="text.secondary"
-            variant="caption"
-          >
-            {dayjs(notification.createdAt).format('MMM D, hh:mm A')}
-          </Typography>
-        </div>
-      </Stack>
-    );
-  }
-
-  if (notification.type === 'new_company') {
-    return (
-      <Stack
-        direction="row"
-        spacing={2}
-        sx={{ alignItems: 'flex-start' }}
-      >
-        <Avatar src={notification.author.avatar}>
-          <UserIcon />
-        </Avatar>
-        <div>
-          <Typography variant="body2">
-            <Typography
-              component="span"
-              variant="subtitle2"
-            >
-              {notification.author.name}
-            </Typography>{' '}
-            created{' '}
-            <Link
-              underline="always"
-              variant="body2"
-            >
-              {notification.company.name}
-            </Link>{' '}
-            company
-          </Typography>
-          <Typography
-            color="text.secondary"
-            variant="caption"
-          >
-            {dayjs(notification.createdAt).format('MMM D, hh:mm A')}
-          </Typography>
-        </div>
-      </Stack>
-    );
-  }
-
-  if (notification.type === 'new_job') {
-    return (
-      <Stack
-        direction="row"
-        spacing={2}
-        sx={{ alignItems: 'flex-start' }}
-      >
-        <Avatar src={notification.author.avatar}>
-          <UserIcon />
-        </Avatar>
-        <div>
-          <Typography variant="body2">
-            <Typography
-              component="span"
-              variant="subtitle2"
-            >
-              {notification.author.name}
-            </Typography>{' '}
-            added a new job{' '}
-            <Link
-              underline="always"
-              variant="body2"
-            >
-              {notification.job.title}
-            </Link>
-          </Typography>
-          <Typography
-            color="text.secondary"
-            variant="caption"
-          >
-            {dayjs(notification.createdAt).format('MMM D, hh:mm A')}
-          </Typography>
-        </div>
-      </Stack>
-    );
-  }
-
-  return <div />;
-}
+//   return (
+//     <Tooltip title={t('mark-all-as-read')}>
+//       <IconButton
+//         edge="end"
+//         onClick={onMarkAllAsRead}
+//         disabled={disabled}
+//       >
+//         <EnvelopeSimpleIcon color={disabled ? 'lightgray' : 'black'} />
+//       </IconButton>
+//     </Tooltip>
+//   );
+// }

002_source/cms/src/components/dashboard/layout/notifications-popover/mark-all-as-read-button.tsx

@@ -0,0 +1,29 @@
+'use client';
+
+import * as React from 'react';
+import IconButton from '@mui/material/IconButton';
+import Tooltip from '@mui/material/Tooltip';
+import { EnvelopeSimple as EnvelopeSimpleIcon } from '@phosphor-icons/react/dist/ssr/EnvelopeSimple';
+import { useTranslation } from 'react-i18next';
+
+export function MarkAllAsReadButton({
+  onMarkAllAsRead,
+  disabled,
+}: {
+  onMarkAllAsRead: (() => void) | undefined;
+  disabled: boolean;
+}): React.JSX.Element {
+  const { t } = useTranslation();
+
+  return (
+    <Tooltip title={t('mark-all-as-read')}>
+      <IconButton
+        edge="end"
+        onClick={onMarkAllAsRead}
+        disabled={disabled}
+      >
+        <EnvelopeSimpleIcon color={disabled ? 'lightgray' : 'black'} />
+      </IconButton>
+    </Tooltip>
+  );
+}

002_source/cms/src/components/dashboard/layout/notifications-popover/notification-content.tsx

@@ -0,0 +1,139 @@
+'use client';
+
+import * as React from 'react';
+import type { Notification } from '@/db/Notifications/type';
+import Avatar from '@mui/material/Avatar';
+import Link from '@mui/material/Link';
+import Stack from '@mui/material/Stack';
+import Typography from '@mui/material/Typography';
+import { ChatText as ChatTextIcon } from '@phosphor-icons/react/dist/ssr/ChatText';
+import { User as UserIcon } from '@phosphor-icons/react/dist/ssr/User';
+
+import { dayjs } from '@/lib/dayjs';
+import getImageUrlFromFile from '@/lib/get-image-url-from-file.ts';
+import { useRouter } from 'next/navigation';
+import { toast } from '@/components/core/toaster';
+
+interface NotificationContentProps {
+  notification: Notification;
+}
+
+export function NotificationContent({ notification }: NotificationContentProps): React.JSX.Element {
+  const router = useRouter();
+
+  if (notification.type === 'new_feature') {
+    return (
+      <Stack
+        direction="row"
+        spacing={2}
+        sx={{ alignItems: 'flex-start' }}
+      >
+        <Avatar>
+          <ChatTextIcon fontSize="var(--Icon-fontSize)" />
+        </Avatar>
+        <div>
+          <Typography variant="subtitle2">New feature!</Typography>
+          <Typography variant="body2">{notification.description}</Typography>
+          <Typography
+            color="text.secondary"
+            variant="caption"
+          >
+            {dayjs(notification.createdAt).format('MMM D, hh:mm A')}
+          </Typography>
+        </div>
+      </Stack>
+    );
+  }
+
+  if (notification.type === 'new_company') {
+    return (
+      <Stack
+        direction="row"
+        spacing={2}
+        sx={{ alignItems: 'flex-start' }}
+      >
+        <Avatar src={notification?.author?.avatar || ''}>
+          <UserIcon size={24} />
+        </Avatar>
+        <div>
+          <Typography variant="body2">
+            <Typography
+              component="span"
+              variant="subtitle2"
+            >
+              {notification?.author?.name}
+            </Typography>{' '}
+            created{' '}
+            <Link
+              underline="always"
+              variant="body2"
+            >
+              {notification?.company?.name}
+            </Link>{' '}
+            company
+          </Typography>
+          <Typography
+            color="text.secondary"
+            variant="caption"
+          >
+            {dayjs(notification.created).format('MMM D, hh:mm A')}
+          </Typography>
+        </div>
+      </Stack>
+    );
+  }
+
+  if (notification.type === 'new_job') {
+    const handleClick = (): void => {
+      try {
+        if (notification.link) {
+          router.push(notification.link);
+        }
+      } catch (error) {
+        toast.error((error as { message: string }).message);
+      }
+    };
+
+    return (
+      <Stack
+        direction="row"
+        spacing={2}
+        sx={{
+          alignItems: 'flex-start',
+          cursor: notification.link ? 'pointer' : '',
+        }}
+        //
+        onClick={handleClick}
+      >
+        <Avatar src={notification?.author?.avatar}>
+          <UserIcon />
+        </Avatar>
+        <div>
+          <Typography variant="body2">
+            <Typography
+              component="span"
+              variant="subtitle2"
+            >
+              {notification?.author?.name}
+            </Typography>{' '}
+            added a new job{' '}
+            <Link
+              underline="always"
+              variant="body2"
+            >
+              {notification?.job?.title}
+            </Link>
+          </Typography>
+          <Typography
+            color="text.secondary"
+            variant="caption"
+          >
+            {dayjs(notification.created).format('MMM D, hh:mm A')}
+          </Typography>
+        </div>
+      </Stack>
+    );
+  }
+
+  return <div />;
+}

002_source/cms/src/components/dashboard/layout/notifications-popover/notification-item.tsx

@@ -0,0 +1,36 @@
+'use client';
+
+import * as React from 'react';
+import type { Notification } from '@/db/Notifications/type';
+import IconButton from '@mui/material/IconButton';
+import ListItem from '@mui/material/ListItem';
+import Tooltip from '@mui/material/Tooltip';
+import { X as XIcon } from '@phosphor-icons/react/dist/ssr/X';
+
+import { NotificationContent } from './notification-content';
+
+interface NotificationItemProps {
+  divider?: boolean;
+  notification: Notification;
+  onRemove?: () => void;
+}
+
+export function NotificationItem({ divider, notification, onRemove }: NotificationItemProps): React.JSX.Element {
+  return (
+    <ListItem
+      divider={divider}
+      sx={{ alignItems: 'flex-start', justifyContent: 'space-between' }}
+    >
+      <NotificationContent notification={notification} />
+      <Tooltip title="Remove">
+        <IconButton
+          edge="end"
+          onClick={onRemove}
+          size="small"
+        >
+          <XIcon />
+        </IconButton>
+      </Tooltip>
+    </ListItem>
+  );
+}

002_source/cms/src/components/dashboard/layout/notifications-popover/sample-notifications.tsx

@@ -1,6 +1,7 @@
 'use client';
+import { Notification } from '@/db/Notifications/type';
 import { dayjs } from '@/lib/dayjs';
-import type { Notification } from './type.d.tsx.del';
+// import type { Notification } from './type.d.tsx';
 
 export const SampleNotifications = [
   {
@@ -8,7 +9,7 @@ export const SampleNotifications = [
     createdAt: dayjs().subtract(7, 'minute').subtract(5, 'hour').subtract(1, 'day').toDate(),
     read: false,
     type: 'new_job',
-    author: { name: 'Jie Yan', avatar: '/assets/avatar-8.png' },
+    author: { id: '0001', collectionId: '0001', name: 'Jie Yan', avatar: '/assets/avatar-8.png' },
     job: { title: 'Remote React / React Native Developer' },
   },
   {
@@ -16,7 +17,7 @@ export const SampleNotifications = [
     createdAt: dayjs().subtract(18, 'minute').subtract(3, 'hour').subtract(5, 'day').toDate(),
     read: true,
     type: 'new_job',
-    author: { name: 'Fran Perez', avatar: '/assets/avatar-5.png' },
+    author: { id: '0001', collectionId: '0001', name: 'Fran Perez', avatar: '/assets/avatar-5.png' },
     job: { title: 'Senior Golang Backend Engineer' },
   },
   {
@@ -24,6 +25,7 @@ export const SampleNotifications = [
     createdAt: dayjs().subtract(4, 'minute').subtract(5, 'hour').subtract(7, 'day').toDate(),
     read: true,
     type: 'new_feature',
+    author: { id: '0001', collectionId: '0001', name: 'Fran Perez', avatar: '/assets/avatar-5.png' },
     description: 'Logistics management is now available',
   },
   {
@@ -31,7 +33,7 @@ export const SampleNotifications = [
     createdAt: dayjs().subtract(7, 'minute').subtract(8, 'hour').subtract(7, 'day').toDate(),
     read: true,
     type: 'new_company',
-    author: { name: 'Jie Yan', avatar: '/assets/avatar-8.png' },
+    author: { id: '0001', collectionId: '002', name: 'Jie Yan', avatar: '/assets/avatar-8.png' },
     company: { name: 'Stripe' },
   },
 ] satisfies Notification[];

002_source/cms/src/components/dashboard/layout/vertical/main-nav/notifications-button.tsx

@@ -9,18 +9,60 @@ import { Bell as BellIcon } from '@phosphor-icons/react/dist/ssr/Bell';
 import { usePopover } from '@/hooks/use-popover';
 
 import { NotificationsPopover } from '../../notifications-popover';
+import { logger } from '@/lib/default-logger';
 // import { NotificationsButton } from './notifications-button';
+import { toast } from '@/components/core/toaster';
+import { MarkOneAsRead } from '@/db/Notifications/mark-one-as-read';
+import { getUnreadNotificationsByUserId } from '@/db/Notifications/GetUnreadNotificationsByUserId';
+import { Notification } from '@/db/Notifications/type';
+import { useUser } from '@/hooks/use-user';
 
 export function NotificationsButton(): React.JSX.Element {
   const popover = usePopover<HTMLButtonElement>();
+  const { user } = useUser();
+
+  const [loading, setLoading] = React.useState(true);
+  const [showError, setShowError] = React.useState<boolean>(false);
+  const [listLength, setListLength] = React.useState<number>(0);
+
+  const [notiList, setNotiList] = React.useState<Notification[]>([]);
+
+  function handleMarkAllAsRead(): void {
+    // try {
+    //   await MarkOneAsRead(id);
+    //   toast.success('Notification marked as read');
+    // } catch (error) {
+    //   logger.debug(error);
+    //   toast.error('Something went wrong');
+    // }
+  }
+
+  function handleRemoveOne(id: string, cb: () => void): void {
+    MarkOneAsRead(id)
+      .then(() => {
+        toast.success('Notification marked as read');
+        cb();
+      })
+      .catch((error) => {
+        logger.debug(error);
+        toast.error('Something went wrong');
+      });
+  }
 
   return (
     <React.Fragment>
       <Tooltip title="Notifications">
         <Badge
           color="error"
-          sx={{ '& .MuiBadge-dot': { borderRadius: '50%', height: '10px', right: '6px', top: '6px', width: '10px' } }}
-          variant="dot"
+          sx={{
+            '& .MuiBadge-badge': {
+              height: '20px',
+              width: '20px',
+              right: '6px',
+              top: '6px',
+            },
+          }}
+          badgeContent={listLength}
         >
           <IconButton
             onClick={popover.handleOpen}
@@ -30,10 +72,14 @@ export function NotificationsButton(): React.JSX.Element {
           </IconButton>
         </Badge>
       </Tooltip>
+      {/*  */}
       <NotificationsPopover
         anchorEl={popover.anchorRef.current}
         onClose={popover.handleClose}
         open={popover.open}
+        onMarkAllAsRead={handleMarkAllAsRead}
+        onRemoveOne={handleRemoveOne}
+        setListLength={setListLength}
       />
     </React.Fragment>
   );

002_source/cms/src/components/dashboard/layout/vertical/main-nav/user-button.tsx

@@ -9,9 +9,12 @@ import type { User } from '@/types/user';
 import { usePopover } from '@/hooks/use-popover';
 
 import { UserPopover } from '../../user-popover/user-popover';
+import { useUser } from '@/hooks/use-user';
+import getImageUrlFromFile from '@/lib/get-image-url-from-file.ts';
 // import { NotificationsButton } from './notifications-button';
 
-const user = {
+// TODO:remove me
+const user1 = {
   id: 'USR-000',
   name: 'Sofia Rivers',
   avatar: '/assets/avatar.png',
@@ -20,6 +23,9 @@ const user = {
 
 export function UserButton(): React.JSX.Element {
   const popover = usePopover<HTMLButtonElement>();
+  const { user, error, isLoading } = useUser();
+
+  if (!user) return <>loading</>;
 
   return (
     <React.Fragment>
@@ -44,7 +50,7 @@ export function UserButton(): React.JSX.Element {
           }}
           variant="dot"
         >
-          <Avatar src={user.avatar} />
+          <Avatar src={getImageUrlFromFile(user.collectionId, user.id, user.avatar)} />
         </Badge>
       </Box>
       <UserPopover

002_source/cms/src/components/dashboard/layout/vertical/side-nav/index.tsx

@@ -0,0 +1,98 @@
+'use client';
+
+import * as React from 'react';
+import RouterLink from 'next/link';
+import { usePathname } from 'next/navigation';
+import Box from '@mui/material/Box';
+import Chip from '@mui/material/Chip';
+import Stack from '@mui/material/Stack';
+import Typography from '@mui/material/Typography';
+import { ArrowSquareOut as ArrowSquareOutIcon } from '@phosphor-icons/react/dist/ssr/ArrowSquareOut';
+import { CaretDown as CaretDownIcon } from '@phosphor-icons/react/dist/ssr/CaretDown';
+import { CaretRight as CaretRightIcon } from '@phosphor-icons/react/dist/ssr/CaretRight';
+import { useTranslation } from 'react-i18next';
+
+import type { NavItemConfig } from '@/types/nav';
+import type { NavColor } from '@/types/settings';
+import { paths } from '@/paths';
+import { isNavItemActive } from '@/lib/is-nav-item-active';
+import { useSettings } from '@/hooks/use-settings';
+import { Logo } from '@/components/core/logo';
+import type { ColorScheme } from '@/styles/theme/types';
+
+import { icons } from '../../nav-icons';
+import { WorkspacesSwitch } from '../../workspaces-switch';
+import { navColorStyles } from '../styles';
+import { RenderNavGroups } from './render-nav-groups';
+
+const logoColors = {
+  dark: { blend_in: 'light', discrete: 'light', evident: 'light' },
+  light: { blend_in: 'dark', discrete: 'dark', evident: 'light' },
+} as Record<ColorScheme, Record<NavColor, 'dark' | 'light'>>;
+
+export interface SideNavProps {
+  color?: NavColor;
+  items?: NavItemConfig[];
+}
+
+export function SideNav({ color = 'evident', items = [] }: SideNavProps): React.JSX.Element {
+  const pathname = usePathname();
+
+  const {
+    settings: { colorScheme = 'light' },
+  } = useSettings();
+
+  const styles = navColorStyles[colorScheme][color];
+  const logoColor = logoColors[colorScheme][color];
+
+  return (
+    <Box
+      sx={{
+        ...styles,
+        bgcolor: 'var(--SideNav-background)',
+        borderRight: 'var(--SideNav-border)',
+        color: 'var(--SideNav-color)',
+        display: { xs: 'none', lg: 'flex' },
+        flexDirection: 'column',
+        height: '100%',
+        left: 0,
+        position: 'fixed',
+        top: 0,
+        width: 'var(--SideNav-width)',
+        zIndex: 'var(--SideNav-zIndex)',
+      }}
+    >
+      <Stack
+        spacing={2}
+        sx={{ p: 2 }}
+      >
+        <div>
+          <Box
+            component={RouterLink}
+            href={paths.home}
+            sx={{ display: 'inline-flex' }}
+          >
+            <Logo
+              color={logoColor}
+              height={32}
+              width={122}
+            />
+          </Box>
+        </div>
+        <WorkspacesSwitch />
+      </Stack>
+      <Box
+        component="nav"
+        sx={{
+          flex: '1 1 auto',
+          overflowY: 'auto',
+          p: 2,
+          scrollbarWidth: 'none',
+          '&::-webkit-scrollbar': { display: 'none' },
+        }}
+      >
+        {RenderNavGroups({ items, pathname })}
+      </Box>
+    </Box>
+  );
+}

002_source/cms/src/components/dashboard/layout/vertical/side-nav/nav-item.tsx

@@ -2,10 +2,8 @@
 
 import * as React from 'react';
 import RouterLink from 'next/link';
-import { usePathname } from 'next/navigation';
 import Box from '@mui/material/Box';
 import Chip from '@mui/material/Chip';
-import Stack from '@mui/material/Stack';
 import Typography from '@mui/material/Typography';
 import { ArrowSquareOut as ArrowSquareOutIcon } from '@phosphor-icons/react/dist/ssr/ArrowSquareOut';
 import { CaretDown as CaretDownIcon } from '@phosphor-icons/react/dist/ssr/CaretDown';
@@ -13,136 +11,9 @@ import { CaretRight as CaretRightIcon } from '@phosphor-icons/react/dist/ssr/Car
 import { useTranslation } from 'react-i18next';
 
 import type { NavItemConfig } from '@/types/nav';
-import type { NavColor } from '@/types/settings';
-import { paths } from '@/paths';
 import { isNavItemActive } from '@/lib/is-nav-item-active';
-import { useSettings } from '@/hooks/use-settings';
-import { Logo } from '@/components/core/logo';
-import type { ColorScheme } from '@/styles/theme/types';
 
-import { icons } from '../nav-icons';
-import { WorkspacesSwitch } from '../workspaces-switch';
-import { navColorStyles } from './styles';
-
-const logoColors = {
-  dark: { blend_in: 'light', discrete: 'light', evident: 'light' },
-  light: { blend_in: 'dark', discrete: 'dark', evident: 'light' },
-} as Record<ColorScheme, Record<NavColor, 'dark' | 'light'>>;
-
-export interface SideNavProps {
-  color?: NavColor;
-  items?: NavItemConfig[];
-}
-
-export function SideNav({ color = 'evident', items = [] }: SideNavProps): React.JSX.Element {
-  const pathname = usePathname();
-
-  const {
-    settings: { colorScheme = 'light' },
-  } = useSettings();
-
-  const styles = navColorStyles[colorScheme][color];
-  const logoColor = logoColors[colorScheme][color];
-
-  return (
-    <Box
-      sx={{
-        ...styles,
-        bgcolor: 'var(--SideNav-background)',
-        borderRight: 'var(--SideNav-border)',
-        color: 'var(--SideNav-color)',
-        display: { xs: 'none', lg: 'flex' },
-        flexDirection: 'column',
-        height: '100%',
-        left: 0,
-        position: 'fixed',
-        top: 0,
-        width: 'var(--SideNav-width)',
-        zIndex: 'var(--SideNav-zIndex)',
-      }}
-    >
-      <Stack spacing={2} sx={{ p: 2 }}>
-        <div>
-          <Box component={RouterLink} href={paths.home} sx={{ display: 'inline-flex' }}>
-            <Logo color={logoColor} height={32} width={122} />
-          </Box>
-        </div>
-        <WorkspacesSwitch />
-      </Stack>
-      <Box
-        component="nav"
-        sx={{
-          flex: '1 1 auto',
-          overflowY: 'auto',
-          p: 2,
-          scrollbarWidth: 'none',
-          '&::-webkit-scrollbar': { display: 'none' },
-        }}
-      >
-        {RenderNavGroups({ items, pathname })}
-      </Box>
-    </Box>
-  );
-}
-
-function RenderNavGroups({ items, pathname }: { items: NavItemConfig[]; pathname: string }): React.JSX.Element {
-  const { t } = useTranslation();
-
-  const children = items.reduce((acc: React.ReactNode[], curr: NavItemConfig): React.ReactNode[] => {
-    acc.push(
-      <Stack component="li" key={curr.key} spacing={1.5}>
-        {curr.title ? (
-          <div>
-            <Typography sx={{ color: 'var(--NavGroup-title-color)', fontSize: '0.875rem', fontWeight: 500 }}>
-              {t(curr.title)}
-            </Typography>
-          </div>
-        ) : null}
-        <div>{renderNavItems({ depth: 0, items: curr.items, pathname })}</div>
-      </Stack>
-    );
-
-    return acc;
-  }, []);
-
-  return (
-    <Stack component="ul" spacing={2} sx={{ listStyle: 'none', m: 0, p: 0 }}>
-      {children}
-    </Stack>
-  );
-}
-
-function renderNavItems({
-  depth = 0,
-  items = [],
-  pathname,
-}: {
-  depth: number;
-  items?: NavItemConfig[];
-  pathname: string;
-}): React.JSX.Element {
-  const children = items.reduce((acc: React.ReactNode[], curr: NavItemConfig): React.ReactNode[] => {
-    const { items: childItems, key, ...item } = curr;
-
-    const forceOpen = childItems
-      ? Boolean(childItems.find((childItem) => childItem.href && pathname.startsWith(childItem.href)))
-      : false;
-
-    acc.push(
-      <NavItem depth={depth} forceOpen={forceOpen} key={key} pathname={pathname} {...item}>
-        {childItems ? renderNavItems({ depth: depth + 1, pathname, items: childItems }) : null}
-      </NavItem>
-    );
-
-    return acc;
-  }, []);
-
-  return (
-    <Stack component="ul" data-depth={depth} spacing={1} sx={{ listStyle: 'none', m: 0, p: 0 }}>
-      {children}
-    </Stack>
-  );
-}
+import { icons } from '../../nav-icons';
 
 interface NavItemProps extends Omit<NavItemConfig, 'items'> {
   children?: React.ReactNode;
@@ -151,7 +22,7 @@ interface NavItemProps extends Omit<NavItemConfig, 'items'> {
   pathname: string;
 }
 
-function NavItem({
+export function NavItem({
   children,
   depth,
   disabled,
@@ -173,7 +44,11 @@ function NavItem({
   const { t } = useTranslation();
 
   return (
-    <Box component="li" data-depth={depth} sx={{ userSelect: 'none' }}>
+    <Box
+      component="li"
+      data-depth={depth}
+      sx={{ userSelect: 'none' }}
+    >
       <Box
         {...(isBranch
           ? {
@@ -254,15 +129,27 @@ function NavItem({
             {t(title || '')}
           </Typography>
         </Box>
-        {label ? <Chip color="primary" label={label} size="small" /> : null}
+        {label ? (
+          <Chip
+            color="primary"
+            label={label}
+            size="small"
+          />
+        ) : null}
         {external ? (
           <Box sx={{ alignItems: 'center', display: 'flex', flex: '0 0 auto' }}>
-            <ArrowSquareOutIcon color="var(--NavItem-icon-color)" fontSize="var(--icon-fontSize-sm)" />
+            <ArrowSquareOutIcon
+              color="var(--NavItem-icon-color)"
+              fontSize="var(--icon-fontSize-sm)"
+            />
           </Box>
         ) : null}
         {isBranch ? (
           <Box sx={{ alignItems: 'center', display: 'flex', flex: '0 0 auto' }}>
-            <ExpandIcon color="var(--NavItem-expand-color)" fontSize="var(--icon-fontSize-sm)" />
+            <ExpandIcon
+              color="var(--NavItem-expand-color)"
+              fontSize="var(--icon-fontSize-sm)"
+            />
           </Box>
         ) : null}
       </Box>

002_source/cms/src/components/dashboard/layout/vertical/side-nav/render-nav-groups.tsx

@@ -0,0 +1,45 @@
+'use client';
+
+import * as React from 'react';
+import Stack from '@mui/material/Stack';
+import Typography from '@mui/material/Typography';
+import { useTranslation } from 'react-i18next';
+
+import type { NavItemConfig } from '@/types/nav';
+
+import { renderNavItems } from './render-nav-items';
+
+export function RenderNavGroups({ items, pathname }: { items: NavItemConfig[]; pathname: string }): React.JSX.Element {
+  const { t } = useTranslation();
+
+  const children = items.reduce((acc: React.ReactNode[], curr: NavItemConfig): React.ReactNode[] => {
+    acc.push(
+      <Stack
+        component="li"
+        key={curr.key}
+        spacing={1.5}
+      >
+        {curr.title ? (
+          <div>
+            <Typography sx={{ color: 'var(--NavGroup-title-color)', fontSize: '0.875rem', fontWeight: 500 }}>
+              {t(curr.title)}
+            </Typography>
+          </div>
+        ) : null}
+        <div>{renderNavItems({ depth: 0, items: curr.items, pathname })}</div>
+      </Stack>
+    );
+
+    return acc;
+  }, []);
+
+  return (
+    <Stack
+      component="ul"
+      spacing={2}
+      sx={{ listStyle: 'none', m: 0, p: 0 }}
+    >
+      {children}
+    </Stack>
+  );
+}

002_source/cms/src/components/dashboard/layout/vertical/side-nav/render-nav-items.tsx

@@ -0,0 +1,51 @@
+'use client';
+
+import * as React from 'react';
+import Stack from '@mui/material/Stack';
+
+import type { NavItemConfig } from '@/types/nav';
+
+import { NavItem } from './nav-item';
+
+export function renderNavItems({
+  depth = 0,
+  items = [],
+  pathname,
+}: {
+  depth: number;
+  items?: NavItemConfig[];
+  pathname: string;
+}): React.JSX.Element {
+  const children = items.reduce((acc: React.ReactNode[], curr: NavItemConfig): React.ReactNode[] => {
+    const { items: childItems, key, ...item } = curr;
+
+    const forceOpen = childItems
+      ? Boolean(childItems.find((childItem) => childItem.href && pathname.startsWith(childItem.href)))
+      : false;
+
+    acc.push(
+      <NavItem
+        depth={depth}
+        forceOpen={forceOpen}
+        key={key}
+        pathname={pathname}
+        {...item}
+      >
+        {childItems ? renderNavItems({ depth: depth + 1, pathname, items: childItems }) : null}
+      </NavItem>
+    );
+
+    return acc;
+  }, []);
+
+  return (
+    <Stack
+      component="ul"
+      data-depth={depth}
+      spacing={1}
+      sx={{ listStyle: 'none', m: 0, p: 0 }}
+    >
+      {children}
+    </Stack>
+  );
+}

002_source/cms/src/components/dashboard/settings/account-details.tsx

@@ -1,138 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import Avatar from '@mui/material/Avatar';
-import Box from '@mui/material/Box';
-import Button from '@mui/material/Button';
-import Card from '@mui/material/Card';
-import CardActions from '@mui/material/CardActions';
-import CardContent from '@mui/material/CardContent';
-import CardHeader from '@mui/material/CardHeader';
-import FormControl from '@mui/material/FormControl';
-import FormHelperText from '@mui/material/FormHelperText';
-import InputAdornment from '@mui/material/InputAdornment';
-import InputLabel from '@mui/material/InputLabel';
-import Link from '@mui/material/Link';
-import OutlinedInput from '@mui/material/OutlinedInput';
-import Select from '@mui/material/Select';
-import Stack from '@mui/material/Stack';
-import Typography from '@mui/material/Typography';
-import { Camera as CameraIcon } from '@phosphor-icons/react/dist/ssr/Camera';
-import { User as UserIcon } from '@phosphor-icons/react/dist/ssr/User';
-
-import { Option } from '@/components/core/option';
-
-export function AccountDetails(): React.JSX.Element {
-  return (
-    <Card>
-      <CardHeader
-        avatar={
-          <Avatar>
-            <UserIcon fontSize="var(--Icon-fontSize)" />
-          </Avatar>
-        }
-        title="Basic details"
-      />
-      <CardContent>
-        <Stack spacing={3}>
-          <Stack direction="row" spacing={2} sx={{ alignItems: 'center' }}>
-            <Box
-              sx={{
-                border: '1px dashed var(--mui-palette-divider)',
-                borderRadius: '50%',
-                display: 'inline-flex',
-                p: '4px',
-              }}
-            >
-              <Box sx={{ borderRadius: 'inherit', position: 'relative' }}>
-                <Box
-                  sx={{
-                    alignItems: 'center',
-                    bgcolor: 'rgba(0, 0, 0, 0.5)',
-                    borderRadius: 'inherit',
-                    bottom: 0,
-                    color: 'var(--mui-palette-common-white)',
-                    cursor: 'pointer',
-                    display: 'flex',
-                    justifyContent: 'center',
-                    left: 0,
-                    opacity: 0,
-                    position: 'absolute',
-                    right: 0,
-                    top: 0,
-                    zIndex: 1,
-                    '&:hover': { opacity: 1 },
-                  }}
-                >
-                  <Stack direction="row" spacing={1} sx={{ alignItems: 'center' }}>
-                    <CameraIcon fontSize="var(--icon-fontSize-md)" />
-                    <Typography color="inherit" variant="subtitle2">
-                      Select
-                    </Typography>
-                  </Stack>
-                </Box>
-                <Avatar src="/assets/avatar.png" sx={{ '--Avatar-size': '100px' }} />
-              </Box>
-            </Box>
-            <Button color="secondary" size="small">
-              Remove
-            </Button>
-          </Stack>
-          <Stack spacing={2}>
-            <FormControl>
-              <InputLabel>Full name</InputLabel>
-              <OutlinedInput defaultValue="Sofia Rivers" name="fullName" />
-            </FormControl>
-            <FormControl disabled>
-              <InputLabel>Email address</InputLabel>
-              <OutlinedInput name="email" type="email" value="sofia@devias.io" />
-              <FormHelperText>
-                Please <Link variant="inherit">contact us</Link> to change your email
-              </FormHelperText>
-            </FormControl>
-            <Stack direction="row" spacing={2}>
-              <FormControl sx={{ width: '160px' }}>
-                <InputLabel>Dial code</InputLabel>
-                <Select
-                  name="countryCode"
-                  startAdornment={
-                    <InputAdornment position="start">
-                      <Box
-                        alt="Spain"
-                        component="img"
-                        src="/assets/flag-es.svg"
-                        sx={{ display: 'block', height: '20px', width: 'auto' }}
-                      />
-                    </InputAdornment>
-                  }
-                  value="+34"
-                >
-                  <Option value="+1">United States</Option>
-                  <Option value="+49">Germany</Option>
-                  <Option value="+34">Spain</Option>
-                </Select>
-              </FormControl>
-              <FormControl sx={{ flex: '1 1 auto' }}>
-                <InputLabel>Phone number</InputLabel>
-                <OutlinedInput defaultValue="965 245 7623" name="phone" />
-              </FormControl>
-            </Stack>
-            <FormControl>
-              <InputLabel>Title</InputLabel>
-              <OutlinedInput name="title" placeholder="e.g Golang Developer" />
-            </FormControl>
-            <FormControl>
-              <InputLabel>Biography (optional)</InputLabel>
-              <OutlinedInput name="bio" placeholder="Describe yourself..." />
-              <FormHelperText>0/200 characters</FormHelperText>
-            </FormControl>
-          </Stack>
-        </Stack>
-      </CardContent>
-      <CardActions sx={{ justifyContent: 'flex-end' }}>
-        <Button color="secondary">Cancel</Button>
-        <Button variant="contained">Save changes</Button>
-      </CardActions>
-    </Card>
-  );
-}

002_source/cms/src/components/dashboard/settings/account-details/_GUIDELINES.md

@@ -0,0 +1,3 @@
+# GUIDELINES
+
+- use i18n

002_source/cms/src/components/dashboard/settings/account-details/index.tsx

@@ -0,0 +1,348 @@
+'use client';
+
+import * as React from 'react';
+import RouterLink from 'next/link';
+import { useRouter } from 'next/navigation';
+import { COL_USER_METAS } from '@/constants';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { LoadingButton } from '@mui/lab';
+import Avatar from '@mui/material/Avatar';
+import Box from '@mui/material/Box';
+import Button from '@mui/material/Button';
+import Card from '@mui/material/Card';
+import CardActions from '@mui/material/CardActions';
+import CardContent from '@mui/material/CardContent';
+import CardHeader from '@mui/material/CardHeader';
+import FormControl from '@mui/material/FormControl';
+import FormHelperText from '@mui/material/FormHelperText';
+import InputAdornment from '@mui/material/InputAdornment';
+import InputLabel from '@mui/material/InputLabel';
+import Link from '@mui/material/Link';
+import OutlinedInput from '@mui/material/OutlinedInput';
+import Select from '@mui/material/Select';
+import Stack from '@mui/material/Stack';
+import Typography from '@mui/material/Typography';
+import { Camera as CameraIcon } from '@phosphor-icons/react/dist/ssr/Camera';
+import { User as UserIcon } from '@phosphor-icons/react/dist/ssr/User';
+import { Controller, useForm } from 'react-hook-form';
+import { useTranslation } from 'react-i18next';
+import { z as zod } from 'zod';
+
+import { paths } from '@/paths';
+import { logger } from '@/lib/default-logger';
+import { fileToBase64 } from '@/lib/file-to-base64';
+import getImageUrlFromFile from '@/lib/get-image-url-from-file.ts';
+import { pb } from '@/lib/pb';
+import { useUser } from '@/hooks/use-user';
+import { Option } from '@/components/core/option';
+import { toast } from '@/components/core/toaster';
+import FormLoading from '@/components/loading';
+
+import ErrorDisplay from '../../error';
+
+const schema = zod.object({
+  name: zod.string().min(1, 'Name is required').max(255),
+  email: zod.string().email('Must be a valid email').min(1, 'Email is required').max(255),
+  phone: zod.string().min(1, 'Phone is required').max(25),
+  company: zod.string().max(255).optional(),
+  billingAddress: zod.object({
+    country: zod.string().min(1, 'Country is required').max(255),
+    state: zod.string().min(1, 'State is required').max(255),
+    city: zod.string().min(1, 'City is required').max(255),
+    zipCode: zod.string().min(1, 'Zip code is required').max(255),
+    line1: zod.string().min(1, 'Street line 1 is required').max(255),
+    line2: zod.string().max(255).optional(),
+  }),
+  taxId: zod.string().max(255).optional(),
+  timezone: zod.string().min(1, 'Timezone is required').max(255),
+  language: zod.string().min(1, 'Language is required').max(255),
+  currency: zod.string().min(1, 'Currency is required').max(255),
+  avatar: zod.string().optional(),
+});
+
+type Values = zod.infer<typeof schema>;
+
+const defaultValues = {
+  name: '',
+  email: '',
+  phone: '',
+  company: '',
+  billingAddress: {
+    country: '',
+    state: '',
+    city: '',
+    zipCode: '',
+    line1: '',
+    line2: '',
+  },
+  taxId: '',
+  timezone: '',
+  language: '',
+  currency: '',
+  avatar: '',
+} satisfies Values;
+
+export function AccountDetails(): React.JSX.Element {
+  const router = useRouter();
+  const { t } = useTranslation();
+
+  const { user, isLoading } = useUser();
+  const [isUpdating, setIsUpdating] = React.useState<boolean>(false);
+  const [showLoading, setShowLoading] = React.useState<boolean>(false);
+  const [showError, setShowError] = React.useState({ show: false, detail: '' });
+
+  const onSubmit = React.useCallback(
+    async (values: Values): Promise<void> => {
+      setIsUpdating(true);
+
+      // const updateData = {
+      //   name: values.name,
+      //   email: values.email,
+      //   phone: values.phone,
+      //   company: values.company,
+      //   billingAddress: values.billingAddress,
+      //   taxId: values.taxId,
+      //   timezone: values.timezone,
+      //   language: values.language,
+      //   currency: values.currency,
+      //   avatar: values.avatar ? await base64ToFile(values.avatar) : null,
+      // };
+
+      // try {
+      //   await pb.collection(COL_CUSTOMERS).update(customerId, updateData);
+      //   toast.success('Customer updated successfully');
+      //   router.push(paths.dashboard.students.list);
+      // } catch (error) {
+      //   logger.error(error);
+      //   toast.error('Failed to update customer');
+      // } finally {
+      //   setIsUpdating(false);
+      // }
+    },
+    [router]
+  );
+
+  const {
+    control,
+    handleSubmit,
+    formState: { errors },
+    setValue,
+    reset,
+    watch,
+  } = useForm<Values>({ defaultValues, resolver: zodResolver(schema) });
+
+  const loadExistingData = React.useCallback(async () => {
+    setShowLoading(true);
+    if (user) {
+      try {
+        const result = await pb.collection(COL_USER_METAS).getOne(user.id);
+        reset({ ...defaultValues, ...result });
+        console.log({ result });
+
+        if (result.avatar) {
+          // TODO: remove me
+          // const fetchResult = await fetch(
+          //   `http://127.0.0.1:8090/api/files/${result.collectionId}/${result.id}/${result.avatar}`
+          // );
+          const fetchResult = await fetch(getImageUrlFromFile(result.collectionId, result.id, result.avatar));
+          const blob = await fetchResult.blob();
+          const url = await fileToBase64(blob);
+          setValue('avatar', url);
+        }
+      } catch (error) {
+        logger.error(error);
+
+        // TODO: add i18n here
+        toast.error('Failed to load customer data');
+
+        setShowError({ show: true, detail: JSON.stringify(error, null, 2) });
+      } finally {
+        setShowLoading(false);
+      }
+    }
+  }, [user, reset, setValue]);
+
+  React.useEffect(() => {
+    void loadExistingData();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  if (showLoading) return <FormLoading />;
+  if (!user) return <>loading</>;
+
+  if (showError.show)
+    return (
+      <ErrorDisplay
+        message={t('error.unable-to-process-request')}
+        code="500"
+        details={showError.detail}
+      />
+    );
+
+  return (
+    <form onSubmit={handleSubmit(onSubmit)}>
+      <Card>
+        <CardHeader
+          avatar={
+            <Avatar>
+              <UserIcon fontSize="var(--Icon-fontSize)" />
+            </Avatar>
+          }
+          title="Basic details"
+        />
+        <CardContent>
+          <Stack spacing={3}>
+            <Stack
+              direction="row"
+              spacing={2}
+              sx={{ alignItems: 'center' }}
+            >
+              <Box
+                sx={{
+                  border: '1px dashed var(--mui-palette-divider)',
+                  borderRadius: '50%',
+                  display: 'inline-flex',
+                  p: '4px',
+                }}
+              >
+                <Box sx={{ borderRadius: 'inherit', position: 'relative' }}>
+                  <Box
+                    sx={{
+                      alignItems: 'center',
+                      bgcolor: 'rgba(0, 0, 0, 0.5)',
+                      borderRadius: 'inherit',
+                      bottom: 0,
+                      color: 'var(--mui-palette-common-white)',
+                      cursor: 'pointer',
+                      display: 'flex',
+                      justifyContent: 'center',
+                      left: 0,
+                      opacity: 0,
+                      position: 'absolute',
+                      right: 0,
+                      top: 0,
+                      zIndex: 1,
+                      '&:hover': { opacity: 1 },
+                    }}
+                  >
+                    <Stack
+                      direction="row"
+                      spacing={1}
+                      sx={{ alignItems: 'center' }}
+                    >
+                      <CameraIcon fontSize="var(--icon-fontSize-md)" />
+                      <Typography
+                        color="inherit"
+                        variant="subtitle2"
+                      >
+                        {t('select')}
+                      </Typography>
+                    </Stack>
+                  </Box>
+                  <Avatar
+                    src={getImageUrlFromFile(user.collectionId, user.id, user.avatar)}
+                    sx={{ '--Avatar-size': '100px' }}
+                  />
+                </Box>
+              </Box>
+              <Button
+                color="secondary"
+                size="small"
+              >
+                {t('remove')}
+              </Button>
+            </Stack>
+            <Stack spacing={2}>
+              <Controller
+                control={control}
+                name="name"
+                render={({ field }) => (
+                  <FormControl
+                    error={Boolean(errors.name)}
+                    fullWidth
+                  >
+                    <InputLabel required>Name</InputLabel>
+                    <OutlinedInput {...field} />
+                    {errors.name ? <FormHelperText>{errors.name.message}</FormHelperText> : null}
+                  </FormControl>
+                )}
+              />
+
+              <Controller
+                disabled
+                control={control}
+                name="email"
+                render={({ field }) => (
+                  <FormControl
+                    error={Boolean(errors.email)}
+                    fullWidth
+                  >
+                    <InputLabel required>Email</InputLabel>
+                    <OutlinedInput
+                      {...field}
+                      type="email"
+                    />
+                    {errors.email ? <FormHelperText>{errors.email.message}</FormHelperText> : null}
+                  </FormControl>
+                )}
+              />
+
+              <Stack
+                direction="row"
+                spacing={2}
+              >
+                <Controller
+                  control={control}
+                  name="phone"
+                  render={({ field }) => (
+                    <FormControl
+                      error={Boolean(errors.phone)}
+                      fullWidth
+                    >
+                      <InputLabel required>Phone</InputLabel>
+                      <OutlinedInput {...field} />
+                      {errors.phone ? <FormHelperText>{errors.phone.message}</FormHelperText> : null}
+                    </FormControl>
+                  )}
+                />
+              </Stack>
+              <FormControl>
+                <InputLabel>Title</InputLabel>
+                <OutlinedInput
+                  name="title"
+                  placeholder="e.g Golang Developer"
+                />
+              </FormControl>
+              <FormControl>
+                <InputLabel>Biography (optional)</InputLabel>
+                <OutlinedInput
+                  name="bio"
+                  placeholder="Describe yourself..."
+                />
+                <FormHelperText>0/200 characters</FormHelperText>
+              </FormControl>
+            </Stack>
+          </Stack>
+        </CardContent>
+        <CardActions sx={{ justifyContent: 'flex-end' }}>
+          <Button
+            color="secondary"
+            component={RouterLink}
+            href={paths.dashboard.overview}
+          >
+            {t('edit.cancelButton')}
+          </Button>
+          {/* <Button variant="contained">Save changes</Button> */}
+          <LoadingButton
+            disabled={isUpdating}
+            loading={isUpdating}
+            type="submit"
+            variant="contained"
+          >
+            {t('edit.updateButton')}
+          </LoadingButton>
+        </CardActions>
+      </Card>
+    </form>
+  );
+}

002_source/cms/src/components/dashboard/settings/delete-account.tsx

@@ -20,11 +20,17 @@ export function DeleteAccount(): React.JSX.Element {
         title="Delete account"
       />
       <CardContent>
-        <Stack spacing={3} sx={{ alignItems: 'flex-start' }}>
+        <Stack
+          spacing={3}
+          sx={{ alignItems: 'flex-start' }}
+        >
           <Typography variant="subtitle1">
             Delete your account and all of your source data. This is irreversible.
           </Typography>
-          <Button color="error" variant="outlined">
+          <Button
+            color="error"
+            variant="outlined"
+          >
             Delete account
           </Button>
         </Stack>

002_source/cms/src/components/dashboard/settings/side-nav/index.tsx

@@ -0,0 +1,116 @@
+'use client';
+
+import * as React from 'react';
+import RouterLink from 'next/link';
+import { usePathname, useRouter } from 'next/navigation';
+import { COL_USER_METAS } from '@/constants';
+import { LoadingButton } from '@mui/lab';
+import Avatar from '@mui/material/Avatar';
+import Stack from '@mui/material/Stack';
+import Typography from '@mui/material/Typography';
+import { useTranslation } from 'react-i18next';
+
+import { paths } from '@/paths';
+import { logger } from '@/lib/default-logger';
+import { fileToBase64 } from '@/lib/file-to-base64';
+import getImageUrlFromFile from '@/lib/get-image-url-from-file.ts';
+import { pb } from '@/lib/pb';
+import { useUser } from '@/hooks/use-user';
+import { toast } from '@/components/core/toaster';
+import FormLoading from '@/components/loading';
+
+import ErrorDisplay from '../../error';
+import { NavItem } from './nav-item';
+import { navItems } from './navItems';
+
+export function SideNav(): React.JSX.Element {
+  const router = useRouter();
+  const { t } = useTranslation();
+  const { user, isLoading } = useUser();
+  const pathname = usePathname();
+  const [isUpdating, setIsUpdating] = React.useState<boolean>(false);
+
+  const [showLoading, setShowLoading] = React.useState<boolean>(false);
+  const [showError, setShowError] = React.useState({ show: false, detail: '' });
+
+  if (showLoading) return <FormLoading />;
+  if (!user) return <>loading</>;
+
+  if (showError.show)
+    return (
+      <ErrorDisplay
+        message={t('error.unable-to-process-request')}
+        code="500"
+        details={showError.detail}
+      />
+    );
+
+  return (
+    <div>
+      <Stack
+        spacing={3}
+        sx={{
+          flex: '0 0 auto',
+          flexDirection: { xs: 'column-reverse', md: 'column' },
+          position: { md: 'sticky' },
+          top: '64px',
+          width: { xs: '100%', md: '240px' },
+        }}
+      >
+        <Stack
+          component="ul"
+          spacing={3}
+          sx={{ listStyle: 'none', m: 0, p: 0 }}
+        >
+          {navItems.map((group) => (
+            <Stack
+              component="li"
+              key={group.key}
+              spacing={2}
+            >
+              {group.title ? (
+                <div>
+                  <Typography
+                    color="text.secondary"
+                    variant="caption"
+                  >
+                    {group.title}
+                  </Typography>
+                </div>
+              ) : null}
+              <Stack
+                component="ul"
+                spacing={1}
+                sx={{ listStyle: 'none', m: 0, p: 0 }}
+              >
+                {group.items.map((item) => (
+                  <NavItem
+                    {...item}
+                    key={item.key}
+                    pathname={pathname}
+                  />
+                ))}
+              </Stack>
+            </Stack>
+          ))}
+        </Stack>
+        <Stack
+          direction="row"
+          spacing={2}
+          sx={{ alignItems: 'center' }}
+        >
+          <Avatar src={getImageUrlFromFile(user.collectionId, user.id, user.avatar)}>{user.name}</Avatar>
+          <div>
+            <Typography variant="subtitle1">{user.name}</Typography>
+            <Typography
+              color="text.secondary"
+              variant="caption"
+            >
+              {user.email}
+            </Typography>
+          </div>
+        </Stack>
+      </Stack>
+    </div>
+  );
+}

002_source/cms/src/components/dashboard/settings/side-nav/nav-item.tsx

@@ -16,36 +16,9 @@ import { UserCircle as UserCircleIcon } from '@phosphor-icons/react/dist/ssr/Use
 import { UsersThree as UsersThreeIcon } from '@phosphor-icons/react/dist/ssr/UsersThree';
 
 import type { NavItemConfig } from '@/types/nav';
-import { paths } from '@/paths';
 import { isNavItemActive } from '@/lib/is-nav-item-active';
 
-// NOTE: First level elements are groups.
-
-const navItems = [
-  {
-    key: 'personal',
-    title: 'Personal',
-    items: [
-      { key: 'account', title: 'Account', href: paths.dashboard.settings.account, icon: 'user-circle' },
-      { key: 'notifications', title: 'Notifications', href: paths.dashboard.settings.notifications, icon: 'bell' },
-      { key: 'security', title: 'Security', href: paths.dashboard.settings.security, icon: 'lock-key' },
-    ],
-  },
-  {
-    key: 'organization',
-    title: 'Organization',
-    items: [
-      { key: 'billing', title: 'Billing & plans', href: paths.dashboard.settings.billing, icon: 'credit-card' },
-      { key: 'team', title: 'Team', href: paths.dashboard.settings.team, icon: 'users-three' },
-      {
-        key: 'integrations',
-        title: 'Integrations',
-        href: paths.dashboard.settings.integrations,
-        icon: 'plugs-connected',
-      },
-    ],
-  },
-] satisfies NavItemConfig[];
+import { navItems } from './navItems';
 
 const icons = {
   'credit-card': CreditCardIcon,
@@ -56,84 +29,11 @@ const icons = {
   bell: BellIcon,
 } as Record<string, Icon>;
 
-export function SideNav(): React.JSX.Element {
-  const pathname = usePathname();
-
-  return (
-    <div>
-      <Stack
-        spacing={3}
-        sx={{
-          flex: '0 0 auto',
-          flexDirection: { xs: 'column-reverse', md: 'column' },
-          position: { md: 'sticky' },
-          top: '64px',
-          width: { xs: '100%', md: '240px' },
-        }}
-      >
-        <Stack
-          component="ul"
-          spacing={3}
-          sx={{ listStyle: 'none', m: 0, p: 0 }}
-        >
-          {navItems.map((group) => (
-            <Stack
-              component="li"
-              key={group.key}
-              spacing={2}
-            >
-              {group.title ? (
-                <div>
-                  <Typography
-                    color="text.secondary"
-                    variant="caption"
-                  >
-                    {group.title}
-                  </Typography>
-                </div>
-              ) : null}
-              <Stack
-                component="ul"
-                spacing={1}
-                sx={{ listStyle: 'none', m: 0, p: 0 }}
-              >
-                {group.items.map((item) => (
-                  <NavItem
-                    {...item}
-                    key={item.key}
-                    pathname={pathname}
-                  />
-                ))}
-              </Stack>
-            </Stack>
-          ))}
-        </Stack>
-        <Stack
-          direction="row"
-          spacing={2}
-          sx={{ alignItems: 'center' }}
-        >
-          <Avatar src="/assets/avatar.png">AV</Avatar>
-          <div>
-            <Typography variant="subtitle1">Sofia Rivers</Typography>
-            <Typography
-              color="text.secondary"
-              variant="caption"
-            >
-              sofia@devias.io
-            </Typography>
-          </div>
-        </Stack>
-      </Stack>
-    </div>
-  );
-}
-
 interface NavItemProps extends NavItemConfig {
   pathname: string;
 }
 
-function NavItem({ disabled, external, href, icon, pathname, title }: NavItemProps): React.JSX.Element {
+export function NavItem({ disabled, external, href, icon, pathname, title }: NavItemProps): React.JSX.Element {
   const active = isNavItemActive({ disabled, external, href, pathname });
   const Icon = icon ? icons[icon] : null;
 

002_source/cms/src/components/dashboard/settings/side-nav/navItems.tsx

@@ -0,0 +1,33 @@
+'use client';
+
+import type { NavItemConfig } from '@/types/nav';
+import { paths } from '@/paths';
+
+// NOTE: First level elements are groups.
+const navItems = [
+  {
+    key: 'personal',
+    title: 'Personal',
+    items: [
+      { key: 'account', title: 'Account', href: paths.dashboard.settings.account, icon: 'user-circle' },
+      { key: 'notifications', title: 'Notifications', href: paths.dashboard.settings.notifications, icon: 'bell' },
+      { key: 'security', title: 'Security', href: paths.dashboard.settings.security, icon: 'lock-key' },
+    ],
+  },
+  {
+    key: 'organization',
+    title: 'Organization',
+    items: [
+      { key: 'billing', title: 'Billing & plans', href: paths.dashboard.settings.billing, icon: 'credit-card' },
+      { key: 'team', title: 'Team', href: paths.dashboard.settings.team, icon: 'users-three' },
+      {
+        key: 'integrations',
+        title: 'Integrations',
+        href: paths.dashboard.settings.integrations,
+        icon: 'plugs-connected',
+      },
+    ],
+  },
+] satisfies NavItemConfig[];
+
+export { navItems };

002_source/cms/src/components/dashboard/student/student-create-form.tsx

@@ -1,9 +1,17 @@
 'use client';
 
+// src/components/dashboard/student/student-create-form.tsx
+//
 import * as React from 'react';
 import RouterLink from 'next/link';
 import { useRouter } from 'next/navigation';
+import { UpdateBillingAddressById } from '@/db/billingAddress/UpdateById';
+import { createStudent } from '@/db/Students/Create';
+import { getStudentById } from '@/db/Students/GetById';
+import { UpdateStudentById } from '@/db/Students/UpdateById';
 import { zodResolver } from '@hookform/resolvers/zod';
+import { LoadingButton } from '@mui/lab';
+//
 import Avatar from '@mui/material/Avatar';
 import Box from '@mui/material/Box';
 import Button from '@mui/material/Button';
@@ -16,41 +24,38 @@ import FormControl from '@mui/material/FormControl';
 import FormControlLabel from '@mui/material/FormControlLabel';
 import FormHelperText from '@mui/material/FormHelperText';
 import InputLabel from '@mui/material/InputLabel';
+import MenuItem from '@mui/material/MenuItem';
 import OutlinedInput from '@mui/material/OutlinedInput';
 import Select from '@mui/material/Select';
 import Stack from '@mui/material/Stack';
 import Typography from '@mui/material/Typography';
 import Grid from '@mui/material/Unstable_Grid2';
+//
 import { Camera as CameraIcon } from '@phosphor-icons/react/dist/ssr/Camera';
+//
 import { Controller, useForm } from 'react-hook-form';
+import { useTranslation } from 'react-i18next';
 import { z as zod } from 'zod';
 
 import { paths } from '@/paths';
+import isDevelopment from '@/lib/check-is-development';
 import { logger } from '@/lib/default-logger';
+import { base64ToFile, fileToBase64 } from '@/lib/file-to-base64';
+import { pb } from '@/lib/pb';
 import { Option } from '@/components/core/option';
 import { toast } from '@/components/core/toaster';
-import { createCustomer } from '@/db/Customers/Create';
-import isDevelopment from '@/lib/check-is-development';
+import FormLoading from '@/components/loading';
 
-function fileToBase64(file: Blob): Promise<string> {
-  return new Promise((resolve, reject) => {
-    const reader = new FileReader();
-    reader.readAsDataURL(file);
-    reader.onload = () => {
-      resolve(reader.result as string);
-    };
-    reader.onerror = () => {
-      reject(new Error('Error converting file to base64'));
-    };
-  });
-}
+// import ErrorDisplay from '../../error';
+import ErrorDisplay from '../error';
+import { CreateFormProps, Student } from './type.d';
 
+// TODO: review schema
 const schema = zod.object({
-  avatar: zod.string().optional(),
   name: zod.string().min(1, 'Name is required').max(255),
   email: zod.string().email('Must be a valid email').min(1, 'Email is required').max(255),
-  phone: zod.string().min(1, 'Phone is required').max(15),
-  company: zod.string().max(255),
+  phone: zod.string().min(1, 'Phone is required').max(25),
+  company: zod.string().max(255).optional(),
   billingAddress: zod.object({
     country: zod.string().min(1, 'Country is required').max(255),
     state: zod.string().min(1, 'State is required').max(255),
@@ -63,12 +68,12 @@ const schema = zod.object({
   timezone: zod.string().min(1, 'Timezone is required').max(255),
   language: zod.string().min(1, 'Language is required').max(255),
   currency: zod.string().min(1, 'Currency is required').max(255),
+  avatar: zod.string().optional(),
 });
 
 type Values = zod.infer<typeof schema>;
 
 const defaultValues = {
-  avatar: '',
   name: 'new name',
   email: '123@123.com',
   phone: '91234567',
@@ -85,10 +90,18 @@ const defaultValues = {
   timezone: 'new_york',
   language: 'en',
   currency: 'USD',
+  avatar: '',
 } satisfies Values;
 
-export function CustomerCreateForm(): React.JSX.Element {
+export function StudentCreateForm(): React.JSX.Element {
   const router = useRouter();
+  const { t } = useTranslation(['students']);
+
+  //
+  const [isUpdating, setIsUpdating] = React.useState<boolean>(false);
+  const [showLoading, setShowLoading] = React.useState<boolean>(false);
+  //
+  const [showError, setShowError] = React.useState({ show: false, detail: '' });
 
   const {
     control,
@@ -100,14 +113,35 @@ export function CustomerCreateForm(): React.JSX.Element {
 
   const onSubmit = React.useCallback(
     async (values: Values): Promise<void> => {
-      try {
       // Use standard create method from db/Customers/Create
-        const record = await createCustomer(values);
-        toast.success('Customer created');
-        router.push(paths.dashboard.students.view(record.id));
+      const tempCreate: CreateFormProps = {
+        avatar: values.avatar ? await base64ToFile(values.avatar) : null,
+        //
+        name: values.name,
+        email: values.email,
+        phone: values.phone,
+        company: values.company,
+        timezone: values.timezone,
+        language: values.language,
+        currency: values.currency,
+        taxId: values.taxId,
+        state: 'pending',
+        meta: {},
+      };
+
+      try {
+        // if (billingAddressId) {
+        //   await UpdateBillingAddressById(billingAddressId, values.billingAddress);
+        // }
+
+        const record = await createStudent(tempCreate);
+        toast.success('Student created');
+        // router.push(paths.dashboard.students.view(record.id));
       } catch (err) {
         logger.error(err);
-        toast.error('Failed to create customer');
+        toast.error('Failed to create Student');
+      } finally {
+        setIsUpdating(false);
       }
     },
     [router]
@@ -137,7 +171,7 @@ export function CustomerCreateForm(): React.JSX.Element {
             spacing={4}
           >
             <Stack spacing={3}>
-              <Typography variant="h6">Account information</Typography>
+              <Typography variant="h6">{t('create.basic-info')}</Typography>
               <Grid
                 container
                 spacing={3}
@@ -151,12 +185,13 @@ export function CustomerCreateForm(): React.JSX.Element {
                     <Box
                       sx={{
                         border: '1px dashed var(--mui-palette-divider)',
-                        borderRadius: '50%',
+                        borderRadius: '5%',
                         display: 'inline-flex',
                         p: '4px',
                       }}
                     >
                       <Avatar
+                        variant="rounded"
                         src={avatar}
                         sx={{
                           '--Avatar-size': '100px',
@@ -175,8 +210,8 @@ export function CustomerCreateForm(): React.JSX.Element {
                       spacing={1}
                       sx={{ alignItems: 'flex-start' }}
                     >
-                      <Typography variant="subtitle1">Avatar</Typography>
-                      <Typography variant="caption">Min 400x400px, PNG or JPEG</Typography>
+                      <Typography variant="subtitle1">{t('create.avatar')}</Typography>
+                      <Typography variant="caption">{t('create.avatarRequirements')}</Typography>
                       <Button
                         color="secondary"
                         onClick={() => {
@@ -184,7 +219,7 @@ export function CustomerCreateForm(): React.JSX.Element {
                         }}
                         variant="outlined"
                       >
-                        Select
+                        {t('create.avatar_select')}
                       </Button>
                       <input
                         hidden
@@ -226,7 +261,7 @@ export function CustomerCreateForm(): React.JSX.Element {
                         error={Boolean(errors.email)}
                         fullWidth
                       >
-                        <InputLabel required>Email address</InputLabel>
+                        <InputLabel required>{t('create.email-address')}</InputLabel>
                         <OutlinedInput
                           {...field}
                           type="email"
@@ -248,7 +283,7 @@ export function CustomerCreateForm(): React.JSX.Element {
                         error={Boolean(errors.phone)}
                         fullWidth
                       >
-                        <InputLabel required>Phone number</InputLabel>
+                        <InputLabel required>{t('create.phone-number')}</InputLabel>
                         <OutlinedInput {...field} />
                         {errors.phone ? <FormHelperText>{errors.phone.message}</FormHelperText> : null}
                       </FormControl>
@@ -268,7 +303,10 @@ export function CustomerCreateForm(): React.JSX.Element {
                         fullWidth
                       >
                         <InputLabel>Company</InputLabel>
-                        <OutlinedInput {...field} />
+                        <OutlinedInput
+                          {...field}
+                          placeholder="no company name"
+                        />
                         {errors.company ? <FormHelperText>{errors.company.message}</FormHelperText> : null}
                       </FormControl>
                     )}
@@ -276,8 +314,9 @@ export function CustomerCreateForm(): React.JSX.Element {
                 </Grid>
               </Grid>
             </Stack>
+            {/*  */}
             <Stack spacing={3}>
-              <Typography variant="h6">Billing information</Typography>
+              <Typography variant="h6">{t('create.billing-information')}</Typography>
               <Grid
                 container
                 spacing={3}
@@ -296,10 +335,12 @@ export function CustomerCreateForm(): React.JSX.Element {
                       >
                         <InputLabel required>Country</InputLabel>
                         <Select {...field}>
-                          <Option value="">Choose a country</Option>
-                          <Option value="us">United States</Option>
-                          <Option value="de">Germany</Option>
-                          <Option value="es">Spain</Option>
+                          <MenuItem value="">Choose a country</MenuItem>
+                          <MenuItem value="US">United States</MenuItem>
+                          <MenuItem value="UK">United Kingdom</MenuItem>
+                          <MenuItem value="CA">Canada</MenuItem>
+                          <MenuItem value="DE">Germany</MenuItem>
+                          <MenuItem value="ES">Spain</MenuItem>
                         </Select>
                         {errors.billingAddress?.country ? (
                           <FormHelperText>{errors.billingAddress?.country?.message}</FormHelperText>
@@ -362,7 +403,7 @@ export function CustomerCreateForm(): React.JSX.Element {
                         error={Boolean(errors.billingAddress?.zipCode)}
                         fullWidth
                       >
-                        <InputLabel required>Zip code</InputLabel>
+                        <InputLabel required>{t('create.zip-code')}</InputLabel>
                         <OutlinedInput {...field} />
                         {errors.billingAddress?.zipCode ? (
                           <FormHelperText>{errors.billingAddress?.zipCode?.message}</FormHelperText>
@@ -383,7 +424,7 @@ export function CustomerCreateForm(): React.JSX.Element {
                         error={Boolean(errors.billingAddress?.line1)}
                         fullWidth
                       >
-                        <InputLabel required>Address</InputLabel>
+                        <InputLabel required>{t('create.address-line-1')}</InputLabel>
                         <OutlinedInput {...field} />
                         {errors.billingAddress?.line1 ? (
                           <FormHelperText>{errors.billingAddress?.line1?.message}</FormHelperText>
@@ -424,7 +465,7 @@ export function CustomerCreateForm(): React.JSX.Element {
               />
             </Stack>
             <Stack spacing={3}>
-              <Typography variant="h6">Additional information</Typography>
+              <Typography variant="h6">{t('create.additional-information')}</Typography>
               <Grid
                 container
                 spacing={3}
@@ -443,10 +484,14 @@ export function CustomerCreateForm(): React.JSX.Element {
                       >
                         <InputLabel required>Timezone</InputLabel>
                         <Select {...field}>
-                          <Option value="">Select a timezone</Option>
-                          <Option value="new_york">US - New York</Option>
-                          <Option value="california">US - California</Option>
-                          <Option value="london">UK - London</Option>
+                          <MenuItem value="">Select a timezone</MenuItem>
+                          <MenuItem value="Europe/London">London</MenuItem>
+                          <MenuItem value="Asia/Tokyo">Tokyo</MenuItem>
+                          <MenuItem value="America/Boa_Vista">Boa Vista</MenuItem>
+                          <MenuItem value="America/Grand_Turk">Grand Turk</MenuItem>
+                          <MenuItem value="Asia/Manila">Manila</MenuItem>
+                          <MenuItem value="Asia/Urumqi">Urumqi</MenuItem>
+                          <MenuItem value="Africa/Tunis">Tunis</MenuItem>
                         </Select>
                         {errors.timezone ? <FormHelperText>{errors.timezone.message}</FormHelperText> : null}
                       </FormControl>
@@ -467,10 +512,11 @@ export function CustomerCreateForm(): React.JSX.Element {
                       >
                         <InputLabel required>Language</InputLabel>
                         <Select {...field}>
-                          <Option value="">Select a language</Option>
-                          <Option value="en">English</Option>
-                          <Option value="es">Spanish</Option>
-                          <Option value="de">German</Option>
+                          <MenuItem value="">Select a language</MenuItem>
+                          <MenuItem value="en">English</MenuItem>
+                          <MenuItem value="es">Spanish</MenuItem>
+                          <MenuItem value="de">German</MenuItem>
+                          <MenuItem value="fr">French</MenuItem>
                         </Select>
                         {errors.language ? <FormHelperText>{errors.language.message}</FormHelperText> : null}
                       </FormControl>
@@ -489,12 +535,12 @@ export function CustomerCreateForm(): React.JSX.Element {
                         error={Boolean(errors.currency)}
                         fullWidth
                       >
-                        <InputLabel>Currency</InputLabel>
+                        <InputLabel required>{t('create.currency')}</InputLabel>
                         <Select {...field}>
-                          <Option value="">Select a currency</Option>
-                          <Option value="USD">USD</Option>
-                          <Option value="EUR">EUR</Option>
-                          <Option value="RON">RON</Option>
+                          <MenuItem value="">no currency selected</MenuItem>
+                          <MenuItem value="USD">USD</MenuItem>
+                          <MenuItem value="EUR">EUR</MenuItem>
+                          <MenuItem value="GBP">GBP</MenuItem>
                         </Select>
                         {errors.currency ? <FormHelperText>{errors.currency.message}</FormHelperText> : null}
                       </FormControl>
@@ -511,14 +557,17 @@ export function CustomerCreateForm(): React.JSX.Element {
             component={RouterLink}
             href={paths.dashboard.students.list}
           >
-            Cancel
+            {t('create.cancelButton')}
           </Button>
-          <Button
+
+          <LoadingButton
+            disabled={isUpdating}
+            loading={isUpdating}
             type="submit"
             variant="contained"
           >
-            Create customer
-          </Button>
+            {t('create.updateButton')}
+          </LoadingButton>
         </CardActions>
       </Card>
       <Box sx={{ display: isDevelopment ? 'block' : 'none' }}>

002_source/cms/src/components/dashboard/student/student-edit-form.tsx

@@ -1,10 +1,15 @@
 'use client';
 
+// src/components/dashboard/student/student-edit-form.tsx
+//
 import * as React from 'react';
 import RouterLink from 'next/link';
 import { useParams, useRouter } from 'next/navigation';
 //
-import { COL_CUSTOMERS } from '@/constants';
+import { COL_CUSTOMERS, COL_USER_METAS } from '@/constants';
+import { UpdateBillingAddressById } from '@/db/billingAddress/UpdateById';
+import { getStudentById } from '@/db/Students/GetById';
+import { UpdateStudentById } from '@/db/Students/UpdateById';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { LoadingButton } from '@mui/lab';
 //
@@ -32,6 +37,7 @@ import { useTranslation } from 'react-i18next';
 import { z as zod } from 'zod';
 
 import { paths } from '@/paths';
+import isDevelopment from '@/lib/check-is-development';
 import { logger } from '@/lib/default-logger';
 import { base64ToFile, fileToBase64 } from '@/lib/file-to-base64';
 import { pb } from '@/lib/pb';
@@ -40,9 +46,8 @@ import FormLoading from '@/components/loading';
 
 // import ErrorDisplay from '../../error';
 import ErrorDisplay from '../error';
-import isDevelopment from '@/lib/check-is-development';
 
-// TODO: review this
+// TODO: review schema
 const schema = zod.object({
   name: zod.string().min(1, 'Name is required').max(255),
   email: zod.string().email('Must be a valid email').min(1, 'Email is required').max(255),
@@ -87,14 +92,15 @@ const defaultValues = {
 
 export function StudentEditForm(): React.JSX.Element {
   const router = useRouter();
-  const { t } = useTranslation(['lp_categories']);
+  const { t } = useTranslation(['students']);
 
-  const { customerId } = useParams<{ customerId: string }>();
+  const { id: studentId } = useParams<{ id: string }>();
   //
   const [isUpdating, setIsUpdating] = React.useState<boolean>(false);
   const [showLoading, setShowLoading] = React.useState<boolean>(false);
   //
   const [showError, setShowError] = React.useState({ show: false, detail: '' });
+  const [billingAddressId, setBillingAddressId] = React.useState<string | null>(null);
 
   const {
     control,
@@ -110,30 +116,38 @@ export function StudentEditForm(): React.JSX.Element {
       setIsUpdating(true);
 
       const updateData = {
+        avatar: values.avatar ? await base64ToFile(values.avatar) : null,
+        //
         name: values.name,
         email: values.email,
         phone: values.phone,
         company: values.company,
-        billingAddress: values.billingAddress,
-        taxId: values.taxId,
+        //
+        // billingAddress: values.billingAddress,
+        //
         timezone: values.timezone,
         language: values.language,
         currency: values.currency,
-        avatar: values.avatar ? await base64ToFile(values.avatar) : null,
+        taxId: values.taxId,
       };
 
       try {
-        await pb.collection(COL_CUSTOMERS).update(customerId, updateData);
-        toast.success('Customer updated successfully');
+        // await pb.collection(COL_USER_METAS).update(studentId, updateData);
+        await UpdateStudentById(studentId, updateData);
+        toast.success('Student updated successfully');
         router.push(paths.dashboard.students.list);
+
+        if (billingAddressId) {
+          await UpdateBillingAddressById(billingAddressId, values.billingAddress);
+        }
       } catch (error) {
         logger.error(error);
-        toast.error('Failed to update customer');
+        toast.error('Failed to update student');
       } finally {
         setIsUpdating(false);
       }
     },
-    [customerId, router]
+    [studentId, router]
   );
 
   const avatarInputRef = React.useRef<HTMLInputElement>(null);
@@ -162,13 +176,14 @@ export function StudentEditForm(): React.JSX.Element {
       setShowLoading(true);
 
       try {
-        const result = await pb.collection(COL_CUSTOMERS).getOne(id);
+        const result = await getStudentById(id);
         reset({ ...defaultValues, ...result });
-        console.log({ result });
 
-        if (result.avatar_file) {
+        setBillingAddressId(result.billingAddress.id);
+
+        if (result.avatar) {
           const fetchResult = await fetch(
-            `http://127.0.0.1:8090/api/files/${result.collectionId}/${result.id}/${result.avatar_file}`
+            `http://127.0.0.1:8090/api/files/${result.collectionId}/${result.id}/${result.avatar}`
           );
           const blob = await fetchResult.blob();
           const url = await fileToBase64(blob);
@@ -176,7 +191,7 @@ export function StudentEditForm(): React.JSX.Element {
         }
       } catch (error) {
         logger.error(error);
-        toast.error('Failed to load customer data');
+        toast.error('Failed to load student data');
         setShowError({ show: true, detail: JSON.stringify(error, null, 2) });
       } finally {
         setShowLoading(false);
@@ -186,9 +201,9 @@ export function StudentEditForm(): React.JSX.Element {
   );
 
   React.useEffect(() => {
-    void loadExistingData(customerId);
+    void loadExistingData(studentId);
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [customerId]);
+  }, [studentId]);
 
   if (showLoading) return <FormLoading />;
   if (showError.show)
@@ -299,7 +314,7 @@ export function StudentEditForm(): React.JSX.Element {
                         error={Boolean(errors.email)}
                         fullWidth
                       >
-                        <InputLabel required>Email</InputLabel>
+                        <InputLabel required>{t('edit.email-address')}</InputLabel>
                         <OutlinedInput
                           {...field}
                           type="email"
@@ -321,7 +336,7 @@ export function StudentEditForm(): React.JSX.Element {
                         error={Boolean(errors.phone)}
                         fullWidth
                       >
-                        <InputLabel required>Phone</InputLabel>
+                        <InputLabel required>{t('edit.phone-number')}</InputLabel>
                         <OutlinedInput {...field} />
                         {errors.phone ? <FormHelperText>{errors.phone.message}</FormHelperText> : null}
                       </FormControl>
@@ -354,7 +369,7 @@ export function StudentEditForm(): React.JSX.Element {
             </Stack>
             {/*  */}
             <Stack spacing={3}>
-              <Typography variant="h6">Billing Information</Typography>
+              <Typography variant="h6">{t('edit.billing-information')}</Typography>
               <Grid
                 container
                 spacing={3}
@@ -373,9 +388,12 @@ export function StudentEditForm(): React.JSX.Element {
                       >
                         <InputLabel required>Country</InputLabel>
                         <Select {...field}>
+                          <MenuItem value="">No Country selected</MenuItem>
                           <MenuItem value="US">United States</MenuItem>
                           <MenuItem value="UK">United Kingdom</MenuItem>
                           <MenuItem value="CA">Canada</MenuItem>
+                          <MenuItem value="DE">Germany</MenuItem>
+                          <MenuItem value="ES">Spain</MenuItem>
                         </Select>
                         {errors.billingAddress?.country ? (
                           <FormHelperText>{errors.billingAddress.country.message}</FormHelperText>
@@ -438,7 +456,7 @@ export function StudentEditForm(): React.JSX.Element {
                         error={Boolean(errors.billingAddress?.zipCode)}
                         fullWidth
                       >
-                        <InputLabel required>Zip Code</InputLabel>
+                        <InputLabel required>{t('edit.zip-code')}</InputLabel>
                         <OutlinedInput {...field} />
                         {errors.billingAddress?.zipCode ? (
                           <FormHelperText>{errors.billingAddress.zipCode.message}</FormHelperText>
@@ -459,7 +477,7 @@ export function StudentEditForm(): React.JSX.Element {
                         error={Boolean(errors.billingAddress?.line1)}
                         fullWidth
                       >
-                        <InputLabel required>Address Line 1</InputLabel>
+                        <InputLabel required>{t('edit.address-line-1')}</InputLabel>
                         <OutlinedInput {...field} />
                         {errors.billingAddress?.line1 ? (
                           <FormHelperText>{errors.billingAddress.line1.message}</FormHelperText>
@@ -494,7 +512,7 @@ export function StudentEditForm(): React.JSX.Element {
             </Stack>
 
             <Stack spacing={3}>
-              <Typography variant="h6">Additional Information</Typography>
+              <Typography variant="h6">{t('edit.additional-information')}</Typography>
               <Grid
                 container
                 spacing={3}
@@ -541,8 +559,10 @@ export function StudentEditForm(): React.JSX.Element {
                       >
                         <InputLabel required>Language</InputLabel>
                         <Select {...field}>
+                          <MenuItem value="">no language selected</MenuItem>
                           <MenuItem value="en">English</MenuItem>
                           <MenuItem value="es">Spanish</MenuItem>
+                          <MenuItem value="de">German</MenuItem>
                           <MenuItem value="fr">French</MenuItem>
                         </Select>
                         {errors.language ? <FormHelperText>{errors.language.message}</FormHelperText> : null}
@@ -562,8 +582,9 @@ export function StudentEditForm(): React.JSX.Element {
                         error={Boolean(errors.currency)}
                         fullWidth
                       >
-                        <InputLabel required>Currency</InputLabel>
+                        <InputLabel required>{t('edit.currency')}</InputLabel>
                         <Select {...field}>
+                          <MenuItem value="">no currency selected</MenuItem>
                           <MenuItem value="USD">USD</MenuItem>
                           <MenuItem value="EUR">EUR</MenuItem>
                           <MenuItem value="GBP">GBP</MenuItem>

002_source/cms/src/components/dashboard/student/type.d.tsx

@@ -23,21 +23,23 @@ export interface CreateFormProps {
   email: string;
   phone?: string;
   company?: string;
-  billingAddress?: {
-    country: string;
-    state: string;
-    city: string;
-    zipCode: string;
-    line1: string;
-    line2?: string;
-  };
+  // handle seperately
+  // billingAddress?: {
+  //   country: string;
+  //   state: string;
+  //   city: string;
+  //   zipCode: string;
+  //   line1: string;
+  //   line2?: string;
+  // };
   taxId?: string;
   timezone: string;
   language: string;
   currency: string;
-  avatar?: string;
+  avatar?: File | null;
   // quota?: number;
-  // status?: 'pending' | 'active' | 'blocked';
+  state?: 'pending' | 'active' | 'blocked';
+  meta: Record<string, null>;
 }
 
 // RULES: form data structure for editing existing student

002_source/cms/src/components/dashboard/teacher/teacher-edit-form.tsx

@@ -1,10 +1,12 @@
 'use client';
 
+// src/components/dashboard/teacher/teacher-edit-form.tsx
+//
 import * as React from 'react';
 import RouterLink from 'next/link';
 import { useParams, useRouter } from 'next/navigation';
 //
-import { COL_TEACHERS, COL_USER_METAS } from '@/constants';
+import { COL_USER_METAS } from '@/constants';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { LoadingButton } from '@mui/lab';
 //
@@ -32,6 +34,7 @@ import { useTranslation } from 'react-i18next';
 import { z as zod } from 'zod';
 
 import { paths } from '@/paths';
+import isDevelopment from '@/lib/check-is-development';
 import { logger } from '@/lib/default-logger';
 import { base64ToFile, fileToBase64 } from '@/lib/file-to-base64';
 import { pb } from '@/lib/pb';
@@ -40,7 +43,6 @@ import FormLoading from '@/components/loading';
 
 // import ErrorDisplay from '../../error';
 import ErrorDisplay from '../error';
-import isDevelopment from '@/lib/check-is-development';
 
 // TODO: review this
 const schema = zod.object({

002_source/cms/src/components/dashboard/user.de/user-edit-form.tsx

@@ -32,6 +32,7 @@ import { useTranslation } from 'react-i18next';
 import { z as zod } from 'zod';
 
 import { paths } from '@/paths';
+import isDevelopment from '@/lib/check-is-development';
 import { logger } from '@/lib/default-logger';
 import { base64ToFile, fileToBase64 } from '@/lib/file-to-base64';
 import { pb } from '@/lib/pb';
@@ -40,7 +41,6 @@ import FormLoading from '@/components/loading';
 
 // import ErrorDisplay from '../../error';
 import ErrorDisplay from '../error';
-import isDevelopment from '@/lib/check-is-development';
 
 // TODO: review this
 const schema = zod.object({

002_source/cms/src/components/dashboard/user_meta/type.d.tsx

@@ -1,8 +1,55 @@
 'use client';
 
+import type { BillingAddress } from '@/db/billingAddress/type';
+
 // RULES: sorting direction for teacher lists
 export type SortDir = 'asc' | 'desc';
 
+// obsoleted
+// export interface BillingAddress {
+//   city: string;
+//   country: string;
+//   line1: string;
+//   line2: string;
+//   state: string;
+//   zipCode: string;
+//   //
+//   id: string;
+//   collectionId: string;
+//   collectionName: string;
+//   updated: string;
+//   created: string;
+// }
+
+export interface DBUserMeta {
+  name: string;
+  //
+  // NOTE: obslete "avatar" and use "avatar_file"
+  avatar?: string;
+  avatar_file?: string;
+  //
+  email: string;
+  phone: string;
+  quota: number;
+  company: string;
+  //
+  // billingAddress: BillingAddress[] | [];
+  expand: { billingAddress?: BillingAddress[] };
+
+  // status is obsoleted, replace by state
+  status: 'pending' | 'active' | 'blocked';
+  state: 'pending' | 'active' | 'blocked';
+  //
+  timezone: string;
+  language: string;
+  currency: string;
+  //
+  id: string;
+  created: string;
+  updated?: string;
+  collectionId: string;
+}
+
 // RULES: core teacher data structure
 export interface UserMeta {
   name: string;
@@ -14,10 +61,18 @@ export interface UserMeta {
   email: string;
   phone?: string;
   quota: number;
+  company?: string;
+  //
+  billingAddress: BillingAddress | Record<string, never>;
 
   // status is obsoleted, replace by state
   status: 'pending' | 'active' | 'blocked';
   state: 'pending' | 'active' | 'blocked';
+  //
+  timezone: string;
+  language: string;
+  currency: string;
+
   //
   id: string;
   createdAt: Date;

002_source/cms/src/components/dashboard/user_meta/user-meta-edit-form.tsx

@@ -1,10 +1,15 @@
 'use client';
 
+// src/components/dashboard/user_meta/user-meta-edit-form.tsx
+//
 import * as React from 'react';
 import RouterLink from 'next/link';
 import { useParams, useRouter } from 'next/navigation';
 //
-import { COL_TEACHERS, COL_USER_METAS } from '@/constants';
+import { COL_CUSTOMERS, COL_USER_METAS } from '@/constants';
+import { UpdateBillingAddressById } from '@/db/billingAddress/UpdateById';
+import { getUserMetaById } from '@/db/UserMetas/GetById';
+import { UpdateUserMetaById } from '@/db/UserMetas/UpdateById';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { LoadingButton } from '@mui/lab';
 //
@@ -32,6 +37,7 @@ import { useTranslation } from 'react-i18next';
 import { z as zod } from 'zod';
 
 import { paths } from '@/paths';
+import isDevelopment from '@/lib/check-is-development';
 import { logger } from '@/lib/default-logger';
 import { base64ToFile, fileToBase64 } from '@/lib/file-to-base64';
 import { pb } from '@/lib/pb';
@@ -40,7 +46,6 @@ import FormLoading from '@/components/loading';
 
 // import ErrorDisplay from '../../error';
 import ErrorDisplay from '../error';
-import isDevelopment from '@/lib/check-is-development';
 
 // TODO: review this
 const schema = zod.object({
@@ -89,7 +94,7 @@ export function UserMetaEditForm(): React.JSX.Element {
   const router = useRouter();
   const { t } = useTranslation(['lp_categories']);
 
-  const { id: teacherId } = useParams<{ id: string }>();
+  const { id: userMetaId } = useParams<{ id: string }>();
   //
   const [isUpdating, setIsUpdating] = React.useState<boolean>(false);
   const [showLoading, setShowLoading] = React.useState<boolean>(false);
@@ -123,7 +128,7 @@ export function UserMetaEditForm(): React.JSX.Element {
       };
 
       try {
-        await pb.collection(COL_USER_METAS).update(teacherId, updateData);
+        await pb.collection(COL_USER_METAS).update(userMetaId, updateData);
         toast.success('Teacher updated successfully');
         router.push(paths.dashboard.teachers.list);
       } catch (error) {
@@ -133,7 +138,7 @@ export function UserMetaEditForm(): React.JSX.Element {
         setIsUpdating(false);
       }
     },
-    [teacherId, router]
+    [userMetaId, router]
   );
 
   const avatarInputRef = React.useRef<HTMLInputElement>(null);
@@ -186,9 +191,9 @@ export function UserMetaEditForm(): React.JSX.Element {
   );
 
   React.useEffect(() => {
-    void loadExistingData(teacherId);
+    void loadExistingData(userMetaId);
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [teacherId]);
+  }, [userMetaId]);
 
   if (showLoading) return <FormLoading />;
   if (showError.show)

002_source/cms/src/constants.ts

@@ -5,6 +5,7 @@ const COL_LESSON_TYPES = 'LessonsTypes';
 const COL_LESSON_CATEGORIES = 'LessonsCategories';
 const COL_USERS = 'users';
 const COL_USER_METAS = 'UserMetas';
+const COL_BILLING_ADDRESS = 'billingAddress';
 
 // RULES:
 // do not use LP_CATEGORIES anymore
@@ -56,4 +57,5 @@ export {
   COL_VOCABULARIES,
   NS_VOCABULARY,
   //
+  COL_BILLING_ADDRESS,
 };

002_source/cms/src/db/Notifications/GetNotificationByUserId.tsx

@@ -1,14 +1,18 @@
 //
 // RULES:
 // api method for get notifications by user id
-import { pb } from '@/lib/pb';
 import { COL_NOTIFICATIONS } from '@/constants';
+
+import { pb } from '@/lib/pb';
+
 import type { Notification } from './type.d';
 
 export async function getNotificationsByUserId(userId: string): Promise<Notification[]> {
   const records = await pb.collection(COL_NOTIFICATIONS).getFullList({
-    filter: `author.id = "000000000000001"`,
+    expand: 'author, to_user_id',
+    filter: `to_user_id.id = "${userId}"`,
     sort: '-created',
   });
+
   return records as unknown as Notification[];
 }

002_source/cms/src/db/Notifications/GetUnreadNotificationsByUserId.tsx

@@ -0,0 +1,20 @@
+//
+// RULES:
+// api method for get notifications by user id
+import { COL_NOTIFICATIONS } from '@/constants';
+
+import { pb } from '@/lib/pb';
+
+import type { Notification } from './type.d';
+
+export async function getUnreadNotificationsByUserId(userId: string): Promise<Notification[]> {
+  const records = await pb.collection(COL_NOTIFICATIONS).getFullList({
+    expand: 'author, to_user_id',
+    filter: `to_user_id.id = "${userId}" && read = false`,
+    sort: '-created',
+    cache: 'no-cache',
+    requestKey: null,
+  });
+
+  return records as unknown as Notification[];
+}

002_source/cms/src/db/Notifications/mark-one-as-read.tsx

@@ -0,0 +1,11 @@
+// api method for update notification record
+// RULES:
+// TBA
+import { pb } from '@/lib/pb';
+import { COL_NOTIFICATIONS } from '@/constants';
+import type { RecordModel } from 'pocketbase';
+import type { NotificationFormProps } from '@/components/dashboard/notification/type.d';
+
+export async function MarkOneAsRead(id: string): Promise<RecordModel> {
+  return pb.collection(COL_NOTIFICATIONS).update(id, { read: true });
+}

002_source/cms/src/db/Notifications/type.d.ts

@@ -1,17 +1,21 @@
 'use client';
 
+import type { User } from '@/types/user';
+
 export type SortDir = 'asc' | 'desc';
 
 export interface Notification {
   id: string;
+  created: string;
+  createdAt: Date;
   read: boolean;
   type: string;
-  author: Record<string, unknown>;
-  job: Record<string, unknown>;
-  description: string;
-  NOTI_ID: string;
-  created: string;
-  updated: string;
+  author?: User;
+  job?: { title: string };
+  description?: string;
+  company?: { name: string };
+  to_user_id?: User;
+  link: string;
 }
 
 export interface CreateFormProps {

002_source/cms/src/db/Students/Create.tsx

@@ -1,11 +1,12 @@
 // api method for crate student record
 // RULES:
 // TBA
-import { pb } from '@/lib/pb';
-import { COL_STUDENTS } from '@/constants';
-import type { CreateFormProps } from '@/components/dashboard/student/type.d';
+import { COL_STUDENTS, COL_USER_METAS } from '@/constants';
 import type { RecordModel } from 'pocketbase';
 
+import { pb } from '@/lib/pb';
+import type { CreateFormProps } from '@/components/dashboard/student/type.d';
+
 export async function createStudent(data: CreateFormProps): Promise<RecordModel> {
-  return pb.collection(COL_STUDENTS).create(data);
+  return pb.collection(COL_USER_METAS).create(data);
 }

002_source/cms/src/db/Students/GetById.tsx

@@ -1,7 +1,28 @@
-import { pb } from '@/lib/pb';
-import { COL_STUDENTS } from '@/constants';
-import { RecordModel } from 'pocketbase';
+import { COL_USER_METAS } from '@/constants';
 
-export async function getStudentById(id: string): Promise<RecordModel> {
-  return pb.collection(COL_STUDENTS).getOne(id);
+import { pb } from '@/lib/pb';
+import type { DBUserMeta, UserMeta } from '@/components/dashboard/user_meta/type.d';
+
+export async function getStudentById(id: string): Promise<UserMeta> {
+  const record = await pb.collection(COL_USER_METAS).getOne<DBUserMeta>(id, { expand: 'billingAddress, helloworld' });
+
+  const temp: UserMeta = {
+    id: record.id,
+    name: record.name,
+    email: record.email,
+    quota: record.quota,
+    billingAddress: record.expand.billingAddress ? record.expand.billingAddress[0] : {},
+    status: record.status,
+    state: record.state,
+    createdAt: new Date(record.created),
+    collectionId: record.collectionId,
+    avatar: record.avatar,
+    phone: record.phone,
+    company: record.company,
+    timezone: record.timezone,
+    language: record.language,
+    currency: record.currency,
+  };
+
+  return temp;
 }

002_source/cms/src/db/Students/UpdateById.tsx

@@ -0,0 +1,10 @@
+import { COL_USER_METAS } from '@/constants';
+import type { RecordModel } from 'pocketbase';
+
+import { pb } from '@/lib/pb';
+
+import type { UpdateStudent } from './type';
+
+export async function UpdateStudentById(id: string, data: Partial<UpdateStudent>): Promise<RecordModel> {
+  return pb.collection(COL_USER_METAS).update(id, data);
+}

002_source/cms/src/db/Students/type.d.ts

@@ -1,3 +1,5 @@
+import type { BillingAddress } from '@/components/dashboard/user_meta/type.d';
+
 // Student type definitions
 export interface Student {
   id: string;
@@ -9,3 +11,29 @@ export interface Student {
   status: 'active' | 'blocked' | 'pending';
   createdAt: Date;
 }
+
+export interface UpdateStudent {
+  name?: string;
+  //
+  // NOTE: obslete "avatar" and use "avatar_file"
+  // avatar_file?: string;
+  avatar: File | null;
+  //
+  email?: string;
+  phone?: string;
+  quota?: number;
+  company?: string;
+  //
+  // relation handle seperately
+  // billingAddress: BillingAddress | Record<string, never>;
+
+  // status is obsoleted, replace by state
+  // status: 'pending' | 'active' | 'blocked';
+  state?: 'pending' | 'active' | 'blocked';
+  //
+  timezone?: string;
+  language?: string;
+  currency?: string;
+  //
+  taxId?: string;
+}

002_source/cms/src/db/UserMetas/UpdateById.tsx

@@ -0,0 +1,10 @@
+import { COL_USER_METAS } from '@/constants';
+import type { RecordModel } from 'pocketbase';
+
+import { pb } from '@/lib/pb';
+
+import type { UpdateUserMeta } from './type';
+
+export async function UpdateUserMetaById(id: string, data: Partial<UpdateUserMeta>): Promise<RecordModel> {
+  return pb.collection(COL_USER_METAS).update(id, data);
+}

002_source/cms/src/db/UserMetas/type.d.ts

@@ -0,0 +1,39 @@
+import type { BillingAddress } from '@/components/dashboard/user_meta/type.d';
+
+// UserMeta type definitions
+export interface UserMeta {
+  id: string;
+  name: string;
+  avatar: string;
+  email: string;
+  phone: string;
+  quota: number;
+  status: 'active' | 'blocked' | 'pending';
+  createdAt: Date;
+}
+
+export interface UpdateUserMeta {
+  name?: string;
+  //
+  // NOTE: obslete "avatar" and use "avatar_file"
+  // avatar_file?: string;
+  avatar: File | null;
+  //
+  email?: string;
+  phone?: string;
+  quota?: number;
+  company?: string;
+  //
+  // relation handle seperately
+  // billingAddress: BillingAddress | Record<string, never>;
+
+  // status is obsoleted, replace by state
+  // status: 'pending' | 'active' | 'blocked';
+  state?: 'pending' | 'active' | 'blocked';
+  //
+  timezone?: string;
+  language?: string;
+  currency?: string;
+  //
+  taxId?: string;
+}

002_source/cms/src/db/billingAddress/Create.tsx

@@ -0,0 +1,11 @@
+// api method for crate student record
+// RULES:
+// TBA
+import { pb } from '@/lib/pb';
+import { COL_STUDENTS } from '@/constants';
+import type { CreateFormProps } from '@/components/dashboard/student/type.d';
+import type { RecordModel } from 'pocketbase';
+
+export async function createStudent(data: CreateFormProps): Promise<RecordModel> {
+  return pb.collection(COL_STUDENTS).create(data);
+}

002_source/cms/src/db/billingAddress/Delete.tsx

@@ -0,0 +1,6 @@
+import { pb } from '@/lib/pb';
+import { COL_STUDENTS, COL_USER_METAS } from '@/constants';
+
+export async function deleteStudent(id: string): Promise<boolean> {
+  return pb.collection(COL_USER_METAS).delete(id);
+}

002_source/cms/src/db/billingAddress/GetActiveCount.tsx

@@ -0,0 +1,9 @@
+import { COL_STUDENTS, COL_USER_METAS } from '@/constants';
+import { pb } from '@/lib/pb';
+
+export default async function GetActiveCount(): Promise<number> {
+  const { totalItems: count } = await pb.collection(COL_USER_METAS).getList(1, 1, {
+    filter: 'status = "active" && role = "student"',
+  });
+  return count;
+}

002_source/cms/src/db/billingAddress/GetAll.tsx

@@ -0,0 +1,7 @@
+import { pb } from '@/lib/pb';
+import { COL_STUDENTS } from '@/constants';
+import { RecordModel } from 'pocketbase';
+
+export async function getAllStudents(options = {}): Promise<RecordModel[]> {
+  return pb.collection(COL_STUDENTS).getFullList(options);
+}

002_source/cms/src/db/billingAddress/GetAllCount.tsx

@@ -0,0 +1,10 @@
+import { pb } from '@/lib/pb';
+import { COL_USER_METAS } from '@/constants';
+
+export async function getAllStudentsCount(): Promise<number> {
+  const result = await pb.collection(COL_USER_METAS).getList(1, 1, {
+    filter: `role = "student"`,
+    //
+  });
+  return result.totalItems;
+}

002_source/cms/src/db/billingAddress/GetBlockedCount.tsx

@@ -0,0 +1,9 @@
+import { COL_USER_METAS } from '@/constants';
+import { pb } from '@/lib/pb';
+
+export default async function GetBlockedCount(): Promise<number> {
+  const { totalItems: count } = await pb.collection(COL_USER_METAS).getList(1, 1, {
+    filter: 'status = "blocked" && role = "student"',
+  });
+  return count;
+}

002_source/cms/src/db/billingAddress/GetById.tsx

@@ -0,0 +1,34 @@
+import { COL_BILLING_ADDRESS, COL_STUDENTS, COL_USER_METAS } from '@/constants';
+import { RecordModel } from 'pocketbase';
+
+import { logger } from '@/lib/default-logger';
+import { pb } from '@/lib/pb';
+import type { DBUserMeta, UserMeta } from '@/components/dashboard/user_meta/type.d';
+
+export async function getBillingAddressById(id: string): Promise<UserMeta> {
+  const record = await pb
+    .collection(COL_BILLING_ADDRESS)
+    .getOne<DBUserMeta>(id, { expand: 'billingAddress, helloworld' });
+
+  console.log({ record });
+
+  const temp: UserMeta = {
+    id: record.id,
+    name: record.name,
+    email: record.email,
+    quota: record.quota,
+    billingAddress: record.expand.billingAddress ? record.expand.billingAddress[0] : {},
+    status: record.status,
+    state: record.state,
+    createdAt: new Date(record.created),
+    collectionId: record.collectionId,
+    avatar: record.avatar,
+    phone: record.phone,
+    company: record.company,
+    timezone: record.timezone,
+    language: record.language,
+    currency: record.currency,
+  };
+
+  return temp;
+}

002_source/cms/src/db/billingAddress/GetPendingCount.tsx

@@ -0,0 +1,9 @@
+import { COL_USER_METAS } from '@/constants';
+import { pb } from '@/lib/pb';
+
+export default async function GetPendingCount(): Promise<number> {
+  const { totalItems: count } = await pb.collection(COL_USER_METAS).getList(1, 1, {
+    filter: 'status = "pending" && role = "student"',
+  });
+  return count;
+}

002_source/cms/src/db/billingAddress/Helloworld.tsx

@@ -0,0 +1,3 @@
+export function helloCustomer() {
+  return 'Hello from Customers module!';
+}

002_source/cms/src/db/billingAddress/Update.tsx

@@ -0,0 +1,8 @@
+import { pb } from '@/lib/pb';
+import { COL_CUSTOMERS } from '@/constants';
+import type { RecordModel } from 'pocketbase';
+import type { EditFormProps } from '@/components/dashboard/customer/type.d';
+
+export async function updateCustomer(id: string, data: Partial<EditFormProps>): Promise<RecordModel> {
+  return pb.collection(COL_CUSTOMERS).update(id, data);
+}

002_source/cms/src/db/billingAddress/UpdateById.tsx

@@ -0,0 +1,10 @@
+import { COL_BILLING_ADDRESS } from '@/constants';
+import type { RecordModel } from 'pocketbase';
+
+import { pb } from '@/lib/pb';
+
+import type { UpdateBillingAddress } from './type';
+
+export async function UpdateBillingAddressById(id: string, data: Partial<UpdateBillingAddress>): Promise<RecordModel> {
+  return pb.collection(COL_BILLING_ADDRESS).update(id, data);
+}

002_source/cms/src/db/billingAddress/_GUIDELINES.md

@@ -0,0 +1,31 @@
+# GUIDELINES
+
+This folder contains drivers for `Customer`/`Customers` records using PocketBase:
+
+- create (Create.tsx)
+- read (GetById.tsx)
+- write (Update.tsx)
+- count (GetAllCount.tsx, GetActiveCount.tsx, GetBlockedCount.tsx, GetPendingCount.tsx)
+- misc (Helloworld.tsx)
+- delete (Delete.tsx)
+- list (GetAll.tsx)
+
+the `@` sign refer to `/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/002_source/cms/src`
+
+## Assumption and Requirements
+
+- assume `pb` is located in `@/lib/pb`
+- no need to handle error in this function, i'll handle it in the caller
+- type information defined in `/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/002_source/cms/src/db/Customers/type.d.tsx`
+
+simple template:
+
+```typescript
+import { pb } from '@/lib/pb';
+import { COL_CUSTOMERS } from '@/constants';
+
+export async function createCustomer(data: CreateFormProps) {
+  // ...content
+  // use direct return of pb.collection (e.g. return pb.collection(xxx))
+}
+```

002_source/cms/src/db/billingAddress/type.d.ts

@@ -0,0 +1,23 @@
+export interface BillingAddress {
+  city: string;
+  country: string;
+  line1: string;
+  line2: string;
+  state: string;
+  zipCode: string;
+  //
+  id: string;
+  collectionId: string;
+  collectionName: string;
+  updated: string;
+  created: string;
+}
+
+export interface UpdateBillingAddress {
+  city?: string;
+  country?: string;
+  line1?: string;
+  line2?: string;
+  state?: string;
+  zipCode?: string;
+}

002_source/cms/src/types/user.ts

@@ -1,8 +1,10 @@
 export interface User {
   id: string;
   name?: string;
-  avatar?: string;
+  avatar: string;
   email?: string;
 
+  collectionId: string;
+
   [key: string]: unknown;
 }

002_source/cms/tsconfig.json

@@ -40,16 +40,15 @@
     "node_modules",
     ".next",
     //
-    "**/*del",
-    "**/*plan",
-    "**/*.bak",
-    "*.bak",
-    "*.log",
-    "*.tmp",
-    "*.bug",
-    "*.del",
-    "*.draft",
     "**/* copy *.tsx",
-    "**/* copy.tsx"
+    "**/* copy.tsx",
+    "**/*.bak",
+    "**/*.bak",
+    "**/*.bug",
+    "**/*.del",
+    "**/*.draft",
+    "**/*.log",
+    "**/*.tmp",
+    "**/*del",
   ]
 }

002_source/docker/.env

@@ -0,0 +1,14 @@
+# THIS IS env file for use with docker-compose.yml
+
+# cms
+
+# doc
+
+# ionic_mobile
+
+# api_ts
+
+# pocketbase
+PB_HOSTNAME=pocketbase
+PB_USERNAME=admin@123.com
+PB_PASSWORD=Aa12345678

002_source/docker/docker-compose.db.yml

@@ -0,0 +1,35 @@
+volumes:
+  shared:
+  dist:
+
+services:
+  pocketbase:
+    # image: ghcr.io/muchobien/pocketbase:latest
+    build:
+      context: ./pocketbase/docker
+      args:
+        - VERSION=0.26.6 # Specify the PocketBase version here
+    # hostname: pocketbase
+    restart: always
+    # environment:
+    #   ENCRYPTION: example #optional
+    ports:
+      - 8090:8090
+    volumes:
+      - ./volumes/pocketbase/pb_data:/pb_data
+      #
+      - ../pocketbase/pb_migrations:/pb_migrations
+      - ../pocketbase/pb_hooks:/pb_hooks
+    # healthcheck:
+    #   #optional (recommended) since v0.10.0
+    #   test: wget --no-verbose --tries=1 --spider http://localhost:8090/api/health || exit 1
+    #   interval: 5s
+    #   timeout: 5s
+    #   retries: 5
+
+    deploy:
+      resources:
+        limits:
+          cpus: 0.5
+        reservations:
+          cpus: 0.01

002_source/docker/docker-compose.dev.yml

@@ -6,7 +6,7 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "1"
+          cpus: '1'
 
   doc:
     environment:
@@ -14,7 +14,7 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "1"
+          cpus: '1'
 
   ionic_mobile:
     environment:
@@ -22,7 +22,7 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "1"
+          cpus: '1'
 
   api_ts:
     environment:
@@ -30,4 +30,4 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "1"
+          cpus: '1'

002_source/docker/docker-compose.yml

@@ -26,9 +26,9 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "0.5"
+          cpus: '0.5'
         reservations:
-          cpus: "0.01"
+          cpus: '0.01'
 
   doc:
     build: ./doc
@@ -50,9 +50,9 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "0.5"
+          cpus: '0.5'
         reservations:
-          cpus: "0.01"
+          cpus: '0.01'
 
   ionic_mobile:
     # image: node:20-bullseye-slim
@@ -80,15 +80,16 @@ services:
     deploy:
       resources:
         limits:
-          cpus: "0.5"
+          cpus: '0.5'
         reservations:
-          cpus: "0.01"
+          cpus: '0.01'
 
   api_ts:
+    # TODO: review this config, the api_ts volumes should be place inside 002_source/docker/volumes
     image: 192.168.10.61:5000/api_ts_ubuntu
     # build: ./api_ts
     volumes:
-      - ./api_ts:/app
+      - ../api_ts:/app
     working_dir: /app
     # env_file:
     #   - .env
@@ -117,33 +118,3 @@ services:
           cpus: 0.5
         reservations:
           cpus: 0.01
-
-  pocketbase:
-    # image: ghcr.io/muchobien/pocketbase:latest
-    build:
-      context: ./pocketbase/docker
-      args:
-        - VERSION=0.26.6 # Specify the PocketBase version here
-    # hostname: pocketbase
-    restart: always
-    # environment:
-    #   ENCRYPTION: example #optional
-    ports:
-      - 8090:8090
-    volumes:
-      - ./pocketbase/volumes/pb_data:/pb_data
-      - ./pocketbase/pb_hooks:/pb_hooks
-      - ./pocketbase/pb_migrations:/pb_migrations
-    # healthcheck:
-    #   #optional (recommended) since v0.10.0
-    #   test: wget --no-verbose --tries=1 --spider http://localhost:8090/api/health || exit 1
-    #   interval: 5s
-    #   timeout: 5s
-    #   retries: 5
-
-    deploy:
-      resources:
-        limits:
-          cpus: 0.5
-        reservations:
-          cpus: 0.01

002_source/ionic_mobile/.gitignore

@@ -1,3 +1,4 @@
+.env
 **/*.log
 **/*.del
 **/*.bak

002_source/ionic_mobile/.prettierrc

@@ -1,9 +1,10 @@
 {
+  "endOfLine": "lf",
   "printWidth": 120,
   "quoteProps": "consistent",
   "semi": true,
   "singleQuote": true,
   "tabWidth": 2,
-  "trailingComma": "all",
-  "plugins": ["prettier-plugin-organize-imports", "prettier-plugin-unused-imports-configurable"]
+  "trailingComma": "es5",
+  "plugins": []
 }

002_source/ionic_mobile/TODO.md

@@ -0,0 +1,3 @@
+# TODO
+
+- [ ] add login mechanism

002_source/ionic_mobile/cypress.config.ts

@@ -1,8 +1,8 @@
-import { defineConfig } from "cypress";
+import { defineConfig } from 'cypress';
 
 export default defineConfig({
   e2e: {
-    baseUrl: "http://localhost:5173",
+    baseUrl: 'http://localhost:5173',
     setupNodeEvents(on, config) {
       // implement node event listeners here
     },

002_source/ionic_mobile/default.code-workspace

@@ -0,0 +1,17 @@
+{
+  "folders": [
+    {
+      "path": ".",
+    },
+    {
+      "path": "./../../001_documentation",
+    },
+    {
+      "path": "../../000_AI_WORKSPACE",
+    },
+  ],
+  "settings": {
+    "git.ignoreLimitWarning": true,
+    "remote.autoForwardPortsFallback": 0,
+  },
+}

002_source/ionic_mobile/index.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />

002_source/ionic_mobile/nodemon.json

@@ -1,5 +1,7 @@
 {
-  "watch": ["src"],
+  "watch": [
+    "src"
+  ],
   "ext": "ts,tsx",
   "exec": "npm run bulid"
 }

002_source/ionic_mobile/package-lock.json

@@ -21,11 +21,14 @@
         "@ionic/react-router": "^8.0.0",
         "@ionic/storage": "^4.0.0",
         "@lifeomic/attempt": "^3.1.0",
+        "@tanstack/react-query": "^5.74.4",
+        "@tanstack/react-query-devtools": "^5.74.6",
         "@types/react-router": "^5.1.20",
         "@types/react-router-dom": "^5.3.3",
         "axios": "^1.8.1",
         "i18next": "^24.2.2",
         "ionicons": "^7.0.0",
+        "pocketbase": "^0.26.0",
         "react": "^18.2.0",
         "react-dom": "^18.2.0",
         "react-i18next": "^15.4.1",
@@ -55,6 +58,7 @@
         "prettier": "^3.4.2",
         "prettier-plugin-organize-imports": "^4.1.0",
         "prettier-plugin-unused-imports-configurable": "^1.14.2",
+        "sass": "^1.88.0",
         "terser": "^5.4.0",
         "typescript": "^5.1.6",
         "vite": "~5.2.0",
@@ -2777,6 +2781,338 @@
         "node": ">= 8"
       }
     },
+    "node_modules/@parcel/watcher": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher/-/watcher-2.5.1.tgz",
+      "integrity": "sha512-dfUnCxiN9H4ap84DvD2ubjw+3vUNpstxa0TneY/Paat8a3R4uQZDLSvWjmznAY/DoahqTHl9V46HF/Zs3F29pg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "detect-libc": "^1.0.3",
+        "is-glob": "^4.0.3",
+        "micromatch": "^4.0.5",
+        "node-addon-api": "^7.0.0"
+      },
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      },
+      "optionalDependencies": {
+        "@parcel/watcher-android-arm64": "2.5.1",
+        "@parcel/watcher-darwin-arm64": "2.5.1",
+        "@parcel/watcher-darwin-x64": "2.5.1",
+        "@parcel/watcher-freebsd-x64": "2.5.1",
+        "@parcel/watcher-linux-arm-glibc": "2.5.1",
+        "@parcel/watcher-linux-arm-musl": "2.5.1",
+        "@parcel/watcher-linux-arm64-glibc": "2.5.1",
+        "@parcel/watcher-linux-arm64-musl": "2.5.1",
+        "@parcel/watcher-linux-x64-glibc": "2.5.1",
+        "@parcel/watcher-linux-x64-musl": "2.5.1",
+        "@parcel/watcher-win32-arm64": "2.5.1",
+        "@parcel/watcher-win32-ia32": "2.5.1",
+        "@parcel/watcher-win32-x64": "2.5.1"
+      }
+    },
+    "node_modules/@parcel/watcher-android-arm64": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-android-arm64/-/watcher-android-arm64-2.5.1.tgz",
+      "integrity": "sha512-KF8+j9nNbUN8vzOFDpRMsaKBHZ/mcjEjMToVMJOhTozkDonQFFrRcfdLWn6yWKCmJKmdVxSgHiYvTCef4/qcBA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-darwin-arm64": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-darwin-arm64/-/watcher-darwin-arm64-2.5.1.tgz",
+      "integrity": "sha512-eAzPv5osDmZyBhou8PoF4i6RQXAfeKL9tjb3QzYuccXFMQU0ruIc/POh30ePnaOyD1UXdlKguHBmsTs53tVoPw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-darwin-x64": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-darwin-x64/-/watcher-darwin-x64-2.5.1.tgz",
+      "integrity": "sha512-1ZXDthrnNmwv10A0/3AJNZ9JGlzrF82i3gNQcWOzd7nJ8aj+ILyW1MTxVk35Db0u91oD5Nlk9MBiujMlwmeXZg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-freebsd-x64": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-freebsd-x64/-/watcher-freebsd-x64-2.5.1.tgz",
+      "integrity": "sha512-SI4eljM7Flp9yPuKi8W0ird8TI/JK6CSxju3NojVI6BjHsTyK7zxA9urjVjEKJ5MBYC+bLmMcbAWlZ+rFkLpJQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm-glibc": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm-glibc/-/watcher-linux-arm-glibc-2.5.1.tgz",
+      "integrity": "sha512-RCdZlEyTs8geyBkkcnPWvtXLY44BCeZKmGYRtSgtwwnHR4dxfHRG3gR99XdMEdQ7KeiDdasJwwvNSF5jKtDwdA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm-musl": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm-musl/-/watcher-linux-arm-musl-2.5.1.tgz",
+      "integrity": "sha512-6E+m/Mm1t1yhB8X412stiKFG3XykmgdIOqhjWj+VL8oHkKABfu/gjFj8DvLrYVHSBNC+/u5PeNrujiSQ1zwd1Q==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm64-glibc": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm64-glibc/-/watcher-linux-arm64-glibc-2.5.1.tgz",
+      "integrity": "sha512-LrGp+f02yU3BN9A+DGuY3v3bmnFUggAITBGriZHUREfNEzZh/GO06FF5u2kx8x+GBEUYfyTGamol4j3m9ANe8w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-arm64-musl": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm64-musl/-/watcher-linux-arm64-musl-2.5.1.tgz",
+      "integrity": "sha512-cFOjABi92pMYRXS7AcQv9/M1YuKRw8SZniCDw0ssQb/noPkRzA+HBDkwmyOJYp5wXcsTrhxO0zq1U11cK9jsFg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-x64-glibc": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-x64-glibc/-/watcher-linux-x64-glibc-2.5.1.tgz",
+      "integrity": "sha512-GcESn8NZySmfwlTsIur+49yDqSny2IhPeZfXunQi48DMugKeZ7uy1FX83pO0X22sHntJ4Ub+9k34XQCX+oHt2A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-linux-x64-musl": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-x64-musl/-/watcher-linux-x64-musl-2.5.1.tgz",
+      "integrity": "sha512-n0E2EQbatQ3bXhcH2D1XIAANAcTZkQICBPVaxMeaCVBtOpBZpWJuf7LwyWPSBDITb7In8mqQgJ7gH8CILCURXg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-win32-arm64": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-arm64/-/watcher-win32-arm64-2.5.1.tgz",
+      "integrity": "sha512-RFzklRvmc3PkjKjry3hLF9wD7ppR4AKcWNzH7kXR7GUe0Igb3Nz8fyPwtZCSquGrhU5HhUNDr/mKBqj7tqA2Vw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-win32-ia32": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-ia32/-/watcher-win32-ia32-2.5.1.tgz",
+      "integrity": "sha512-c2KkcVN+NJmuA7CGlaGD1qJh1cLfDnQsHjE89E60vUEMlqduHGCdCLJCID5geFVM0dOtA3ZiIO8BoEQmzQVfpQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher-win32-x64": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-x64/-/watcher-win32-x64-2.5.1.tgz",
+      "integrity": "sha512-9lHBdJITeNR++EvSQVUcaZoWupyHfXe1jZvGZ06O/5MflPcuPLtEphScIBL+AiCWBO46tDSHzWyD0uDmmZqsgA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/parcel"
+      }
+    },
+    "node_modules/@parcel/watcher/node_modules/detect-libc": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-1.0.3.tgz",
+      "integrity": "sha512-pGjwhsmsp4kL2RTz08wcOlGN83otlqHeD/Z5T8GXZB+/YcpQ/dgo+lbU8ZsGxV0HIvqqxo9l7mqYwyYMD9bKDg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "optional": true,
+      "bin": {
+        "detect-libc": "bin/detect-libc.js"
+      },
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/@parcel/watcher/node_modules/node-addon-api": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.1.1.tgz",
+      "integrity": "sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true
+    },
     "node_modules/@prettier/plugin-xml": {
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/@prettier/plugin-xml/-/plugin-xml-2.2.0.tgz",
@@ -2836,6 +3172,59 @@
         "npm": ">=7.10.0"
       }
     },
+    "node_modules/@tanstack/query-core": {
+      "version": "5.74.7",
+      "resolved": "https://registry.npmjs.org/@tanstack/query-core/-/query-core-5.74.7.tgz",
+      "integrity": "sha512-X3StkN/Y6KGHndTjJf8H8th7AX4bKfbRpiVhVqevf0QWlxl6DhyJ0TYG3R0LARa/+xqDwzU9mA4pbJxzPCI29A==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      }
+    },
+    "node_modules/@tanstack/query-devtools": {
+      "version": "5.74.7",
+      "resolved": "https://registry.npmjs.org/@tanstack/query-devtools/-/query-devtools-5.74.7.tgz",
+      "integrity": "sha512-nSNlfuGdnHf4yB0S+BoNYOE1o3oAH093weAYZolIHfS2stulyA/gWfSk/9H4ZFk5mAAHb5vNqAeJOmbdcGPEQw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      }
+    },
+    "node_modules/@tanstack/react-query": {
+      "version": "5.74.7",
+      "resolved": "https://registry.npmjs.org/@tanstack/react-query/-/react-query-5.74.7.tgz",
+      "integrity": "sha512-u4o/RIWnnrq26orGZu2NDPwmVof1vtAiiV6KYUXd49GuK+8HX+gyxoAYqIaZogvCE1cqOuZAhQKcrKGYGkrLxg==",
+      "license": "MIT",
+      "dependencies": {
+        "@tanstack/query-core": "5.74.7"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      },
+      "peerDependencies": {
+        "react": "^18 || ^19"
+      }
+    },
+    "node_modules/@tanstack/react-query-devtools": {
+      "version": "5.74.7",
+      "resolved": "https://registry.npmjs.org/@tanstack/react-query-devtools/-/react-query-devtools-5.74.7.tgz",
+      "integrity": "sha512-j60esTQF+ES0x52kQUYOX0Z8AJUcqCGANj6GaOf8J3YQz2bZPB1imLSw4SFeM3Ozv8uO/X/Dmh3IT1z+y57ZLQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@tanstack/query-devtools": "5.74.7"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/tannerlinsley"
+      },
+      "peerDependencies": {
+        "@tanstack/react-query": "^5.74.7",
+        "react": "^18 || ^19"
+      }
+    },
     "node_modules/@testing-library/dom": {
       "version": "10.4.0",
       "resolved": "https://registry.npmjs.org/@testing-library/dom/-/dom-10.4.0.tgz",
@@ -4781,6 +5170,22 @@
         "regexp-to-ast": "0.5.0"
       }
     },
+    "node_modules/chokidar": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
+      "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 14.16.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
     "node_modules/chownr": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/chownr/-/chownr-2.0.0.tgz",
@@ -8843,6 +9248,13 @@
       "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
       "license": "MIT"
     },
+    "node_modules/immutable": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/immutable/-/immutable-5.1.2.tgz",
+      "integrity": "sha512-qHKXW1q6liAk1Oys6umoaZbDRqjcjgSrbnrifHsfsttza7zcvRAsL7mMV6xWcyhwQy7Xj5v4hhbr6b+iDYwlmQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/import-fresh": {
       "version": "3.3.0",
       "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.0.tgz",
@@ -12281,6 +12693,12 @@
         "node": ">=10.4.0"
       }
     },
+    "node_modules/pocketbase": {
+      "version": "0.26.0",
+      "resolved": "https://registry.npmjs.org/pocketbase/-/pocketbase-0.26.0.tgz",
+      "integrity": "sha512-WBBeOgz4Jnrd7a1KEzSBUJqpTortKKCcp16j5KoF+4tNIyQHsmynj+qRSvS56/RVacVMbAqO8Qkfj3N84fpzEw==",
+      "license": "MIT"
+    },
     "node_modules/possible-typed-array-names": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.0.0.tgz",
@@ -13023,6 +13441,20 @@
         "node": ">= 6"
       }
     },
+    "node_modules/readdirp": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
+      "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.18.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
     "node_modules/redent": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/redent/-/redent-3.0.0.tgz",
@@ -13824,6 +14256,27 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/sass": {
+      "version": "1.88.0",
+      "resolved": "https://registry.npmjs.org/sass/-/sass-1.88.0.tgz",
+      "integrity": "sha512-sF6TWQqjFvr4JILXzG4ucGOLELkESHL+I5QJhh7CNaE+Yge0SI+ehCatsXhJ7ymU1hAFcIS3/PBpjdIbXoyVbg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "chokidar": "^4.0.0",
+        "immutable": "^5.0.2",
+        "source-map-js": ">=0.6.2 <2.0.0"
+      },
+      "bin": {
+        "sass": "sass.js"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "optionalDependencies": {
+        "@parcel/watcher": "^2.4.1"
+      }
+    },
     "node_modules/sax": {
       "version": "1.1.4",
       "resolved": "https://registry.npmjs.org/sax/-/sax-1.1.4.tgz",

002_source/ionic_mobile/package.json

@@ -36,11 +36,14 @@
     "@ionic/react-router": "^8.0.0",
     "@ionic/storage": "^4.0.0",
     "@lifeomic/attempt": "^3.1.0",
+    "@tanstack/react-query": "^5.74.4",
+    "@tanstack/react-query-devtools": "^5.74.6",
     "@types/react-router": "^5.1.20",
     "@types/react-router-dom": "^5.3.3",
     "axios": "^1.8.1",
     "i18next": "^24.2.2",
     "ionicons": "^7.0.0",
+    "pocketbase": "^0.26.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-i18next": "^15.4.1",
@@ -70,6 +73,7 @@
     "prettier": "^3.4.2",
     "prettier-plugin-organize-imports": "^4.1.0",
     "prettier-plugin-unused-imports-configurable": "^1.14.2",
+    "sass": "^1.88.0",
     "terser": "^5.4.0",
     "typescript": "^5.1.6",
     "vite": "~5.2.0",

002_source/ionic_mobile/scripts/004_dev.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+set -ex
+
+npm run dev

002_source/ionic_mobile/scripts/010_rsync_backup.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+set -ex
+
+rsync -avh --exclude="node_modules" ../ionic_mobile/ \
+    ../_archive/ionic_mobile_draft_012
+
+echo "done"

002_source/ionic_mobile/scripts/999_express_commit.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+set -ex
+
+git add src
+git commit -m'update,'
+
+echo "done"

002_source/ionic_mobile/src/RouteConfig.tsx

@@ -21,6 +21,10 @@ import ConnectivesWordPage from './pages/Favorite/ConnectivesWordPage';
 import FavVocabularyPage from './pages/Favorite/Vocabulary';
 import FavoriteVocabularyPage from './pages/Favorite/WordPage';
 import ConnectivesPage from './pages/Lesson/ConnectivesPage';
+import AuthHome from './pages/auth/Home';
+import { AuthLogin } from './pages/auth/Login';
+import { AuthSignUp } from './pages/auth/SignUp';
+
 import Lesson from './pages/Lesson/index';
 
 // NOTES: old version using json file
@@ -88,6 +92,7 @@ function RouteConfig() {
         <ListeningPractice />
       </Route>
 
+      {/* http://localhost:5173/connective_revision/r/000000000000001 */}
       <Route exact path={`${CONNECTIVE_REVISION_LINK}/r/:p_route`}>
         <ConnectiveRevisionQuizRun />
       </Route>
@@ -96,6 +101,7 @@ function RouteConfig() {
         <ConnectiveRevisionQuizResult />
       </Route>
 
+      {/* http://localhost:5173/connective_revision */}
       <Route exact path={CONNECTIVE_REVISION_LINK}>
         <ConnectiveRevisionSelectCategory />
       </Route>
@@ -154,6 +160,18 @@ function RouteConfig() {
         <ConnectivesPage />
       </Route>
 
+      <Route exact path={`/auth/Home`}>
+        <AuthHome />
+      </Route>
+
+      <Route exact path={`/auth/login`}>
+        <AuthLogin />
+      </Route>
+
+      <Route exact path={`/auth/signup`}>
+        <AuthSignUp />
+      </Route>
+
       {/* TODO: remove below */}
       <Route exact path="/tab1">
         <Tab1 />

002_source/ionic_mobile/src/components/Action/index.tsx

@@ -0,0 +1,21 @@
+import { IonCol, IonRouterLink, IonRow } from '@ionic/react';
+
+function Action(props: { message: string; text: string; link: string }): React.JSX.Element {
+  return (
+    <>
+      <IonRow className="ion-text-center ion-justify-content-center">
+        <IonCol size="12">
+          <p>
+            {props.message}
+            <IonRouterLink className="custom-link" routerLink={props.link}>
+              {' '}
+              {props.text} &rarr;
+            </IonRouterLink>
+          </p>
+        </IonCol>
+      </IonRow>
+    </>
+  );
+}
+
+export { Action };

002_source/ionic_mobile/src/components/CustomField/index.tsx

@@ -0,0 +1,40 @@
+import { IonInput, IonLabel } from '@ionic/react';
+import styles from './style.module.scss';
+
+function CustomField({
+  field,
+  errors,
+}: {
+  field: {
+    id: string;
+    label: string;
+    required: boolean;
+    input: {
+      props: { type: string; placeholder: string };
+      state: {
+        value: string;
+        reset: (newValue: any) => void;
+        onIonChange: (e: any) => Promise<void>;
+        onKeyUp: (e: any) => Promise<void>;
+      };
+    };
+  };
+  errors: any;
+}): React.JSX.Element {
+  const error = errors && errors.filter((e) => e.id === field.id)[0];
+  const errorMessage = error && errors.filter((e) => e.id === field.id)[0].message;
+
+  return (
+    <>
+      <div className={styles.field}>
+        <IonLabel className={styles.fieldLabel}>
+          {field.label}
+          {error && <p className="animate__animated animate__bounceIn">{errorMessage}</p>}
+        </IonLabel>
+        <IonInput className={styles.customInput} {...field.input.props} {...field.input.state} />
+      </div>
+    </>
+  );
+}
+
+export { CustomField };

002_source/ionic_mobile/src/components/CustomField/style.module.scss

@@ -0,0 +1,29 @@
+.field:not(:last-child) {
+  margin-bottom: 1rem !important;
+}
+
+.field {
+  ion-label {
+    padding-left: 0.2rem;
+    padding-right: 0.5rem;
+    color: #d3a6c7;
+    display: flex;
+    justify-content: space-between;
+    align-content: center;
+    align-items: center;
+
+    p {
+      color: rgb(236, 149, 35);
+    }
+  }
+}
+.customInput {
+  // --background: #834e76;
+  --padding-bottom: 1rem;
+  --padding-top: 1rem;
+  --padding-start: 1rem;
+  --padding-end: 1rem;
+  border-radius: 10px;
+  margin-top: 0.25rem;
+  transition: all 0.2s linear;
+}

002_source/ionic_mobile/src/components/Helloworld.tsx

@@ -0,0 +1,5 @@
+function Helloworld(): React.JSX.Element {
+  return <>Helloworld Component</>;
+}
+
+export { Helloworld };

002_source/ionic_mobile/src/components/Wave/index.tsx

@@ -0,0 +1,9 @@
+export const Wave = () => (
+  <svg style={{ marginBottom: '-0.5rem' }} xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1440 320">
+    <path
+      fill="#7a506f"
+      fillOpacity="1"
+      d="M0,288L40,277.3C80,267,160,245,240,224C320,203,400,181,480,176C560,171,640,181,720,181.3C800,181,880,171,960,144C1040,117,1120,75,1200,58.7C1280,43,1360,53,1400,58.7L1440,64L1440,320L1400,320C1360,320,1280,320,1200,320C1120,320,1040,320,960,320C880,320,800,320,720,320C640,320,560,320,480,320C400,320,320,320,240,320C160,320,80,320,40,320L0,320Z"
+    ></path>
+  </svg>
+);

002_source/ionic_mobile/src/data/fields.tsx

@@ -0,0 +1,71 @@
+import { useFormInput } from './utils';
+
+export const useSignupFields = () => {
+  return [
+    {
+      id: 'name',
+      label: 'Name',
+      required: true,
+      input: {
+        props: {
+          type: 'text',
+          placeholder: 'Joe Bloggs',
+        },
+        state: useFormInput(''),
+      },
+    },
+    {
+      id: 'email',
+      label: 'Email',
+      required: true,
+      input: {
+        props: {
+          type: 'email',
+          placeholder: 'joe@bloggs.com',
+        },
+        state: useFormInput(''),
+      },
+    },
+    {
+      id: 'password',
+      label: 'Password',
+      required: true,
+      input: {
+        props: {
+          type: 'password',
+          placeholder: '*********',
+        },
+        state: useFormInput(''),
+      },
+    },
+  ];
+};
+
+export const useLoginFields = () => {
+  return [
+    {
+      id: 'email',
+      label: 'Email',
+      required: true,
+      input: {
+        props: {
+          type: 'email',
+          placeholder: 'joe@bloggs.com',
+        },
+        state: useFormInput(''),
+      },
+    },
+    {
+      id: 'password',
+      label: 'Password',
+      required: true,
+      input: {
+        props: {
+          type: 'password',
+          placeholder: '*******',
+        },
+        state: useFormInput(''),
+      },
+    },
+  ];
+};

002_source/ionic_mobile/src/data/utils.tsx

@@ -0,0 +1,38 @@
+import { useState } from 'react';
+
+export const useFormInput = (initialValue = '') => {
+  const [value, setValue] = useState(initialValue);
+
+  const handleChange = async (e) => {
+    const tempValue = await e.currentTarget.value;
+    setValue(tempValue);
+  };
+
+  return {
+    value,
+    reset: (newValue) => setValue(newValue),
+    onIonChange: handleChange,
+    onKeyUp: handleChange,
+  };
+};
+
+export const validateForm = (fields) => {
+  let errors = [];
+
+  fields.forEach((field) => {
+    if (field.required) {
+      const fieldValue = field.input.state.value;
+
+      if (fieldValue === '') {
+        const error = {
+          id: field.id,
+          message: `Please check your ${field.id}`,
+        };
+
+        errors.push(error);
+      }
+    }
+  });
+
+  return errors;
+};