🏗️📦feat: scaffold `infra/hasura/` folder structure and Hasura config

[sotoJ24]

---

Issue Summary

Create the infra/hasura/ directory structure inside dApp-SafeTrust and
add the root Hasura configuration files. This is the infrastructure container
that all subsequent migration and metadata issues will populate. No migrations
are added in this issue — only the scaffold and Hasura project config.

Type of Issue

• Feature Request

Depends on

None — can run in parallel with all frontend issues.

Files to create

infra/
└── hasura/
    ├── config.yaml              ← Hasura CLI project config
    ├── .env.example             ← infra-specific env vars
    └── migrations/
        └── safetrust/
            └── .gitkeep         ← placeholder, removed when first migration added
    └── metadata/
        ├── base/
        │   └── .gitkeep
        └── tenants/
            └── safetrust/
                └── .gitkeep
    └── seeds/
        └── safetrust/
            └── .gitkeep

infra/hasura/config.yaml

version: 3
endpoint: http://localhost:8080
admin_secret: myadminsecretkey
metadata_directory: metadata
actions:
  kind: synchronous
  handler_webhook_baseurl: http://localhost:3000

infra/hasura/.env.example

# Hasura
HASURA_GRAPHQL_ENDPOINT=http://localhost:8080
HASURA_GRAPHQL_ADMIN_SECRET=myadminsecretkey

# Database
PG_DATABASE_URL=postgres://postgres:postgrespassword@postgres:5432/postgres

# JWT (Firebase)
HASURA_GRAPHQL_JWT_SECRET='{"type":"RS256","jwk_url":"https://www.googleapis.com/service_accounts/v1/jwk/securetoken@system.gserviceaccount.com","audience":"safetrust-890d0","issuer":"https://securetoken.google.com/safetrust-890d0"}'

Update docker-compose.yml

Verify the hasura service in the root docker-compose.yml mounts the
correct migration path. Add if missing:

hasura:
  volumes:
    - ./infra/hasura/migrations:/hasura-migrations
    - ./infra/hasura/metadata:/hasura-metadata
  environment:
    HASURA_GRAPHQL_MIGRATIONS_DIR: /hasura-migrations
    HASURA_GRAPHQL_METADATA_DIR: /hasura-metadata

Acceptance Criteria

• infra/hasura/ directory exists with the full subfolder structure
• infra/hasura/config.yaml exists with correct endpoint and version
• infra/hasura/.env.example documents all required infra env vars
• docker-compose.yml hasura service mounts infra/hasura/migrations
  and infra/hasura/metadata correctly
• docker compose up hasura starts without volume mount errors
• migrations/safetrust/, metadata/base/, metadata/tenants/safetrust/,
  seeds/safetrust/ directories all exist

References

• Contributing Guide
• Git Guidelines

---

[BigJohn-dev]

@BigJohn-dev has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

This issue appeals to me because it combines the challenge of solving complex frontend performance problems with the opportunity to deliver a smoother, more reliable user experience, while also sharpening my skills with emerging design and resolution patterns.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @BigJohn-dev to this issue.

[emarc99]

@emarc99 has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hello team, with relevant db migration experience, I'd love to do this! Kindly assign.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @emarc99 to this issue.

[drips-wave]

Congratulations, @BigJohn-dev! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @BigJohn-dev: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