init

README.md

@@ -0,0 +1,71 @@
+# K12Study
+
+K12Study 是首版 K12 智能学习系统项目骨架，当前聚焦“可运行基础框架”，用于承接多区域、多租户、多角色的后续业务建设。
+
+## 目录结构
+
+- `backend`: Java 多模块后端、网关、本地聚合启动、Python AI 占位服务
+- `frontend`: 单一 React 管理端项目，保留 `api / types / utils / components / dynamic route`
+- `app`: 微信小程序项目骨架，独立于 Web 管理端
+- `init/pg`: PostgreSQL 初始化脚本，按模块拆分维护
+- `docs`: 产品、架构和实施计划文档
+
+## 运行模式
+
+- 分布式模式：独立启动 `gateway`、`auth`、`upms`、`python-ai`
+- 本地模式：通过 `backend/boot-dev` 单进程暴露 `/api/auth/**`、`/api/upms/**`
+
+## VS Code Docker Dev
+
+提供两套 dev container：
+
+- `.devcontainer/external/devcontainer.json`
+  连接外部 PostgreSQL / Redis
+- `.devcontainer/internal/devcontainer.json`
+  在开发环境内部创建 PostgreSQL / Redis
+
+代码与本地目录同步方式是 Docker bind mount，不是额外复制：
+
+- 宿主机项目目录直接挂载到容器工作目录
+- 本地改代码，容器内实时可见
+- 容器里安装的依赖和运行环境与本地源码共用同一份工程目录
+
+## 快速开始
+
+### Backend
+
+```bash
+cd backend
+mvn -q -DskipTests package
+```
+
+### Frontend
+
+```bash
+cd frontend
+pnpm install
+pnpm dev
+```
+
+### App
+
+```bash
+cd app
+npm run dev
+```
+
+然后使用微信开发者工具打开 `app/project.config.json`。
+
+### Python AI
+
+```bash
+cd backend/python-ai
+pip install -r requirements.txt
+uvicorn app.main:app --reload --port 9000
+```
+
+### Infrastructure
+
+```bash
+docker compose up -d postgres redis
+```