How angelykcoder/eggsimulator works
GallinaCoin simulates poultry farms, egg-market conditions, token trading, and farmer reinvestment over monthly periods. The visible browser workflow is user → role-specific dashboard → local simulation API → persisted state → refreshed client/farmer views. The sampled browser API explicitly uses localStorage, while the repository also contains a FastAPI service layer with parallel domain operations and JSON-file state; the excerpts do not establish that the browser currently calls that backend. Backend wiring is shown from its routes and service calls; unsampled README and business-rule details are not inferred.
Components 17
Browser application
- Dashboard page
- App controller
- Client dashboard
- Farmer dashboard
- Browser simulator
Backend API
- API routes
Simulation domain
- Market pricing
- Farm operations
- Token trading
- Monthly simulation
State and study data
- Browser market study
- Browser state
- State manager
- Backend state
- Market study
Other components
- User
- API caller
Connections 23
- User → Dashboard page: uses
- Dashboard page → App controller: presents
- App controller → Browser simulator: loads state
- Browser simulator → Browser state: reads/writes
- Browser simulator → Browser market study: reads study
- App controller → Client dashboard: renders client
- App controller → Farmer dashboard: renders farmer
- Client dashboard → Browser simulator: trades tokens
- Farmer dashboard → Browser simulator: manages farms
- API caller → API routes: calls endpoints
- API routes → State manager: reads state
- API routes → Monthly simulation: advances month
- API routes → Token trading: buys/sells
- API routes → Farm operations: farm actions
- State manager → Backend state: reads/writes
- State manager → Market study: seeds initial state
- Market pricing → Market study: loads study
- Monthly simulation → State manager: loads/saves state
- Monthly simulation → Market pricing: prices eggs
- Monthly simulation → Farm operations: calculates farm results
- Token trading → State manager: loads/saves state
- Token trading → Farm operations: looks up farm
- Farm operations → State manager: loads/saves state