2026-09-01 13:50:41 +08:00
2026-08-31 20:53:53 +08:00

Enterprise Knowledge Platform

Enterprise internal knowledge infrastructure.

Core capabilities

  • Multi-format document ingestion
  • OCR and document parsing
  • Structure-aware chunking
  • Multiple embedding providers
  • Hybrid retrieval and reranking
  • ACL-aware search
  • Knowledge Compilation
  • REST API
  • MCP Server
  • Admin Console

Architecture baseline

  • API First + Admin Console
  • Modular Monolith + async workers + MCP gateway
  • PostgreSQL + object storage as canonical source of truth
  • Mochow as the initial retrieval index, behind a replaceable adapter
  • Embedding / reranker / parser / LLM providers are replaceable
  • Raw source is immutable
  • Compiled Knowledge is derived and traceable
  • ACL is enforced before or during retrieval, never after Top-K

Start here

  1. Read AGENTS.md
  2. Read CODEX_START_HERE.md
  3. Read docs/product/PRD.md
  4. Read docs/architecture/ARCHITECTURE.md
  5. Read docs/plans/V1_EXECUTION_PLAN.md
  6. For the current milestone, read docs/demo/DEMO_SCOPE.md and pick exactly one DEMO-* task. The V1 tasks in docs/plans/TASKS.md remain the deferred product backlog.

Demo development

The current implementation target is the retrieval demo defined in docs/demo/DEMO_SCOPE.md.

Prerequisites:

  • uv
  • Docker (for PostgreSQL and later integration dependencies)

Install dependencies and run the API:

cp .env.example .env
make install
make run

The health endpoint is available at http://localhost:8000/healthz, and the versioned OpenAPI document is available at http://localhost:8000/api/v1/openapi.json.

Run the development checks with:

make format-check lint typecheck test migration-check eval

Document metadata is canonical in PostgreSQL. Demo source files use the local storage/ directory through the provider-neutral ObjectStorage interface; existing objects cannot be overwritten. Upload endpoints are introduced by DEMO-003, not by the current storage foundation.

Description
知识平台
Readme 1.9 MiB
Languages
Python 88.7%
CSS 3.8%
JavaScript 2.8%
HTML 1.6%
Shell 0.9%
Other 2.2%