2.6 KiB
Stock Report Portal Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: Build a static stock-report portal with category navigation, calendar browsing, indexed HTML reports, and an upload-friendly rebuild script.
Architecture: A single-page vanilla JavaScript application reads data/reports.json, renders category/month/date views, and opens source HTML reports from reports/. A Node.js script scans report paths and emits the index, keeping storage simple and automation-friendly.
Tech Stack: HTML5, CSS3, vanilla JavaScript, Node.js standard library only.
Global Constraints
- No database, framework, or runtime server is required to serve the site.
- Report storage uses
reports/<category>/<YYYY>/<MM>/. - The browser-facing index contract uses
data/reports.json. - Empty and malformed data must render a recoverable empty state.
Task 1: Create the static portal shell
Files:
-
Create:
index.html -
Create:
styles.css -
Create:
app.js -
Create:
data/reports.json -
Add semantic layout for sidebar categories, dashboard header, calendar, report list, and recent reports.
-
Add responsive CSS with a dark research-terminal visual style and accessible focus states.
-
Implement loading of
data/reports.json, category filtering, month navigation, date selection, search, and report links. -
Seed representative records and make all relative paths deploy-safe.
Task 2: Add representative report fixtures and index rebuild tooling
Files:
-
Create:
reports/daily-review/2026/08/2026-08-16-market-review.html -
Create:
reports/intraday/2026/08/2026-08-16-ai-sector.html -
Create:
scripts/build-index.mjs -
Create:
README.md -
Write the rebuild script using Node standard library and the filename convention
YYYY-MM-DD-slug.html. -
Preserve category labels and derive title, summary, tags, and path for each record.
-
Add deployment and automation instructions, including the upload-then-rebuild workflow.
-
Run the rebuild script and verify the generated JSON contains both fixtures.
Task 3: Validate the complete static site
Files:
-
Modify:
data/reports.json -
Run
node scripts/build-index.mjs. -
Serve the root with a local static server and request
index.html,app.js, and both report files. -
Parse the generated JSON and verify every indexed path exists.
-
Check the site for broken relative references and report the final upload directory.