buglab/README.md

38 lines
1.2 KiB
Markdown

# BugLab - Maze Pathfinding & Optimization Project
C++ pathfinding and maze optimization project for [buglab.ru](https://buglab.ru/).
## Project Structure
```text
buglab/
├── CMakeLists.txt # CMake build configuration (C++23)
├── Makefile # Build shortcuts (wraps CMake)
├── run.sh # Background runner with cpulimit (160% CPU)
├── README.md # Project documentation
├── src/
│ └── main.cpp # Tabu Search optimizer engine
├── docs/
│ ├── ideas.md # Short-term ideas and backlog
│ ├── observations.md # Key heuristics and insights
│ ├── research.md # General research and milestone notes
│ └── experiments/ # Detailed logs for specific experiments
└── storage/
├── labyrinths.db # SQLite database for saved labyrinths & metadata
└── schema.sql # Database schema definition
```
## Build & Run
1. **Build the project:**
```bash
make
```
2. **Run optimizer in background with resource limit:**
```bash
./run.sh ./build/optimizer
```
3. **Clean build artifacts:**
```bash
make clean
```