Files

T

LineWalker 7669c1a3cf docs(agents): dedupe layered AGENTS.md, add runtime topology + backend pitfalls

- root: fix client react-query v5->v4 (@tanstack ^4.28), add 5-line runtime
  topology block to §1, release-contract.md path in SDD step 0, accurate §7
  pitfall pointers, docs-index pointers and instruction-file loading map in §8
- frontend platform/client: remove the 7 hard rules duplicated from root §4
  (single source of truth; kills the <600 vs <=600 drift), keep only
  app-specific rules; promote any-minimize + named-exports to root §4
- backend: new Known Pitfalls section (tenant auto-filter is SELECT-only —
  bulk UPDATE/DELETE and raw SQL need hand-written tenant conditions; ruff
  PostToolUse hook drops not-yet-used imports; Celery Beat x multi-tenant
  context; DB config 100s Redis TTL) + Quick Map accuracy fixes
- docs/README.md: drop dead links (qa/, archive/, gateway-deploy dir), add
  PRD/ and observability/ rows

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-04 19:07:21 +08:00

1.6 KiB

Raw Permalink Blame History

BiSheng 文档导航

找文档从这里开始。原则:规范看根目录、架构看 architecture/、功能文档看 ../features/。

规范(开发前必读)

文档	内容
`constitution.md`	架构铁律 C1–C7(双 DB / 多租户 / 权限 / 分层 / 错误码 / 安全)——不可违反
`SDD-Guide.md`	开发流程总纲:流程分级、★ 暂停点、偏差处理、测试分层、harness 现状
`../AGENTS.md`	全局 agent 规则入口(各子项目规则按目录自动加载)

架构(子系统深度)

architecture/ — 13 篇:总览 / 后端模块 / 工作流引擎 / RAG / Linsight / 双前端 / 数据模型 / 部署 / 开发指南 / 权限 ReBAC / 商业网关 / 多租户 / 游标分页 + 数据库表结构。子系统架构的唯一正文。

功能文档(SDD 产出)

../features/ — 按 v{X.Y.Z}/{NNN}-{name}/ 组织,每个功能含 spec.md / design.md / tasks.md(及按需 testcases.md,如 F025)。模板见 ../features/_templates/。

接口 · 测试 · 部署 · 科普

目录	内容
`api/`	接口文档(filelib 纯检索、知识空间/知识库接口)
`PRD/`	现行迭代的产品 PRD 与技术方案(按 `{版本} {主题} PRD/` 组织)
`observability/`	BS_METRIC 指标日志契约(监控团队解析依据)
`私有化部署/`	部署文档
`blog/`	设计科普(如"企业权限体系的前世今生")

1.6 KiB Raw Permalink Blame History