Skip to content
bitzorcas
中EN

Concept

快速开始:BitzOrcas.Modern 研发上手指南

BitzOrcas.Modern 开发者上手总览:从架构哲学认知、前置依赖审查、Docker 容器基础设施拉起,到执行首个多租户垂直切片业务用例。

Last updated

许多企业级框架在入门文档设计上存在严重的“断层”:要么只给出几条毫无解释的 docker run 命令,导致开发者把 Demo 跑起来后依然对架构运转机制一无所知;要么陷入冗长的理论宣讲,让工程师在数十页的概念泥潭中丧失耐心。

BitzOrcas.Modern 采用“心智模型先行、流水线渐进落地”的布道体系。本章旨在引导架构师与核心研发人员在最短时间内建立起对 .NET 10 模块化单体的端到端掌控力:从底层的物理依赖隔离,到中层的 10 级应用执行管道,再到顶层的多租户垂直切片实战。

快速上手工程演进路线

从代码拉取到生产级多租户用例验证,标准开发生命周期划分为以下 5 个关键阶段:

1. 认知底座架构
(Introduction)

2. 核查依赖与工具链
(Prerequisites)

3. 拉起容器与建库
(Install)

4. 执行首个垂直切片
(Quick Start)

5. 验证多租户与鉴权
(Demo Accounts)

环境疑难排查
(Troubleshooting)


模块篇章结构与导航

为确保在真实团队协作中不遗漏关键工程约束,建议按以下逻辑顺序阅读并实践:

  1. 认识 BitzOrcas.Modern
    深入理解为何选择模块化单体与垂直切片架构,解构请求穿越 10 级治理管道的端到端时序,掌握跨模块协作的 5 条物理红线。

  2. 开发环境与前置依赖
    核对 .NET 10 SDK、Node.js 22、Docker 容器引擎与 IDE 插件配置,建立符合 Native AOT 约束的本地编译工具链。

  3. 代码安装与本地配置
    克隆仓库、通过 Docker Compose 启动按摘要锁定的容器基础设施(SQL Server 2022、Redis 7、RabbitMQ),执行 --init-schema 完成开箱建库与种子初始化。

  4. 5 分钟极速起飞
    启动后端 Minimal API 宿主,获取 RSA-OAEP 公钥并执行端到端登录,发起首个受 10 级管道治理的业务切片请求。

  5. 预置演示账号与口令注入契约
    掌握生产级“Fail-Closed 口令注入契约”,剖析特权超管与租户演示账号的生命周期,验证多租户资源防探测机制(404 代替 403)。

  6. 常见问题与排错手册
    汇总端口占用、开发证书信任、Source Generator 增量编译缓存清理等高频阻塞点的秒级自愈方案。


本章快速索引

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%