admin/CargoTrace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: document tools/ directory and migrated submodules in README

Browse Source 
Adds tools/ to the project tree and a derivative-tools subsection; syncs example submodule URLs to gitea.misdev.icu (server10086 decommissioned).

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Misaka_Company
2026-08-10 12:42:24 +08:00
parent 0c4cb0f3a6
commit 82c8eda1d8
1 changed files with 15 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
README.md
View File

@@ -8,27 +8,33 @@
### Android 端 (Flutter) ### Android 端 (Flutter)
- **路径**: `apps/pad_scanner` - **路径**: `apps/pad_scanner`
- **仓库**: `git@gitea.server10086.icu:admin/pad_scanner.git` - **仓库**: `git@gitea.misdev.icu:CargoTrace/pad_scanner.git`
- **技术栈**: Flutter - **技术栈**: Flutter
- **说明**: 基于 Flutter 框架的安卓应用，用于货物扫描和追踪 - **说明**: 基于 Flutter 框架的安卓应用，用于货物扫描和追踪
### 后端服务 (FastAPI) ### 后端服务 (FastAPI)
- **路径**: `services/fastapi` - **路径**: `services/fastapi`
- **仓库**: `git@gitea.server10086.icu:CargoTrace/fastAPI.git` - **仓库**: `git@gitea.misdev.icu:CargoTrace/fastAPI.git`
- **技术栈**: FastAPI (Python) - **技术栈**: FastAPI (Python)
- **说明**: 后端 API 服务 - **说明**: 后端 API 服务
### 衍生工具 (tools/)
- **WareShipManifest** (`tools/WareShipManifest/`): 装箱单/签收单 PDF 报表与打印服务,Python + reportbro-lib,仓库 `gitea.misdev.icu:CargoTrace/WareShipManifest`
- **attachmentQRCodeGenerator** (`tools/attachmentQRCodeGenerator/`): 压力表标签查询打印,VBA 导出代码,仓库 `gitea.misdev.icu:CargoTrace/attachmentQRCodeGenerator`
- 详见 `tools/README.md`
## 项目结构 ## 项目结构
``` ```
CargoTrace/ CargoTrace/
├── apps/ # 应用层子模块 ├── apps/ # 应用层子模块
│ └── pad_scanner/ # Flutter Android 应用 │ └── pad_scanner/ # Flutter Android 应用
├── services/ # 后端服务子模块 ├── services/ # 后端服务子模块
│ └── fastapi/ # FastAPI 后端服务 │ └── fastapi/ # FastAPI 后端服务
├── shared/ # 共享代码/库（待添加） ├── tools/ # 衍生工具子模块
├── infra/ # 基础设施（待添加） │ ├── WareShipManifest/ # 装箱单/签收单报表与打印
└── docs/ # 项目文档 │ └── attachmentQRCodeGenerator/ # 压力表标签查询打印
└── docs/ # 项目文档
``` ```
## 开发指南 ## 开发指南