Initial: main repo with docker-compose and submodules

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "HarborForge.Backend"]
+	path = HarborForge.Backend
+	url = https://git.hangman-lab.top/zhi/HarborForge.Backend.git

README.md

@@ -0,0 +1,32 @@
+# HarborForge
+
+Agent/人类协同任务管理平台
+
+## 项目结构
+
+```
+HarborForge/
+├── HarborForge.Backend/    # 后端 (FastAPI + MySQL)
+├── HarborForge.Frontend/   # 前端 (React) - 规划中
+├── HarborForge.Cli/       # CLI 工具 - 规划中
+└── docker-compose.yml      # 部署配置
+```
+
+## 快速开始
+
+```bash
+# 克隆并初始化子模块
+git clone https://git.hangman-lab.top/zhi/HarborForge.git
+cd HarborForge
+git submodule update --init --recursive
+
+# 启动服务
+cp .env.example .env
+docker compose up -d
+```
+
+## 子模块
+
+- [HarborForge.Backend](https://git.hangman-lab.top/zhi/HarborForge.Backend) - 后端 API
+- [HarborForge.Frontend](https://git.hangman-lab.top/zhi/HarborForge.Frontend) - 前端 (规划中)
+- [HarborForge.Cli](https://git.hangman-lab.top/zhi/HarborForge.Cli) - CLI 工具 (规划中)

docker-compose.yml

@@ -0,0 +1,91 @@
+version: '3.8'
+
+services:
+  # MySQL Database
+  mysql:
+    image: mysql:8.0
+    container_name: harborforge-mysql
+    restart: unless-stopped
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-harborforge_root}
+      MYSQL_DATABASE: ${MYSQL_DATABASE:-harborforge}
+      MYSQL_USER: ${MYSQL_USER:-harborforge}
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD:-harborforge_pass}
+    volumes:
+      - mysql_data:/var/lib/mysql
+    ports:
+      - "3306:3306"
+    networks:
+      - harborforge
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    deploy:
+      resources:
+        limits:
+          cpus: '0.5'
+          memory: 512M
+
+  # FastAPI Backend
+  backend:
+    build:
+      context: ./HarborForge.Backend
+      dockerfile: Dockerfile
+    container_name: harborforge-backend
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: mysql+pymysql://${MYSQL_USER:-harborforge}:${MYSQL_PASSWORD:-harborforge_pass}@mysql:3306/${MYSQL_DATABASE:-harborforge}
+      SECRET_KEY: ${SECRET_KEY:-change_me_in_production}
+      LOG_LEVEL: ${LOG_LEVEL:-INFO}
+    ports:
+      - "8000:8000"
+    depends_on:
+      mysql:
+        condition: service_healthy
+    networks:
+      - harborforge
+    volumes:
+      - ./HarborForge.Backend:/app
+    deploy:
+      resources:
+        limits:
+          cpus: '0.5'
+          memory: 512M
+
+  # React Frontend (optional, for future)
+  # frontend:
+  #   build:
+  #     context: ./frontend
+  #     dockerfile: Dockerfile
+  #   container_name: harborforge-frontend
+  #   restart: unless-stopped
+  #   ports:
+  #     - "3000:3000"
+  #   depends_on:
+  #     - backend
+  #   networks:
+  #     - harborforge
+  #   volumes:
+  #     - ./frontend:/app
+  #     - /app/node_modules
+
+  # CLI (run on demand)
+  # cli:
+  #   build:
+  #     context: ./cli
+  #     dockerfile: Dockerfile
+  #   volumes:
+  #     - ./cli:/app
+  #     - ~/.harborforge:/root/.harborforge
+  #   networks:
+  #     - harborforge
+
+networks:
+  harborforge:
+    driver: bridge
+
+volumes:
+  mysql_data:
+    driver: local