CASE STUDY · CS-01
Knowledge, connected.
A design study for a private, permission-aware answer layer over fragmented organizational knowledge.
- INDUSTRY
- Professional services
- PROBLEM
- Answers exist across wikis, drives, and ticket history, but people cannot find them quickly, and search ignores who is allowed to see what.
- SOLUTION CATEGORY
- Retrieval-augmented knowledge assistant
- TECHNOLOGY
- TypeScript
- Next.js
- Python
- PostgreSQL + pgvector
- LLM APIs
- OpenTelemetry
- INTENDED OUTCOME
- Grounded answers with visible sources, scoped to each person’s existing permissions, and a clear route to a human expert when the system cannot answer.
01Sources
- Wiki
- Shared drives
- Ticket history
02Ingestion
- Connectors
- Chunking
- Permission sync
03Retrieval
- Hybrid search
- Access filter
- Re-ranking
04Generation
- Grounded prompt
- Citation check
- Fallback
05Experience
- Answer UI
- Feedback
- Expert routing
01 / 14
Overview
Knowledge-heavy teams lose time re-asking questions that have already been answered somewhere. The information exists, but it is spread across tools with different search behavior and different access rules.
This study designs an answer layer that sits over approved sources. It retrieves relevant passages, composes an answer with citations, and respects the permissions people already have in each source system.
02 / 14
Challenge
How can a team get useful, checkable answers from fragmented internal knowledge without exposing anything a person could not already open?
A fluent answer that is wrong, or one that quotes a document the reader should not see, is worse than no answer. Trust has to be designed in, not added later.
03 / 14
Constraints
Access boundaries
A person must only receive answers built from content they can already open in the source system.
Changing sources
Documents are edited and deleted daily; the index has to follow without full rebuilds.
Checkable answers
Every statement in an answer needs a source the reader can open and verify.
Data handling
Content stays in the organization’s environment and only reaches model providers under approved data-processing terms.
Predictable cost
Per-question cost and latency need an agreed budget before the system is opened to more people.
04 / 14
Discovery
WHAT DISCOVERY WOULD ESTABLISH
- 01
Source inventory
Which systems hold the knowledge, who owns them, how they expose content and permissions, and how often they change.
- 02
Real questions
A log of questions people actually ask, collected before building, so the system is designed around real demand.
- 03
Permission model
How groups, shared links, and inherited access work in each source, including the edge cases.
- 04
Evaluation set
A reviewed set of questions with expected sources, created with subject-matter experts, to measure retrieval and answer quality.
05 / 14
Solution
Connectors pull content and permission data from approved sources into a single index. At question time, retrieval filters by the asker’s access before ranking, and the model only sees passages the person is allowed to read.
Answers are composed with mandatory citations. When retrieval finds nothing relevant, the system says so and offers to route the question to a named owner.
CAPABILITIES
- Permission-aware hybrid search
- Answers with inline citations
- Explicit “no answer found” state
- Routing to a subject-matter owner
- Inline feedback on every answer
- Per-question traces for review
06 / 14
UX & product decisions
DECISION 01
Citations are mandatory
- WHY
- People need to check an answer before acting on it, and citations make errors visible.
- TRADE-OFF
- Some questions receive “no source found” instead of a plausible-sounding answer.
DECISION 02
“No answer” is a designed state
- WHY
- An honest gap, with a route to an expert, keeps trust when coverage is incomplete.
- TRADE-OFF
- Early coverage looks smaller, because the system declines rather than guesses.
DECISION 03
Escalate to an owner, not a queue
- WHY
- Questions reach the person who can answer them, and their answer can become a new source.
- TRADE-OFF
- Requires maintaining ownership metadata for each collection.
DECISION 04
Feedback on every answer
- WHY
- Thumbs and short comments feed the evaluation set with real failures.
- TRADE-OFF
- Feedback needs triage time from the team that owns the system.
07 / 14
Architecture
Permissions are enforced at retrieval, before the model sees anything. The index can be rebuilt from sources at any time, and every answer can be traced back to the passages that produced it.
- L1
Sources
Systems of record that keep ownership of content and access rules.
- Wiki
- Shared drives
- Ticket history
- L2
Ingestion
Incremental connectors that normalize content and copy permission data alongside it.
- Connectors
- Chunking
- Permission sync
- L3
Retrieval
Combines keyword and semantic search, filtered by the asker’s access, then re-ranked.
- Hybrid search
- Access filter
- Re-ranking
- L4
Generation
Composes an answer from retrieved passages only, and checks that each claim has a citation.
- Grounded prompt
- Citation check
- Fallback
- L5
Experience
Where people ask, verify sources, give feedback, and reach an expert.
- Answer UI
- Feedback
- Expert routing
DESIGN PRINCIPLES
Access before relevance
Filtering happens inside the retrieval query, so a ranking change can never surface restricted content.
Rebuildable index
The index is derived data. Sources stay the system of record, which keeps deletion and correction simple.
Provider adapter
Model calls go through one interface, so providers can be evaluated and changed without touching the product.
08 / 14
Technology
| Area | Choice | Why |
|---|---|---|
| Interface |
| Server-rendered answers with streaming, and one typed codebase for the UI and its API layer. |
| Retrieval service |
| One datastore for content, metadata, permissions, and embeddings keeps access filtering in a single query. |
| Models |
| Model choice stays an evaluated, reversible decision rather than an architectural commitment. |
| Observability |
| Each answer records retrieval results, prompts, and timings for review and debugging. |
09 / 14
Implementation
PROPOSED DELIVERY SEQUENCE
- PHASE 01
Evaluation harness first
Build the evaluation set and scoring before features, so every later change is measured.
- PHASE 02
One source, end to end
Connect a single well-understood source, including permissions, to prove the full path.
- PHASE 03
Pilot group
Open to a small group with feedback enabled, and review failures weekly.
- PHASE 04
Expand deliberately
Add sources and expert routing one at a time, re-running the evaluation after each.
10 / 14
Testing
Retrieval evaluation
Scores whether the expected sources appear for each question in the reviewed set.
Negative access tests
Test identities without access must never receive content, citations, or hints from restricted documents.
Regression on change
Prompt, model, and ranking changes re-run the evaluation before release.
Ingestion load tests
Bulk edits and deletions are replayed to check the index keeps up.
11 / 14
Infrastructure
Client-controlled environment
Deployed in the organization’s cloud account, with network access to approved sources only.
Scheduled and event-driven sync
Webhooks where sources support them, with scheduled reconciliation as a safety net.
Secrets and keys
Source credentials and provider keys held in a managed secret store and rotated.
Cost and latency dashboards
Per-question cost, token usage, and latency tracked against the agreed budget.
12 / 14
Key challenges
CHALLENGE 01
Permission drift between a source and the index.
RESPONSE
Incremental permission sync, plus a query-time check against the source for the most sensitive collections.
CHALLENGE 02
Stale or contradictory documents.
RESPONSE
Show document age and owner next to each citation, and notify owners when answers rely on outdated material.
CHALLENGE 03
Ambiguous questions.
RESPONSE
Ask a clarifying question rather than guessing between interpretations.
13 / 14
Results
This is a concept, so there are no measured results. The outcomes below are what the design is intended to achieve; the measures after them are how a pilot would verify it against an agreed baseline.
INTENDED RESULTS · QUALITATIVE
- Every answer can be checked against its source in one click.
- Access boundaries are a tested requirement, not a configuration detail.
- Gaps in coverage become visible and route to the people who can close them.
HOW RESULTS WOULD BE VERIFIED
- Retrieval and answer quality against the reviewed evaluation set.
- Access correctness through negative tests on every release.
- Latency and cost per question against the agreed budget.
- Pilot feedback compared with a baseline of how people search today.
14 / 14
Lessons
- 01
Evaluate before you build
Without a reviewed question set, quality discussions become opinion.
- 02
Permissions are the product
Access correctness decides whether the system can be used at all.
- 03
Design the “I don’t know”
A clear gap with a route forward earns more trust than a confident guess.