已开启
[讨论] 项目可行性技术方向论证:基于 origin/main 代码结构与实测数据 #5
雅皮士创建于 15 天前
雅皮士
15 天前 评论:
15 天前 评论:
生产化改造拆分索引
由本讨论拆出的 3 个可独立跟踪的 Issue:
- #6 [Security][P1] 鉴权与授权体系(AuthN/AuthZ)
- #7 [Security][P1] HTTPS 传输安全
- #8 [Observability][P2] 可观测性(日志/指标/告警)
建议落地顺序:#6(鉴权)→ #7(HTTPS,与会话凭证配套)→ #8(可观测性)。


项目可行性技术方向论证
一、结论摘要
本项目(HarmonyOS ArkTS 端侧 + Appwrite 自托管 Serverless 云侧)在教学演示 / 中小规模个人应用定位下技术可行:
生产级可行性尚缺三项工程化能力:鉴权、HTTPS、可观测性——属工程增补,非架构不可行。
二、可验证数据基线
.etsgit ls-tree+wc -lmain.jswc -lwc -lgrep -c createStringAttribute等grep -cE '^\s*\{ word:'wc -lls -l三、技术方向可行性(论点 + 证据)
3.1 架构可行性
App → POST /v1/functions/{id}/executions → Function → NoSQL → responseBody;HttpUtil.ets89 行统一封装,客户端不持有数据库凭据(代码结构可验证)。3.2 工具链可行性(已实测)
hvigorw assembleHap:BUILD SUCCESSFUL(SDK 26 环境,临时移除compileSdkVersion(24)后构建)。node --check:6 个云函数全部通过。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 性能可行性
3.5 安全可行性(边界明确)
execute=["any"]为演示态公开访问,db-init可被匿名调用(代码可验证:deploy.py 中"execute": ["any"])。execute=["users"]+ 越权校验 + 限流 + HTTPS)为生产门槛。3.6 一致性可行性
2026-11-06→ UTC[2026-11-05T16:00Z, 2026-11-06T16:00Z)。LocalStorage.getShared()为窗口级内存,重启丢失 → PR #5 改 Preferences + 冷启动路由。10→ PR #3 改DAILY_GOAL环境变量。3.7 可维护性与演进
if/else→Map配置(PR #6),并补网络重试与配置校验。mergeable=True,改动区域互不重叠,证明可增量演进。四、风险矩阵(证据驱动)
runtime=node-16.0;node-appwrite ^11limit(500)/limit(200)execute=["any"]toISOString()UTC 日期LocalStorage.getShared()五、演进路线
六、结论
七、数据复现命令
# 端侧行数 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:'