# business-brain

**Repository Path**: rebys/business-brain

## Basic Information

- **Project Name**: business-brain
- **Description**: 企业业务大脑(基于现有java项目梳理)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Business Brain

Build AI-ready business knowledge from source code — and run it through an auditable AI Engineering workflow.

Business Brain is not a documentation project. It is a business knowledge operating system with a plan-first runtime.

```mermaid
flowchart LR
  Source[Source Code] --> Facts[Business Facts]
  Facts --> Knowledge[Domain / Rule / Flow / Metric]
  Knowledge --> Context[AI Context]
  Context --> Runtime[Business Brain Runtime]
  Runtime --> Impact[Impact / Architecture / Task Plan]
  Impact --> Gates[Human Gates]
  Gates --> Delivery[Code / Test / Release]
  Delivery --> Update[Knowledge Diff]
  Update --> Knowledge
```

## Current release

**v4.0.0** introduces the organization-level Delivery Control Plane:

- Change Window → explicit production release windows and concurrency limits
- Release Calendar → risk-tier approvals bound to Runtime readiness and Knowledge Drift
- Organization Policy Pack → shared release, approval and adapter constraints
- Portfolio View → cross-project Run, release and risk visibility
- Standard Adapter Contract → Codex, Git, TAPD and Confluence handoff-only envelopes

## Start here

- [Docs Home](docs/README.md)
- [Runtime v3.0](docs/17-runtime/README.md)
- [Runtime Governance v3.1](docs/18-runtime-governance/README.md)
- [Execution Checkpoints v3.2](docs/19-execution-checkpoints/README.md)
- [Knowledge Drift Detection v3.3](docs/20-knowledge-drift/README.md)
- [Knowledge Patch Candidates v3.4](docs/21-knowledge-patches/README.md)
- [Knowledge Merge Governance v3.5](docs/22-knowledge-merge/README.md)
- [Merge CI Integration v3.6](docs/23-merge-ci/README.md)
- [Release Attestation v3.7](docs/24-release-attestation/README.md)
- [Environment and Rollback Attestation v3.8](docs/25-environment-rollback/README.md)
- [Multi-environment Promotion Governance v3.9](docs/26-multi-environment-promotion/README.md)
- [Delivery Control Plane v4.0](docs/27-delivery-control-plane/README.md)
- [Delivery Control Plane Reference](runtime/control-plane-state/REFERENCE.md)
- [Runtime CLI](runtime/README.md)
- [Runtime Example](runtime/examples/customer-multi-owner/request.yaml)
- [v3.2 Execution Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-execution-reference/report.md)
- [v3.3 Drift Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-drift-reference/DRIFT-REFERENCE.md)
- [v3.4 Patch Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-patch-reference/PATCH-REFERENCE.md)
- [v3.5 Merge Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-merge-reference/MERGE-REFERENCE.md)
- [v3.6 Merge CI Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-ci-reference/CI-REFERENCE.md)
- [v3.7 Release Attestation Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-release-reference/RELEASE-ATTESTATION-REFERENCE.md)
- [v3.8 Environment and Rollback Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-environment-rollback-reference/ENVIRONMENT-ROLLBACK-REFERENCE.md)
- [v3.9 Promotion Reference](runtime/runs/REQ-CUS-MULTI-OWNER-001-promotion-reference/PROMOTION-REFERENCE.md)
- [AI Engineering Workflow](docs/15-ai-engineering/README.md)
- [System Business Graph](graph/system-business-graph.md)
- [Cross-Domain Consistency Package](knowledge/consistency/README.md)
- [Cross-Domain Consistency Graph](graph/cross-domain-consistency-graph.md)
- [Four Service System Map](knowledge/business-map/four-service-system-map.md)

## Run the Runtime

```bash
python -m pip install -r runtime/requirements.txt
python runtime/cli.py run \
  --request runtime/examples/customer-multi-owner/request.yaml

# approve a gate
python runtime/cli.py gate \
  --run runtime/runs/<run-id> \
  --gate requirement_boundary \
  --decision approved \
  --actor ming
```

## Core domains

- [Customer](knowledge/domains/customer/README.md)
- [Order](knowledge/domains/order/README.md)
- [Payment](knowledge/domains/payment/README.md)
- [Contract](knowledge/domains/contract/README.md)
- [Product](knowledge/domains/product/README.md)
- [ProductionOrder](knowledge/domains/production-order/README.md)
- [QYWX](knowledge/domains/qywx/README.md)
- [DataView](knowledge/domains/dataview/README.md)
- [OA](knowledge/domains/oa/README.md)
- [TaxPolicy](knowledge/domains/tax-policy/README.md)
- [Invoice](knowledge/domains/invoice/README.md)
- [TaxEstimated](knowledge/domains/tax-estimated/README.md)
- [TaxRisk](knowledge/domains/tax-risk/README.md)
- [ComplianceReport](knowledge/domains/compliance-report/README.md)
- [ServiceProvider](knowledge/domains/service-provider/README.md)

