How joabss/correai-api works
CorreAI is an anonymous-user running and walking API. A client obtains a JWT, then submits and browses activities and requests goal progress and performance statistics. The graph follows the documented hexagonal boundary from web controllers through application services to persistence and token adapters. Source excerpts show activity, goal, and statistics orchestration; the README documents authentication middleware and the broader port-to-adapter wiring. Persistence and middleware implementation details were not sampled, so their edges rely on that documentation.
Main entry points: ActivityApplicationService.java Activity workflow · GoalApplicationService.java Goal workflow · AuthApplicationService.java Anonymous auth · UserContextInterceptor.java User context
Components 18
Web API
- Auth endpoint
src/main/java/com/correai/api/adapter/in/web/auth/AuthController.java - Activity endpoints
src/main/java/com/correai/api/adapter/in/web/activity/ActivityController.java - Goal endpoints
src/main/java/com/correai/api/adapter/in/web/goal/GoalController.java - Stats endpoints
src/main/java/com/correai/api/adapter/in/web/stats/StatsController.java - User context
src/main/java/com/correai/api/adapter/in/web/config/UserContextInterceptor.java
Application workflows
- Anonymous auth
src/main/java/com/correai/api/application/auth/AuthApplicationService.java - Activity workflow
src/main/java/com/correai/api/application/activity/ActivityApplicationService.java - Goal workflow
src/main/java/com/correai/api/application/goal/GoalApplicationService.java - Statistics workflow
src/main/java/com/correai/api/application/stats/StatsApplicationService.java - Streak calculator
src/main/java/com/correai/api/application/common/StreakCalculator.java
Domain models
- Activity model
src/main/java/com/correai/api/domain/model/activity/Activity.java - Goal model
src/main/java/com/correai/api/domain/model/goal/Goal.java
Outbound adapters
- Activity persistence
src/main/java/com/correai/api/adapter/out/persistence/activity - Goal persistence
src/main/java/com/correai/api/adapter/out/persistence/goal - User persistence
src/main/java/com/correai/api/adapter/out/persistence/user - JWT adapter
src/main/java/com/correai/api/adapter/out/security/JwtTokenAdapter.java
Other components
- API client
- PostgreSQL
Connections 25
- API client → Auth endpoint: requests token
- Auth endpoint → Anonymous auth: issues token
src/main/java/com/correai/api/adapter/in/web/auth/AuthController.java - Anonymous auth → User persistence: saves user
- Anonymous auth → JWT adapter: issues or verifies
- API client → Activity endpoints: sends requests
- API client → Goal endpoints: requests goals
- API client → Stats endpoints: requests stats
- Activity endpoints → User context: receives user context
- Stats endpoints → User context: receives user context
- Goal endpoints → User context: receives user context
- User context → Anonymous auth: authenticates token
- Activity endpoints → Activity workflow: invokes use cases
- Goal endpoints → Goal workflow: invokes use cases
- Stats endpoints → Statistics workflow: invokes use cases
- Activity workflow → Activity model: creates activities
src/main/java/com/correai/api/domain/model/activity/Activity.java - Activity workflow → Streak calculator: calculates streak
src/main/java/com/correai/api/application/activity/ActivityApplicationService.java - Statistics workflow → Streak calculator: calculates streak
src/main/java/com/correai/api/application/stats/StatsApplicationService.java - Goal workflow → Goal model: creates or deactivates
src/main/java/com/correai/api/application/goal/GoalApplicationService.java - Activity workflow → Activity persistence: uses repository port
- Goal workflow → Goal persistence: uses repository port
- Goal workflow → Activity persistence: reads activities
- Statistics workflow → Activity persistence: reads activities
- Activity persistence → PostgreSQL: reads and writes
- Goal persistence → PostgreSQL: reads and writes
- User persistence → PostgreSQL: reads and writes