# annie1008/coe-feedback-tracker-ps architecture

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

- Interactive diagram: https://gitdiagram.com/annie1008/coe-feedback-tracker-ps
- Repository: https://github.com/annie1008/coe-feedback-tracker-ps

## Overview

This is a CoE Advisor application for capturing and managing field feedback against initiatives, then analyzing, deduplicating, and tracking it for follow-up. The main user flow runs through the React app, which loads shared data and submits canonical field-input changes to the server; analysis and communication features branch from feedback views. The backend also supports a canonical-data cutover and legacy import. Evidence is limited to the supplied excerpts, source index, and empty README; some integrations and unsampled component behavior are therefore left unconnected.

Main entry points: [`src/App.js`](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/App.js) (App coordinator), [`src/components/InitiativeDetail.js`](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/InitiativeDetail.js) (Initiative detail), [`src/components/FeedbackAnalysisPanel.js`](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackAnalysisPanel.js) (Feedback analysis), [`server/db.js`](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/db.js) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Advisor workspace"]
  node_app["App coordinator<br/>[App.js]"]
  node_initiatives["Initiatives<br/>[InitiativesView.js]"]
  node_initiative_detail["Initiative detail"]
  node_feedback_form["Feedback capture<br/>[FeedbackForm.js]"]
  node_feedback_table["Feedback table<br/>[FeedbackTable.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.js]"]
  node_closed_loop["Close-the-loop<br/>[ClosedLoopModal.js]"]
end

subgraph group_analysis["Feedback intelligence"]
  node_feedback_analysis["Feedback analysis"]
  node_ai_query["AI queries<br/>[AIQueryBox.js]"]
  node_roadmap["Roadmap matching<br/>[roadmapData.js]"]
  node_timeline["Delivery timeline<br/>[TimelineView.js]"]
  node_jira_sync["Jira sync<br/>[JiraSyncPanel.js]"]
  node_advisor_sharing["Advisor sharing"]
end

subgraph group_backend["Canonical data"]
  node_data_client["Data access<br/>[data.js]"]
  node_field_api["Field input API client<br/>[fieldInputApi.js]"]
  node_server["HTTP server<br/>[server.js]"]
  node_canonical_api["Canonical API<br/>[canonicalApi.js]"]
  node_cutover["Cutover state<br/>[cutoverState.js]"]
  node_database[("PostgreSQL<br/>[db.js]")]
end

subgraph group_migration["Data transition"]
  node_legacy_import["Legacy import<br/>[legacyImport.js]"]
  node_cutover_scripts["Cutover operations"]
  node_field_reconcile["Field reconciliation"]
end

node_advisor(("Advisor"))
node_gateway{{"AI gateway"}}

node_advisor -->|"uses"| node_app
node_app -->|"renders"| node_initiatives
node_app -->|"renders"| node_initiative_detail
node_app -->|"renders"| node_feedback_table
node_app -->|"renders"| node_dashboard
node_app -->|"opens"| node_closed_loop
node_app -->|"loads and saves"| node_data_client
node_app -->|"submits changes"| node_field_api
node_initiatives -->|"renders"| node_feedback_form
node_initiative_detail -->|"renders"| node_feedback_form
node_initiative_detail -->|"renders"| node_feedback_table
node_initiative_detail -->|"renders"| node_feedback_analysis
node_initiative_detail -->|"renders"| node_ai_query
node_feedback_analysis -->|"matches feedback"| node_roadmap
node_feedback_analysis -->|"opens"| node_jira_sync
node_feedback_analysis -->|"requests analysis"| node_gateway
node_ai_query -->|"sends question"| node_gateway
node_timeline -->|"uses analysis"| node_feedback_analysis
node_timeline -->|"matches roadmap"| node_roadmap
node_timeline -->|"renders"| node_advisor_sharing
node_data_client -->|"loads canonical data"| node_canonical_api
node_server -->|"routes requests"| node_canonical_api
node_server -->|"creates pool"| node_database
node_server -->|"reads state"| node_cutover
node_canonical_api -->|"checks state"| node_cutover
node_canonical_api -->|"queries records"| node_database
node_cutover_scripts -->|"updates cutover"| node_database
node_cutover_scripts -->|"runs reconciliation"| node_field_reconcile
node_field_reconcile -->|"reconciles records"| node_database
node_legacy_import -->|"imports records"| node_database
node_jira_sync -.->|"supports Jira workflow"| node_advisor

