commit b2f12533828741407e68bfda2440da2dc82f617d
Author: Misaka <pengqiangqiang@gmail.com>
Date:   Fri May 8 21:00:36 2026 +0800

    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>

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..fe3f9fc
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,15 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log
+.env
+.env.local
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..4bab680
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "apps/pad_scanner"]
+	path = apps/pad_scanner
+	url = git@gitea.server10086.icu:admin/pad_scanner.git
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..505e3df
--- /dev/null
+++ b/README.md
@@ -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 | ✅ 确定 |
+| 后端服务 | 待定 | ⏳ 待定 |
+
+## 许可证
+
+待定
diff --git a/apps/pad_scanner b/apps/pad_scanner
new file mode 160000
index 0000000..236cfae
--- /dev/null
+++ b/apps/pad_scanner
@@ -0,0 +1 @@
+Subproject commit 236cfae485f971eba886ebe74a742283d416de34