peterjohn89/military-study-capability-desk

ASEAN Army Platform Comparison

Responsive web app for comparing public-source Army platform assets across ASEAN countries. The current product focuses on tanks, light tanks, tracked AFVs, wheeled AFVs / Terrex-class vehicles, protected transport, and mobile fire-support platforms.

What It Does

• —Compares two ASEAN countries at a time by selected Army platform group.
• —Scores each platform across armour and survivability, firepower, sensors and fire control, C-UAS / active protection evidence, mobility, and sustainment.
• —Shows a quick dashboard, engineering factor analysis, fleet pair matrix, and matchup citations.
• —Stores consolidated platform data in data/repository/platforms.json, with optional Hugging Face Dataset sync.
• —Runs locally from Visual Studio Code and deploys as a Docker Hugging Face Space for public laptop and mobile browser access.

Local Development In VS Code

For the complete run guide, see docs/RUNNING.md. For public web hosting, see docs/DEPLOYMENT.md. For scoring logic, see docs/ANALYSIS_MODEL.md.

1. 1.Open this folder in Visual Studio Code.
2. 2.Install dependencies:

   npm.cmd install

1. 1.Start development mode:

   npm.cmd run dev

1. 1.Open http://localhost:5173.

PowerShell may block npm.ps1 on some Windows machines. Use npm.cmd from PowerShell if that happens.

Hugging Face Dataset Layout

Create a dataset repo such as your-user/military-study-repository and upload this file under data/:

• —platforms.json: ASEAN country list, platform groups, scoring weights, source references, and Army platform factor assessments.

The app reads from Hugging Face when HF_DATASET_REPO is configured. Without that variable, it uses the local seed file in data/repository/platforms.json.

Recommended Hosting

Use Hugging Face Spaces with the Docker SDK. This gives users a normal HTTPS URL that works from phones and laptop browsers, while Hugging Face Dataset storage remains the data repository.

Deployment outline:

1. 1.Create a Hugging Face Dataset repo and upload data/platforms.json.
2. 2.Create a Hugging Face Space.
3. 3.Select Docker as the Space SDK.
4. 4.Push this repository to the Space.
5. 5.Add Space secrets:
6. 6.HF_DATASET_REPO
7. 7.HF_TOKEN if the Space needs private dataset access
8. 8.Open the Space URL on a laptop or mobile browser.

Useful Commands

npm.cmd run typecheck
npm.cmd test
npm.cmd run build
npm.cmd run start
npm.cmd run seed:hf

Data And Source Discipline

This app is designed for public open-source study only. Scores are engineering-oriented comparisons of cited platform characteristics, not predictions of combat outcomes. It excludes classified readiness, ammunition stocks, exact serviceability, crew proficiency, terrain, real-time force disposition, and operational intent.