@@ -59,12 +59,14 @@ docker-compose -f docker-compose.proxy-test.yml up
5959### CI/CD and Linting
6060
6161The project uses GitHub Actions for automated checks:
62+
6263- ** hadolint** - Dockerfile linting
6364- ** shellcheck** - Shell script validation
6465- ** markdownlint** - Markdown formatting
6566- ** deploy** - Multi-arch build and push to GHCR on main branch changes
6667
6768To run linters locally:
69+
6870``` bash
6971hadolint Dockerfile
7072shellcheck rootfs/** /* .sh
@@ -76,13 +78,15 @@ markdownlint *.md
7678### S6-Overlay Service
7779
7880The s6 service configuration is critical for Docker container operation:
81+
7982- Run script must use ` #!/command/with-contenv bash ` (not ` /usr/bin/with-contenv ` )
8083- Service runs as root (no ` abc ` user in base image)
8184- Located at ` /etc/s6-overlay/s6-rc.d/aircraft-circle/run `
8285
8386### Reverse Proxy Support
8487
8588The application supports mounting at subpaths (e.g., ` /circles/ ` ):
89+
8690- JavaScript dynamically detects base URL from ` window.location.pathname `
8791- All navigation uses relative links (` ./ ` , ` history ` not ` / ` , ` /history ` )
8892- API calls use computed ` baseUrl + '/api/...' `
@@ -91,6 +95,7 @@ The application supports mounting at subpaths (e.g., `/circles/`):
9195### Pattern Detection Parameters
9296
9397Key thresholds that affect detection sensitivity:
98+
9499- Circle: MIN_RADIUS=0.5km, MAX_RADIUS=10km, MIN_TURNS=1.5
95100- Grid: MIN_GRID_LEGS=3, MIN_LEG_LENGTH=2.0km
96101- Data quality: max_speed_kmh=1000, max_position_jump_km=5.0
@@ -106,6 +111,7 @@ Key thresholds that affect detection sensitivity:
106111### CSV Data Files
107112
108113Pattern detections are logged to:
114+
109115- ` /app/circle_detections.csv ` - Circular patterns
110116- ` /app/grid_detections.csv ` - Grid patterns
111117
@@ -124,8 +130,9 @@ Each entry includes timestamp, aircraft info, pattern parameters, and TAR1090 re
124130## Testing TAR1090 Connection
125131
126132The application expects TAR1090 API format:
133+
127134``` bash
128135curl http://your-tar1090/data/aircraft.json
129136```
130137
131- Should return JSON with ` aircraft ` or ` ac ` array containing objects with lat, lon, hex, flight fields.
138+ Should return JSON with ` aircraft ` or ` ac ` array containing objects with lat, lon, hex, flight fields.
0 commit comments