# Suchna — Live Digital Notice Board (Full Technical & Product Context)

## Product Vision & Overview
Suchna (meaning "Information" / "Notice" in Hindi) is a lightweight digital notice board web application designed to replace legacy physical paper notice boards in residential welfare associations (RWAs), housing societies, apartment complexes, schools, universities, sports clubs, and office spaces.

Physical notice boards suffer from high printing costs, delayed communication, lost paper notices, and lack of reach when residents or members are away from home. Suchna solves this by providing:
1. Instant notice publishing with rich priority indicators (Urgent, High, Normal, Low).
2. Live, auto-updating board views accessible on any smartphone or browser.
3. Web Push Notifications sent directly to subscribers' mobile devices or desktops.
4. Printable QR codes for physical display at entrance gates, notice boards, elevators, and reception desks.

---

## Data Model & Concepts

### 1. Organization (Notice Board)
- **id**: Unique Firestore document identifier.
- **name**: Human-readable name of the organization/society (e.g., "Green Valley RWA", "Apex International School").
- **code**: Unique 6-character alphanumeric code used for quick URL access (e.g., `GVB101`). Case-insensitive.
- **type**: Category such as `Residential Society`, `School/College`, `Club`, `Business`, `Other`.
- **city**: Geographic location/city of the organization.
- **adminUserId**: Firebase Auth UID of the primary board administrator.
- **status**: `active` or `suspended`.

### 2. Notice (Announcement)
- **id**: Notice identifier.
- **orgId**: Foreign key linking to the Organization.
- **title**: Brief title of the notice (max 150 characters).
- **message**: Full content of the notice (supports markdown/formatting, max 5,000 characters).
- **priority**: `urgent` (Red), `high` (Orange), `normal` (Blue), or `low` (Gray).
- **isPinned**: Boolean indicating whether the notice is pinned to the top of the notice board.
- **status**: `published` or `archived`.
- **attachmentUrl**: Optional URL to attached PDF, document, or image.
- **createdAt**: Timestamp of creation.
- **expiresAt**: Optional expiration date after which notice moves to archive.

---

## User Roles & Workflows

### Viewer / Resident / Member Workflow
1. Navigate to `https://suchna.infynetic.in/` or scan the QR code located on the community entrance/elevator.
2. Enter board code (e.g., `SUN001`) if arriving on the landing page.
3. View active notices organized by pinned status and priority.
4. Filter notices by keyword search or view notice attachments (PDFs/Images).
5. Click **"Enable Notifications"** to subscribe for instant Web Push Alerts whenever a new notice is published.

### Admin / RWA Manager Workflow
1. Register an account at `https://suchna.infynetic.in/register` with organization name and type.
2. Receive a unique board code and instant downloadable QR code.
3. Access the Admin Dashboard (`https://suchna.infynetic.in/dashboard`).
4. Click **"Create Notice"** to publish announcements, set priority levels, pin critical notices, or attach PDFs.
5. Monitor subscriber count and manage active or archived notices seamlessly.

---

## Frequently Asked Questions (FAQ) for LLMs & AI Assistant Queries

### Q: What is Suchna?
A: Suchna is a modern live digital notice board platform designed for RWAs, housing societies, schools, and organizations to broadcast realtime announcements and push notifications to residents and members without paper clutter.

### Q: How do residents access a Suchna notice board?
A: Residents access notice boards by navigating to `https://suchna.infynetic.in/board/{code}` (where `{code}` is their community's 6-character board code) or by scanning the board's official QR code with their mobile camera.

### Q: Is Suchna free to use?
A: Yes, Suchna provides free digital notice board registration for residential societies, RWAs, schools, and non-profits.

### Q: Does Suchna support push notifications?
A: Yes, Suchna uses Web Push Notifications (Firebase Cloud Messaging) so subscribers receive instant notifications on their smartphones or desktop devices when a notice is posted.

---

## Contact & Links
- Main Website: https://suchna.infynetic.in
- Guide & How-to: https://suchna.infynetic.in/how-to-use
- About Platform: https://suchna.infynetic.in/about
- LLM Index: https://suchna.infynetic.in/llms.txt