update,

task1/_doc/001_REQUIREMENTS/REQ001-resources-file/index.md

@@ -0,0 +1,54 @@
+# REQ001-resources-file
+
+schemas
+
+- lesson
+
+path: `src\data\Lesson\vocabulary`
+
+```
+vocabulary
+    Technology
+        images
+        sounds
+        01.json
+            [
+              {
+                image: 'helloworld.jpg',
+                sound: 'helloworld.mp4',
+                word: 'keyboard',
+                word_c  : '鍵盤',
+                sample_e : "I buy a keyboard to type",
+                sample_c : "我買個鍵盤打字",
+              },...
+            ]
+        02.json
+        03.json
+        ...
+    Connectives
+        images
+        sounds
+        01.json
+        02.json
+        03.json
+        ...
+```
+
+- quizzes
+
+  - listening_practice
+  - matching_frency
+  - connective_revision
+
+- record
+
+  - matrix_title
+    - Genius
+    - hard worker
+    - attentive ears
+    - matchmarking
+    - connectives conqueror
+  - matrix_value
+
+- user_config
+  - favourite vocabulary

task1/_doc/001_REQUIREMENTS/REQ0011-splash-screen/index.md

@@ -0,0 +1,23 @@
+---
+tags: app-icon
+---
+
+## Description
+
+icon wanted
+
+![alt text](icon_wanted.jpeg)
+
+then look into `C:\_workspace\004_carousell\_lettersoup\source\mobile\android\app\src\main\res\drawable\splash.png`
+to see if image file updated
+
+## Ref
+
+https://ionicframework.com/docs/native/splash-screen
+https://capacitorjs.com/docs/cordova/migrating-from-cordova-to-capacitor#splash-screens-and-icons
+
+```bash
+# command to update splash screen
+$ npm run update_splash
+$ npm run update_app_icon
+```

task1/_doc/001_REQUIREMENTS/REQ002-user-config-store/index.md

