# arya251223/advance_project_manager architecture

> Architecture diagram of the GitHub repository arya251223/advance_project_manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arya251223/advance_project_manager
- Repository: https://github.com/arya251223/advance_project_manager

## Overview

AI Project Manager turns a user’s project brief into generated, tested project files and a downloadable ZIP. The documented workflow proceeds from strategy and planning through core and module development, integration, two validation stages, and delivery. The FastAPI service exposes project assignment, status, and download capabilities; generated files and ZIPs are stored on the filesystem, and agents obtain local Ollama models through a shared factory. README-described capabilities are included, but frontend request wiring and several pipeline transitions are not fully shown in the excerpts, so uncertain links are omitted or marked unverified.

Main entry points: [`backend/crew/crew_manager.py`](https://github.com/arya251223/advance_project_manager/blob/main/backend/crew/crew_manager.py) (Crew orchestrator), [`backend/utils/llm_factory.py`](https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/llm_factory.py) (LLM factory), [`backend/main.py`](https://github.com/arya251223/advance_project_manager/blob/main/backend/main.py) (FastAPI service), [`backend/frontend/index.html`](https://github.com/arya251223/advance_project_manager/blob/main/backend/frontend/index.html) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_service["API and UI"]
  node_webui["Web interface<br/>[index.html]"]
  node_api["FastAPI service<br/>[main.py]"]
  node_launcher["API entrypoint<br/>[main.py]"]
  node_project_models["Project models<br/>[models.py]"]
end

subgraph group_planning["Planning"]
  node_crew["Crew orchestrator<br/>[crew_manager.py]"]
  node_strategy["Strategy agent"]
  node_project_planning["Project planner"]
end

subgraph group_development["Development"]
  node_senior_dev["Core developer"]
  node_junior_dev["Module developers"]
  node_integrators["Integrators"]
end

subgraph group_validation["Validation and delivery"]
  node_integration_test["Integration tester"]
  node_final_test["Final tester<br/>[tester_agent.py]"]
  node_delivery["Delivery agent<br/>[delivery_agent.py]"]
end

subgraph group_runtime["Runtime services"]
  node_files[("Generated project files<br/>[file_manager.py]")]
  node_packager["ZIP packager"]
  node_llm_factory["LLM factory<br/>[llm_factory.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
end

node_user(("Project requester"))
node_ollama{{"Ollama LLM service"}}
node_download["Project ZIP download"]

node_user -.->|"submits brief"| node_webui
node_user -->|"assigns project"| node_api
node_webui -.->|"uses API"| node_api
node_api -->|"executes project"| node_crew
node_launcher -->|"executes project"| node_crew
node_api -->|"validates requests"| node_project_models
node_crew -->|"analyzes brief"| node_strategy
node_crew -->|"creates plan"| node_project_planning
node_crew -->|"builds core"| node_senior_dev
node_crew -->|"implements modules"| node_junior_dev
node_crew -->|"integrates code"| node_integrators
node_crew -->|"tests integration"| node_integration_test
node_crew -->|"validates output"| node_final_test
node_crew -->|"prepares delivery"| node_delivery
node_crew -->|"saves generated files"| node_files
node_crew -->|"creates package"| node_packager
node_api -.->|"serves project files"| node_files
node_api -->|"returns ZIP"| node_download
node_packager -->|"writes ZIP"| node_download
node_strategy -->|"creates model"| node_llm_factory
node_project_planning -->|"creates model"| node_llm_factory
node_senior_dev -->|"creates model"| node_llm_factory
node_junior_dev -->|"creates model"| node_llm_factory
node_integrators -->|"creates model"| node_llm_factory
node_integration_test -->|"creates model"| node_llm_factory
node_final_test -->|"creates model"| node_llm_factory
node_delivery -->|"creates model"| node_llm_factory
node_llm_factory -->|"reads model settings"| node_config
node_llm_factory -->|"requests inference"| node_ollama

click node_webui "https://github.com/arya251223/advance_project_manager/blob/main/backend/frontend/index.html"
click node_api "https://github.com/arya251223/advance_project_manager/blob/main/backend/main.py"
click node_launcher "https://github.com/arya251223/advance_project_manager/blob/main/main.py"
click node_project_models "https://github.com/arya251223/advance_project_manager/blob/main/backend/models.py"
click node_crew "https://github.com/arya251223/advance_project_manager/blob/main/backend/crew/crew_manager.py"
click node_strategy "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/senior_manager_agent.py"
click node_project_planning "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/project_manager_agent.py"
click node_senior_dev "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/senior_developer_agent.py"
click node_junior_dev "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/junior_developer_agent.py"
click node_integrators "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/integrator_agent.py"
click node_integration_test "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/integrator_tester_agent.py"
click node_final_test "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/tester_agent.py"
click node_delivery "https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/delivery_agent.py"
click node_files "https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/file_manager.py"
click node_packager "https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/project_packager.py"
click node_llm_factory "https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/llm_factory.py"
click node_config "https://github.com/arya251223/advance_project_manager/blob/main/backend/config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webui,node_api,node_launcher,node_project_models toneBlue
class node_crew,node_strategy,node_project_planning toneAmber
class node_senior_dev,node_junior_dev,node_integrators,node_user toneMint
class node_integration_test,node_final_test,node_delivery toneRose
class node_files,node_packager,node_llm_factory,node_config,node_ollama,node_download toneIndigo
```

## Components

### API and UI

- [Web interface](https://github.com/arya251223/advance_project_manager/blob/main/backend/frontend/index.html): `backend/frontend/index.html`
- [FastAPI service](https://github.com/arya251223/advance_project_manager/blob/main/backend/main.py): `backend/main.py`
- [API entrypoint](https://github.com/arya251223/advance_project_manager/blob/main/main.py): `main.py`
- [Project models](https://github.com/arya251223/advance_project_manager/blob/main/backend/models.py): `backend/models.py`

### Planning

- [Crew orchestrator](https://github.com/arya251223/advance_project_manager/blob/main/backend/crew/crew_manager.py): `backend/crew/crew_manager.py`
- [Strategy agent](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/senior_manager_agent.py): `backend/agents/senior_manager_agent.py`
- [Project planner](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/project_manager_agent.py): `backend/agents/project_manager_agent.py`

### Development

- [Core developer](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/senior_developer_agent.py): `backend/agents/senior_developer_agent.py`
- [Module developers](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/junior_developer_agent.py): `backend/agents/junior_developer_agent.py`
- [Integrators](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/integrator_agent.py): `backend/agents/integrator_agent.py`

### Validation and delivery

- [Integration tester](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/integrator_tester_agent.py): `backend/agents/integrator_tester_agent.py`
- [Final tester](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/tester_agent.py): `backend/agents/tester_agent.py`
- [Delivery agent](https://github.com/arya251223/advance_project_manager/blob/main/backend/agents/delivery_agent.py): `backend/agents/delivery_agent.py`

### Runtime services

- [Generated project files](https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/file_manager.py): `backend/utils/file_manager.py`
- [ZIP packager](https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/project_packager.py): `backend/utils/project_packager.py`
- [LLM factory](https://github.com/arya251223/advance_project_manager/blob/main/backend/utils/llm_factory.py): `backend/utils/llm_factory.py`
- [Runtime configuration](https://github.com/arya251223/advance_project_manager/blob/main/backend/config.py): `backend/config.py`

### Other components

- **Project requester**
- **Ollama LLM service**
- **Project ZIP download**

## Connections

- Project requester → Web interface: submits brief (evidence: `README.md`)
- Project requester → FastAPI service: assigns project (evidence: `backend/main.py`)
- Web interface → FastAPI service: uses API (evidence: `README.md`)
- FastAPI service → Crew orchestrator: executes project (evidence: `backend/main.py`)
- API entrypoint → Crew orchestrator: executes project (evidence: `main.py`)
- FastAPI service → Project models: validates requests (evidence: `backend/main.py`)
- Crew orchestrator → Strategy agent: analyzes brief (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Project planner: creates plan (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Core developer: builds core (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Module developers: implements modules (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Integrators: integrates code (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Integration tester: tests integration (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Final tester: validates output (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Delivery agent: prepares delivery (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → Generated project files: saves generated files (evidence: `backend/crew/crew_manager.py`)
- Crew orchestrator → ZIP packager: creates package (evidence: `backend/crew/crew_manager.py`)
- FastAPI service → Generated project files: serves project files
- FastAPI service → Project ZIP download: returns ZIP (evidence: `backend/main.py`)
- ZIP packager → Project ZIP download: writes ZIP (evidence: `backend/utils/project_packager.py`)
- Strategy agent → LLM factory: creates model (evidence: `backend/agents/senior_manager_agent.py`)
- Project planner → LLM factory: creates model (evidence: `backend/agents/project_manager_agent.py`)
- Core developer → LLM factory: creates model (evidence: `backend/agents/senior_developer_agent.py`)
- Module developers → LLM factory: creates model (evidence: `backend/agents/junior_developer_agent.py`)
- Integrators → LLM factory: creates model (evidence: `backend/agents/integrator_agent.py`)
- Integration tester → LLM factory: creates model (evidence: `backend/agents/integrator_tester_agent.py`)
- Final tester → LLM factory: creates model (evidence: `backend/agents/tester_agent.py`)
- Delivery agent → LLM factory: creates model (evidence: `backend/agents/delivery_agent.py`)
- LLM factory → Runtime configuration: reads model settings (evidence: `backend/utils/llm_factory.py`)
- LLM factory → Ollama LLM service: requests inference (evidence: `backend/utils/llm_factory.py`)
