Appearance
快速开始
本指南帮助开发者在本地搭建 KanTime 开发环境。
环境要求
| 工具 | 版本要求 | 说明 |
|---|---|---|
| .NET SDK | 10.0+ | 下载地址 |
| Docker | 最新版 | 必需，用于运行数据库容器 |
| Node.js | 18+ | 用于文档站点开发 |
| IDE | VS 2022 / VS Code / Rider | 任选其一 |
获取代码
内网地址
仓库地址为珠海分部内网 Gitea 地址，需连接公司内网访问。
bash
# 克隆仓库（含子模块）
git clone --recurse-submodules https://192.168.100.190:3001/kantime/kantime-next
cd kantime-next
# 如果已克隆但缺少子模块
git submodule update --init --recursive运行项目
前置条件
请确保 Docker Desktop 已启动并正常运行。
方式一：通过命令行启动
项目集成了 .NET Aspire 用于本地开发编排，启动时会自动创建 PostgreSQL 数据库容器，无需手动配置数据库。
bash
dotnet run --project kantime.AppHost/kantime.AppHost.csproj启动后会自动打开 Aspire Dashboard，点击 Web 项目链接即可访问。
方式二：Visual Studio
- 打开
kantime.slnx解决方案 - 将
kantime.AppHost设为启动项目 - 按
F5启动调试
同样会自动创建数据库容器。
数据库迁移
首次运行或模型变更后，执行数据库迁移：
bash
cd kantime/kantime
dotnet ef database update默认账号
系统启动时会自动创建默认管理员：
| 用户名 | 密码 | 角色 |
|---|---|---|
| admin | kantime | 管理员 |
安全提醒
生产环境请务必修改默认密码！
文档站点
文档使用 VitePress 构建，开发模式：
bash
cd docs
npm install
npm run docs:dev构建生产版本：
bash
npm run docs:build