Files
marqdo/doc/roadmap/ext-web.md
T
cflmyandCursor 027b19c5db feat(web): C4 conditional nav with when and media columns
Filter nav/sidebar/footer by auth/guest/hide and emit responsive media CSS; stamp _logged_in from session on listen.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-04 13:54:53 +08:00

3.6 KiB
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