How seedcompany/cord-field works
CORD Field is the React UI for field-program management, backed by a separately hosted CORD API. The principal user workflow is to open the application, browse or manage program entities through lists and grids, and receive query or mutation results through Apollo. The tree also shows distinct reporting, changeset, collaboration, and file-upload capabilities. Sampled code supports the application-provider setup and list-query behavior; most domain screens were not sampled, so their detailed call wiring is not inferred.
Main entry points: createClient.ts Apollo client · App.tsx React application · server.ts Seed API proxy · List Lists and grids
Components 19
Application shell
- React application
src/App.tsx - Session and auth
src/components/Session - Web server
src/server/server.ts
API and data
- Apollo client
src/api/client/createClient.ts - GraphQL cache
src/api/client/createCache.ts - Seed API proxy
src/server/server.ts - Community seed data
src/api/seed
Program management
- Lists and grids
src/components/List - Projects and partners
src/components/ProjectDataGrid - Languages and engagements
src/components/LanguageDataGrid - Field regions and zones
src/components/FieldRegion - Reports and budgets
src/components/PeriodicReports
Collaboration and files
- Changesets
src/components/Changeset - Comments
src/components/Comments - File uploads
src/components/Upload - File previews
src/components/files/FilePreview/useFilePreview.tsx
Other components
- Field user
- CORD API
- Seed API
Connections 18
- Field user → React application: uses
- React application → Apollo client: provides client
- React application → Session and auth: provides session
- Apollo client → GraphQL cache: uses cache
- Apollo client → CORD API: sends GraphQL
- Web server → CORD API: logout mutation
- Web server → Seed API proxy: serves proxy
- Seed API proxy → Seed API: forwards GraphQL
- Community seed data → Seed API proxy: requests data
- Lists and grids → Apollo client: queries pages
- Projects and partners → Lists and grids: uses list queries
- Languages and engagements → Lists and grids: uses list queries
- Field regions and zones → CORD API: manages records
- Reports and budgets → CORD API: loads and updates
- Changesets → CORD API: loads diffs
- Comments → CORD API: loads and updates
- File uploads → CORD API: submits file data
- File previews → Field user: shows preview