chore: boilerplate for tournament + cleanup

.github/dependabot.yaml

@@ -0,0 +1,20 @@
+---
+version: 2
+updates:
+  - package-ecosystem: gomod
+    directory: /
+    schedule:
+      interval: monthly
+    groups:
+      prod:
+        patterns:
+          - "*"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    groups:
+      prod:
+        patterns:
+          - "*"

README.md

@@ -1,2 +1,57 @@
 # rush
-simple game 
+
+Rush is a five-player lane battle game that blends elements from risk and battle arena games. 
+Built in Go, the game emphasises deep, meaningful strategic decisions through [coach personas](internal/ui/rules.md), tactical playbooks, and dynamic lane-based combat.
+
+## Quick Demo
+
+![demo](./docs/rush-demo.gif)
+
+## Prerequisites
+
+- [Go](https://go.dev/doc/install) (latest stable version)
+- [Task](https://taskfile.dev/installation/) (task runner)
+- [golangci-lint](https://golangci-lint.run/usage/install/) (for linting)
+- [sqlc](https://sqlc.dev/usage/install/) (for database code generation)
+
+## Getting Started
+
+### Installation
+
+1. Clone the repository:
+   ```bash
+   git clone <repository-url>
+   cd rush
+   ```
+
+2. Tidy dependencies:
+   ```bash
+   task format
+   ```
+
+### Running the Application
+
+To run the game:
+```bash
+task dev
+```
+
+### Development
+
+We use `Taskfile.yml` to manage project tasks. To see all available commands, run:
+```bash
+task --list
+```
+
+Key tasks include:
+- `task test`: Run unit tests.
+- `task lint`: Run linters.
+- `task format`: Format code and tidy modules.
+- `task db-reset`: Reset the database to a clean state.
+- `task cover`: Generate and show test coverage.
+
+## Project Structure
+
+- `cmd/`: Application entrypoint.
+- `internal/`: Core application logic.
+- `docs/`: Documentation.

cmd/rush/main.go

@@ -2,6 +2,7 @@ package main
 
 import (
 	"context"
+	"database/sql"
 	"log/slog"
 	"os"
 
@@ -11,6 +12,7 @@ import (
 	"github.com/code-gorilla-au/rush/internal/games"
 	"github.com/code-gorilla-au/rush/internal/playbooks"
 	"github.com/code-gorilla-au/rush/internal/teams"
+	"github.com/code-gorilla-au/rush/internal/tournaments"
 	"github.com/code-gorilla-au/rush/internal/ui"
 )
 
@@ -42,6 +44,14 @@ func main() {
 	playbooksSvc := playbooks.NewPlaybooksService(queries)
 	teamsSvc := teams.NewTeamsService(queries, playbooksSvc)
 	gameSvc := games.NewService(queries)
+	_ = tournaments.NewService(tournaments.ServiceDependencies{
+		GamesSvc: gameSvc,
+		TeamsSvc: teamsSvc,
+		Store:    queries,
+		TxnFunc: func(txDB *sql.Tx) tournaments.Store {
+			return database.New(txDB)
+		},
+	})
 
 	go func() {
 		hasAICoaches, tErr := teamsSvc.HasAICoaches(ctx)

internal/database/db.go

@@ -2,6 +2,7 @@ package database
 
 import (
 	"database/sql"
+	"fmt"
 
 	_ "modernc.org/sqlite"
 )
@@ -15,3 +16,21 @@ func NewSqLiteProvider(dbPath string) (*sql.DB, error) {
 
 	return db, nil
 }
+
+func WithTxnCtx(db *sql.DB, fn func(tx *sql.Tx) error) error {
+	tx, err := db.Begin()
+	if err != nil {
+		return err
+	}
+
+	err = fn(tx)
+	if err != nil {
+		if rErr := tx.Rollback(); rErr != nil {
+			return fmt.Errorf("tx rollback failed: %w", rErr)
+		}
+
+		return fmt.Errorf("txn rolled back due to error: %w", err)
+	}
+
+	return tx.Commit()
+}