click node_app "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/App.js"
click node_initiatives "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/InitiativesView.js"
click node_initiative_detail "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/InitiativeDetail.js"
click node_feedback_form "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackForm.js"
click node_feedback_table "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackTable.js"
click node_dashboard "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/Dashboard.js"
click node_closed_loop "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/ClosedLoopModal.js"
click node_data_client "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/data.js"
click node_field_api "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/fieldInputApi.js"
click node_feedback_analysis "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackAnalysisPanel.js"
click node_ai_query "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/AIQueryBox.js"
click node_roadmap "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/roadmapData.js"
click node_timeline "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/TimelineView.js"
click node_jira_sync "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/JiraSyncPanel.js"
click node_advisor_sharing "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/SendToAdvisorButton.js"
click node_server "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server.js"
click node_canonical_api "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/canonicalApi.js"
click node_cutover "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/cutoverState.js"
click node_database "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/db.js"
click node_legacy_import "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/legacyImport.js"
click node_cutover_scripts "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/scripts/activate-canonical-cutover.js"
click node_field_reconcile "https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/scripts/reconcile-field-inputs.js"

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_app,node_initiatives,node_initiative_detail,node_feedback_form,node_feedback_table,node_dashboard,node_closed_loop toneBlue
class node_feedback_analysis,node_ai_query,node_roadmap,node_timeline,node_jira_sync,node_advisor_sharing toneAmber
class node_data_client,node_field_api,node_server,node_canonical_api,node_cutover,node_database toneMint
class node_legacy_import,node_cutover_scripts,node_field_reconcile toneRose
class node_advisor,node_gateway toneIndigo
```

## Components

### Advisor workspace

- [App coordinator](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/App.js): `src/App.js`
- [Initiatives](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/InitiativesView.js): `src/components/InitiativesView.js`
- [Initiative detail](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/InitiativeDetail.js): `src/components/InitiativeDetail.js`
- [Feedback capture](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackForm.js): `src/components/FeedbackForm.js`
- [Feedback table](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackTable.js): `src/components/FeedbackTable.js`
- [Dashboard](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/Dashboard.js): `src/components/Dashboard.js`
- [Close-the-loop](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/ClosedLoopModal.js): `src/components/ClosedLoopModal.js`

### Feedback intelligence

- [Feedback analysis](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/FeedbackAnalysisPanel.js): `src/components/FeedbackAnalysisPanel.js`
- [AI queries](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/AIQueryBox.js): `src/components/AIQueryBox.js`
- [Roadmap matching](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/roadmapData.js): `src/roadmapData.js`
- [Delivery timeline](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/TimelineView.js): `src/components/TimelineView.js`
- [Jira sync](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/JiraSyncPanel.js): `src/components/JiraSyncPanel.js`
- [Advisor sharing](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/components/SendToAdvisorButton.js): `src/components/SendToAdvisorButton.js`

### Canonical data

- [Data access](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/data.js): `src/data.js`
- [Field input API client](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/src/fieldInputApi.js): `src/fieldInputApi.js`
- [HTTP server](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server.js): `server.js`
- [Canonical API](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/canonicalApi.js): `server/canonicalApi.js`
- [Cutover state](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/cutoverState.js): `server/cutoverState.js`
- [PostgreSQL](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/db.js): `server/db.js`

### Data transition

- [Legacy import](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/server/legacyImport.js): `server/legacyImport.js`
- [Cutover operations](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/scripts/activate-canonical-cutover.js): `scripts/activate-canonical-cutover.js`
- [Field reconciliation](https://github.com/annie1008/coe-feedback-tracker-ps/blob/main/scripts/reconcile-field-inputs.js): `scripts/reconcile-field-inputs.js`

### Other components

- **Advisor**
- **AI gateway**

## Connections

- Advisor → App coordinator: uses
- App coordinator → Initiatives: renders (evidence: `src/App.js`)
- App coordinator → Initiative detail: renders (evidence: `src/App.js`)
- App coordinator → Feedback table: renders (evidence: `src/App.js`)
- App coordinator → Dashboard: renders (evidence: `src/App.js`)
- App coordinator → Close-the-loop: opens (evidence: `src/App.js`)
- App coordinator → Data access: loads and saves (evidence: `src/App.js`)
- App coordinator → Field input API client: submits changes (evidence: `src/App.js`)
- Initiatives → Feedback capture: renders (evidence: `src/components/InitiativesView.js`)
- Initiative detail → Feedback capture: renders (evidence: `src/components/InitiativeDetail.js`)
- Initiative detail → Feedback table: renders (evidence: `src/components/InitiativeDetail.js`)
- Initiative detail → Feedback analysis: renders (evidence: `src/components/InitiativeDetail.js`)
- Initiative detail → AI queries: renders (evidence: `src/components/InitiativeDetail.js`)
- Feedback analysis → Roadmap matching: matches feedback (evidence: `src/components/FeedbackAnalysisPanel.js`)
- Feedback analysis → Jira sync: opens (evidence: `src/components/FeedbackAnalysisPanel.js`)
- Feedback analysis → AI gateway: requests analysis (evidence: `src/components/FeedbackAnalysisPanel.js`)
- AI queries → AI gateway: sends question (evidence: `src/components/AIQueryBox.js`)
- Delivery timeline → Feedback analysis: uses analysis (evidence: `src/components/TimelineView.js`)
- Delivery timeline → Roadmap matching: matches roadmap (evidence: `src/components/TimelineView.js`)
- Delivery timeline → Advisor sharing: renders (evidence: `src/components/TimelineView.js`)
- Data access → Canonical API: loads canonical data (evidence: `src/data.js`)
- HTTP server → Canonical API: routes requests (evidence: `server.js`)
- HTTP server → PostgreSQL: creates pool (evidence: `server.js`)
- HTTP server → Cutover state: reads state (evidence: `server.js`)
- Canonical API → Cutover state: checks state (evidence: `server/canonicalApi.js`)
- Canonical API → PostgreSQL: queries records (evidence: `server/canonicalApi.js`)
- Cutover operations → PostgreSQL: updates cutover (evidence: `scripts/activate-canonical-cutover.js`)
- Cutover operations → Field reconciliation: runs reconciliation (evidence: `scripts/activate-canonical-cutover.js`)
- Field reconciliation → PostgreSQL: reconciles records (evidence: `scripts/reconcile-field-inputs.js`)
- Legacy import → PostgreSQL: imports records (evidence: `server/legacyImport.js`)
- Jira sync → Advisor: supports Jira workflow
