Skip to content

Latest commit

 

History

History
78 lines (61 loc) · 3.35 KB

CONTEXT.md

File metadata and controls

78 lines (61 loc) · 3.35 KB

Deep Dive

The public site that gives a plain-language reading of a listed company: a score, a verdict, and the figures behind them. It exists for people who already own shares but do not know how to read a company.

Language

Reader: A French retail investor who has already bought shares and cannot read a balance sheet. Every page is written for this person first. Avoid: user, trader, analyst, client

User: The person using the app: holds a Solana wallet and USDC, has not bought a tokenized stock yet. The app speaks English to the User and never explains the blockchain. Avoid: reader (the person of the Card), holder, trader

Card (fiche): The page of one company. One linear document read top to bottom, in named sections, with no tabs. The reference layout is the France Cryptos analysis page. Avoid: report, dashboard, stock page, deep dive (the product name, not the page)

Universe: Every listed company syndicate knows. Any of them has a Card; none is excluded by a hand-kept list. Avoid: registry, coverage, corpus, watchlist (a Selection is not the Universe)

Selection: A named subset of the Universe defined by a rule on syndicate figures, such as "profitable for ten years" or "more cash than debt". A Selection is computed, never typed in. Its name is a noun of two or three words that promises exactly the rule under it, never a question and never more than the rule delivers. Avoid: registry, list, collection, preset, screen (the mechanism, not the thing)

Section: One named block of a Card, always in the same order across companies: The essentials, Understanding the company, Price and market, Quality and profitability, Growth, Valuation, Financial strength, Technical reading, What analysts expect, Against competitors, Risks to watch, News that matters.

Opportunities: Everything shown under the wallet on the main page: Movers, Picks, Comebacks and Selections, in that order. It is the one place the Reader finds something to buy. Avoid: discover, explore, popular, home feed

Movers: The five largest rises and the five largest falls of the day across the Universe. Avoid: gainers, losers, trending

Picks: Companies whose overall score is above 5, whose technical regime is bullish, and whose price has pulled back recently. A Pick is a computed fact about the company, never advice. Avoid: recommendations, recommended buys, opportunities of the moment

Comebacks: Companies whose overall score is above 5 and whose price has fallen by more than a quarter from its 52-week high. Like a Pick, a computed fact about the company, never advice; shown after the Picks, and only when the rule matches at least one company. Avoid: bargains, dips, discounted, buy the dip

Flagged ambiguities

  • "Strategy" (Defensive / Balanced / Growth, a basket of 22 companies bought in one go) was dropped on 21 September 2026. The app has one objective: buy one stock. The components stay in the tree until a dead-code pass removes them; no route reaches them.

  • "Deep dive" names the product and the syndicate payload. It never names a page: the page of a company is the Card.

Example dialogue

Dev: The report has six tabs. Do I keep them on the new Card? Domain expert: No. A Card is one document the Reader scrolls, section after section, in the fixed order. Tabs hide sections, and the Reader does not know which one to open.