# 刷课平台后端 架构总入口

> 状态：骨架（待填充）
> 创建日期：2026-04-25

## 1. 项目简介

刷课平台后端，提供登录、课程列表获取、网课记录查询、学习接口等功能。前端项目为 wk-frontend（git submodule），通过 Taskfile 管理构建与开发流程。

## 2. 核心概念 / 术语表

（待填充）

## 3. 子系统 / 模块索引

| 目录 | 职责 |
|---|---|
| `cmd/` | 启动入口 |
| `internal/ckwk/` | 网课接口封装 |
| `internal/conf/` | 项目配置 |
| `internal/dto/` | 请求响应实体 |
| `internal/handler/` | 控制层 |
| `internal/middleware/` | 中间件 |
| `internal/router/` | 路由定义 |
| `internal/schedule/` | 定时任务 |
| `pkg/common/` | 通用工具 |
| `pkg/log/` | 日志 |
| `pkg/request/` | 请求库 |
| `web/frontend/` | 前端项目（submodule） |
| `web/web.go` | 构建时读取前端输出目录 |

## 4. 关键架构决定

（待填充）

## 5. 已知约束 / 硬边界

（待填充）