backend-core
Operate on BiSheng FastAPI backend core surfaces: DDD modules, routers, schemas, settings/context, models, error codes, and focused backend tests.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- backend-core
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Operate on BiSheng FastAPI backend core surfaces: DDD modules, routers, schemas, settings/context, models, error codes, and focused backend tests.
- disable-model-invocation
- true
02 资源文件 2
- 参考文档references/troubleshooting.md4.3 KB
- 参考文档references/workflows.md5.1 KB
03 SKILL.md 正文
backend-core
Use this sub-skill when a task touches BiSheng's FastAPI backend core: app startup, route registration, DDD module boundaries, common API schemas, settings/context lifecycle, SQLModel/DAO model surfaces, backend error codes, or focused backend tests.
Start Here
Run bundled helper commands from this sub-skill directory, or adjust the script path to this directory after import.
- Identify the exact backend surface before editing. The bundled helper can inspect a checkout without importing application modules:
python scripts/inspect_backend_surface.py --repo-root <bisheng-checkout> --format text - Read references/workflows.md for concrete backend workflows, entry points, commands, and review checklists.
- If the failure mode is unclear, start with references/troubleshooting.md.
Owned Responsibilities
- FastAPI app factory/lifespan and middleware ordering around
src/backend/bisheng/main.py. - Global API router registration in
src/backend/bisheng/api/router.py, including/api/v1frontend routes and/api/v2RPC routes. - DDD backend module shape:
api/,domain/services/,domain/models/,domain/schemas/, and repository boundaries. - Common response/pagination/SSE schemas in
src/backend/bisheng/common/schemas/api.py. - Error-code discipline in
src/backend/bisheng/common/errcode/. - Settings and application context surfaces in
src/backend/bisheng/core/config/settings.pyandsrc/backend/bisheng/core/context/. - SQLModel/DAO model surfaces in
src/backend/bisheng/database/models/and domain model directories. - Focused backend tests under
src/backend/test/, especiallytest/common/,test/core/,test/database/, and module-specific tests.
Route Sibling Areas Instead of Duplicating Them
- Use
workflow-enginefor LangGraph DAG execution, workflow nodes, edges, callbacks, and workflow Celery task behavior. - Use
knowledge-ragfor knowledge base ingestion, RAG, Milvus/Elasticsearch dual recall, file parsing, and knowledge workers. - Use
identity-permissions-tenancyfor OpenFGA/ReBAC permission flows, tenant hierarchy, admin scope, SSO/org sync, and quota semantics. - Use
linsight-mcpfor Linsight worker/runtime, deepagents, MCP integrations, and Linsight task-mode behavior. - Use
frontend-appsfor Platform or Client React code and API client usage. - Use
deployment-maintenancefor Docker Compose, Nginx, production deployment, operational scripts, and environment rollout concerns.
Non-Negotiables for Backend Core Work
- Preserve the layered call chain: Router → Endpoint → Service → Repository/DAO → DB. Do not add endpoint-to-model shortcuts for new code.
- Keep
common/andcore/independent of application domains and API modules. - Return success and business errors through the shared response/error-code helpers; do not hide internal exceptions by converting every failure to
resp_500(message=str(e)). - Treat MySQL and DM8 as co-equal targets. Use dialect helpers for JSON, large text, and update timestamps.
- Respect tenant ContextVar semantics. ORM SELECTs are auto-filtered, but bulk updates/deletes and raw SQL require explicit tenant-safe design.
- Backend tests run from
src/backend/with uv; new tests belong undertest/<module>/, not the test root.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.