Community projects
Capital work and big repairs, tracked from “we should do this” through bidding, work-in-progress, and the final ribbon-cutting. Bids and updates are kept on the project so the paper trail stays together.
On this page
The five statuses
Every project has a status: planned, bidding (“Seeking Bids” on the card), in_progress, completed, or cancelled. The Active tab on /projects shows the first three; the Completed tab shows the last two. Each status has its own color chip so a quick scan tells you what’s going on.
Status is a manual flip from the admin view. The natural flow is planned → bidding → in_progress → completed, but nothing’s enforced; you can jump directly to completed for a small one-off job that didn’t need bids.
Categories
Seven categories ship by default: Landscaping, Infrastructure, Amenities, Safety & Security, Roofing & Gutters, Painting, and General. The category labels project cards and helps neighbors mentally group what’s happening (“the roof job, the front-gate job, the pool deck job”).
Bids
When a project is in the bidding phase, admins can attach bids. Each bid carries a vendor name, an optional amount, optional notes, and an optional attached document (the contractor’s PDF proposal, for instance). Bid counts show on the project card, and the project detail page lists every bid received.
Bid documents land in the private documents storage bucket and are served through 24-hour signed URLs, same as the main Documents library.
Updates
Projects support a running update feed: small posts from the admin or project lead describing progress (“foundation poured,” “waiting on permit,” “punch list this week”). The most recent update preview shows on the project card; clicking through shows the full timeline. Updates can carry attachments too.
Showing or hiding the budget
Each project has a budget_amount and a show_budget flag. The flag is the gate: with it off, the budget is stored but never rendered for residents (useful while bids are open and the board doesn’t want to anchor proposals to a public number). With it on, the budget shows on the project card.