How hari10031/location-management-application works
Fieldnote is a multi-user location manager. Users register or sign in, then save places manually or import coordinates from a ZIP and explore their own locations on a map. The client routes users through authentication and protected map/upload views; the API handles authentication and location operations, with PostgreSQL as persistent storage. The graph includes the upload parsing/archive stages documented by the README and indexed source references. Some client page internals and upload implementation were not excerpted, so those relationships are shown only where documented or indexed.
Main entry points: router.jsx App routes · app.js Express app · uploadSlice.js Upload state · service.js Location service
Components 26
Fieldnote client
- Client entry
client/src/main.jsx - App routes
client/src/router.jsx - Sign-in / register
client/src/pages/AuthPage.jsx - Session guards
client/src/components/AuthRoutes.jsx - Auth state
client/src/features/auth/authSlice.js - HTTP client
client/src/api/http.js - Location map
client/src/pages/MapPage.jsx - Location state
client/src/features/locations/locationsSlice.js - ZIP import
client/src/pages/UploadPage.jsx - Upload state
client/src/features/upload/uploadSlice.js - Notifications
client/src/features/notifications/Toast.jsx
API and domain
- Express app
server/src/app.js - Auth routes
server/src/modules/auth/routes.js - Auth controller
server/src/modules/auth/controller.js - Auth service
server/src/modules/auth/service.js - User repository
server/src/modules/auth/repository.js - Location routes
server/src/modules/locations/routes.js - Location controller
server/src/modules/locations/controller.js - Location service
server/src/modules/locations/service.js - Location repository
server/src/modules/locations/repository.js - Text parser
server/src/modules/locations/parser.js - ZIP processing
server/src/modules/locations/archive.js
Persistence and security
- JWT services
server/src/lib/jwt.js - Authentication middleware
server/src/middleware/auth.js - PostgreSQL
Other components
- User
Connections 31
- User → Client entry: uses
- Client entry → App routes: renders
client/src/main.jsx - App routes → Sign-in / register: routes to
client/src/router.jsx - App routes → Session guards: guards routes
client/src/router.jsx - Session guards → Auth state: loads session
client/src/components/AuthRoutes.jsx - Sign-in / register → Auth state: dispatches auth
client/src/pages/AuthPage.jsx - Auth state → HTTP client: requests auth
client/src/features/auth/authSlice.js - App routes → Location map: routes to
client/src/router.jsx - App routes → ZIP import: routes to
client/src/router.jsx - Location map → Location state: manages places
- Location state → HTTP client: requests locations
client/src/features/locations/locationsSlice.js - ZIP import → Upload state: dispatches import
client/src/pages/UploadPage.jsx - Upload state → HTTP client: uploads archive
client/src/features/upload/uploadSlice.js - Upload state → Location state: refreshes locations
client/src/features/upload/uploadSlice.js - Upload state → Notifications: reports outcome
client/src/features/upload/uploadSlice.js - HTTP client → Express app: calls API
- Express app → Auth routes: mounts routes
server/src/app.js - Express app → Location routes: mounts routes
server/src/app.js - Auth routes → Auth controller: dispatches to
server/src/modules/auth/routes.js - Auth controller → Auth service: delegates to
- Auth service → User repository: uses users
server/src/app.js - Auth service → JWT services: issues tokens
- Express app → JWT services: creates service
server/src/app.js - Express app → Authentication middleware: creates middleware
server/src/app.js - Location routes → Location controller: dispatches to
server/src/modules/locations/routes.js - Location controller → Location service: delegates to
server/src/modules/locations/controller.js - Location service → Location repository: uses repository
server/src/app.js - Location service → ZIP processing: processes ZIP
server/src/modules/locations/service.js - Location service → Text parser: parses coordinates
server/src/modules/locations/service.js - User repository → PostgreSQL: reads / writes
- Location repository → PostgreSQL: reads / writes