tech/gamma-nuclide-analyzer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Gamma Nuclide Analyzer
74 commits 3 branches 0 tags 412 KiB
  • Python 54.3%
  • TypeScript 32.9%
  • CSS 12.3%
  • Dockerfile 0.4%
  • HTML 0.1%
Find a file
Exact
TechBerry Admin 2daaa45451
All checks were successful
CI / docker (push) Successful in 2m0s
Details
CI / backend (push) Successful in 51s
Details
CI / frontend (push) Successful in 9m54s
Details
CI / deploy (push) Successful in 35s
Details
ci: use dedicated FORGEJO_REGISTRY_TOKEN for container registry push 
GITHUB_TOKEN in Forgejo Actions lacks packages:write access (reqPackageAccess).
Use persistent ci-registry-push token (write:package scope) instead.
Also disable provenance attestation (not supported by Forgejo registry).
2026-05-13 17:31:15 +02:00
.forgejo/workflows ci: use dedicated FORGEJO_REGISTRY_TOKEN for container registry push 2026-05-13 17:31:15 +02:00
backend feat: nuclide ID + calibration check + fit-parameter uncertainties (#25) 2026-05-11 22:37:10 +02:00
deploy Add container publishing and deployment pipeline 2026-04-08 16:03:49 +02:00
docs chore: remove broken ui-smoke test and Playwright machinery (#4) 2026-05-11 15:31:07 +02:00
frontend feat: nuclide ID + calibration check + fit-parameter uncertainties (#25) 2026-05-11 22:37:10 +02:00
validation Add validation reference catalog 2026-04-08 21:56:46 +02:00
.dockerignore Add container publishing and deployment pipeline 2026-04-08 16:03:49 +02:00
.gitignore Add container publishing and deployment pipeline 2026-04-08 16:03:49 +02:00
CLAUDE.md Add Claude issue automation + dev-staging discipline (#1) 2026-05-11 14:46:49 +02:00
docker-compose.yml Add container publishing and deployment pipeline 2026-04-08 16:03:49 +02:00
Dockerfile Add container publishing and deployment pipeline 2026-04-08 16:03:49 +02:00
package.json chore: remove broken ui-smoke test and Playwright machinery (#4) 2026-05-11 15:31:07 +02:00
README.md Add user guide 2026-04-08 19:26:50 +02:00

README.md

Gamma Nuclide Analyzer

A Docker-first web application for automated gamma spectrum analysis from N42 data.

Vision

Gamma Nuclide Analyzer is a clean, modern web application for importing N42 gamma spectra, detecting peaks, fitting lines, proposing nuclide matches, and exporting reproducible results.

Planned architecture

  • Backend: FastAPI, scientific analysis services, REST API
  • Frontend: React + TypeScript + Vite
  • Storage: SQLite for metadata, filesystem for imported data and exports
  • Deployment: Docker Compose
  • Quality: Clean architecture, strong unit test coverage, CI

Repository structure

backend/     FastAPI application, analysis core, tests
frontend/    React application
docker/      Container-related assets
docs/        Specifications and design notes
scripts/     Developer helper scripts

Current status

The project now has a usable first MVP for browser-based gamma spectrum analysis.

Current capabilities include:

  • ZIP upload through the web UI
  • experiment and spectrum browsing
  • spectrum plotting
  • peak detection with adjustable thresholds
  • first peak integration preview
  • Gaussian fit preview with fit warnings
  • line tracking across spectra of one experiment
  • saved line result tables
  • CSV export for saved lines and experiment summary
  • Playwright smoke testing for the core UI workflow

A concise status snapshot is kept in docs/mvp-status.md. A user-oriented guide is available in docs/user-guide.md.

Deployment

The repository includes:

  • CI for backend tests and frontend build
  • Docker image publishing to GHCR
  • SSH-based deployment workflow for a Docker host
  • a deployment compose file under deploy/

See docs/deployment.md for setup details.