How venkataravindra/url-shorten-project works
This is a Spring Boot platform that turns engineering requirements into reviewable software-workflow outputs, alongside a runnable URL-shortener application used both as product and brownfield baseline. Users create and execute DAG workflows, review artifacts at approval gates, then inspect decisions, audit history, summaries, and reliability metrics. The separate URL flow creates links, redirects visitors, and records click analytics. The README documents these capabilities; source excerpts chiefly show the browser console’s REST calls, so some backend connections are documented rather than source-verified.
Main entry points: WorkflowService.java Workflow service · UrlShortenerService.java Short-link service · app.js Console UI · WorkflowEngine.java DAG engine
Components 20
Web console
- Console UI
src/main/resources/static/app.js - Flow runner
src/main/resources/static/flows.js
Engineering workflow
- Workflow API
src/main/java/com/example/agentic/controller/WorkflowController.java - Workflow service
src/main/java/com/example/agentic/service/WorkflowService.java - DAG engine
src/main/java/com/example/agentic/orchestration/WorkflowEngine.java - Task scheduler
src/main/java/com/example/agentic/orchestration/WorkflowScheduler.java - Agent stages
src/main/java/com/example/agentic/agent - LLM provider
src/main/java/com/example/agentic/llm/MockLLMProvider.java - Codebase analysis
src/main/java/com/example/agentic/codebase/CodebaseAnalyzer.java
Governance and observability
- Approval and policy
src/main/java/com/example/agentic/governance - Artifacts and decisions
src/main/java/com/example/agentic/service/ArtifactService.java - Audit trail
src/main/java/com/example/agentic/audit/AuditService.java - Reliability metrics
src/main/java/com/example/agentic/metrics/MetricsService.java - Workflow state store
src/main/java/com/example/agentic/orchestration/WorkflowStateStore.java
URL shortener
- URL API
src/main/java/com/example/agentic/urlshortener/controller/UrlShortenerController.java - Short-link service
src/main/java/com/example/agentic/urlshortener/service/UrlShortenerService.java - Link writer
src/main/java/com/example/agentic/urlshortener/service/ShortUrlWriter.java - URL validation
src/main/java/com/example/agentic/urlshortener/service/UrlValidator.java - Link and click data
src/main/java/com/example/agentic/urlshortener/repository
Other components
- Engineer / approver
Connections 19
- Engineer / approver → Console UI: uses
README.md - Console UI → Workflow API: calls REST
src/main/resources/static/app.js - Console UI → URL API: calls REST
src/main/resources/static/app.js - Flow runner → Workflow API: runs API flows
src/main/resources/static/flows.js - Workflow API → Workflow service: handles requests
- Workflow service → DAG engine: executes workflow
- DAG engine → Task scheduler: schedules tasks
README.md - Task scheduler → Agent stages: dispatches stages
README.md - Agent stages → LLM provider: requests outputs
README.md - Agent stages → Codebase analysis: scans baseline
README.md - DAG engine → Approval and policy: enforces approval gates
README.md - Approval and policy → Workflow state store: persists workflow state
README.md - Workflow service → Artifacts and decisions: serves outcomes
- Workflow service → Audit trail: records events
README.md - Reliability metrics → Workflow state store: derives metrics
README.md - URL API → Short-link service: handles link requests
- Short-link service → URL validation: validates target
- Short-link service → Link writer: writes links
- Short-link service → Link and click data: reads clicks and links
README.md