Visualink!内部功能需求管理系统。
# 构建并启动（第一次约 1-2 分钟）
docker compose up -d --build
# 访问
open http://localhost:8080
# 查看日志
docker compose logs -f
# 停止
docker compose down数据库文件保存在 ./data/app.db，容器重建不会丢失。
go mod tidy # 下载依赖
go run . # 启动，监听 :8080| 角色 | 权限 |
|---|---|
| 产品经理 (pm) | 提交功能、创建功能组、查看全部功能 |
| 开发工程师 (dev) | 查看全部功能、更新状态（待处理→进行中→完成） |
| 路径 | 说明 |
|---|---|
/dashboard |
主看板，含筛选 + 提交表单 |
/features/mine |
我的提交 |
/groups |
功能组列表 + 新建 |
/groups/{id} |
功能组详情 |
PATCH /features/{id}/status |
HTMX 状态更新 |
所见即所得的 Markdown 笔记（Milkdown 编辑器，输入 ## 自动变标题），支持中文全文搜索（SQLite FTS5 trigram）、历史版本、图片/文件附件。
Markdown 兼容 CommonMark + GFM（表格对齐、任务列表、删除线、自动链接），另支持：数学公式 $...$ / $$...$$（KaTeX 自托管渲染，双击编辑源码）、Emoji 短代码（:smiley: → 😃）、YAML front matter、代码块多语言语法高亮（highlight.js 自托管按需加载，29 种常用语言，```go/```py 等标注即生效）；[TOC] 独占一行渲染为文档目录（点击跳转、随标题实时更新，原文保留）；内联 HTML 标签原样保留显示（不渲染执行）。
表格：输入 |3x2| + 空格插入 3 列 2 行表格；光标进入表格时浮出加行/加列/删行/删列/对齐/删表工具条，Tab 在单元格间移动。
编辑页左侧侧栏（Typora 式）：鼠标移到窗口左缘临时探出，顶栏「侧栏」按钮点开常驻（再点关闭，刷新保持）；底部在「文件」（工作区文档列表，公共/私人分组、当前文档高亮）与「大纲」（当前文档目录，点击跳转、实时跟随内容更新）两视图间切换。顶栏另有配色按钮：自动（跟随系统）→ 浅色 → 深色循环切换。
多人同时编辑同一篇笔记，互相实时看到对方的输入和光标（带用户名名牌）。基于 y-sweet（Yjs CRDT 服务器）：
- 部署：
docker-compose.yml已含ysweet服务（数据存./data/ysweet/）。deploy.sh首次部署会自动生成.env（密钥对 + 自动探测的空闲直连端口），无需手动操作；手动生成时：docker run --rm ghcr.io/jamsocket/y-sweet:latest y-sweet gen-auth --json # private_key → .env 的 YSWEET_PRIVATE_KEY（给 y-sweet 的 --auth） # server_token → .env 的 YSWEET_SERVER_TOKEN（给 app 调管理 API） # 另加 YSWEET_PUBLIC_PORT=<空闲端口>（直连模式的宿主端口，默认 8081）
- 鉴权链路：房间 token 由 Go 校验笔记权限后代签、随编辑页直出（前端零额外 round-trip；过期回退
GET /notes/{id}/collab-token）。websocket 有两种模式：- 直连模式（默认，
Y_SWEET_PUBLIC_PORT=8081）：浏览器用访问本服务的同一主机名直连 y-sweet 暴露端口，Go 不在数据路径上——可信内网（ZeroTier）性能优先；裸连仍需有效房间 token（y-sweet 校验） - 反代模式（删掉该 env 即回落）：ws 走
/collab/*反代，多一层登录 session 拦截
- 直连模式（默认，
- 持久化：编辑静默 3 秒后前端把 Markdown 快照回写现有
PUT /notes/{id}（协作模式跳过乐观锁），FTS 搜索/历史版本机制不变；y-sweet 自身也落盘房间状态 - 降级：不配
Y_SWEET_URL环境变量 = 协作关闭，纯阶段一单人模式；配了但 y-sweet 挂掉时，编辑页 8 秒超时自动静默降级单人保存（一个人时状态栏不显示任何字） - 源码/预览与协作：分屏在协作下照常可用——源码栏是共享文档的实时镜像，独自在线时可编辑（写回共享文档），两人及以上自动转只读并提示（防整文覆盖吞掉他人输入），人走后恢复可编辑；标题修改也实时同步
- 登录用户可查看/编辑所有非私有笔记（内网协作场景）
私有笔记仅创建者可见（编辑页右上角勾选）- 删除仅创建者可操作（软删除进回收站，保留 30 天后自动清除；文库页「回收站」入口可恢复或彻底删除）
| 路径 | 说明 |
|---|---|
GET /notes |
笔记列表（最近更新排序 + FTS 搜索框）；条目/新建均在新标签页打开 |
GET /notes/new |
新建空笔记后 302 到编辑页 |
GET /notes/panel |
编辑页左侧面板的文档列表片段（公共/私人分组） |
GET /notes/trash |
回收站视图片段（仅自己删除的笔记，新删在前） |
POST /notes/{id}/recover |
从回收站恢复（回到原分区/原分组，重新可被搜索） |
DELETE /notes/{id}/purge |
彻底删除（连历史版本与附件，不可找回） |
GET /notes/{id} |
WYSIWYG 编辑页（独立标签页、Typora 式极简风格；停顿 2 秒自动保存，乐观锁冲突返回 409） |
GET /notes/{id}/export |
下载 Markdown 原文（.md，文件名用笔记标题）；打印/存 PDF 用编辑页 Ctrl+P |
POST /notes/{id}/favorite |
收藏开关（按用户各记各的）；文库置顶显示，侧栏顶部「收藏」快捷分区 |
GET /notes/{id}/history |
历史版本弹层（正文变化且距上次快照 >5 分钟才产生新版本，每篇最多 100 条） |
GET /notes/{id}/revisions/{rid}/diff |
该版本与上一版本的行级对比（增/删着色，长段未改动折叠） |
POST /notes/{id}/restore/{rid} |
恢复到某版本（当前内容先自动存为一条版本） |
POST /notes/{id}/attachments |
附件上传（≤20MB，扩展名白名单），存 ./data/attachments/{note_id}/ |
GET /attachments/{note_id}/{name} |
附件下载（需登录，私有笔记附件外人不可见） |
编辑器岛用 esbuild 打包，产物为 static/notes-editor.js（已提交入库，改动源码后需重新构建）；构建同时把 KaTeX 的 CSS/字体从 node_modules 复制到 static/vendor/katex/（自托管，内网可用）。编辑页样式是手写的 static/css/notes-editor.css，不经打包：
cd web/notes-editor
npm install # 首次
npm run build # 输出到 ../../static/- Docker 构建（
docker compose up -d --build）内置 node 构建阶段，会自动重新打包，无需本地构建 Dockerfile.prebuilt快速部署路径直接 COPY 仓库里的static/，改过编辑器源码时记得先在开发机npm run build并提交产物- 服务启动时会对
notes-editor.js计算内容 hash 做缓存版本号（同bundle.js机制），改版后无需手动清缓存