How devfullcycle/imersao-ia1 works
Full Cycle Chat is a team-chat product specified to combine conversations, tasks, notifications, and pluggable AI agents. The intended flow is a person chatting in the web client, asking an agent in a conversation, and receiving its response there; agents may also delegate work or answer business-data questions. The README documents this target architecture, but the checked-in application code is still an early scaffold: the Nest API currently wires configuration, database setup, and error handling, and the agent service is not present in the tree. Connections for the product workflow reflect README documentation, not inspected implementations.
Main entry points: hld.md Agent dispatch · main.ts Chat API · app.module.ts API bootstrap · page.tsx Web client / BFF
Components 16
Web client
- Web client / BFF
apps/web/src/app/page.tsx - Channels and DMs
docs/product-brief.md
Chat API
- Chat API
apps/chat-api/src/main.ts - API bootstrap
apps/chat-api/src/app.module.ts - Environment config
apps/chat-api/src/config/config.module.ts - Database setup
apps/chat-api/src/database/database.module.ts - Error responses
apps/chat-api/src/common/errors/problem-details.filter.ts
Agent system
- Agent dispatch
docs/hld.md - Agent plugins
docs/hld.md - Task delegation
docs/product-brief.md - Business data queries
docs/product-brief.md
Data and services
- AI model provider
- PostgreSQL
- Redis
- PDF storage
Other components
- Chat user
Connections 20
- Chat user → Web client / BFF: uses
README.md - Chat user → Chat API: connects by WebSocket
README.md - Web client / BFF → Chat API: calls by REST
README.md - Web client / BFF → Agent dispatch: dispatches request
README.md - Channels and DMs → Agent dispatch: mentions agent
- Agent dispatch → Agent plugins: routes to plugin
- Agent dispatch → Chat API: posts bot reply
README.md - Agent dispatch → AI model provider: requests inference
README.md - Agent dispatch → PostgreSQL: reads business data
README.md - Agent dispatch → Redis: uses queue and events
README.md - Agent dispatch → PDF storage: stores PDF
README.md - Task delegation → Agent dispatch: invoked by agent
- Business data queries → Agent dispatch: invoked by agent
- Chat API → PostgreSQL: persists chat data
README.md - Chat API → Redis: uses queue and events
README.md - Chat API → API bootstrap: starts
apps/chat-api/src/main.ts - API bootstrap → Environment config: imports
apps/chat-api/src/app.module.ts - API bootstrap → Database setup: imports
apps/chat-api/src/app.module.ts - API bootstrap → Error responses: registers filter
apps/chat-api/src/app.module.ts - Environment config → Database setup: provides config