## Cross-domain consistency

- [17-domain business main chain](knowledge/consistency/cross-domain-main-chain.md)
- [20 consistency findings](knowledge/consistency/findings.md)
- [13 cross-domain invariants](knowledge/consistency/invariants.md)
- [AI consistency bundle](ai/bundles/cross-domain-consistency-bundle.md)

## Design principles

1. Source code is the source of truth.
2. Every knowledge item needs evidence.
3. Facts first, knowledge second.
4. Knowledge before prompt.
5. Everything is linked.
6. AI first, human readable.
7. Business before technology.
8. Incremental over over-design.
9. Human decisions at material business and release gates.
10. Knowledge update is part of done.

## Release artifacts

- [Release Notes](RELEASE.md)
- [Changelog](CHANGELOG.md)
- [v3.0 Checklist](quality/V3.0-CHECKLIST.md)
- [v3.0 Runtime Report](quality/reports/V3.0-RUNTIME-REPORT.md)
- [v3.1 Checklist](quality/V3.1-CHECKLIST.md)
- [v3.1 Governance Report](quality/reports/V3.1-GOVERNANCE-REPORT.md)
- [v3.2 Checklist](quality/V3.2-CHECKLIST.md)
- [v3.2 Execution Report](quality/reports/V3.2-EXECUTION-REPORT.md)
- [v3.3 Checklist](quality/V3.3-CHECKLIST.md)
- [v3.3 Drift Report](quality/reports/V3.3-DRIFT-REPORT.md)
- [v3.4 Checklist](quality/V3.4-CHECKLIST.md)
- [v3.4 Patch Report](quality/reports/V3.4-PATCH-REPORT.md)

- [v3.5 Checklist](quality/V3.5-CHECKLIST.md)
- [v3.5 Merge Report](quality/reports/V3.5-MERGE-REPORT.md)
- [v3.6 Checklist](quality/V3.6-CHECKLIST.md)
- [v3.6 Merge CI Report](quality/reports/V3.6-MERGE-CI-REPORT.md)
- [v3.6 Quality Gate Log](quality/reports/V3.6-QUALITY-GATE.txt)
- [v3.7 Checklist](quality/V3.7-CHECKLIST.md)
- [v3.7 Release Attestation Report](quality/reports/V3.7-RELEASE-ATTESTATION-REPORT.md)
- [v3.7 Quality Gate Log](quality/reports/V3.7-QUALITY-GATE.txt)

- [v3.8 Checklist](quality/V3.8-CHECKLIST.md)
- [v3.8 Environment and Rollback Report](quality/reports/V3.8-ENVIRONMENT-ROLLBACK-REPORT.md)
- [v3.9 Checklist](quality/V3.9-CHECKLIST.md)
- [v3.9 Promotion Report](quality/reports/V3.9-PROMOTION-REPORT.md)
- [v3.9 Final Quality Log](quality/reports/V3.9-FINAL-QUALITY.txt)
- [v4.0 Checklist](quality/V4.0-CHECKLIST.md)
- [v4.0 Delivery Control Plane Report](quality/reports/V4.0-DELIVERY-CONTROL-PLANE-REPORT.md)
- [v4.0 Final Quality Log](quality/reports/V4.0-FINAL-QUALITY.txt)

## 新增源码领域

- [ServiceProvider 服务商准入与运营分发](knowledge/domains/service-provider/README.md)
- [Product 商品与交易配置](knowledge/domains/product/README.md)
- [Contract 合同生成与签署履约](knowledge/domains/contract/README.md)
- [ProductionOrder 生产工单与服务交付](knowledge/domains/production-order/README.md)

- [OA 审批与内部协作](knowledge/domains/oa/README.md)
- [TaxPolicy 税收政策智能匹配](knowledge/domains/tax-policy/README.md)
- [Invoice 发票与开票账单](knowledge/domains/invoice/README.md)
- [TaxEstimated 税费预估与双端确认](knowledge/domains/tax-estimated/README.md)
- [TaxRisk 涉税风险检测与双端确认](knowledge/domains/tax-risk/README.md)
- [ComplianceReport 合规诊断报告](knowledge/domains/compliance-report/README.md)

- [Payment 支付、退款与交易结算](knowledge/domains/payment/README.md)

- [Membership 会员、权益与续费](knowledge/domains/membership/README.md)
- [VirtualCoin 虚拟币账户、充值与审核](knowledge/domains/virtual-coin/README.md)