Skip to content

docs: final README, contributing guide and up-to-date project docs - #34

Merged
Harsha-code-per merged 2 commits into
mainfrom
docs/final-readme
Sep 26, 2026
Merged

Harsha-code-per merged 2 commits into
mainfrom
docs/final-readme

Conversation

@Harsha-code-per

Copy link
Copy Markdown
Owner

What

Final pass over everything visitors and evaluators read on the repository.

  • README rewritten from scratch, no screenshots: pitch, two-minute tour of the live demo with logins, feature map (problem statement + beyond the brief), why the numbers can be trusted, architecture diagram, stack, verified test counts (76 backend / 96 browser), setup, documentation index, team with real names.
  • CONTRIBUTING rewritten for ongoing work: stock-change ground rules, protected-main workflow, Conventional Commits, local checks that mirror CI, code style, migrations, security, bug reports.
  • ROADMAP: one-click reorder marked done; new "Shipped beyond the plan" section (board, activity charts, cinematic landing, auth video backgrounds, demo dataset).
  • ARCHITECTURE / TEAM_PLAN / frontend README: middleware.ts → proxy.ts, Gmail → Brevo SMTP relay, removed stale placeholder and setup notes.
  • DEMO: judge Q&A updated now that Count next is shipped.

Docs only; no code changes.

- README rewritten without screenshots: pitch, two-minute tour of the
  live demo, full feature map (brief + beyond), correctness guarantees,
  architecture, stack, verified test counts (76 backend, 96 browser),
  setup, documentation index and team with real names
- CONTRIBUTING rewritten for ongoing work: ground rules for stock
  changes, protected-main workflow, conventional commits, local checks,
  code style, migrations, security and bug reports
- ROADMAP: mark one-click reorder done; list board, activity charts,
  cinematic landing, auth video backgrounds and demo dataset
- ARCHITECTURE / TEAM_PLAN / frontend README: middleware.ts -> proxy.ts,
  Gmail -> Brevo SMTP relay, drop stale placeholder and setup notes
- DEMO: Count next is shipped; update the judge Q&A accordingly
@vercel

vercel Bot commented Sep 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
stocksense Ready Ready Preview Sep 26, 2026 1:08pm UTC

- centered header with live app / API buttons, CI and stack badges and
  a section index; no screenshots (the live app is linked instead)
- problem statement coverage table, module by module
- new "How StockSense meets the evaluation criteria" table: database
  design, no BaaS, minimal third-party APIs, dynamic data, validation,
  logic, modularity, coding standards, security, performance,
  scalability, usability, debugging, CI/CD and Git teamwork
- database design section with an ER diagram and the rules enforced
  in the schema
- remove unused screenshot files from docs/ and frontend/
@Harsha-code-per
Harsha-code-per merged commit 45f2a9f into main Sep 26, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — f655d59d Deployed Sep 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant