fischer-agentkit/docs/brainstorms
chiguyong bbbf9cd40a feat(bitable): add bitable companion service with full P0-P2 fixes
Bitable is a multi-dimensional table companion service that runs alongside
the main AgentKit server. It provides structured data storage with formula
fields, views, and ingestion pipelines.

Major components:
- Domain models (Pydantic v2): Table, Field, Record, View, RecalcTask
- SQLAlchemy 2 async ORM with independent bitable PostgreSQL schema
- Formula engine: AST parser, DAG, Kahn topological sort, safe eval
- RecalcWorker: atomic task claiming (FOR UPDATE SKIP LOCKED), topo-order
  processing, stale-threshold reaper for crash recovery
- REST API (/api/v1/bitable): tables, fields, records, views, files
- BitableTool: agent-facing tool with batch chunking (500/batch)
- CLI: agentkit bitable subcommands (create, list, import-excel, etc.)
- Frontend: Vue 3 + vxe-table grid with field management, views, filters
- Ingestion: Excel (openpyxl), database reflection, API collector

Security fixes (ce-code-review P0 + ce-debug P1):
- SQL injection prevention (field_id validation, parameterized queries)
- IDOR protection (_check_table_ownership on all table-level endpoints)
- SSRF prevention (URL scheme + private IP validation in parse_excel_url)
- OOM prevention (streaming file upload, batch delete, batch insert)
- Atomic recalc task claiming (FOR UPDATE SKIP LOCKED)
- Formula engine cache invalidation on field changes
- Composite cursor pagination for non-id sort orders
- Batch upsert (eliminates N+1 queries)
- Sync I/O offloaded to thread pool in async contexts
- Internal token auth (X-Internal-Token, hmac.compare_digest)
- PK unique index enforcement

Test coverage: 88 unit tests (95 skipped without Docker)
2026-06-25 01:09:59 +08:00
..
2026-06-09-agentkit-capability-matrix feat: accumulated frontend enhancements, docs, and static assets 2026-06-14 16:35:01 +08:00
2026-06-05-agentkit-architecture-gap-analysis-requirements.md feat(agentkit): v2 Phase 1 - ReAct/LLM Gateway/Skill/Server + review fixes 2026-06-05 23:32:16 +08:00
2026-06-09-clawith-research-prompt.md feat: accumulated frontend enhancements, docs, and static assets 2026-06-14 16:35:01 +08:00
2026-06-12-frontend-productization-requirements.md feat: frontend productization with code review fixes 2026-06-13 01:29:58 +08:00
2026-06-13-agentkit-platform-experience-upgrade-requirements.md feat: accumulated frontend enhancements, docs, and static assets 2026-06-14 16:35:01 +08:00
2026-06-13-gui-productization-requirements.md feat: accumulated frontend enhancements, docs, and static assets 2026-06-14 16:35:01 +08:00
2026-06-13-gui-redesign-requirements.md feat: accumulated frontend enhancements, docs, and static assets 2026-06-14 16:35:01 +08:00
2026-06-14-expert-team-mode-requirements.md feat: Expert Team Mode — plan-execute collaboration with conversation UI 2026-06-14 22:20:14 +08:00
2026-06-15-autonomous-task-execution-requirements.md feat: autonomous task execution - connect PlanExecEngine + TeamOrchestrator 2026-06-15 12:41:32 +08:00
2026-06-17-board-meeting-mode-requirements.md feat: 私董会讨论模式 + 回测集成 + WS持久化修复 2026-06-17 23:52:53 +08:00
2026-06-17-expert-team-evolution-roadmap-requirements.md feat: 企业级客户端-服务端架构 + 代码审查修复 2026-06-20 06:48:18 +08:00
2026-06-18-chat-area-vi-redesign-requirements.md feat: 企业级客户端-服务端架构 + 代码审查修复 2026-06-20 06:48:18 +08:00
2026-06-20-centralized-auth-token-persistence-requirements.md plan: 计划审查修订 + AuthProvider 抽象层设计 2026-06-21 00:21:52 +08:00
2026-06-21-admin-console-requirements.md feat(admin): U1+U2+U4 — schema v3, department service, context filtering 2026-06-21 15:03:27 +08:00
2026-06-23-calendar-schedule-requirements.md docs(calendar): mark plan as completed — all 12 units implemented 2026-06-24 05:04:39 +08:00
2026-06-23-document-processing-capability-requirements.md feat(documents): add document processing capability (U1-U9) 2026-06-23 15:05:01 +08:00
2026-06-24-agent-debate-collaboration-requirements.md feat(experts): add debate phase executor to TeamOrchestrator (U2) 2026-06-24 10:54:51 +08:00
2026-06-24-bitable-module-requirements.md feat(bitable): add bitable companion service with full P0-P2 fixes 2026-06-25 01:09:59 +08:00
2026-06-24-expert-team-project-manager-collaboration-requirements.md fix(experts): PM 协同代码审查全量修复 2026-06-24 18:56:27 +08:00
2026-06-24-portal-platform-evolution-requirements.md feat(bitable): add bitable companion service with full P0-P2 fixes 2026-06-25 01:09:59 +08:00