已开启
[讨论] 项目可行性技术方向论证:基于 origin/main 代码结构与实测数据 #5
雅皮士创建于  15 天前
雅皮士
雅皮士
15 天前 创建

渠道说明:GitCode 讨论区(Discussions,/api/v1/discuss)目前仅接受 Web 会话 Cookie,Bearer token 被拒绝(token无效/401),无法通过 API 创建讨论帖。故以 Issue 形式发起本次讨论,待讨论区 API 开放后迁移。本 Issue 不针对具体代码缺陷,欢迎就技术方向本身展开讨论。


项目可行性技术方向论证

数据快照:origin/main(commit 7f39645)。所有数字均可通过文末「数据复现命令」在本地复算,非估算值。

一、结论摘要

本项目(HarmonyOS ArkTS 端侧 + Appwrite 自托管 Serverless 云侧)在教学演示 / 中小规模个人应用定位下技术可行:

  • 端侧 1343 行、云侧 586 行即可闭环「4 页面 + 6 云函数 + 3 集合」;
  • 命令行工具链可完整构建(实测产出 HAP 293,912 bytes);
  • 已识别的核心链路缺陷与一致性问题均有对应修复方案(已提交 7 个 PR)。

生产级可行性尚缺三项工程化能力:鉴权、HTTPS、可观测性——属工程增补,非架构不可行。

二、可验证数据基线

维度 数据(origin/main) 复现方式
端侧代码 1343 行 / 13 个 .ets git ls-tree + wc -l
云侧代码 586 行 / 6 个 main.js 同上
页面 Login 178 / Home 242 / Flashcard 285 / Quiz 347 行 wc -l
公共层 HttpUtil 89 行 / Models 91 行 / EntryAbility 74 行 wc -l
数据模型 3 集合 / 13 String 属性 / 2 Integer 属性 / 2 索引 grep -c createStringAttribute 等
词库 58 条(WORDS_SEED) grep -cE '^\s*\{ word:'
部署脚本 deploy.py 285 行(仅标准库) wc -l
依赖 node-appwrite ^11.0.0;compileSdkVersion 6.1.1(24) package.json / build-profile.json5
构建产物 entry-default-unsigned.hap(293,912 bytes) ls -l

三、技术方向可行性(论点 + 证据)

3.1 架构可行性

  • 云侧 6 函数职责单一,单文件 59–187 行;端侧 4 页面 178–347 行,无单文件 >400 行,维护半径可控。
  • 数据流单向:App → POST /v1/functions/{id}/executions → Function → NoSQL → responseBody;HttpUtil.ets 89 行统一封装,客户端不持有数据库凭据(代码结构可验证)。
  • 结论:函数粒度为「用例级」,与 Serverless 模型匹配。

3.2 工具链可行性(已实测)

  • hvigorw assembleHap:BUILD SUCCESSFUL(SDK 26 环境,临时移除 compileSdkVersion(24) 后构建)。
  • node --check:6 个云函数全部通过。
  • deploy.py 285 行仅用 Python 标准库(urllib/tarfile),无第三方依赖。
  • 唯一约束:SDK 版本需匹配(24 vs 26 实测冲突),属配置问题而非代码问题。

3.3 数据模型可行性

  • 3 集合:users_col / words_col / learn_records_col;13 String + 2 Integer 属性;索引 idx_email、idx_user_word。
  • 主键为字符串 $id;登录按 email、学习记录按 (userId, wordId) 查询,均命中索引。
  • 边界:原查询 limit(500) / limit(200) 在数据增长后会静默截断 → 已用分页方案验证可修复(PR #4)。

3.4 性能可行性

  • 当前 58 词规模、单次取 10 词;分页方案将安全上限提升到 10,000 条。
  • Serverless 冷启动延迟存在,但学习类应用非高频实时场景,可接受。
  • 结论:当前规模性能充足,增长路径清晰(分页 + 索引)。

3.5 安全可行性(边界明确)

  • execute=["any"] 为演示态公开访问,db-init 可被匿名调用(代码可验证:deploy.py 中 "execute": ["any"])。
  • 密码 PBKDF2-SHA256(10000 轮 / 64 字节)在 register / login / db-init 三处一致,非半成品实现。
  • 已提 PR #2 提供 ADMIN_TOKEN 渐进保护;完整鉴权(execute=["users"] + 越权校验 + 限流 + HTTPS)为生产门槛。

3.6 一致性可行性

  • 时区:原用 UTC 计算「今日」,UTC+8 用户 00:00–08:00 记录错日 → PR #3 改为时区边界,单点验证:本地日 2026-11-06 → UTC [2026-11-05T16:00Z, 2026-11-06T16:00Z)。
  • 登录态:原 LocalStorage.getShared() 为窗口级内存,重启丢失 → PR #5 改 Preferences + 冷启动路由。
  • 每日目标:原 3 处硬编码 10 → PR #3 改 DAILY_GOAL 环境变量。

3.7 可维护性与演进

  • HttpUtil 的 6 分支 if/else → Map 配置(PR #6),并补网络重试与配置校验。
  • 页面业务逻辑抽离为 ViewModel(PR #7),Login 逻辑行数 178 → 136。
  • 7 个 PR 当前均 mergeable=True,改动区域互不重叠,证明可增量演进。

四、风险矩阵(证据驱动)

风险 证据 缓解 状态
运行时锁 node-16 deploy.py runtime=node-16.0;node-appwrite ^11 锁版本 + 默认导入 PR #1
查询截断 limit(500) / limit(200) 分页 PR #4
匿名调用 execute=["any"] ADMIN_TOKEN / 完整鉴权 PR #2(部分)
明文传输 仅 80 端口(README 边界说明) HTTPS 反代 待办
时区错乱 toISOString() UTC 日期 时区边界 PR #3
登录态丢失 LocalStorage.getShared() Preferences PR #5

五、演进路线

  1. P0 修复:SDK 导入兼容(PR #1)
  2. 安全加固:ADMIN_TOKEN → 会话鉴权 → HTTPS → 限流
  3. 一致性:时区、登录态(PR #3 / #5)
  4. 架构分层:HttpUtil、ViewModel(PR #6 / #7)
  5. 质量保障:单元测试(需 IDE/设备运行)、可观测性

六、结论

  • 教学 / 中小规模:技术方向成立,现有代码已具备可运行、可部署、可演进条件。
  • 生产级:需补鉴权、HTTPS、可观测性,属工程化增补而非重构。
  • 建议以现有 7 个 PR 合并为起点,按上述路线推进。

七、数据复现命令

# 端侧行数
git ls-tree -r --name-only origin/main -- harmony_app/entry/src/main/ets \
  | grep '\.ets$' | xargs -I{} sh -c 'git show origin/main:{} | wc -l'

# 云侧行数
for f in $(git ls-tree -r --name-only origin/main -- harmony_cloud/functions \
  | grep 'main.js$' | grep -v node_modules); do git show origin/main:$f | wc -l; done

# 词库条目数
git show origin/main:harmony_cloud/functions/db-init/main.js | grep -cE '^\s*\{ word:'
likedislike
雅皮士
雅皮士
15 天前 评论:

生产化改造拆分索引

由本讨论拆出的 3 个可独立跟踪的 Issue:

建议落地顺序:#6(鉴权)→ #7(HTTPS,与会话凭证配套)→ #8(可观测性)。

likedislike