# wuziqi

**Repository Path**: RichardLemonTea/wuziqi

## Basic Information

- **Project Name**: wuziqi
- **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-03-17
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gomoku Django Minimal Demo

This is a minimal local Django demo for a Gomoku game website.

## Quick Start

```bash
cd /Users/richardluo/Documents/Code/Python/five
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python manage.py migrate
.venv/bin/python manage.py runserver
```

Open your browser at:

`http://127.0.0.1:8000/`

## Included Features (Minimal)

- Django project/app structure
- One playable 15x15 Gomoku board page
- Local two-player turns (black/white)
- Win detection (five in a row)
- Restart button

## Notes

- This is a local MVP demo, not a production-ready multiplayer server.
- Next upgrade can add accounts, rooms, WebSocket real-time matches, and ranking.

## CentOS Deployment

This repo includes a CentOS deployment script that installs Python and Nginx,
syncs the repo into `/srv/wuziqi`, creates a virtual environment, runs Django
migrations, collects static files, and configures `systemd` plus Nginx.

Run on the target server as root:

```bash
cd /path/to/wuziqi
chmod +x deploy/centos/deploy.sh
sudo DOMAIN=your-server-domain-or-ip bash deploy/centos/deploy.sh
```

Generated runtime files:

- App directory: `/srv/wuziqi`
- Env file: `/etc/wuziqi/wuziqi.env`
- Service file: `/etc/systemd/system/wuziqi.service`
- Nginx file: `/etc/nginx/conf.d/wuziqi.conf`

If you need to change hosts or trusted origins later, edit:

`/etc/wuziqi/wuziqi.env`

## Notebook Tests

The repository includes a notebook-based smoke test at:

`tests/gomoku_smoke_tests.ipynb`

Install test-only dependencies and execute it with:

```bash
pip install -r requirements-test.txt
python -m nbclient.cli tests/gomoku_smoke_tests.ipynb
```