How yishai946/trace works
This repository provides search-and-rescue mission coordination: commanders organize missions and teams in a web console, while field searchers join missions, share location, submit reports and sightings, and raise SOS alerts. The API services persist mission activity and timeline events; the field app also presents assigned-area reports and map data. The graph highlights the sampled command and field flows plus major API capabilities visible in the source index. Many route registrations and unsampled integrations are not evidenced here, so their connections are omitted.
Main entry points: index.ts Postgres database · timeline.service.ts Timeline service · missions.service.ts Mission service · participants.service.ts Participant service
Components 24
Command console
- Console launch
apps/command/src/App/Launch.tsx - Mission actions
apps/command/src/App/Console/useMissionActions.ts - Console queries
apps/command/src/mission/missionQueries - Mission creation
apps/command/src/pages/NewMissionPage/useNewMissionForm.ts - Mission map
apps/command/src/map/MissionMap/index.tsx
Field app
- Field mission queries
apps/field/src/mission/queries.ts - Reports screen
apps/field/src/components/ReportsScreen/useReportsScreen.ts - Map area data
apps/field/src/components/MapScreen/useMapArea.ts
API services
- API server
apps/api/src/server.ts - Authentication
apps/api/src/auth/auth.plugin.ts - Mission service
apps/api/src/modules/missions/missions.service.ts - Participant service
apps/api/src/modules/participants/participants.service.ts - Polygon service
apps/api/src/modules/polygons/polygons.service.ts - Report service
apps/api/src/modules/reports/reports.service.ts - Sighting service
apps/api/src/modules/sightings/sightings.service.ts - SOS service
apps/api/src/modules/sos/sos.service.ts - Tracking service
apps/api/src/modules/tracking/tracking.service.ts - Timeline service
apps/api/src/modules/timeline/timeline.service.ts
Shared data
- Domain rules
packages/domain/src/mission/index.ts - API schemas
packages/schemas/src/index.ts
Runtime infrastructure
- Postgres database
apps/api/src/db/index.ts - Database schema
apps/api/src/db/schema.ts
Other components
- Commander
- Field searcher
Connections 29
- Commander → Console launch: uses console
- Console launch → Mission actions: offers actions
- Mission actions → Console queries: uses queries
apps/command/src/App/Console/useMissionActions.ts - Commander → Mission creation: creates missions
- Mission creation → Console queries: uses queries
apps/command/src/pages/NewMissionPage/useNewMissionForm.ts - Commander → Mission map: manages map
- Field searcher → Reports screen: reviews reports
- Reports screen → Field mission queries: loads mission data
apps/field/src/components/ReportsScreen/useReportsScreen.ts - Reports screen → Map area data: shares report model
- Map area data → Field mission queries: loads mission data
apps/field/src/components/MapScreen/useMapArea.ts - API server → Postgres database: creates connection
apps/api/src/server.ts - API server → Database schema: configures database
- Mission service → Postgres database: reads and writes
apps/api/src/modules/missions/missions.service.ts - Participant service → Postgres database: reads and writes
apps/api/src/modules/participants/participants.service.ts - Participant service → Tracking service: uses tracking rules
apps/api/src/modules/participants/participants.service.ts - Polygon service → Postgres database: reads and writes
apps/api/src/modules/polygons/polygons.service.ts - Report service → Postgres database: reads and writes
apps/api/src/modules/reports/reports.service.ts - Report service → Timeline service: records events
apps/api/src/modules/reports/reports.service.ts - Sighting service → Postgres database: reads and writes
apps/api/src/modules/sightings/sightings.service.ts - SOS service → Postgres database: reads and writes
apps/api/src/modules/sos/sos.service.ts - SOS service → Timeline service: records events
apps/api/src/modules/sos/sos.service.ts - Mission service → Timeline service: records events
apps/api/src/modules/missions/missions.service.ts - Polygon service → Timeline service: records events
apps/api/src/modules/polygons/polygons.service.ts - Mission service → Domain rules: applies rules
apps/api/src/modules/missions/missions.service.ts - Participant service → Domain rules: applies rules
apps/api/src/modules/participants/participants.service.ts - Mission service → API schemas: uses contracts
apps/api/src/modules/missions/missions.service.ts - Report service → API schemas: uses contracts
apps/api/src/modules/reports/reports.service.ts - Authentication → Postgres database: resolves profiles
apps/api/src/auth/auth.plugin.ts - Timeline service → Postgres database: persists events
apps/api/src/modules/timeline/timeline.service.ts