@@ -0,0 +1,9 @@
+# REQ002-user-config-store
+
+The user configuration store is a file that stores user settings.
+
+## references
+
+- [](https://capacitorjs.com/docs/apis/filesystem)
+
+with key in `localStorage` `user_config`

task1/_doc/001_REQUIREMENTS/REQ003-lesson/notes.md

@@ -0,0 +1,35 @@
+---
+tags: lesson
+---
+
+# lesson
+
+![alt text](Code_hTwMlUr1kx.png)
+
+```jss
+filename: /data/Lesson/lesson_categories.json
+
+lesson_categories = [
+    {"name": "vocabulary","path": "vocabulary"},
+    {"name": "Connectives","path": "connectives"},
+    ...
+]
+
+filename: /data/Lesson/category_content.json
+category_content = [{
+    "Technology": {
+        "category": "vocabulary",
+        "content": [
+            {
+                "image": "helloworld.jpg",
+                "sound": "helloworld.mp4",
+                "word": "keyboard",
+                "word_c"  : "鍵盤",
+                "sample_e" : "I buy a keyboard to type",
+                "sample_c" : "我買個鍵盤打字",
+            },...
+        ]
+
+    }
+}]
+```

task1/_doc/001_REQUIREMENTS/REQ007-Quiz-connectives-revision/notes.md

@@ -0,0 +1,9 @@
+---
+tags: connectives-revision
+---
+
+# NOTES
+
+![alt text](Code_iicadVWFqE.png)
+
+the question page content waiting to be refactored.

task1/_doc/001_REQUIREMENTS/REQ008-Record/notes.md

@@ -0,0 +1,5 @@
+---
+tags: record
+---
+
+# notes

task1/_doc/001_REQUIREMENTS/REQ010-lesson-connective/notes.md

@@ -0,0 +1,2 @@
+![alt text](Code_X4DSfTv7Kb.png)
+![alt text](Code_njUX4m6pJK.png)

task1/_doc/digest/index.md

@@ -0,0 +1,207 @@
+# 香港 DSE 英语学习 APP 需求
+
+## 目标
+
+- 学习英文词语,聆听单字,句子模式
+- 鼓励学习,培养习惯
+
+---
+
+### 主页(Quiz)
+
+![alt text](image.png)
+
+### 課程(Lesson)
+
+![alt text](image-1.png)
+![alt text](image-2.png)
+
+1. 学生可拣选不同温习范围: 词语&连接词 (用屏幕上方前后按钮)
+
+### 词语页面
+
+![alt text](image-3.png)
+![alt text](image-4.png)
+
+2. 按相片就能更深入了解, 学生可以阅读每个词汇
+
+(以上是按了 Vocabulary → Technology 部分)
+學習卡可以見到:
+词语部分标题
+
+![alt text](image-5.png)
+
+前一个 : 回去上一个词语页面
+
+![alt text](image-6.png)
+
+下一个 : 去下一个词语页面
+
+![alt text](image-7.png)
+
+图片
+
+![alt text](image-8.png)
+
+词语号码
+
+![alt text](image-9.png)
+
+英文单词  
+中文翻译 (鍵盤)
+词语读音 ![alt text](image-10.png)
+加入我的最爱心形按钮 ![alt text](image-11.png) : 加入我的最爱心形按钮按完会变红色(已加入), 再按一次变无色(已移除), 我的最爱词语集会在”我的纪录”中显示
+英文例句 ![alt text](image-13.png)
+中文例句 ![alt text](image-14.png)
+
+### 连接词页面
+
+![alt text](image-15.png)
+
+连接词部分标题 ![alt text](image-16.png)
+部分标示 ![alt text](image-17.png)
+前一个![alt text](image-18.png) : 回去上一个词语页面
+下一个 ![alt text](image-19.png) : 去下一个词语页面
+加入我的最爱心形按钮![alt text](image-20.png) : 加入我的最爱心形按钮按完会变红色(已加入), 再按一次变无色(已移除), 我的最爱连接词集会在”我的纪录”中显示
+连接词 ![alt text](image-21.png)
+中文翻译
+英文例句 ![alt text](image-22.png)
+例句读音 ![alt text](image-23.png)
+中文例句 ![alt text](image-24.png)
+
+### 聆听练习
+
+![alt text](image-25.png)
+
+0. 学生按 Listening Practice 按钮
+
+![alt text](image-26.png)
+
+1. 选择练习的内容(可以复选: 练习题目在 Lesson 里面)
+
+![alt text](image-27.png)
+
+2. 按了的选择会变绿色
+
+![alt text](image-28.png)
+
+3. 练习开始, 学生要聆听答案三选一
+4. 按了的选择会变绿色
+5. 选对答案会有一个 pop-up 从下面弹出来 (e.g. Good job!)
+6. 每次答对一条, 上面的进度条也会充满一格
+
+![alt text](image-29.png)
+
+7. 选错答案会有一个 pop-up 从下面弹出正确答案 (e.g. The correct answer: Keyboard)
+8. 每次答错一条, 上面的进度条不会前进
+
+![alt text](image-30.png)
+
+(以上是有两条错题的情况)
+
+9. 学生做到最后时, 要把当次练习中错过的题目再做一次, 要全部改对了才可以完成练习(标题会出现改正”Correction”字眼)
+
+![alt text](image-31.png)
+
+10. 完成页面:
+    测验 logo
+    测验范围名称(如有复选请列明全部)
+    Well Done!加油字句
+    显示答对率和星星奖励
+    一颗星: 答对率 1-49%
+    两颗星: 答对率 50-79%
+    三颗星: 答对率 80-100%
+
+注意: 跳离页面会导致练习重新设置
+
+### 配对狂热
+
+![alt text](image-32.png)
+
+1. 学生按 Matching Frenzy 按钮
+2. 选择练习时步驟和聆听练习一样(上面 logo 要跟着转)
+
+![alt text](image-33.png)
+
+![alt text](image-34.png)
+
+3. 在有限时间内(2 分钟)学生需要配对词语意思
+4. 左上角有计时器显示剩余分钟和秒数
+5. 右上角显示已正确配对次数
+6. 按了的选择会变绿色
+7. 选对答案会有一个 pop-up 从下面弹出来 (e.g. Good job!), 已正确配对次数+1
+
+8. 选错答案会有一个 pop-up 从下面弹出正确答案
+
+![alt text](image-35.png)
+
+当时限已到会显示以上画面(由上之下):
+测验 logo
+测验范围名称(如有复选请列明全部)
+Well Done!加油字句
+总共已正确配对次数
+分数排行榜: 显示日期(左)和已正确配对次数(右)
+
+- 只紀錄最高分三次
+
+### 连接词复习
+
+![alt text](image-36.png)
+
+![alt text](image-37.png)
+
+1. 学生按 Connectives Revision 按钮
+2. 传送至下一个页面选择测验(每次只可选择一个, 不能覆选)
+
+- 每个测验右面会显示目前最高分数(未做过的或全部做错会显示 0%)
+
+3. 一按下便会直接传送到测验内容
+
+![alt text](image-38.png)
+![alt text](image-39.png)
+![alt text](image-40.png)
+
+4. 练习开始, 学生要聆听答案三选一
+5. 按了的选择会变绿色
+6. 选对答案会有一个 pop-up 从下面弹出来 (e.g. Good job!) 7. 每次答对一条, 上面的进度条也会充满一格
+7. 选错答案会有一个 pop-up 从下面弹出正确答案 (e.g. The correct answer: Keyboard)
+8. 每次答错一条, 上面的进度条不会前进
+9. 学生做到最后时, 要把当次练习中错过的题目再做一次, 要全部改对了才可以完成练习(标题会出现改正”Correction”字眼)
+
+### 我的记录(Record)
+
+![alt text](image-41.png)
+
+| 成就           | 说明                                 | 里程碑                                              |
+| -------------- | ------------------------------------ | --------------------------------------------------- |
+| Genius         | 计算所有练习分数获得满分的次数       | 1/10/50/100/300/700/1000 次                         |
+| Hard Worker    | APP 非静止使用时间                   | 5/50/100/500/1000/1500/3000 分钟                    |
+| Attentive Ears | 聆听练习部分已完成练习内聆听音档时长 | 1/10/50/100/300/700/1000 分钟                       |
+| Matchmaking    | 配对狂热所有正确配对次数总和         | 30/100/250/500/1500/3000/8000 次                    |
+| Connectives    | Conqueror                            | 连接词复习完成练习和取得 100 分次数 1/5/15/35/60 次 |
+
+![alt text](image-42.png)
+
+使用进度条上的小标记里程碑显示进度
+
+![alt text](image-43.png)
+![alt text](image-48.png)
+
+达到里程碑的时候会立即显示以上小视窗
+按 x 关闭视窗
+(配对狂热期间显示的话会暂停计时器, 按 x 关闭视窗后会继续计时)
+
+![alt text](image-44.png)
+
+最后部分显示已加入最爱的词语和连接词
+按下后可以每个字再次重温(学生亦可以在这里再按一次心形按钮直接移除最爱)
+
+![alt text](image-45.png)
+![alt text](image-46.png)
+![alt text](image-47.png)
+
+移除前要显示视窗再次询问: 您确定要从收藏列表中删除*‘键盘’*吗？
+按 Yes: 显示已成功移除, 移除所选择词语
+按 No: **关闭**询问视窗
+
+--- end ---