How colingoonth/risk-management works
Risk Management is an offline-first, single-user app for a fraternity risk chair to manage event staffing and member discipline. The main workflow is to maintain a roster and term, create events, preview or make fair shift assignments, then handle swaps and strikes; the app also supports term archiving and GroupMe operations. The README describes a React-to-FastAPI-to-services-to-repositories-to-SQLite layering. Some routers and services were not sampled, so their internal call relationships are not detailed here.
Main entry points: services Business Services · app.py HTTP API · App.tsx Web App · pages Management Pages
Components 20
User Interfaces
- Web App
web/src/App.tsx - Management Pages
web/src/pages - Typed API Client
web/src/lib/api.ts - Command Line
src/risk/cli/main.py - Desktop Launcher
src/risk/desktop/__main__.py
Application Backend
- HTTP API
src/risk/api/app.py - Roster Ingest Route
src/risk/api/routers/ingest.py - Business Services
src/risk/services
Risk Workflows
- Roster and Strike Ingest
src/risk/services/ingest.py - Fair Shift Assignment
src/risk/services/assignment.py - Eligibility and Availability
src/risk/services/eligibility.py - Assignment Fairness
src/risk/services/fairness.py - Pledge and House Policy
src/risk/services/policy.py - Strike Tracking
src/risk/services/strike_state.py - Shift Swaps
src/risk/services/swaps.py - GroupMe Operations
src/risk/services/groupme.py
Local Data
- SQL Repositories
src/risk/repos - SQLite Access and Schema
src/risk/db/connection.py - Local SQLite Database
Other components
- Risk Chair
Connections 20
- Risk Chair → Web App: uses
README.md - Risk Chair → Command Line: uses
README.md - Web App → Management Pages: routes to
web/src/App.tsx - Management Pages → Typed API Client: requests data
web/src/pages/Ops.tsx - Typed API Client → HTTP API: HTTP requests
web/src/lib/api.ts - HTTP API → Roster Ingest Route: registers routes
src/risk/api/app.py - Roster Ingest Route → Roster and Strike Ingest: calls
src/risk/api/routers/ingest.py - HTTP API → Business Services: uses business rules
README.md - Command Line → Roster and Strike Ingest: runs ingest
- Business Services → SQL Repositories: uses
README.md - SQL Repositories → SQLite Access and Schema: executes SQL
README.md - SQLite Access and Schema → Local SQLite Database: reads and writes
README.md - Business Services → Fair Shift Assignment: includes
README.md - Business Services → Eligibility and Availability: includes
README.md - Business Services → Assignment Fairness: includes
README.md - Business Services → Pledge and House Policy: includes
README.md - Business Services → Strike Tracking: includes
README.md - Business Services → Shift Swaps: includes
README.md - Business Services → GroupMe Operations: includes
- Desktop Launcher → HTTP API: starts
src/risk/desktop/__main__.py