# 天枢

**Repository Path**: jianmu-dev/tianshu

## Basic Information

- **Project Name**: 天枢
- **Description**: 面向研发人员与平台团队的开发者门户。以软件服务为中心，连接自研产品与第三方工具。当前提供软件目录、负责人和系统登记、Gitea 仓库关联与实时只读摘要，以及 Logto 登录、组织选择、受控工具入口、成员和标准角色管理。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-09
- **Last Updated**: 2026-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 天枢 / Tianshu

源码公开，非商业使用免费，商业使用须另行授权。详见 [完整许可协议](LICENSE)。

正式部署采用 **Logto＋天枢基础管理＋按需选用的业务产品**。天枢基础管理为必需组件，承接组织、成员、产品实例和共享权限目录治理；工作协作可通过 `TIANSHU_WORK_ENABLED=false` 关闭，旧部署默认保留。最小部署见[基础管理部署](docs/base-management-deployment.md)，接入边界见[v1 契约](docs/identity-access-integration-v1.md)。

天枢提供可选的工作与交付能力。项目与事项组织日常工作、讨论和验收，应用与服务及工具入口连接代码、文档和交付资源。事项可以独立使用，研发工具按需关联。Logto 管理身份、组织成员和标准角色，各产品负责自己的资源与执行权限。

## 当前能力

- **工作台**：我的事项、我负责的项目、代码仓库、应用与服务四类卡片，以及工具快捷入口。个人事项支持到期筛选、搜索和分页；统计由服务端对完整筛选结果计算。
- **项目与事项**：创建项目和独立事项、分配有效组织成员、列表与状态看板、评论、活动、资源关联及明确验收。项目可归档和恢复，归档期间关联事项只读。
- **应用与服务**：登记用途、文本负责人/团队、所属系统、生命周期和文档，关联扶桑或 Gitea 仓库并读取摘要。
- **工具接入**：平台管理组织的组织管理员管理实例、组织绑定和连接验证；内置陆吾、扶桑、归墟和建木可直接配置入口和启用组织，保存立即生效；其余目录保持只读，工具入口统一去重。扶桑支持当前 Logto 账号的只读授权，Gitea 支持个人 PAT 读取。
- **权限治理**：统一预览、初始化和增量升级陆吾／扶桑的版本化 Logto 权限清单，展示跨组织成员影响；成员角色调整须预览后确认。详见[统一权限治理](docs/permission-governance.md)。
- **组织与账号**：统一登录、组织切换、成员与标准角色管理；按账号 ID 或完整用户名查询后邀请，也可申请加入。无邮箱账号可登录，邮箱设置须验证当前身份与新邮箱归属。
- **部署初始化**：未完成初始化时，任何能访问首页的人都可直接配置，无需部署密码或服务器凭证文件。四步完成 Logto 连接、组织与初始职责、预览执行及真实登录验收；可明确指定工作管理员和平台管理组织，兼容旧初始化状态及完整环境变量身份配置。

顶部提供“基础管理”，工作开启时另有“工作台、项目、事项、应用与服务”。工具启动器、组织设置、平台管理、权限治理和个人账号分别提供对应范围的操作。事项列表与看板共享筛选，详情可返回原工作台、项目或列表；跨登录只保留合法详情目标，不恢复来源和筛选参数。页面职责见[信息架构](docs/information-architecture.md)。

## 权限与数据边界

工作模块使用独立 SQLite 持久化。查看、协作、管理角色需在 Logto 显式初始化和分配；组织管理员不自动取得工作业务权限。新部署可在首次向导中明确指定工作管理员，旧部署仍由 Logto 管理员明确授予。工作权限或数据库未就绪时，原有门户能力仍可使用。权限、升级和备份见[工作协作](docs/work-collaboration.md)。

仓库数据按当前用户、组织和来源实例授权读取。开放合并请求数属于仓库，不表示“待我评审”；未取得的可见性、发布、构建或部署状态不补造。建木运行、归墟制品、陆吾应用/环境等事项关联目前是分类链接，执行与资源鉴权仍由目标产品负责。

当前数据目录只支持单实例写入；会话和个人仓库读取凭据在服务端内存中，重启后需重新登录并连接授权。工作流触发、自助交付模板、跨产品状态和账号自动同步、跨产品全局退出尚未实现。

## 构建与部署

使用当前功能请从当前源码构建，步骤见[源码开发](docs/development.md)：

```sh
make build
make test
```

构建输出前端静态文件及服务、初始化、健康检查、工作数据库工具。同源本地启动、身份配置和专用测试环境要求均在开发指南中说明。

全新部署打开首页即可进入“连接身份服务 → 组织与管理员 → 预览并执行 → 登录与验收”。Logto 仍需先准备具有管理权限的引导应用和业务用户；向导支持按完整用户名或用户 ID 核对账号，并自动准备天枢登录应用、回调、运行期管理应用及标准角色。选择工作管理员时，完成前还会实时检查其工作权限和数据库；产品接入与产品业务验收另行完成。

容器部署、HTTPS、持久卷和备份恢复见[镜像部署指南](docs/deployment.md)，首次连接 Logto 见[部署初始化](docs/setup.md)。建木 Hub 的 `1.0.0` 标签历史上对应多个构建，须按 digest 和功能范围选取；仓库保留的 2026-10-27 镜像记录不包含工作协作及后续扶桑接入，不能用于证明当前源码已发布。历史产物见[镜像发布记录](docs/image-release.md)。

`/healthz` 只表示进程存活，登录、权限、仓库读取与目标产品业务须分别验证。源码能力、本地验收和 UAT / 生产部署结果在[验证范围](docs/acceptance.md)中分开记录。

## 文档入口

| 任务 | 文档 |
| --- | --- |
| 浏览全部文档及主要源码 | [文档索引](docs/README.md) |
| 理解组件与数据边界 | [系统架构](docs/architecture.md) |
| 配置账号、加入组织与申请权限 | [账号与权限指南](docs/account-permissions-guide.md) |
| 使用项目、事项与验收 | [工作协作](docs/work-collaboration.md) |
| 接入工具与仓库 | [开发者门户](docs/developer-portal.md)、[扶桑接入](docs/fusang-integration.md) |
| 了解产品接入和权限职责 | [产品接入约定](docs/integration.md) |
| 核对已验证与未验证范围 | [验证记录](docs/acceptance.md) |