refactor: 文档站品牌改名为汇账 Ledgerly,站点与脚本标识统一为 ledgerly
- 站点标题、首页与文档正文品牌名由「收支管理系统」改为「汇账 Ledgerly」 - package.json 包名改为 ledgerly-docs - 维护脚本环境变量由 FINANCE_* 改为 LEDGERLY_*,测试库路径与示例同步 - 项目结构、构建部署、开发环境等文档中的目录名与 jar 名改为 ledgerly - 保留在线体验域名与 OSS 截图前缀不变
This commit is contained in:
+4
-4
@@ -11,12 +11,12 @@
|
||||
|
||||
```bash
|
||||
# 后端(默认 8080)
|
||||
cd finance-app
|
||||
cd ledgerly
|
||||
set JAVA_HOME=D:\venv\jdk-21
|
||||
gradlew.bat bootRun
|
||||
|
||||
# 前端(默认 5173,接口代理到 8080)
|
||||
cd finance-app/frontend
|
||||
cd ledgerly/frontend
|
||||
npm run dev
|
||||
```
|
||||
|
||||
@@ -34,12 +34,12 @@ gradle bootJar
|
||||
./package.sh
|
||||
```
|
||||
|
||||
输出:`build/libs/finance-app-0.0.1-SNAPSHOT.jar`
|
||||
输出:`build/libs/ledgerly-0.0.1-SNAPSHOT.jar`
|
||||
|
||||
启动(默认 8080,可另指定端口):
|
||||
|
||||
```bash
|
||||
java -jar build/libs/finance-app-0.0.1-SNAPSHOT.jar --server.port=18081
|
||||
java -jar build/libs/ledgerly-0.0.1-SNAPSHOT.jar --server.port=18081
|
||||
```
|
||||
|
||||
访问对应端口即可;刷新 `/dashboard` 等子路由由后端 `SpaErrorController` 回退到 `index.html`。
|
||||
|
||||
+1
-1
@@ -20,7 +20,7 @@
|
||||
| `SchemaMigrator` | 建表后的幂等结构迁移(如列重命名),启动与切换数据源时执行 |
|
||||
| `DatabaseBootstrap` | 应用启动后加载配置并初始化 |
|
||||
|
||||
`FinanceApplication` 刻意排除了 `DataSourceAutoConfiguration`,以便「零配置也能启动」。
|
||||
`LedgerlyApplication` 刻意排除了 `DataSourceAutoConfiguration`,以便「零配置也能启动」。
|
||||
|
||||
## 配置来源与顺序
|
||||
|
||||
|
||||
+3
-3
@@ -8,7 +8,7 @@
|
||||
|
||||
| 环境 | 前端 | 后端 | 数据库 |
|
||||
|---|---|---|---|
|
||||
| 测试环境 | 5174 | 8081 | 独立 SQLite 空库(`ai-home/data/ai-finance.db`) |
|
||||
| 测试环境 | 5174 | 8081 | 独立 SQLite 空库(`ai-home/data/ai-ledgerly.db`) |
|
||||
| 真实环境 | 5173 | 8080 | MySQL(真实数据) |
|
||||
|
||||
- 两个环境共用同一份源码:前端改动经 Vite HMR 两边同步;后端改动执行 `./reload.sh` 后两边 devtools 同时热重启。
|
||||
@@ -28,7 +28,7 @@
|
||||
- 修改 `src/main/resources` 下的资源文件后,需额外同步资源:
|
||||
|
||||
```bash
|
||||
docker exec finance-backend-dev gradle -I /project/nexus-init.gradle processResources
|
||||
docker exec ledgerly-backend-dev gradle -I /project/nexus-init.gradle processResources
|
||||
```
|
||||
|
||||
- 仅在新增依赖、修改配置等需要彻底重启时才重启容器。
|
||||
@@ -38,7 +38,7 @@
|
||||
|
||||
- **Javadoc**:新增 Java 文件的类级 javadoc 末尾必须加一行 `@date`,格式 `yyyy-MM-dd HH:mm:ss`,时间取文件创建时间。
|
||||
- **导入顺序**:由 Spotless 管理,三组、组间空行分隔:`java`/`javax` → 第三方 → `cn.rosercode`。
|
||||
- 格式化:`docker exec finance-backend-dev gradle -I /project/nexus-init.gradle spotlessApply`
|
||||
- 格式化:`docker exec ledgerly-backend-dev gradle -I /project/nexus-init.gradle spotlessApply`
|
||||
- `spotlessCheck` 已挂到 `check`,`build` 时会校验。
|
||||
- **日志**:统一使用 Lombok `@Slf4j`,按级别使用(`error` 未预期异常、`warn` 可预期业务失败、`info` 关键写操作与外部调用、`debug` 流程细节)。
|
||||
- **控制器**:方法签名禁止声明 `HttpServletRequest` / `HttpServletResponse`,统一使用 `cn.rosercode.finance.util.UserContext`。
|
||||
|
||||
+2
-2
@@ -4,9 +4,9 @@
|
||||
|
||||
## 为什么保存
|
||||
|
||||
收支管理系统的不少界面是「多 Tab」或「带筛选条件」的,如果每次进入都重置为默认值,用户每次都要重新选一遍语言、筛选项、分页、排序、上次使用的记账方式等,体验割裂。
|
||||
汇账的不少界面是「多 Tab」或「带筛选条件」的,如果每次进入都重置为默认值,用户每次都要重新选一遍语言、筛选项、分页、排序、上次使用的记账方式等,体验割裂。
|
||||
|
||||
为此项目在 `finance-app/AGENTS.md` 中约定:
|
||||
为此项目在 `ledgerly/AGENTS.md` 中约定:
|
||||
|
||||
> 多 Tab 或可切换的界面偏好需**持久化记忆**(`localStorage`),下次打开时恢复到上次选择;存储键统一以 `finance.` 前缀命名,读取时对非法值回退默认项,写入时忽略存储异常。
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
## 仓库根目录
|
||||
|
||||
```text
|
||||
finance-app/
|
||||
ledgerly/
|
||||
├── build.gradle # Gradle 构建脚本(依赖、打包、前端集成、Spotless)
|
||||
├── settings.gradle # Gradle 项目设置
|
||||
├── gradlew / gradlew.bat # Gradle Wrapper
|
||||
|
||||
Reference in New Issue
Block a user