# dispatch-docs

**Repository Path**: baichen9187/dispatch-docs

## Basic Information

- **Project Name**: dispatch-docs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-04-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



Based on the provided code map, I can see this is a VitePress-based documentation project. Let me analyze the key components to create a proper README.md.

Looking at the code map:

1. **Project Type**: A technical documentation site built with VitePress
2. **Main Content**: Documentation about "Dispatch 调度系统" (Dispatch scheduling system)
3. **Key Files**:
   - `docs/home.md` - Main documentation page for Dispatch system
   - `docs/dispathch-network.md` - Network architecture and routing documentation
   - `docs/index.md` - Index linking to network docs
   - `Dockerfile` - Container build configuration
   - `CLAUDE.md` - Project metadata

Now I'll create the README.md based on this analysis:

---

# Dispatch 调度系统文档

本项目是 Dispatch 调度系统的技术文档站点，使用 [VitePress](https://vitepress.dev/) 构建。

## 项目简介

Dispatch 是一个企业级调度系统，提供完整的服务架构和网络路由管理。本文档详细记录了系统的网络架构、请求路由、K8s 集群部署以及日常运维中的排障记录。

## 文档内容

### 核心文档

- **系统概览** (`docs/home.md`) - Dispatch 调度系统服务介绍
- **网络架构** (`docs/dispathc-network.md`) - 完整的网络架构与请求路由详解
- **部署架构** - CI/CD 流程与 Helm 部署参数

### 网络分层

文档详细描述了六层网络架构：

1. 外网接入层
2. 宿主机防火墙 (firewalld/nftables)
3. 宿主机 Nginx (宝塔面板)
4. K8s Ingress (Nginx Ingress Controller)
5. K8s Service (kube-proxy)
6. Pod 网络 (Flannel CNI)

### 排障记录

包含多个实际问题的排查与修复记录：

- Ingress Service Name 不匹配导致 503 错误
- firewalld 阻断 Pod 间通信导致 502 错误
- 前端静态资源 404 导致页面白屏
- API 调用配置缺失问题

## 快速开始

### 本地开发

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run docs:dev

# 构建静态站点
npm run docs:build
```

### Docker 部署

项目已配置 Dockerfile，可直接构建 Docker 镜像：

```bash
docker build -t dispatch-docs .
docker run -d -p 80:80 dispatch-docs
```

或者使用 docker-compose：

```bash
docker-compose up -d
```

## 技术栈

- **文档框架**: VitePress
- **前端框架**: Vue 3
- **容器化**: Docker / Nginx
- **编排**: Kubernetes + Helm

## 项目结构

```
├── CLAUDE.md              # 项目元数据
├── Dockerfile            # Docker 构建配置
├── docs/
│   ├── index.md          # 文档首页
│   ├── home.md           # 系统概览
│   └── dispathch-network.md  # 网络架构文档
└── package.json          # 项目依赖
```

## 相关链接

- [VitePress 官方文档](https://vitepress.dev/)
- [Vue 3 文档](https://vuejs.org/)

---

这是一个内部技术文档项目，主要用于记录 Dispatch 调度系统的架构设计和运维经验。