1

.gitignore

@@ -0,0 +1,15 @@
+**/bin/
+**/obj/
+**/node_modules/
+**/dist/
+.vs/
+.vscode/
+*.user
+*.suo
+*.sqlite
+*.sqlite-shm
+*.sqlite-wal
+src/Jiaowu.Api/data/
+.env
+.env.*
+!.env.example

Jiaowu.slnx

@@ -0,0 +1,8 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/Jiaowu.Api/Jiaowu.Api.csproj" />
+  </Folder>
+  <Folder Name="/tests/">
+    <Project Path="tests/Jiaowu.Api.Tests/Jiaowu.Api.Tests.csproj" />
+  </Folder>
+</Solution>

README.md

@@ -0,0 +1,52 @@
+# 明序教务管理系统
+
+面向普通高校的教务管理系统。后端使用 ASP.NET Core 10、EF Core 10，前端使用 Vue 3、TypeScript 和 Element Plus。
+
+## 本地开发
+
+本地开发固定使用 SQLite。首次启动会自动创建 `src/Jiaowu.Api/data/jiaowu-dev.sqlite` 并写入演示组织数据。
+
+```powershell
+dotnet run --project src/Jiaowu.Api
+```
+
+另开一个终端：
+
+```powershell
+Set-Location web
+npm install
+npm run dev
+```
+
+访问 `http://localhost:5173`，开发账号为 `admin`，密码为 `Admin@123456`。
+
+## MySQL 部署
+
+非 Development 环境只允许使用 MySQL。连接串和 JWT 密钥应通过环境变量或安全配置中心提供：
+
+```powershell
+$env:ASPNETCORE_ENVIRONMENT = 'Production'
+$env:Database__Provider = 'MySql'
+$env:ConnectionStrings__MySql = 'Server=127.0.0.1;Port=3306;Database=jiaowu;User=YOUR_USER;Password=YOUR_PASSWORD;'
+$env:Jwt__Key = '至少32字节的随机生产密钥'
+dotnet run --project src/Jiaowu.Api
+```
+
+生产环境不会创建默认管理员。首次部署前可以临时配置 `SeedAdmin__UserName`、`SeedAdmin__Password` 和 `SeedAdmin__DisplayName`，账号创建后移除这些配置。
+
+生产数据库使用 MySQL 专用 EF Core 迁移。部署前先恢复仓库工具并检查迁移：
+
+```powershell
+dotnet tool restore
+dotnet ef migrations list --project src/Jiaowu.Api --startup-project src/Jiaowu.Api
+```
+
+应用启动时会自动执行尚未应用的 MySQL 迁移。SQLite 只用于本地开发，并通过 `EnsureCreated` 建立本地数据库；开发模型变化后，可删除本地 SQLite 文件重新生成，不能把该文件用于生产。
+
+## 验证
+
+```powershell
+dotnet test Jiaowu.slnx
+Set-Location web
+npm run build
+```