logan
2c0bfafd8d
- 补入库：server/internal/db/dump.go、redis 分页/扫描预算测试、opsxdb-mcp main_test、 packages/opsxdb-mcp package-lock、docs 审计与对比文档等 37 个新文件 - 含结构扁平化进行中的 80 处修改与 155 处旧结构删除（server/ src/ src-tauri/ 为当前有效源） - 构建产物（bin/target/dist）与签名私钥仍按规则排除
1.8 KiB
1.8 KiB
OpsxDB 开发指南
数据库桌面客户端（连接 / SQL 工作台 / AI 写 SQL）。请使用中文沟通。
产品形态（硬边界）
浏览器 → 只看官网 + 文档（Gin :8788）
操作 → 只走桌面 Tauri（./run.sh gui）
src (:5174) → 仅桌面 Vite 源 / 打包 frontendDist，不是浏览器产品
- 不要把工作台做成浏览器 SaaS，或把
:5174当对外入口。 - Gin（
server）= 官网 / docs / health / 驱动相关 API；不是「远程多人协作后端」。 - 连接与查询数据默认在本机；密钥与连接串按现有桌面安全实践处理。
同族：opsxapi 同形态；opsxshell 同样「浏览器=官网/docs，操作=桌面」（Gin 在 server，无操作 API，原生全在 Rust）。
架构
src/ → React 桌面 UI / 本机 API
src-tauri/ → Tauri 2 壳
server/ → Gin 官网 + docs + 驱动 API
connection-types/ → 引擎注册表（ready / verified / notes）
agents/ → JDBC agent 桥（Java 单文件桥 + 协议文档；Go 侧在 server/internal/db/agent.go）
改驱动能力：先动注册表与 server/src-tauri 对应路径，再补 UI；未 ready 的引擎界面须灰态，勿标成可用。
怎么跑
npm install
./run.sh web # 仅官网 + docs → :8788
./run.sh gui # 桌面（推荐）
./run.sh stop | status | restart
改 server 后需重编（./run.sh restart）。清单与验收见 docs/BACKLOG.md。
给 AI
- 沿用根级 src / src-tauri / server 架构，勿重建 apps 或第二套客户端；homepage 保持独立。
- 需求清楚就直接改；细节以邻近代码与 BACKLOG 为准，不必先扩写长规范。
- 少加「仅 AI 可读」的重复文档；用户可见文案与 docs 内容保持同步即可。