Files
marqdo/doc/roadmap/ext-web.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

3.8 KiB
Executable File
Raw Blame History

官方扩展:ext/web 实现路线图

状态 W0–W7 + P3 完结(审计/RBAC/相册/ETag/外键已落地)
日期 2026-08-28
锁定设计 design/ext-web.md
相关 ext-cli.md · ext-abi.md · ext-llm.md
安装 marqdo ext add web(web / 网页)

本文只跟踪实现阶段。类模型、赋值绑定、后台、.env、异步边界、ABI 名等以设计文为准。


1. 目标回顾(一句)

表格完成动态站:页面表拼组件、组件表绑库与样式、样式表定外观;热路径进 ABI 插件;可选 S3 / Redis。人写目标见设计 §0.1 与 examples/man-write-site/。


2. 落地阶段

阶段 内容 状态
W0 CATALOG + L1 + web_listen Hello done
W1 env 端口;page 四栏;nav 表;static done
W2 SQLite define/migrate/all done
W3 三列绑定;变量名即表名;/admin CRUD+日志+布局 done
W3s 安全硬化:argon2 密码哈希、CSRF、SQLite 会话持久化、CSPRNG、登录限速 done
W3.5 人写面首版:web.assemble + `表`.`字段` + examples/man-write-site done(编排袋仍可再瘦)
W4 Postgres;Redis / S3 驱动(见 ext-web-drivers.md) done
W4c 内容标配:SEO / Markdown / RSS / 分页 UI(见 web-net-capabilities.md) done
W5 上传与媒体:multipart 接收 + 落盘 + 下载(见 web-net-capabilities.md A5) done
W6 迁移 + FTS5 搜索;草稿/评论用既有 where/表;WS 广播 + 访问日志 done
W7 Cache-Control / 404·500 / 重定向 / sitemap·robots / init 唯一·索引 / HTTPS 反代说明 done
P3 审计时间戳 / 外键 / RBAC / 相册 / ETag done

定制波次(规划中)

自研后台 / 主题 / 响应式踩坑见 ext-web-customization-limits.md;解法索引 ext-web-customization/。

波次 内容 状态
C0 admin 关则不占路径;admin_prefix / 登录回跳可配 done
C1 gate 匹配与未登录策略一致;段边界默认 admin gate done
C2 shell_css + layout 松绑 done
C3 样式 strict / 脚本 defer·version done
C4 条件导航 when/media(layout 见 C2) done

验收金样:tests/ext/web-smoke.mq.md、tests/ext/web-security-smoke.mq.md、tests/ext/web-drivers-smoke.mq.md、tests/ext/web-upload-smoke.mq.md、tests/ext/web-db-w6-smoke.mq.md、tests/ext/web-w7-finish-smoke.mq.md、tests/ext/web-p3-smoke.mq.md、ext_cli_add_web。


3. 已收敛的原开放点

原疑问 锁定结论(见设计文)
listen 阻塞 vs 后台任务 # main 内 listen 同步阻塞;插件内部异步
handler 形态 不主推手写 REST;表 href + bind + 自动后台
marqdo web 子命令 scaffold 经 web.scaffold;marqdo web new 可后续补
Windows + SQLite 路径用 DATABASE_URL

4. 与其它文档

文档 关系
design/ext-web.md 真理
user-site.md 静态站互补
ext-quantum.md 同属官方 ext + ABI + ext add
ext-hosting.md · ext-hosting-gaps.md W/C 之后:同域 SSE 中继、HTTP→##(不重开本表 W0–W7)