# jy.abp.framework

**Repository Path**: jiyangcd/jy.abp.framework

## Basic Information

- **Project Name**: jy.abp.framework
- **Description**: abp框架扩展及模板项目
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: abp-10.3.x
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-09
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Jy.Abp.Framework

基于 ABP vNext 的扩展框架与项目模板 monorepo。框架（`framework/`、`modules/`）产出 `Jy.Abp.*` NuGet 包；项目模板（`templates/app/`）是客户项目的蓝图，经 OSS 分发、由 `abp-template` CLI 生成客户项目。

> 框架提交历史自原 `jy.abp` 仓库原样承接，模板与维护者工具以整理快照签入（ADR-0004）。旧仓库已在 gitee 改名归档（显示名归档，URL 仍为 `jy.abp` 与 `abp-vnext-project-template`），模板仓库的历史回溯请到归档仓库按 commit hash 查询。设计决策见 `docs/adr/`，术语表见 `CONTEXT.md`。

## 仓库结构

```
jy.abp.framework/
├── common.props          # 版本号唯一定义点（AbpVersion + ProjectVersion）
├── framework/            # 框架层（Jy.Abp.Core / Application / Domain ...）
├── modules/              # 模块层（BlobStoring / Identity / GeneralTree ...）
├── templates/app/        # 项目模板 = 客户项目蓝图（server + client + deploy）
├── tools/                # 维护者工具（packager 打包推 OSS / abp-template-cli / 生成器）
├── scripts/              # bump.ps1 / pack-all.ps1 / push-all.ps1 ...
└── nupkg/                # 打包产物（兼作本地联调 NuGet 源）
```

## 日常流程

### 发布（框架 + 模板同一列车）

```powershell
# 1. 迭代框架后升版本（ProjectVersion 末段 +1，自动同步模板 JyAbpVersion）
./scripts/bump.ps1
# 或 ABP 大版本升级（同步两侧 AbpVersion）
./scripts/bump.ps1 -AbpVersion 10.3.1

# 2. 打包（含版本一致性预检）并推送 nuget.org
./scripts/pack-all.ps1
./scripts/push-all.ps1

# 3. 打 tag（包版本）并推送
git tag v10.3.0.116
git push origin abp-10.3.x --tags

# 4. 模板包推 OSS（模板包版本标签 = AbpVersion），CLI 用户即可拉到新版
./tools/packager/package.ps1 -OssPath 'oss://public-chengdu/abp-template/'
```

### 联调（改框架立刻在模板见效，无需发布）

```powershell
# 一次性：把 nupkg/ 注册为用户级 NuGet 源
dotnet nuget add source "$PWD\nupkg" -n jy-local
# 之后：改框架 -> pack -> 模板直接 restore
./scripts/pack-all.ps1
```

## 铁律

- 模板内永远 `PackageReference`，禁止引用框架源码或仓库内部相对路径（ADR-0002）。
- 版本号只允许 `bump.ps1` 修改（ADR-0003）。
- ABP 升级开新分支：`git checkout -b abp-10.4.x`，monorepo 中模板随分支自动存在。