Update multiple markdown files with project guidelines, tasks, and database handling instructions

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

@@ -0,0 +1,11 @@
+# Greetings
+
+Hi,
+Imaging 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`,
+it provides background information of project i want you to help.
+
+thanks

000_AI_WORKSPACE/software-engineer/greetings/002_guideline.md

@@ -0,0 +1,32 @@
+# guideline
+
+## principles
+
+- at any time, please keep your answer, solution, explaination simple and short (K.I.S.S. or 大道至簡)
+- please divide the problem into small parts
+- if you found youself cannot understand the problem, please stop and ask how to do
+- if you found youself cannot solve the problem, plesae stop and ask how to do
+- review the whole solution before you reply to user
+- if code syntax is already there, do follow (e.g. naming convention, syntax) the existing code
+- no need to explain the reason until you are told to do so
+- no need to show me the code change, at the end just simple summary in point form is ok
+
+## highlighted project directories and their meanings
+
+- `_ignore_this_directory` please ignore this directory and any files inside it
+
+- `001_documentation` documentation of this project
+- `002_source` source code of this project
+- `002_source/cms` home of Context management system of this project
+  - use singular form for `src/components/dashboard` (e.g. `src/components/dashboard/student`)
+  - use plural form for `src/app/dashboard` (e.g. `src/app/dashboard/students`)
+- `002_source/ionic_mobile` home of mobile client of this project
+- `002_source/pocketbase` home of pocketbase home directory this project
+- `003_test` e2e test of this project (not yet implemented)
+- `004_marketing` marketing page of this project (not yet implemented)
+- `005_references` opensource refence of this project
+- `006_lab` my test (POC) of this project
+- `README.md` Readme of this project
+- `TODO.md` todo list of this project
+
+- if the directory contains `_GUIDELINES.md`, please read it before operation

000_AI_WORKSPACE/software-engineer/greetings/003_knowledgebase.md

@@ -0,0 +1,12 @@
+# Knowledgebase
+
+you can answer the question with below knowledge:
+
+## frameworks and stacks
+
+- if code syntax is already there, do follow (e.g. naming convention, syntax) the existing code
+- make use of MCP `Context7` when you troubleshoot the problem with below topics:
+  - [pocketbase javascript SDK](https://context7.com/pocketbase/js-sdk/llms.txt)
+  - [DBML](https://context7.com/holistics/dbml/llms.txt)
+  - [ionic framework](https://context7.com/ionic-team/ionic-framework/llms.txt)
+  - [nextjs 14 app router](https://context7.com/nextjsargentina/next.js-docs/llms.txt)

000_AI_WORKSPACE/software-engineer/greetings/010_FAQ.md

@@ -0,0 +1,22 @@
+# FAQ
+
+Q: where is `dbml` file ?
+A: dbml file located in `/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project/001_documentation/Requirements/REQ0006/schema.dbml`
+
+Q: when file not found, do i need to search it in `_ignore_this_directory` ?
+A: No, you just stop there and voice out.
+
+Q: Shall I assume the component is already exist ?
+A: yes, you can assume that
+
+Q: Is `COL_USER_METAS` the collection for User related (e.g. `Teacher`, `Student`) collections?
+A: yes
+
+Q: Shall I verify `import` or `types` when do modification job ?
+A: No, you just replace the name of the function, variables etc is ok. no need to check for dependencies thanks.
+
+Q: how to list files with `.tsx.draft` extensions in `src/db/UserMetas` folder?
+A: using command like `find src/db/UserMetas -name "*.tsx.draft" -type f -ls` to list the files with `.tsx.draft` extendions only exist in `src/db/UserMetas`
+
+Q: when user want to modify `.tsx.draft` file, do i need to take care the `.tsx` file as well?
+A: No, no don't need to, user will handle the remaining modifications. please restrict your modification in the mentioned file or directory only.

000_AI_WORKSPACE/software-engineer/greetings/013_DB.md

@@ -0,0 +1,39 @@
+# database and schemas
+
+## getting started
+
+Imagine there is a:
+
+1. developer (provide the modification)
+2. QA engineer (provide the feedback, and testing)
+3. software engineer
+4. technical writer
+
+they will:
+
+- conclude and integrate the ideas from developer and QA engineer
+- make decision to modify the code accordingly.
+
+## project background and initial setup
+
+- **IMPORTANT**: No need to reply me what you are going on and your digest in this phase.
+  No need to show me your code plan
+  Just reply me "OK" when done
+
+- base_dir=`/home/logic/_wsl_workspace/001_github_ws/lettersoup-online-ws/lettersoup-online/project`
+
+- `schema.dbml`
+  - read `<base_dir>/001_documentation/Requirements/REQ0006/schema.dbml`
+    this is file in `dbml` format stating the main database structure
+
+- `schema.json`
+  - read `<base_dir>/002_source/cms/src/db/schema.json`
+    this is the file of current pocketbase schema
+
+- look into the md files in folder `<base_dir>/002_source/ionic_mobile/_AI_WORKSPACE/001_guideline`
+
+- if the directory user provided contins `_GUIDELINES.md`, please read the file
+
+- read the files, remember and link up the ideas in file stated above,  i will tell them the task afterwards
+
+- please review at least 3 times after you modified the code