#94 lambda readme generation

.github/workflows/lambda-readme.yml

@@ -0,0 +1,43 @@
+name: Lambda README Generation
+
+on:
+  workflow_run:
+    workflows: ["Terraform Plan on Changed Files"]
+    types: [completed]
+  workflow_dispatch:
+
+jobs:
+  generate-readmes:
+    runs-on: ubuntu-latest
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      github.event.workflow_run.conclusion == 'success'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_branch || github.ref }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate READMEs
+        working-directory: apps/backend/lambdas
+        run: node tools/lambda-cli.js generate-readme
+
+      - name: Commit updated READMEs
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+
+          git add apps/backend/lambdas/*/README.md
+
+          if git diff --staged --quiet; then
+            echo "No README changes to commit"
+          else
+            git commit -m "chore: regenerate lambda READMEs"
+            git push
+          fi

apps/backend/lambdas/auth/README.md

@@ -0,0 +1,42 @@
+# auth
+
+## Description
+
+Lambda for auth handler.
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /health | Health check |
+| POST | /register |  |
+
+## Setup
+
+```bash
+cd apps/backend/lambdas/auth
+npm install
+npm run dev
+```
+
+The handler will be available at `http://localhost:3000/auth`.
+
+Swagger UI: `http://localhost:3000/auth/swagger`
+
+## Adding Routes
+
+From the `apps/backend/lambdas` directory:
+
+```bash
+node tools/lambda-cli.js add-route auth GET /auth/{id}
+node tools/lambda-cli.js add-route auth POST /auth --body name:string
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run dev` | Start local development server |
+| `npm run build` | Compile TypeScript |
+| `npm test` | Run tests |
+| `npm run package` | Build and zip for deployment |

apps/backend/lambdas/donors/README.md

@@ -0,0 +1,42 @@
+# donors
+
+## Description
+
+Lambda for managing donors.
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /health | Health check |
+| GET | /donors |  |
+
+## Setup
+
+```bash
+cd apps/backend/lambdas/donors
+npm install
+npm run dev
+```
+
+The handler will be available at `http://localhost:3000/donors`.
+
+Swagger UI: `http://localhost:3000/donors/swagger`
+
+## Adding Routes
+
+From the `apps/backend/lambdas` directory:
+
+```bash
+node tools/lambda-cli.js add-route donors GET /donors/{id}
+node tools/lambda-cli.js add-route donors POST /donors --body name:string
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run dev` | Start local development server |
+| `npm run build` | Compile TypeScript |
+| `npm test` | Run tests |
+| `npm run package` | Build and zip for deployment |

apps/backend/lambdas/expenditures/README.md

@@ -0,0 +1,42 @@
+# expenditures
+
+## Description
+
+Lambda for tracking project expenditures.
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /health | Health check |
+| POST | /expenditures |  |
+
+## Setup
+
+```bash
+cd apps/backend/lambdas/expenditures
+npm install
+npm run dev
+```
+
+The handler will be available at `http://localhost:3000/expenditures`.
+
+Swagger UI: `http://localhost:3000/expenditures/swagger`
+
+## Adding Routes
+
+From the `apps/backend/lambdas` directory:
+
+```bash
+node tools/lambda-cli.js add-route expenditures GET /expenditures/{id}
+node tools/lambda-cli.js add-route expenditures POST /expenditures --body name:string
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run dev` | Start local development server |
+| `npm run build` | Compile TypeScript |
+| `npm test` | Run tests |
+| `npm run package` | Build and zip for deployment |

apps/backend/lambdas/projects/README.md

@@ -0,0 +1,43 @@
+# projects
+
+## Description
+
+Lambda for managing projects.
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /health | Health check |
+| GET | /projects |  |
+| POST | /projects |  |
+
+## Setup
+
+```bash
+cd apps/backend/lambdas/projects
+npm install
+npm run dev
+```
+
+The handler will be available at `http://localhost:3000/projects`.
+
+Swagger UI: `http://localhost:3000/projects/swagger`
+
+## Adding Routes
+
+From the `apps/backend/lambdas` directory:
+
+```bash
+node tools/lambda-cli.js add-route projects GET /projects/{id}
+node tools/lambda-cli.js add-route projects POST /projects --body name:string
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run dev` | Start local development server |
+| `npm run build` | Compile TypeScript |
+| `npm test` | Run tests |
+| `npm run package` | Build and zip for deployment |

apps/backend/lambdas/reports/README.md

@@ -0,0 +1,41 @@
+# reports
+
+## Description
+
+Lambda for generating reports.
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /health | Health check |
+
+## Setup
+
+```bash
+cd apps/backend/lambdas/reports
+npm install
+npm run dev
+```
+
+The handler will be available at `http://localhost:3000/reports`.
+
+Swagger UI: `http://localhost:3000/reports/swagger`
+
+## Adding Routes
+
+From the `apps/backend/lambdas` directory:
+
+```bash
+node tools/lambda-cli.js add-route reports GET /reports/{id}
+node tools/lambda-cli.js add-route reports POST /reports --body name:string
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run dev` | Start local development server |
+| `npm run build` | Compile TypeScript |
+| `npm test` | Run tests |
+| `npm run package` | Build and zip for deployment |