Initial commit: Setup CargoTrace monorepo

- Add README.md with project overview
- Add .gitignore for IDE and OS files
- Add Flutter Android app as submodule (apps/pad_scanner)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Misaka
2026-05-08 21:00:36 +08:00
commit b2f1253382
4 changed files with 88 additions and 0 deletions

15
.gitignore vendored Normal file
View File

@@ -0,0 +1,15 @@
# IDE
.idea/
.vscode/
*.swp
*.swo
*~
# OS
.DS_Store
Thumbs.db
# Project specific
*.log
.env
.env.local

3
.gitmodules vendored Normal file
View File

@@ -0,0 +1,3 @@
[submodule "apps/pad_scanner"]
path = apps/pad_scanner
url = git@gitea.server10086.icu:admin/pad_scanner.git

69
README.md Normal file
View File

@@ -0,0 +1,69 @@
# CargoTrace - 库房货物追踪系统
## 项目概述
这是一个库房货物追踪管理系统的主仓库Monorepo采用 Git Submodule 的方式管理多个子项目。
## 子仓库
### Android 端 (Flutter)
- **路径**: `apps/pad_scanner`
- **仓库**: `git@gitea.server10086.icu:admin/pad_scanner.git`
- **技术栈**: Flutter
- **说明**: 基于 Flutter 框架的安卓应用,用于货物扫描和追踪
### 后端服务
- **状态**: 待定
- **技术栈**: 待定(可能使用 FastAPI 等)
## 项目结构
```
CargoTrace/
├── apps/ # 应用层子模块
│ └── pad_scanner/ # Flutter Android 应用
├── services/ # 后端服务子模块(待添加)
├── shared/ # 共享代码/库(待添加)
└── docs/ # 项目文档
```
## 开发指南
### 克隆仓库
```bash
# 克隆主仓库
git clone <repo-url> CargoTrace
cd CargoTrace
# 初始化并更新所有子模块
git submodule update --init --recursive
```
### 添加新的子模块
```bash
git submodule add <submodule-url> <path>
```
### 更新子模块
```bash
# 更新所有子模块到最新提交
git submodule update --remote
# 更新特定子模块
cd <submodule-path>
git pull origin main
```
## 技术栈
| 层级 | 技术栈 | 状态 |
|------|--------|------|
| Android 端 | Flutter | ✅ 确定 |
| 后端服务 | 待定 | ⏳ 待定 |
## 许可证
待定

1
apps/pad_scanner Submodule

Submodule apps/pad_scanner added at 236cfae485