FM / docs

/home/techb158/trellopowerup.abdallabala.com/docs/

/home/techb158/trellopowerup.abdallabala.com/docs

Name	Size	Mode	Actions
00-design-study.md	3678	0644	edit dl rm
01-uml-class-diagram.puml	11869	0644	edit dl rm
02-use-case-diagram.puml	3763	0644	edit dl rm
03-sequence-diagrams.puml	9732	0644	edit dl rm
04-database-entity-model.mmd	7051	0644	edit dl rm
05-database-schema.sql	13372	0644	edit dl rm
06-diagram-preview.html	5021	0644	edit dl rm
07-design-checklist.md	3256	0644	edit dl rm
08-step-2-storage-layer.md	5325	0644	edit dl rm
09-step-3-risk-crud-ui.md	3380	0644	edit dl rm
10-step-4-mitigation-workflow.md	3996	0644	edit dl rm
11-step-5-deployment-gate-workflow.md	2292	0644	edit dl rm
12-step-6-multi-pm-integration.md	3770	0644	edit dl rm
13-step-6-1-microsoft-planner-integration.md	2335	0644	edit dl rm
14-step-7-reporting-export.md	4158	0644	edit dl rm
15-step-7-1-oauth-live-connectors.md	4545	0644	edit dl rm
16-step-8-user-roles-access-control.md	3297	0644	edit dl rm
17-step-9-production-deployment-security.md	4228	0644	edit dl rm
18-step-10-final-academic-submission.md	3199	0644	edit dl rm
19-final-report-draft.md	6814	0644	edit dl rm
20-instructor-submission-checklist.md	3639	0644	edit dl rm
21-demo-script.md	3948	0644	edit dl rm
22-traceability-matrix.md	4847	0644	edit dl rm
23-testing-evidence.md	2961	0644	edit dl rm
24-evaluation-rubric-mapping.md	2910	0644	edit dl rm
25-final-deployment-runbook.md	3214	0644	edit dl rm
26-known-limitations-and-future-work.md	2632	0644	edit dl rm
27-final-qa-checklist.md	2893	0644	edit dl rm
28-demo-rehearsal-script.md	3618	0644	edit dl rm
29-submission-freeze-report.md	2769	0644	edit dl rm
30-final-known-issues.md	1876	0644	edit dl rm
31-trello-powerup-implementation-guide.md	7608	0644	edit dl rm
32-vps-deployment-guide.md	3697	0644	edit dl rm
dashboard-spec.md	3691	0644	edit dl rm
methodology-mapping.md	2471	0644	edit dl rm
next-implementation-step.md	1304	0644	edit dl rm
trello-admin-setup.md	2175	0644	edit dl rm

Edit: /home/techb158/trellopowerup.abdallabala.com/docs/trello-admin-setup.md (2175B)

# Trello Power-Up Admin Setup

## 1. Create the Power-Up

1. Open the Trello Power-Up admin portal.
2. Create a new Power-Up named `COSMIC AI-Risk Management`.
3. Set the connector URL to your deployed `/index.html` URL.
4. Enable these capabilities:
   - `authorization-status`
   - `show-authorization`
   - `show-settings`
   - `board-buttons`
   - `card-buttons`
   - `card-badges`
   - `card-detail-badges`
   - `card-back-section`

## 2. Generate the Trello API key

1. In the Power-Up admin portal, open the API Key tab.
2. Generate a Power-Up API key.
3. Put the value in `.env`:

```env
TRELLO_API_KEY=your_generated_powerup_key
TRELLO_APP_NAME=COSMIC AI-Risk Management
PUBLIC_BASE_URL=https://your-public-powerup-domain.example.com
```

The app serves these values to the browser through `/config.js`.

## 3. Use HTTPS for Trello testing

Trello must load the connector and iframe pages from a public secure URL.

For local development, expose the local app with an HTTPS tunnel, then set:

```env
PUBLIC_BASE_URL=https://your-tunnel-url.example.com
```

Restart the server after changing `.env`.

## 4. Register the connector URL

Use this URL in the Trello Power-Up admin portal:

```text
https://your-public-powerup-domain.example.com/index.html
```

For local tunnel testing, use:

```text
https://your-tunnel-url.example.com/index.html
```

## 5. Add the Power-Up to a board

1. Open the target Trello board.
2. Add the custom Power-Up.
3. Open Power-Up settings.
4. Confirm the COSMIC API base URL.
5. Open a Trello card.
6. Click `Assess AI Risk`.
7. Save the assessment.
8. Confirm the card badge, detail badge, and card back section update.
9. Click `Create Mitigation Checklist` after authorization.

## 6. Expected board behavior

| Feature | Expected result |
|---|---|
| Board button | Opens the COSMIC AI-Risk dashboard. |
| Card button | Opens the assessment form. |
| Card badge | Shows `Risk n/100`. |
| Detail badge | Shows risk status and deployment gate status. |
| Card back section | Shows latest score, interpretation, highest risk, and blocking criteria. |
| Mitigation checklist | Creates a checklist with governance and evidence tasks. |

cmd: