82c8eda1d8
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>
2.2 KiB
2.2 KiB
CargoTrace - 库房货物追踪系统
项目概述
这是一个库房货物追踪管理系统的主仓库（Monorepo），采用 Git Submodule 的方式管理多个子项目。
子仓库
Android 端 (Flutter)
- 路径:
apps/pad_scanner - 仓库:
git@gitea.misdev.icu:CargoTrace/pad_scanner.git - 技术栈: Flutter
- 说明: 基于 Flutter 框架的安卓应用，用于货物扫描和追踪
后端服务 (FastAPI)
- 路径:
services/fastapi - 仓库:
git@gitea.misdev.icu:CargoTrace/fastAPI.git - 技术栈: FastAPI (Python)
- 说明: 后端 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/
├── apps/ # 应用层子模块
│ └── pad_scanner/ # Flutter Android 应用
├── services/ # 后端服务子模块
│ └── fastapi/ # FastAPI 后端服务
├── tools/ # 衍生工具子模块
│ ├── WareShipManifest/ # 装箱单/签收单报表与打印
│ └── attachmentQRCodeGenerator/ # 压力表标签查询打印
└── docs/ # 项目文档
开发指南
克隆仓库
# 克隆主仓库
git clone <repo-url> CargoTrace
cd CargoTrace
# 初始化并更新所有子模块
git submodule update --init --recursive
添加新的子模块
git submodule add <submodule-url> <path>
更新子模块
# 更新所有子模块到最新提交
git submodule update --remote
# 更新特定子模块
cd <submodule-path>
git pull origin main
技术栈
| 层级 | 技术栈 | 状态 |
|---|---|---|
| Android 端 | Flutter | ✅ 确定 |
| 后端服务 | FastAPI (Python) | ✅ 确定 |
许可证
待定