How yaroslavsokoi/int20h-alco-team works
AlcoDOLIV is a sales-tax order management system for New York deliveries, with a React admin console and Express API. Its core flow is an authenticated user creating or importing orders; the backend resolves delivery coordinates and tax, then persists results for search, filtering, statistics, and review. User and login administration are separate product branches. The README documents local reverse geocoding, NY boundary checks, composite rates, CSV/JSON import, and Redis caching; these capabilities are included, though some implementation links remain unverified because their sources were not excerpted.
Main entry points: App.tsx React application · app.ts API server · order.service.ts Order workflows · tax.service.ts Composite tax rates
Components 27
Admin console
- React application
frontend/src/App.tsx - Login page
frontend/src/pages/LoginPage.tsx - Orders dashboard
frontend/src/pages/DashboardPage.tsx - User management
frontend/src/pages/UsersPage.tsx - Session state
frontend/src/store/authStore.ts - Order state
frontend/src/store/orderStore.ts - Order table and charts
frontend/src/features/orders/components - User forms
frontend/src/features/users/components - API client
frontend/src/api/client.ts
API and access
- API server
backend/src/app.ts - Auth routes
backend/src/routes/auth.routes.ts - Order routes
backend/src/routes/order.routes.ts - User routes
backend/src/routes/user.routes.ts - Authentication
backend/src/services/auth.service.ts - User operations
backend/src/services/user.service.ts - User records
backend/src/repositories/user.repository.ts
Order processing
- Order handlers
backend/src/controllers/order.controller.ts - Order workflows
backend/src/services/order.service.ts - CSV and JSON parsing
backend/src/utils - Order queries
backend/src/repositories/order.repository.ts - Orders database
backend/src/repositories/db.ts
Tax and location
- Local geocoder
backend/src/clients/local-geocoder.client.ts - Composite tax rates
backend/src/services/tax.service.ts - Tax rate client
backend/src/clients/tax.client.ts - Redis cache
backend/src/clients/redis.client.ts - Nominatim fallback
backend/src/clients/nominatim.client.ts
Other components
- Admin user
Connections 31
- Admin user → React application: uses
- React application → Login page: routes to
- React application → Orders dashboard: routes to
- React application → User management: routes to
- Login page → Session state: signs in
- User management → User forms: renders
- Orders dashboard → Order table and charts: renders
- Order table and charts → Order state: uses
- Session state → API client: requests through
- Order state → API client: requests through
- User forms → API client: requests through
- API client → API server: sends API requests
- API server → Auth routes: mounts
backend/src/app.ts - API server → Order routes: mounts
backend/src/app.ts - API server → User routes: mounts
backend/src/app.ts - Auth routes → Authentication: dispatches to
backend/src/routes/auth.routes.ts - User routes → User operations: dispatches to
backend/src/routes/user.routes.ts - User operations → User records: uses
backend/src/services/user.service.ts - Authentication → User records: looks up users
backend/src/services/auth.service.ts - Order routes → Order handlers: dispatches to
backend/src/routes/order.routes.ts - Order handlers → Order workflows: calls
backend/src/controllers/order.controller.ts - Order workflows → CSV and JSON parsing: parses imports
backend/src/services/order.service.ts - Order workflows → Order queries: queries and writes
backend/src/services/order.service.ts - Order queries → Orders database: reads and writes
backend/src/repositories/order.repository.ts - Order queries → CSV and JSON parsing: parses search
backend/src/repositories/order.repository.ts - Order workflows → Composite tax rates: calculates tax
backend/src/services/order.service.ts - Composite tax rates → Local geocoder: resolves jurisdiction
- Composite tax rates → Tax rate client: gets rates
- Tax rate client → Redis cache: caches rates
backend/src/clients/tax.client.ts - Local geocoder → Redis cache: caches locations
- Composite tax rates → Nominatim fallback: optional geocoding