1778c5ac7b
refactor(tracing): remove Jaeger integration and related components
...
This commit removes Jaeger tracing support from the project, including the associated Docker configurations, Go modules, and middleware. The changes simplify the codebase by eliminating unused tracing functionality, which was previously integrated for observability. Documentation and scripts have also been updated to reflect the removal of Jaeger references.
2026-06-08 21:01:04 +08:00
7ebb29cd3e
docs: add Chinese RBAC guide and link with shared space docs
...
Replace the English docs/rbac.md with a comprehensive Chinese
docs/RBAC说明.md and a wiki-style summary under docs/wiki/安全认证/.
Explain how tenant RBAC relates to the shared space feature (they
are orthogonal: tenant RBAC is the vertical defense, shared space
is the horizontal collaboration channel) and cross-link the two
docs in both the flat and wiki trees. Update inbound references in
.env.example, docker-compose.yml, and the auth legacy env test to
point at the new file name.
2026-05-21 12:28:31 +08:00
c8b2129853
docs(api): restore auth.md and update README/wiki links
...
Fixes #958 .
- 新建 docs/api/auth.md：覆盖 10 个 /auth/* 端点
register / login / oidc 三件套（config/url/callback）/ refresh /
validate / logout / me / change-password。
说明各端点的鉴权方式（无 / refresh_token / Bearer JWT），并对齐
/auth/oidc/callback 的真实行为（始终 302 跳到 / 并把结果编码进
URL hash）。
- docs/api/README.md：
- 增加"最权威参考：Swagger UI"段落，引导读者优先访问
/swagger/index.html（swagger 由 swag 注解自动从代码生成）。
- "认证管理"行链接由仅指向 OIDC 流程文档改为同时指向 auth.md
与 OIDC 流程文档。
- 新增 "IM 渠道" 行指向 docs/IM集成开发文档.md。
- 新增 "数据源导入" 行指向 docs/数据源导入开发文档.md。
- docs/wiki/API参考/API文档概览.md：随 api/README.md 的"认证管理"
行同步更新即可——IM 与数据源在该文件原有的"相关主题"/"反向链接"
小节已经登记，不在 "API 分类" 表中重复。
2026-05-12 13:16:58 +08:00
02be05c095
feat: support Tencent VectorDB keyword retrieval
2026-05-10 00:02:05 +08:00
74b1342440
feat: add Tencent VectorDB retriever backend
2026-05-09 13:14:01 +08:00
fc6f160eff
fix(retriever/doris): code review cleanup
...
针对 4cce6f2e（接入 Apache Doris）的 code review 修复，主要修正若干阻断性
问题与可读性问题，并剔除不应进入主仓的本地工作流文件。
阻断性修复：
- docker-compose: Doris 镜像由 2.1.0 升至 4.1.0。原 2.1.0 不支持 HNSW
ANN、cosine_distance_approximate 与 Stream Load partial_columns，
按当前 DDL 一启动就会失败。
- DSN 字面量拼接改用 mysql.Config.FormatDSN()。原 fmt.Sprintf 在用户名/
密码包含 `@`/`:`/`/` 等字符时会跑偏。覆盖 health check 与 engine
factory 两处。
健壮性修复：
- 新增 validateEmbedding，写入与查询前拒绝 NaN/±Inf；strconv.FormatFloat
对非有限值会输出 "NaN"/"+Inf" 拼成无效 SQL。
- waitANNReady 改为后台 goroutine + 独立 context，避免新维度首次写入路径
阻塞最长 30s；ANN 未就绪时 Doris 会自动退化为 brute-force。
清理：
- annIndexReady 移除最终两个分支都 return true 的冗余写法。
- Save 移除冗余的双重 toDorisVectorEmbedding。
- testDorisConnection 把 "5.7.99 Doris-4.1.0" 解析为裸 "4.1.0"，与
Postgres/ES 的版本格式对齐。
剔除（不应合入主仓）：
- docs/wiki/集成扩展/Doris改动与上游同步.md：纯 fork 维护工作流文档。
- scripts/e2e-doris.sh：作者本地 E2E 验证清单。
测试：
- repository_test 用 require.Eventually 适配 ANN 异步轮询。
- 现有 doris 单测全部通过。
2026-05-09 00:31:03 +08:00
4cce6f2e99
feat(retriever): 接入 Apache Doris 4.1 作为向量数据库
...
为 RetrieveEngine 体系新增 Doris 后端，与现有 Qdrant/Milvus/Weaviate
等保持完整能力对齐：向量检索、关键词检索、健康检查、环境变量与多实例
DB 配置、前端类型注册、单元测试、Docker Compose 模板。
实现要点：
- 协议分工：主链路用 MySQL 协议（database/sql + go-sql-driver/mysql）
做 DDL / 查询 / 删除；批量更新走 Stream Load HTTP API，并启用
partial_update=true、merge_type=APPEND，自动按 1MiB 切分批次并处理
307 重定向。
- 表结构：UNIQUE KEY(id) + enable_unique_key_merge_on_write=true 以
支持 upsert/部分列更新；按维度分表（<base>_<dim>），每张表上建
HNSW ANN 索引（metric_type=cosine_distance）和 INVERTED 索引
（parser=chinese）。
- 分数语义：使用 cosine_distance_approximate，再以 1 - dist 转换为
"越大越相似"，与现有 KVHybridRetrieveEngine 约定一致。
- 异步索引：ANN 索引为后台构建，ensureTable 通过轮询 SHOW INDEX 等
待索引就绪后再放行写入，避免首次检索召回为空。
- ARRAY<FLOAT> 序列化：go-sql-driver/mysql 不支持数组占位符，
embeddingLiteral 将 []float32 转成 SQL 字面量字符串再拼接。
新增文件：
- internal/application/repository/retriever/doris/{structs,schema,
query,repository,streamload,repository_test}.go
- scripts/e2e-doris.sh：E2E 验证清单
- docs/wiki/集成扩展/Doris改动与上游同步.md：fork-and-rebase 工作流
与改动清单
修改文件（接线 + 文档）：
- internal/types/{retriever,tenant,vectorstore}.go：新增
DorisRetrieverEngineType、env 解析、表单 schema 与索引参数校验
- internal/container/{container,engine_factory}.go：环境变量驱动
与 VectorStore 配置驱动两条路径都支持 Doris
- internal/application/service/vectorstore{,_healthcheck}.go：连接
校验 + Ping/Version 健康检查
- docker-compose.yml：新增 doris-fe / doris-be 服务（profile=doris）
- .env.example：DORIS_* 环境变量与示例
- docs/{使用其他向量数据库,wiki/集成扩展/集成向量数据库}.md：
使用说明与索引/分数行为说明
依赖：go.mod/go.sum 新增 github.com/go-sql-driver/mysql（运行时）和
github.com/DATA-DOG/go-sqlmock（测试）。
测试：repository 层 SQL 形状、Stream Load HTTP 行为、whereBuilder
逻辑、embeddingLiteral 往返、健康检查错误路径均有单测覆盖。
2026-05-08 21:59:35 +08:00
d48638427f
Fix authentication API documentation links
2026-05-08 16:48:07 +08:00
2beb64c429
docs: add wiki documentation with cross-referenced links
...
- Create structured wiki from docs/ directory
- Add 17 markdown pages organized in 7 categories
- Include standard Markdown relative path links for navigation
- Add Mermaid knowledge graph visualization in Home.md
2026-04-15 20:38:31 +08:00
wizardchen