golden-hyper

byБогдан Каюмов

Привет

ГлавнаяСтатистика
Главная

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirements Document for Привет

1. Introduction

This System Requirements Document describes the public website for Школа 101 (School 101). The product's intent is narrow and explicit: the site shows статистика успеваемости класса — class academic performance statistics — to anyone who visits it. A visitor opens the site, understands immediately that it is School 101's site, and reads the class performance statistics on a single clear page.

The audience is the Посетитель сайта школы — a visitor to the school's website (a parent, student, teacher, or member of the public) who wants to see how a class is performing. The site is public: no account, login, or identity is required to view it.

The site is delivered as a custom React frontend backed by a shared FastAPI service and a MariaDB database, per the provisioned scaffold.

Page 1 of 13

2. System Overview

The product is a two-page public website for School 101:

  • Главная — the public entry page. It states what the site is (School 101's class performance site) and offers a call to action that leads to the statistics.
  • Статистика — the page that presents the class academic performance statistics.

Both pages are publicly accessible with no identity requirement. There is one active human persona, Посетитель сайта школы, who uses both pages.

The frontend is a React application. It reads statistics from the shared FastAPI backend, which persists class performance data in MariaDB. The backend is a single shared process serving the application's API; the database holds the class performance records the statistics page displays.

Removed from scope

  • None. No concepts were removed by the user.
Page 2 of 13

2a. Product Interpretation and Delivery Boundary

The user asked for a website for School 101 that shows class academic performance statistics. That is the whole current product: a public, read-only presentation of class performance data. The site is first-party and application-owned; there is no provider-owned or external surface, and no headless delivery.

Access is public and anonymous on both pages. No login, account, or session is required, because the accepted behavior is viewing public school statistics and nothing in the source requires private or actor-specific state. There is no differentiated permission or role-based visibility: every visitor sees the same statistics.

The current delivery horizon covers only the two pages above and the statistics they present. Nothing about editing data, managing classes, teacher tools, or accounts is part of the current product.

2c. Page Content and Component Coverage

Page 3 of 13

Главная

  • Information and state: The page identifies the site as Школа 101 and states that it shows class academic performance statistics. It carries the entry hero copy: headline "Школа 101: успеваемость класса", subline "Смотрите оценки, прогресс и результаты класса на одной странице.", and call to action "Смотреть статистику".
  • Primary action: The "Смотреть статистику" call to action navigates the visitor to Статистика.
  • Supporting actions: None beyond navigation to the statistics page.
  • Domain entities: School identity (Школа 101); the concept of class performance statistics as the site's subject.
  • Component responsibilities:
    • Hero block: full-bleed paper ground with a stacked Anton headline in black and red; the words "Школа 101" set as a stacked headline; a yellow band behind the last word; a red CTA block at the lower left holding "Смотреть статистику".
    • Subline block: Archivo text carrying the subline.
    • Poster rule grid: thin black rules marking section boundaries.
  • States:
    • Loading: not applicable (static entry content).
    • Empty: not applicable.
    • Success: hero and CTA render fully; CTA navigates to Статистика.
    • Error: not applicable (no data fetch on this page).
    • Recovery: not applicable.
Page 4 of 13

Статистика

  • Information and state: Class academic performance statistics for School 101, presented in colour-coded blocks (red, yellow, teal) aligned to the poster grid. Numbers are set in Anton at large display size with small Archivo labels above them.
  • Primary action: Read the class performance statistics.
  • Supporting actions: Return to Главная via site navigation.
  • Domain entities: Class (a class group of School 101); performance statistic (a measured value describing class academic performance, such as grades, progress, or results, as supplied by the backend).
  • Component responsibilities:
    • Statistics blocks: colour-coded blocks per class group, each holding labelled numbers.
    • Number display: Anton numerals at display size with Archivo labels above.
    • Rule grid: thin black rules separating statistic sections.
    • Navigation: link back to Главная.
  • States:
    • Loading: a loading state while statistics are fetched from the backend.
    • Empty: a message shown when no statistics are available.
    • Success: statistics blocks render with class data.
    • Error: an error message shown when statistics cannot be loaded, with a way to retry.
    • Recovery: retry re-requests statistics from the backend.
Page 5 of 13

3. Functional Requirements

FR-1 — View class performance statistics (explicit) As a Посетитель сайта школы, I should open the Статистика page and see the class academic performance statistics for School 101, so that I understand how the class is performing.

  • Trigger/input: the visitor navigates to Статистика (directly or via the Главная CTA).
  • Observable result: statistics for the class are displayed in colour-coded blocks with labelled numbers.
  • Access state: public, no identity required.
  • Failure/recovery: if statistics cannot be loaded, an error message is shown with a retry action; retry re-requests the data.
  • Continuation: the visitor can return to Главная.

FR-2 — Understand the site's purpose on entry (required_inference) As a Посетитель сайта школы, I should land on Главная and immediately understand that this is School 101's site showing class performance statistics, so that I know what the site offers.

  • Trigger/input: the visitor opens the site root.
  • Observable result: the hero headline "Школа 101: успеваемость класса", the subline, and the "Смотреть статистику" CTA are visible.
  • Access state: public, no identity required.
  • Failure/recovery: not applicable (static content).
  • Continuation: the visitor activates the CTA to reach Статистика.
Page 6 of 13

FR-3 — Navigate from entry to statistics (required_inference) As a Посетитель сайта школы, I should activate the "Смотреть статистику" call to action on Главная and be taken to the Статистика page, so that I can reach the statistics in one step.

  • Trigger/input: the visitor activates the CTA.
  • Observable result: the Статистика page opens.
  • Access state: public.
  • Failure/recovery: not applicable.
  • Continuation: the visitor reads the statistics.

FR-4 — Return from statistics to entry (required_inference) As a Посетитель сайта школы, I should navigate back from Статистика to Главная, so that I can revisit the entry page.

  • Trigger/input: the visitor uses site navigation.
  • Observable result: Главная opens.
  • Access state: public.
  • Failure/recovery: not applicable.
  • Continuation: the visitor may re-enter Статистика.

4. User Personas

Page 7 of 13

Посетитель сайта школы

  • Product context: A visitor to School 101's public website — a parent, student, teacher, or member of the public — who wants to see how a class is performing academically. They arrive with no account and no prior session.
  • Primary goal: Read clear, understandable class academic performance statistics for School 101 on one page.
  • Distinct accepted responsibilities: Opening the site and understanding its purpose (FR-2), navigating to the statistics (FR-3), reading the class statistics (FR-1), and returning to the entry page (FR-4).
  • Relevant inputs or decisions: Whether to proceed from the entry page to the statistics; which class statistics to read.
  • Interactions with other accepted participants: None. The visitor is the only active human persona; the backend and database serve data but are not human participants.
  • Observable success: The visitor sees the class statistics rendered clearly on the Статистика page, with the site's purpose evident from the entry page.

5. Core User Flows

Page 8 of 13

Flow A — Visitor opens the site and reads class statistics

  1. The visitor opens the site root and lands on Главная.
  2. The visitor sees the stacked Anton headline "Школа 101: успеваемость класса", the subline "Смотрите оценки, прогресс и результаты класса на одной странице.", and the red "Смотреть статистику" CTA block at the lower left.
  3. The visitor activates "Смотреть статистику".
  4. The Статистика page opens and requests class statistics from the backend.
  5. While loading, a loading state is shown.
  6. On success, the class statistics render in colour-coded blocks (red, yellow, teal) with labelled numbers.
  7. If loading fails, an error message with a retry action is shown; the visitor retries and the statistics are re-requested.
  8. If no statistics exist, an empty-state message is shown.
  9. The visitor reads the statistics and may return to Главная via navigation.

Flow B — Visitor returns to the entry page

  1. From Статистика, the visitor uses site navigation to return to Главная.
  2. Главная opens with the hero and CTA.
  3. The visitor may re-enter Статистика by activating the CTA again.

6. Visuals Colors and Theme

The creative direction is authoritative: Typography as architecture for School 101, after the muse Paula Scher. The mood is loud school pride, not a quiet dashboard.

Page 9 of 13
  • Mode: Light.
  • Colour tokens:
    • Background (paper ground): #F4EFE4 — holds ~70% of the page.
    • Surface: #FFFFFF.
    • Text: #111111.
    • Primary (red blocks, CTA): #E02B20.
    • Accent (yellow band, class group coding): #F2C200.
    • Muted (teal class group coding): #3B7A6E.
  • Typography:
    • Headings: Anton, all caps, tight leading, stacked lines.
    • Body: Archivo at 400 and 600.
    • Scale: 1.5 modular; display sizes 44/72/96/128; text sizes 16/18/24; mobile display starts at 40px.
    • Numbers: Anton at 96px with small Archivo labels above.
  • Shape language: Hard edges only. Full-bleed colour bands, diagonal cuts, solid rectangles. No rounded corners, no soft shadows.
  • Layout: Poster grid with strong columns and horizontal rules. A giant stacked headline fills the top. Statistics sit in colour-coded blocks aligned to the grid.
  • Imagery: Typography is the image. Bold colour blocks and a few high-contrast photo cutouts of the school building.
  • Readability constraint: Headlines, wordmarks, labels, numbers, cards' text and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling (e.g. clamp(...)) to fit; no other element covers them. Decoration and imagery may bleed, crop, or overlap freely as long as they cover no readable text or control.
Page 10 of 13

7. Signature Design Concept

The public entry (Главная) is a full-bleed paper ground (#F4EFE4) carrying a stacked Anton headline in black and red. The words "Школа 101" take three lines at 128px on desktop and 44px on mobile. A yellow band (#F2C200) runs behind the last word. A red block (#E02B20) holds the "Смотреть статистику" CTA at the lower left — not centered. Thin black rules mark section boundaries like a poster frame. The concept recomposes only accepted content: the school name, the subline, and the CTA.

8. Interaction Model & Motion Direction

Interaction Model: Animated Motion Tempo: expressive Hero Dimensionality: flat

Landing Hero Motion Brief

  • Focal subject: the stacked Anton headline "Школа 101" in black and red on paper ground, with the yellow band behind the last word.
  • Input→transformation→outcome thesis: on load, the headline words reveal in a staggered sequence; the yellow band wipes in behind the last word; the red CTA block settles at the lower left. The outcome is the composed poster hero with the CTA ready.
  • Motion vocabulary: type marquees, staggered word reveals, colour-block wipes on scroll. No bounce.
  • Composed first frame: paper ground, black and red stacked headline, yellow band behind the last word, red CTA block at lower left, thin black rules.
  • Reduced-motion state: all elements render in their final positions with no reveal or wipe; content remains fully readable and the CTA remains usable.
Page 11 of 13

9. Non-Functional Requirements

  • Public access (explicit): Both pages are viewable without login or account. No identity, session, or permission control is required.
  • Readability at all viewports (explicit, from creative direction): Readable text and controls stay whole and inside their container at 375px, 768px, and 1280px.
  • Reduced motion (explicit, from creative direction): With prefers-reduced-motion, a usable static arrangement is provided.
  • Data freshness (required_inference): The Статистика page reflects the current statistics stored in the backend database at request time.
  • Failure handling (required_inference): Statistics load failures surface an error message and a retry action rather than a blank page.

10. Tech Stack

  • Frontend: React application UI.
  • Backend: Shared FastAPI process serving the application API and domain modules.
  • Database: MariaDB for application-owned persistent class performance data.
  • Infrastructure: The provisioned scaffold services (backend, database, frontend) as the runnable inventory.
Page 12 of 13

11. Assumptions and Constraints

  • A-1 (required_inference): The class performance statistics are stored in MariaDB and served by the FastAPI backend; the frontend reads them via the backend API.
  • A-2 (required_inference): The site presents statistics for a single class ("класса") as stated by the user; no multi-class selection is required by the source.
  • A-3 (explicit): No authentication, accounts, or role-based access are part of the current product.
  • A-4 (explicit): The creative direction's palette, fonts, shape language, layout, and motion are binding for the visual implementation.
  • A-5 (explicit): The generic indigo/blue-on-white SaaS template is forbidden.

12. Glossary

  • Школа 101 (School 101): The school whose website this is.
  • Статистика успеваемости класса: Class academic performance statistics — the measured performance data (grades, progress, results) for a class, displayed on the Статистика page.
  • Посетитель сайта школы: A public visitor to the school's website; the only active human persona.
  • Главная: The public entry page of the site.
  • Статистика: The page presenting class academic performance statistics.
  • Poster grid: The layout system of strong columns, horizontal rules, and full-bleed colour bands defined by the creative direction.
Page 13 of 13
Live
Главная design preview

Главная: Open site root

Главная: Read headline and subline

Главная: Activate statistics CTA

Статистика: 1. View loading state

Статистика: 2. Read class statistics

Статистика: 3. View empty-state message

Статистика: 4. View error message

Статистика: 5. Retry loading statistics

Статистика: 6. Return to entry page

Главная: 7. Re-enter statistics via CTA

Live
Главная design preview

Главная: Open site root

Главная: Read headline and subline

Главная: Activate statistics CTA

Статистика: 1. View loading state

Статистика: 2. Read class statistics

Статистика: 3. View empty-state message

Статистика: 4. View error message

Статистика: 5. Retry loading statistics

Статистика: 6. Return to entry page

Главная: 7. Re-enter statistics via CTA