Happening At The Moment (ATM)

It's common for city council, planning and commission meetings to only list one start time. The agenda items aren't scheduled for specific times because they do not know how long it will take to discuss each item. This leaves attendees wondering when they'll be able to comment on the agenda item they're interested in.

This problem has become a growing issue in the era of COVID-19 since virtual meetings are becoming more common. This web app allows meeting participants to "subscribe" to meeting items for notifications via text or email. Participants will benefit greatly from a notification system rather than be on stand-by for an undetermined length of time.

The City of San Jose is interested in this service, but this is a project that can scale to other cities as well.

Software Tech Stack

• Frontend
  • React.js + hooks
  • SASS
• Backend
  • Node.js and npm
  • GraphQL for backend.
  • Apollo for backend.
  • Postgres
  • AWS S3
  • Twilio for sending SMS.
  • AWS SES for sending emails.
  • Docker to bring up development environment.

Resources

• Slack Channel: #proj-happening-atm-eng

• Google Drive

• Links to Visual Design Mocks

• Latest Kanban ToDo list TODO: Update to JIRA board?

• User Stories Board

Build & Deploy Pipeline

Application is hosted on AWS

• AWS ECS (Elastic Container Serivce)
• AWS RDS for database. Github Actions is utilized for CI/CD. See .github/workflows/ for workflows.

Testing Pipeline

TODO via Github Actions

Set up local environment development

• Install Docker
• Run the app, and wait for the engine to run (green status bar on bottom left)
• In the terminal, go to your repository and run docker compose build. You only need to run this command once, then you can bring up your environment again by using docker compose up.

Live deployments

• stage: https://happening-atm-stage.codeforsanjose.org
• prod: Production is not live yet

Contributing

Any and all PRs are welcome. Please see this documentation.