# 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-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dispatch Scheduling System Documentation

This project is a technical documentation site for the Dispatch Scheduling System, built with [VitePress](https://vitepress.dev/).

## Project Overview

Dispatch is an enterprise-grade scheduling system providing a comprehensive service architecture and network routing management. This documentation details the system's network architecture, request routing, K8s cluster deployment, and troubleshooting records from daily operations.

## Documentation Content

### Core Documents

- **System Overview** (`docs/home.md`) - Introduction to the Dispatch Scheduling System
- **Network Architecture** (`docs/dispatch-network.md`) - Detailed explanation of the complete network architecture and request routing
- **Deployment Architecture** - CI/CD workflows and Helm deployment parameters

### Network Layers

The documentation describes a six-layer network architecture:

1. External Access Layer
2. Host Firewall (firewalld/nftables)
3. Host Nginx (BT Panel)
4. K8s Ingress (Nginx Ingress Controller)
5. K8s Service (kube-proxy)
6. Pod Network (Flannel CNI)

### Troubleshooting Records

Includes real-world issue resolution logs:

- 503 errors caused by Ingress Service name mismatch
- 502 errors due to firewalld blocking inter-Pod communication
- Frontend static resource 404 errors causing blank pages
- Missing API configuration issues

## Getting Started

### Local Development

```bash
# Install dependencies
npm install

# Start development server
npm run docs:dev

# Build static site
npm run docs:build
```

### Docker Deployment

The project includes a Dockerfile for building a Docker image:

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

Or use docker-compose:

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

## Technology Stack

- **Documentation Framework**: VitePress
- **Frontend Framework**: Vue 3
- **Containerization**: Docker / Nginx
- **Orchestration**: Kubernetes + Helm

## Project Structure

```
├── CLAUDE.md              # Project metadata
├── Dockerfile             # Docker build configuration
├── docs/
│   ├── index.md           # Documentation homepage
│   ├── home.md            # System overview
│   └── dispatch-network.md # Network architecture documentation
└── package.json           # Project dependencies
```

## Related Links

- [VitePress Official Documentation](https://vitepress.dev/)
- [Vue 3 Documentation](https://vuejs.org/)

---

This is an internal technical documentation project designed to record the architectural design and operational experience of the Dispatch Scheduling System.