Skip to content

About

Lightweight, comprehensive management dashboard for a gaming community. Features member management, automated multi-platform tracking with War Thunder, Arma 3 and Discord integration.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

7BOW WGST Clan Management System

A lightweight, server-rendered clan ERP and management dashboard designed for a War Thunder and Arma 3 gaming community. The system tracks member lifecycle history, community nicknames, core/section ranks, awards, and multi-platform account associations over time.

Key Features

  • Member Management: Tracks community members, lifecycle events (joins, leaves, kicks), rank changes, awards, and statuses.
  • Multi-Platform Accounts: Distinguishes concepts of member identity from external platform and game accounts - supporting Discord, War Thunder, Arma 3 Units and Steam.
  • History Tracking: Preserves historical records for anything that changes over time (nicknames, ranks, platform linkages and relations).
  • Source Auditability: Distinguishes manual administrative entries from automated data, with manual inputs taking priority.
  • Role-Based Access: Secure, role-restricted dashboard access tailored for Owners, Administrators, and Members.

Tech Stack

  • Runtime & Package Manager: Bun (>= 1.4)
  • Web Framework: Hono (Server-Side Rendering via Hono JSX)
  • Database Query Builder: Kysely
  • Database Driver: pg (PostgreSQL running as a local Windows service)
  • UI Framework: Bootstrap 5 (loaded strictly via CDN)

Quick Start

Prerequisites

  • Installed Bun runtime (>= 1.4)
  • Active local PostgreSQL instance (e.g. database clan_management)

Step-by-Step

  1. Clone the repository:

    git clone https://github.com/7BOW-WGST/ClanManagementSystem
    cd ClanManagementSystem
  2. Install dependencies:

    bun install
  3. Configure the environment:

    Copy .env.example to .env and set DATABASE_URL to match your local PostgreSQL instance.

  4. Prepare the database:

    bun run migrate
    bun run seed
  5. Run the development server (Hot Reload):

    bun run dev

    Open http://localhost:3000. Use bun run test to run the test suite.

Scripts

Command Purpose
bun run dev Development server with hot reload
bun run start Start the server once
bun run migrate Apply database migrations
bun run seed Seed catalog data (sections)
bun run test Run tests (bun:test)
bun run typecheck Type-check the project

Documentation & Development

AI-assisted and human contributions are governed by strict project standards:

About

Lightweight, comprehensive management dashboard for a gaming community. Features member management, automated multi-platform tracking with War Thunder, Arma 3 and Discord integration.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages