Let’s not just “show”, but I will lay out this letter as a living example of our system — the Crystal of construction of a + digital operator.
What it is now (as it is). This is a classic letter:
- Manufacturer (LLC "Dh4Ru")
- Product(s)
- Cases (objects)
- Offer (catalogs, samples)
This is a linear model:
Company → Letter → Potential customer
Weakness:
No system
No digital footprint
No integration into the market
How it looks in our system (Crystal construction)
Now we include our architecture:
Crystal = 3
Nodes (entities)
- Manufacturer: Dx4Ru
- Products: mixes, coatings, tool
- Objects: metro, Magnet, parking
- Client: Union of single fighters
This is already a registry of nodes
Ryobra (links)
- Materials → are used in projects
- Company → supplier
- Objects → quality assurance
- Client → potential customer
This is a link graph (Graph DB).
Crystal (system)
Now it all becomes:
The company's digital passport + Products + Cases
What it should look like in a single portal
Here's the key. Now for paper. We need a digital living system.
Instead of a letter: Company profile
- rating
- production capacity
- certification (ISO - already available)
Product catalog (not text!)
- Material Cards
- Features
- BIM-integration
- price / availability
Register of objects (very important). Each case = object:
- Moscow Metro → digital object
- Magnet → Network of objects
- Parkings → cluster
. . . with reference:
- Geo
- Square
- materials
- Contractors
Verification (the strongest place)
Instead of the words: “we worked on 50 objects”
The system shows:
- Confirmed contracts
- Acts
- Digital footprints
Direct integration into the market
Here is where the magic happens:
It was: “We will be happy to provide information”
It will become: “Click — and order materials right now”
Translating a letter into a digital model
Here is our scheme:
Letter element |
In the system |
|
Company |
Host (Entity) |
|
Products |
Catalogue |
|
Projects |
Register of objects |
|
Trust |
Verification |
|
Contact |
API / order |
The most important thing is your system. We turn:
Description → in data
→ in relation to
→ links to the market
What it looks like in practice (very specific)
If you implement our system: - This document turns into:
- 1 company profile
- 20+ Material Cards
- 100+ digital objects
- 1 API for orders
Hard truth (without embellishments)
Now: It's just a marketing letter
In our system: it becomes an asset
And the difference is huge:
- letter = 0 scalability
- System = exponential growth
System architecture
Main idea
A letter is not a document. A letter is an unstructured incoming signal about:
- companies,
- products,
- The implemented objects,
- trust,
- Contact,
- Intend to enter the market.
The goal of the system is to turn this signal into a digital asset that lives on inside the platform. The way is this:
Document → Entity Extraction → Registry → Contact Graph → Services → Transaction
Logical levels of architecture
I'd lay 7 levels.
Level 1. Incoming Outline
This includes everything that comes into the system:
- Letters
- Scans
- commercial offers
- catalogs
- Certificates
- Power of Attorney
- presentations
- Photos of objects
In the example of the letter:
The incoming artifact is a letter scan of LLC "Dh4Ru".
What the layer does:
- uploading file
- OCR / text parsing
- highlighting the document structure
- Definition of Document Type
Result:
The system understands that it is:
- letter of representation of the company,
- with the listing of products,
- with case studies of objects,
- with props.
Level 2. Substance Extraction Layer
This is the core of the primary intelligence of the system.
It extracts:
- Organizations: LLC "Dh4Ru"
- INN: 9717038195
- Contact details
- Product categories:
- Polymer Coatings
- Dry Mixtures
- Components
- Objects/cases:
- Moscow Metro
- Belgi
- Magnet
- Moscow Residential Complex
- Astana locomotive plant
- Rostvertol
- Geography
- Squares
- Periods of work
- Recipient of the letter
- Subscriber
- Signs of trust:
- 30 years
- ISO
- List of large objects
At the output: a set of normalized entities appears.
Level 3. Normalization and master data (MDM)
This is where the system clears the chaos. Because the documents say the same thing in different ways:
- "Moscow Metro"
- "Metro of Moscow"
- "Moscow Metro"
The system must understand that it is the same object / customer / project outline.
What's going on here:
- Deduplication of organizations
- Unification of names
- Comparison with government and industry directories
- Verification of requisites
- normalization of addresses
- normalization of units of measurement
- normalization of the roles of participants
Result: a single entity register is created.
Basic system registers
It's the foundation. Without it, everything will fall apart.
Register of companies
The company card must contain:
- Company ID
- Name
- INN / OGRN
- Type of participant
- manufacturer
- supplier
- Contractor
- Designer
- Customer
- region
- Contacts
- Site
- production capacity
- Verification Statuses
- Trust Rating
- documents
- Product Connections
- Connections to objects
For this case: LLC "Dx4Ru" = manufacturer of building materials.
Register of products and materials
Every material should have a card.
Material card:
- Product ID
- Category
- Name
- technical specifications
- normative documents
- Certificates
- photo
- Product Passport
- BIM-attributes
- scope of application
- manufacturer
- Availability / Logistics
- history of application at facilities
In the example of the letter:
- Polymer floor coverings
- Dry construction mixes
- Decorative coatings "Terrazzo"
- knives, discs, cutters, guides, formwork
Register of construction objects
This is one of the main assets of the platform.
Object Card
- Object ID
- title
- object type
- location
- Square
- Timeline
- status
- Participants
- Applied Materials
- Contractors
- Photos / Documents
- Digital Footprint
- Verification of participation
For example:
- Moscow Metro
- 32 Magnit supermarket
- more than 50 parking lots in Moscow
- Rostvertol
and so on.
Register of documents
The document should not live separately, but as part of the graph.
Document card:
- Document ID
- type
- Source
- date
- Sender
- Signatories
- Related Companies
- related objects
- Related Products
- Extracted text
- Version
- Checking status
- electronic trail / hash
This letter is type = submission letter/commercial installation letter.
Register of roles and participants
There are always a lot of participants in one place.
Roles:
- Customer
- Developer
- Technical Customer
- General Contractor
- Contractor
- supplier
- manufacturer
- Designer
- Air Operator
- Investor
The system should see not just companies, but who is in what role where it participates.
Graph model: knots and edges
That's where your idea of "node, edge, crystal" becomes real architecture.
Nodes
Node types:
- Company
- Product
- Material
- Project
- Object
- Person
- Document
- Certificate
- Region
- Contract
- Role
- Category
Ribs. Connections between nodes:
- COMPANY_PRODUCES_PRODUCT
- PRODUCT_USED_IN_OBJECT
- COMPANY_PARTICIPATED_IN_OBJECT
- DOCUMENT_MENTIONS_COMPANY
- DOCUMENT_MENTIONS_OBJECT
- COMPANY_HAS_CERTIFICATE
- PERSON_SIGNED_DOCUMENT
- COMPANY_LOCATED_IN_REGION
- OBJECT_LOCATED_IN_REGION
- COMPANY_HAS_ROLE_IN_OBJECT
Example of a graph for writing:
Dx4Ru LLC → produces → polymer coatings
LLC "Dh4Ru" → participated in → Moscow Metro
Polymer coatings→ applied on → parking lots of Moscow
Letter No105/25/Dx→ mentions → LLC "Dx4Ru"
Letter No105/25/Dx→ mentions → Magnet / Belgi / Rostvertol
Application services on top of data
This is no longer storage, but use.
Company Digital Profile Service
Shows:
- Who is this,
- What he does,
- Where materials are used,
- What level of trust,
- What documents confirm the experience.
Materials catalog service
Allows:
- Looking for materials,
- filter by properties,
- Look at the actual objects of use.
- Comparing producers.
Decision-making service
For example: "We need parking cover 10 000 m² in Moscow"
The system gives out:
- Suitable materials,
- suppliers,
- Verified cases,
- Dates and analogues.
Trust and Verification Service
Checks:
- Is there proof of objects,
- There are certificates,
- If there are any confirmed documents,
- Are there any anomalies in the claimed cases?
Service deals / purchases
This is the transition to marketplace:
- Samples request
- KP Request
- Tender
- Party Order
- Logistics
- delivery support
Technological architecture
Now hard and objective.
Frontend. Interfaces:
- web portal
- Personal account of the company
- Customer's office
- Platform Operator Cabinet
- Analytical Panel
- object card
- Material Card
- Company Card
Approach:
- React / Next.js
- design system
- Roles and Conditions
- search-first interface
Backend
We need a modular backend.
Main services:
- Auth Service
- Company Service
- Product Service
- Object Registry Service
- Document Service
- Graph Service
- Verification Service
- Search Service
- Procurement Service
- Notification Service
- Analytics Service
Approach:
- microservices or modular monolith at the start
- API-first
- event-driven integration
For MVP, I would not spray and went to a modular monolith to quickly assemble the core.
Data warehouses. We don't need one base here.
Relational DB
For registries and transactions:
- PostgreSQL
Stores:
- Company
- Products
- objects
- Users
- Roles
- documents
- Applications
- Deals
Graph DB
For links:
- Neo4j / Memgraph
Stores:
- Nodes
- Ribs
- the Participation Chain
- Communication of materials and objects
- Count of Trust
Search index
For a quick search:
- Elasticsearch / OpenSearch
Stores:
- Indexes of documents
- full-text search
- facet search by materials, objects, companies
Object Storage
For files:
- S3-compatible storage / MinIO
Stores:
- Scans
- photo
- Certificates
- catalogs
AI / intellectual layer
Without it, the system would be just an archive.
Document AI
Handles incoming documents:
- OCR
- Classification of the document
- Extracting entities
- Extraction of props
- Extraction of cases
Entity Resolution
Is it a new object or an existing one?
Recommendation Engine. Selects:
- materials
- Suppliers
- Model solutions
- Analogs
Trust Scoring
Considers the rating of trust of the company based on:
- Confirmed objects
- Documents
- Certification
- Profile Completeness
- Repeated participation in projects
Knowledge Graph Intelligence
Allows you to answer questions:
- Where was this material used?
- Which companies actually worked in large transport facilities?
- Who provides parking solutions?
- What materials have proven to be scalable?
Event Model
The system is alive, not static.
Events:
- CompanyCreated
- DocumentUploaded
- DocumentParsed
- EntityMatched
- ProductCreated
- ObjectLinked
- VerificationRequested
- VerificationApproved
- RFQCreated
- QuoteSubmitted
- ContractRegistered
This will allow:
- running checks,
- updating the indices,
- Notify users,
- Building analytics.
Security and Trusted Environment
This is critical for the construction platform.
Need:
- RBAC / ABAC accesses
- Action Log
- version of documents
- Control of data origin
- electronic signature
- hashing of documents
- Audit of changes
- Separation of public and private data
Screen architecture on the example of this case
If you open a company from this letter in the system, the screen should be:
Company card
LLC "Dh4Ru"
Block 1. General
- Taxpayer Identification Number (INN)
- Site
- region
- Type of participant
- date of foundation
- Verification Status
Block 2. Products
- Polymer Coatings
- Dry Mixtures
- Terrazzo
- Components
Block 3. Confirmed cases
- Moscow Metro
- Magnet
- Belgi
- Rostvertol
- Moscow Residential Complex
Block 4. Documents
- Letter of Submission
- Certificates
- catalogs
- Power of Attorney
Block 5. Links graph
visual scheme:
Company ↔ Products ↔ Objects ↔ Documents ↔ Regions
Block 6. Actions
- Request to KP
- request samples
- invite to tender
- Contact us
- check the experience
Minimum MVP
Don't build a space ship right away. We need to build a core.
MVP v1. Includes only 6 entities:
- Company
- Products
- objects
- documents
- Communications
- Applications
MVP-functions:
- document loading
- Extract Text
- Manual confirmation of entities
- Company Card
- Product Card
- object card
- graph links
- Search
- Contact Request / KP
That’s enough to show the power of the system..
Recommended stack to start
Without too much romance. Practically.
Front
- Next.js
- TypeScript
Back
- NestJS or FastAPI
- REST/GraphQL API
Data
- PostgreSQL
- Neo4j
- OpenSearch
- MinIO
AI
- OCR
- NER / LLM extraction
- entity matching
- scoring pipelines
Infra
The architectural formula of our system
In one sentence:
Single construction portal = registry platform + graph links + intelligent verification + transaction service.
And if in your terminology:
Entities Nodes =
Ribs = relationship
Crystal = digital operating model of the construction market
The most important decision
Do not build a system as a "company website". It's dead-end.
Build as:
Registry + Graph + Proof Environment + Transaction Circuit
Then even such a simple letter becomes not an archive, but an entrance into the digital economy of construction.